Nathan Spencer afe0c0a07b
Update balboa docs to include fault event entity (#37484)
* Update balboa docs to include fault sensor entity

* Use event instead of sensor
2025-03-02 22:28:10 +01:00

2.4 KiB

title, description, ha_category, ha_release, ha_iot_class, ha_domain, ha_platforms, ha_codeowners, ha_config_flow, ha_integration_type, ha_dhcp
title description ha_category ha_release ha_iot_class ha_domain ha_platforms ha_codeowners ha_config_flow ha_integration_type ha_dhcp
Balboa Spa Client Instructions on how to integrate Balboa Spa WiFi within Home Assistant.
Binary sensor
Climate
Fan
Light
Select
2021.12 Local Push balboa
binary_sensor
climate
event
fan
light
select
switch
time
@garbled1
@natekspencer
true integration true

The Balboa Spa Client {% term integration %} adds support for Balboa Spa WiFi Modules to be used within Home Assistant.

There is currently support for the following device types within Home Assistant:

  • Binary sensor (Filter cycles and circulation pumps)
  • Climate
  • Event (Last known fault, if any)
  • Fan (Pumps/Jets)
  • Light
  • Select (Low/high temperature range)
  • Switch (Enable/disable filter cycle 2)
  • Time (Set filter cycle start/end times)

Compatible hardware

Balboa Spa Client integration support local control of hot tub spas equipped with a Balboa BP system and a bwa™ Wi-Fi Module (50350).

Balboa Spa Client integration is not compatible with ControlMySpa™ cloud API used by Balboa ControlMySpa Gateway Ultra (59303).

{% include integrations/config_flow.md %}

{% configuration_basic %} host: description: "Hostname or IP address of your Balboa Spa Wifi Device, e.g., 192.168.1.58." {% endconfiguration_basic %}

{% include integrations/option_flow.md %}

{% configuration_basic %} sync_time: description: Sync the Spa's internal clock with Home Assistant daily {% endconfiguration_basic %}

Known limitations

  • The WiFi Module is a direct connection to the control panel of the spa. Certain combinations of settings are not possible due to limitations of the spa.
  • Turning on certain pumps, depending on the spa configuration, may cause other pumps to come online as well.
  • The spa WiFi Module will need to be configured initially by the phone app to authenticate and get an IP on your network.
  • The WiFi Module will automatically disconnect from Home Assistant periodically, and then be automatically reconnected. The disconnect is built-in to the hardware.

Debugging integration

If you have problems with Balboa or the integration you can add debug prints to the log.

logger:
  default: info
  logs:
    pybalboa: debug
    homeassistant.components.balboa: debug