Hot Spring

The Hot Spring integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to monitor and control your Hot Spring spa equipped with the HotSpring Connected Spa Kit 2 (part number 79994) module directly from Home Assistant.

Supported devices

• 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 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.

Configuration

To add the Hot Spring device to your Home Assistant instance, use this My button:

Hot Spring can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Reconfiguration

If the IP address of your Hot Spring spa changes, reconfigure the integration:

1. Go to Settings > Devices & services.
2. Select the Hot Spring integration.
3. Select Menu > Reconfigure.

Supported functionality

The Hot Spring integration provides the following entities:

Binary sensor

• Heating
  • Description: Indicates whether the spa heater is actively heating water.
• Problem
  • Description: Indicates whether a failure or error condition is detected on the spa.
• Spa connected
  • Description: Indicates whether the wireless radio link between the Home Network Adapter (HNA) and the Spa Network Adapter (SNA) is connected.

Light

• Light zone 1
  • Description: Controls a light zone on the spa (one entity is created per enabled light zone). Supports turning the light on and off, adjusting brightness, and setting an RGB color.

Number

• Target temperature
  • Description: Allows setting the target water temperature for the spa.
  • Range: 80 °F to 104 °F

Sensor

• Current temperature
  • Description: Current water temperature of the spa.
• Salt 10-day check timer
  • Description: Number of days remaining until the next 10-day salt water test reminder.
  • Availability: Available when a FreshWater Salt System cartridge is installed.
• Salt cartridge age
  • Description: Number of days the FreshWater Salt System cartridge has been in use.
  • Availability: Available when a FreshWater Salt System cartridge is installed.
• Salt value
  • Description: Current salt level reading from the FreshWater Salt System.
  • Availability: Available when a FreshWater Salt System cartridge is installed.
• Control box version
  • Description: Firmware version of the spa control box.
  • Remarks: Disabled by default.
• FreshWater Salt System version
  • Description: Firmware version of the FreshWater Salt System module.
  • Remarks: Disabled by default. Available when a FreshWater Salt System is detected.
• Wi-Fi dongle version
  • Description: Firmware version of the Wi-Fi dongle.
  • Remarks: Disabled by default.

Hot Spring automation examples

Here are a few ideas to get you started.

Notify when the 10-day salt check timer is due

Get a reminder to test your Hot Spring spa water with a salt test strip when the 10-day check timer expires.

alias: "Notify when 10-day salt check is due"
description: "Send a notification when the 10-day salt check timer reaches 0 days."
triggers:
  - trigger: numeric_state
    entity_id: sensor.hot_spring_salt_10_day_check_timer
    below: 1
actions:
  - action: notify.send_message
    target:
      entity_id: notify.notify
    data:
      title: "Hot Spring spa"
      message: "The 10-day salt water test timer has expired. Please test your spa water with a test strip."

Notify when the spa reaches target temperature

Get notified when your spa water has reached the desired target temperature and is ready for use.

alias: "Notify when spa reaches target temperature"
description: "Send a notification when the spa water temperature reaches the target temperature."
triggers:
  - trigger: numeric_state
    entity_id: sensor.hot_spring_current_temperature
    above: 101
actions:
  - action: notify.send_message
    target:
      entity_id: notify.notify
    data:
      title: "Hot Spring spa"
      message: "The spa is ready! Current water temperature is {{ states('sensor.hot_spring_current_temperature') }} °F."

Data updates

The Hot Spring integration uses local pollingData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] 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:

• Make sure your Hot Spring spa module is powered on and connected to your local network.
• Verify that you are using the IP address of the HNA (Home Network Adapter) and not the SNA (Spa Network Adapter).
• Verify that you can locate the device on your local network router client list.
• Double-check that the IP address or hostname entered is correct and reachable from your Home Assistant instance.
• Restart the Hot Spring spa module and reload the integration in Home Assistant.

Diagnostics

The Hot Spring integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides diagnostics to help with troubleshooting. The download includes:

• Redacted configuration entry data
• Spa hardware information and firmware versions
• Current state and telemetry for the spa heater, jets, blower, lights, clean cycle, spa lock, water care, FreshWater IQ, energy savings schedules, connection status, and test metrics

Sensitive information, such as the host, IP address, and MAC address, is redacted.

To download diagnostics:

1. Go to Settings > Devices & services.
2. Select the Hot Spring integration.
3. Open the three-dot menu on the integration entry and select Download diagnostics.

Attach the downloaded file when reporting an issue. For more information, see Download diagnostics.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.