From 4f5bc38b44247b2013fca4786c6ecd484f77f26d Mon Sep 17 00:00:00 2001 From: Moustachauve <2206577+Moustachauve@users.noreply.github.com> Date: Thu, 30 Jul 2026 03:56:11 +0000 Subject: [PATCH 1/5] Add initial Hot Spring integration documentation --- source/_integrations/hotspring.markdown | 79 +++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 source/_integrations/hotspring.markdown diff --git a/source/_integrations/hotspring.markdown b/source/_integrations/hotspring.markdown new file mode 100644 index 000000000000..5c0d519bfb1e --- /dev/null +++ b/source/_integrations/hotspring.markdown @@ -0,0 +1,79 @@ +--- +title: Hot Spring +description: Instructions on how to integrate Hot Spring spas into Home Assistant. +ha_release: 2026.8 +ha_category: + - Water heater +ha_iot_class: Local Polling +ha_codeowners: + - '@Moustachauve' +ha_domain: hotspring +ha_platforms: + - diagnostics + - water_heater +ha_integration_type: device +--- + +The **Hot Spring** {% term integration %} allows you to monitor and control your [Hot Spring](https://www.hotspring.com/) spa equipped with the **Connected Spa Kit 2** (Part #79994) module directly from Home Assistant. + +## Supported hardware + +- Hot Spring Spas equipped with the **HotSpring Connected Spa Kit 2** (Part #79994) local network module. + +## Prerequisites + +1. Install and set up the **HotSpring Connected Spa Kit 2** on your hot tub following the manufacturer's quick start guide. +2. Use the official **HotSpring Connected Spa** app to connect the spa module to your home Wi-Fi or local network. +3. Verify that your Home Assistant instance and the Hot Spring spa module are on the same local network subnet. + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Host: + description: "The hostname or IP address of your Hot Spring HNA (Home Network Adapter) on your local network (for example, `192.168.1.150`)." +{% endconfiguration_basic %} + +{% note %} +When setting up or reconfiguring the integration, ensure you enter the IP address of the **HNA (Home Network Adapter)** and **not** the IP address of the **SNA (Spa Network Adapter)**. +{% endnote %} + +### Reconfiguration + +If the IP address of your Hot Spring spa changes, you can reconfigure the integration by going to {% my integrations title="**Settings** > **Devices & services**" %}, selecting the **Hot Spring** integration, clicking {% icon "mdi:dots-vertical" %} and choosing **Reconfigure**. + +## Supported functionality + +The **Hot Spring** integration provides the following entities: + +### Water heater + +- **Water heater** + - **Description**: Displays the current water temperature and allows setting the target water temperature. + - **Temperature Range**: 80.0 °F to 104.0 °F + - **Remarks**: Turning the water heater on or off is not supported by the integration. + +### Diagnostics + +- Provides diagnostic data collection for troubleshooting. Sensitive unique IDs and MAC addresses are automatically redacted. + +## Data updates + +The **Hot Spring** integration uses local {% term polling %} to fetch status updates directly from the spa module on your local network. + +## Troubleshooting + +### Cannot connect to Hot Spring spa + +If Home Assistant cannot establish a connection to your Hot Spring spa: + +1. Make sure your Hot Spring spa module is powered on and connected to your local network. +2. Verify that you are using the IP address of the **HNA (Home Network Adapter)** and not the **SNA (Spa Network Adapter)**. +3. Verify that you can locate the device on your local network router client list. +4. Double check that the IP address or hostname entered is correct and reachable from your Home Assistant instance. +5. Try restarting the Hot Spring spa module and reloading the integration in Home Assistant. + +## Removing the integration + +This integration follows standard integration removal. + +{% include integrations/remove_device_service.md %} From b2537ca4ac1372618ecdfbaa970415ac2b982c83 Mon Sep 17 00:00:00 2001 From: Moustachauve <2206577+Moustachauve@users.noreply.github.com> Date: Sat, 1 Aug 2026 23:37:59 -0400 Subject: [PATCH 2/5] Remove diagnosis from initial version --- source/_integrations/hotspring.markdown | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/_integrations/hotspring.markdown b/source/_integrations/hotspring.markdown index 5c0d519bfb1e..cb4c2d8e2c91 100644 --- a/source/_integrations/hotspring.markdown +++ b/source/_integrations/hotspring.markdown @@ -9,7 +9,6 @@ ha_codeowners: - '@Moustachauve' ha_domain: hotspring ha_platforms: - - diagnostics - water_heater ha_integration_type: device --- @@ -52,10 +51,6 @@ The **Hot Spring** integration provides the following entities: - **Temperature Range**: 80.0 °F to 104.0 °F - **Remarks**: Turning the water heater on or off is not supported by the integration. -### Diagnostics - -- Provides diagnostic data collection for troubleshooting. Sensitive unique IDs and MAC addresses are automatically redacted. - ## Data updates The **Hot Spring** integration uses local {% term polling %} to fetch status updates directly from the spa module on your local network. From a193d860105818246e83a7c1138e7fb363f0bc0e Mon Sep 17 00:00:00 2001 From: Christophe Gagnier Date: Sat, 1 Aug 2026 23:44:24 -0400 Subject: [PATCH 3/5] add ha_config_flow to hotspring Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- source/_integrations/hotspring.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/hotspring.markdown b/source/_integrations/hotspring.markdown index cb4c2d8e2c91..9d8c2b79e663 100644 --- a/source/_integrations/hotspring.markdown +++ b/source/_integrations/hotspring.markdown @@ -5,6 +5,7 @@ ha_release: 2026.8 ha_category: - Water heater ha_iot_class: Local Polling +ha_config_flow: true ha_codeowners: - '@Moustachauve' ha_domain: hotspring From 3dc3c6753f24cc8bc0173122e403d1800acd0469 Mon Sep 17 00:00:00 2001 From: Moustachauve <2206577+Moustachauve@users.noreply.github.com> Date: Sat, 1 Aug 2026 23:48:59 -0400 Subject: [PATCH 4/5] Implement AI reviewer suggestions --- source/_integrations/hotspring.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/hotspring.markdown b/source/_integrations/hotspring.markdown index cb4c2d8e2c91..ce63bbe9db50 100644 --- a/source/_integrations/hotspring.markdown +++ b/source/_integrations/hotspring.markdown @@ -13,15 +13,15 @@ ha_platforms: ha_integration_type: device --- -The **Hot Spring** {% term integration %} allows you to monitor and control your [Hot Spring](https://www.hotspring.com/) spa equipped with the **Connected Spa Kit 2** (Part #79994) module directly from Home Assistant. +The **Hot Spring** {% term integration %} allows you to monitor and control your [Hot Spring](https://www.hotspring.com/) spa equipped with the **HotSpring Connected Spa Kit 2** (part number 79994) module directly from Home Assistant. -## Supported hardware +## Supported devices -- Hot Spring Spas equipped with the **HotSpring Connected Spa Kit 2** (Part #79994) local network module. +- Hot Spring Spas equipped with the **HotSpring Connected Spa Kit 2** (part number 79994) local network module. ## Prerequisites -1. Install and set up the **HotSpring Connected Spa Kit 2** on your hot tub following the manufacturer's quick start guide. +1. Install and set up the **HotSpring Connected Spa Kit 2** on your spa following the manufacturer's quick start guide. 2. Use the official **HotSpring Connected Spa** app to connect the spa module to your home Wi-Fi or local network. 3. Verify that your Home Assistant instance and the Hot Spring spa module are on the same local network subnet. @@ -38,7 +38,7 @@ When setting up or reconfiguring the integration, ensure you enter the IP addres ### Reconfiguration -If the IP address of your Hot Spring spa changes, you can reconfigure the integration by going to {% my integrations title="**Settings** > **Devices & services**" %}, selecting the **Hot Spring** integration, clicking {% icon "mdi:dots-vertical" %} and choosing **Reconfigure**. +If the IP address of your Hot Spring spa changes, you can reconfigure the integration by going to {% my integrations title="**Settings** > **Devices & services**" %}, selecting the **Hot Spring** integration, selecting {% icon "mdi:dots-vertical" %}, and then choosing **Reconfigure**. ## Supported functionality @@ -64,7 +64,7 @@ If Home Assistant cannot establish a connection to your Hot Spring spa: 1. Make sure your Hot Spring spa module is powered on and connected to your local network. 2. Verify that you are using the IP address of the **HNA (Home Network Adapter)** and not the **SNA (Spa Network Adapter)**. 3. Verify that you can locate the device on your local network router client list. -4. Double check that the IP address or hostname entered is correct and reachable from your Home Assistant instance. +4. Double-check that the IP address or hostname entered is correct and reachable from your Home Assistant instance. 5. Try restarting the Hot Spring spa module and reloading the integration in Home Assistant. ## Removing the integration From 9724784989eaf8fc3d0bcfd5f27315a909203c6c Mon Sep 17 00:00:00 2001 From: Moustachauve <2206577+Moustachauve@users.noreply.github.com> Date: Tue, 4 Aug 2026 23:11:07 -0400 Subject: [PATCH 5/5] docs: add actions documentation to Hot Spring integration page --- source/_integrations/hotspring.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/hotspring.markdown b/source/_integrations/hotspring.markdown index 10c5e5488aad..4ee248b9e10f 100644 --- a/source/_integrations/hotspring.markdown +++ b/source/_integrations/hotspring.markdown @@ -52,6 +52,8 @@ The **Hot Spring** integration provides the following entities: - **Temperature Range**: 80.0 °F to 104.0 °F - **Remarks**: Turning the water heater on or off is not supported by the integration. +{% include integrations/actions.md %} + ## Data updates The **Hot Spring** integration uses local {% term polling %} to fetch status updates directly from the spa module on your local network.