Skip to content

mathieu-mp/homeassistant-intex-spa

Repository files navigation

Intex Spa integration for Home Assistant

hacs GitHub Release Project Maintenance Open in Remote - Containers

Disclaimers

Intex brand is not involved in any way with this integration.

Please read the license file before use, and the manufacturer documentation.

Compatibility

This integration allows connection with the spas made to be used with the 'Intex Link - Spa Management' app (the one with the dark background).

To identify if your spa is compatible with this integration, check the back of the control panel and look for the code engraved on it as referred to in the below sections.

Compatible spas

Firmware models

Your spa is compatible if the engraved code on the control panel does not contain the letters "TY", see the example below:

Compatible version image

Hardware models

The following hardware models are known to be compatible with this integration. In Home Assistant, you can manually disable the entities that your spa does not provide.

EU/US Model EU Control Panel Part No. EU Manual Ref. FR/US Name Bubbles Sanitizer Jets
28440/28439 13035 SB-HWF20 (352A) Baltik/Greywood 4p X
28442/28441 13035 SB-HWF20 (352A) Baltik/Greywood 6p X
28450/28449 13100 SB-HSWF20 (353A) Ardoise/- 4p X X
28452/28451 13100C SB-HSWF20 (353A) Ardoise/- 6p X X
28446/28445 13100 SB-HSWF20 (353A) Chevron 4p X X
28472/28471 13100C SB-HSWF20 (353A) Chevron 6p X X
28458/28457 13023 SC-WF20 (351A) Carbone/- 4p X X X
28462/28461 13023 SC-WF20 (351A) Carbone/- 6p X X X
28464/28463 13023C SC-WF20-1 (357A) Calacatta 4p X X X

Non-compatible spas

Firmware models

Your spa is not compatible if the engraved code on the control panel does contain the letters "TY", see the example below:

Compatible version image

For these spa, please refer to the following discussions:

  1. How to connect to the spa to your wifi
  2. How to connect to the spa to Home Assistant via Local Tuya

The most we can do here is refer you to these discussions. There will be no new feature implementing connection to these spas through this integration.

What it does

This integration relies on Intex Spa Python package.
This integration connects to your spa via your local network, and does not rely on the cloud. Your spa just needs to be paired with your wifi1.

This component will set up the following entities:

Platform Entity Description Remarks
climate Spa Climate controller for water heating Does not provide the actual heating status 2
switch Power Switch for toggling power state
switch Bubbles Switch for toggling bubbles
switch Jets Switch for toggling jets To disable if your spa does not feature jets
switch Filter Switch for toggling water filtering
switch Sanitizer Switch for toggling water electrolysis To disable if your spa does not feature a sanitizer
sensor Current Temperature Sensor for current temperature (similar to climate entity 'current_temp' attribute) Disabled by default 3
sensor Target Temperature Sensor for target temperature (similar to climate entity 'target_temp' attribute) Disabled by default 3
sensor UID Unique ID of the spa Disabled by default 3
sensor Error Eventual error code and explanation
sensor Error description Eventual action to take to solve the error
sensor Error code Eventual uppercase error code Disabled by default 3

Dashboard example

Screenshot

Installation

Installation is done using HACS:

  1. Go to your Home Assistant instance
  2. Go to "HACS" tab -> "Integrations" -> Click "+"
  3. Search for "Intex Spa" -> Select it -> Click "Download with HACS"

Configuration

Configuration is done via Home Assistant interface.

  1. Go to your Home Assistant instance
  2. Go to "Settings" -> "Devices & Services" -> Click "+"
  3. Search for "Intex Spa" -> Select it
  4. Fill in the local IP or FQDN of your spa

Dashboard

This integration does not provide additional dashboard cards... Dashboard creation is up to you !

Contributions

Contributions are welcome :

  • If you face an issue
  • If you want to translate the integration to your language
  • If you want to contribute in any way

...please read the Contribution guidelines.

Versioning

The versioning of this integration follows Semantic Versioning 2.0.0

Reminder: Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable.

Footnotes

  1. Use the official Intex App to pair your Spa with your wifi network, or try ESPTouch as suggested by @FreezyExp

  2. The spa unit does not return the actual heating status. As a workaround, this integration always pretends that the spa is heating when it is set to heat. This is required to indicate that the spa is not turned off, and is a common behavior to implement in this case. As a result, do not use the hvac_action to calculate energy consumption (e.g. with the integral sensor helper) as it will not be relevant.

  3. Some sensors are disabled by default because they are not needed by most of the users. There is no risk or side effect in enabling them if necessary. 2 3 4