- Bump geckolib to fix DIV/0
- Made platform load/unload more tolerant of runtime faults
- Support basic inMix RGB zones. Need feedback on this. No lighting modes or synchro support yet.
- Prevent various entities (such as reminder dates) from being included in scenes as this would make reminders a bit pointless. This was belt and braces really since the date platform doesn't support scene restore, but in doing this, there were other entities that were being used that would have potentially caused problems.
- Support changing date for reminders. A simple button to reset was originally considered, but ended up being a date object that can be set which gives much better flexibility. You can write your own buttons now.
- Update bug template to link to gecko-home-assistant issues rather than the blueprint
- Rework pumps to use new clean library versions, now supports one, two and variable speed pumps
- Expose water heater as a native water heater entity in addition to the climate one
- Expose water care mode as a select in addition to the climate preset modes
- Support light L120 as well as existing internal light
- Add buttons for all keypad operations
- Add support for changing keypad backlight colour
- Blower is now a fan, not a switch
- Pump modes are no longer "HIGH", "LOW", "OFF", they are "HI", "LO", "OFF" or "ON"
- Implement climate action async_set_hvac_mode so that the integration can be used in scenes
- Add supoort for lock mode if it exists
- Add support for standby mode
- Add "Heating" binary sensor
- Using better async patterns which should alleviate some CPU usage issues and connection problems.
- Much faster integration setup, removed wait for full connection from the init loop.
- Status sensor available immediately so initialization progress can be tracked.
- Reconnect button available after full connection, or connection failure allowing retry without having to restart HA.
- Added "Spa In Use" sensor that is ON if any pumps, blowers or lights are on.
- Added support for external heat sources
- This is a big change, so I'm releasing it now while I'm still available to fix issues quickly
- During the tidy and delint phase, constants were imported from HA 2025 locations, so this is now a minimum requirement. hacs.json updated accordingly.
- Get validation & lint workflows running
- Expose temperature sensors for current temperature, set point temperature and real setpoint temperature which takes economy mode into consideration. These allow various automations to be written that otherwise would have to dig into the attributes of the climate control object
- Added 'Snapshot' button to dump data that might be useful in getting new spa features implemented
- Bump the version number!
- Removed warnings about light color modes
- Added French string table, thanks @claudegel
- Fixed ConfigType, thanks @grahamcraqer
- Use geckolib 0.4.16, it fixes some other HA warnings and issues
- Use Fan modes correctly, thanks @sicarriere
- Update docker container to use latest version from blueprint ... phew, that was 2 years of updates
Component to integrate with Gecko Spas.
This component will set up the following platforms.
| Platform | Description |
|---|---|
button |
Reconnect & snapshot buttons. |
binary_sensor |
Various on/off spa sensors. |
sensor |
Text/Enum spa sensors. |
switch |
Waterfalls |
fan |
Spa pumps, fans. |
light |
Spa lights |
climate |
Spa water heater |
select |
External heating support |
water_heater |
An alternative way to set spa water temperature |
date |
Reminder reset support |
The preferred method to install is to use HACS.
If you don't have/want HACS installed, you will need to manually install the integration
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledgecko. - Download all the files from the
custom_components/gecko/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Gecko"
The snapshot function allows you to generate a datablock that can be used during development and testing to support new SPA features. To use, please open an issue on Github outlining what your requirements are.
Then, switch to the integration device page where you should find a "Snapshot" button in the "Diagnostics" panel.
- Place your spa into default state, i.e. powered up, but idle.
- Press the "Snapshot" button
- Activate whatever feature you are trying to provide functionality for.
- Press the "Snapshot" button again.
Repeat steps 3 & 4 for as many times as necessary to capture all the states that your spa goes through during you exercising the feature.
You should find this data in your log file but, for convenience, it's also in the persistent notification
panel on lovelace. Select the snapshot notification, expand the data block behind the "Click to expand"
label, and copy the data block (which begins {'Integration Version ...'}).
Add this data as a reply to your issue on Github. One snapshot per reply please otherwise it might get too busy. Annotate the reply with a statement of what your spa was doing at the snapshot time, e.g. "Idle" or "After turning RGB light to Red".