diff --git a/source/_integrations/balboa.markdown b/source/_integrations/balboa.markdown new file mode 100644 index 00000000000..b444932f3ba --- /dev/null +++ b/source/_integrations/balboa.markdown @@ -0,0 +1,56 @@ +--- +title: "Balboa Spa" +description: "Instructions on how to integrate Balboa Spa WiFi within Home Assistant." +ha_category: + - Climate +ha_release: 2021.12 +ha_iot_class: Local Push +ha_domain: balboa +ha_platforms: + - climate +ha_codeowners: + - '@garbled1' +ha_config_flow: true +--- + +This integration adds support for [Balboa](http://www.balboawatergroup.com/) Spa WiFi Modules to be used within Home Assistant. + +There is currently support for the following device types within Home Assistant: + +- Climate + +{% 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`." + required: true + type: string +{% endconfiguration_basic %} + +{% include integrations/option_flow.md %} +{% configuration_basic %} +sync_time: + description: Sync the Spa's internal clock with Home Assistant daily + type: boolean + default: false +{% 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. + +```yaml +logger: + default: info + logs: + pybalboa: debug + homeassistant.components.balboa: debug +```