Skip to content

aqualinkd/AqualinkD

Repository files navigation

Aqualinkd

Linux daemon to control Aqualink RS pool controllers. Provides web UI, MQTT client & HTTP API endpoints. Control your pool equipment from any phone/tablet or computer. Is also compatible with most Home control systems including Apple HomeKit, Home Assistant, Samsung, Alexa, Google, etc.


Binaries are supplied for Raspberry Pi both 32 & 64 bit OS, Has been, and can be compiled for many different SBC's, and a Docker is also available.

It does not, and will never provide any layer of security. NEVER directly expose the device running this software to the outside world; only indirectly through the use of Home Automation hub's or other security measures. e.g. VPNs.


Donation

If you like this project, you can buy me a cup of coffee :)
Donate


AqualinkD new home

AqualinkD has grown over the years and now has multiple repositories for software / hardware. We are brining them all together under one organization. AqualinkD home page (under construction) -or- AqualinkD organization.
AqualinkD will always be open source and so will every associated repository. Nothing will change from that perspective. You will always be able to run this on cheap off the shelf hardware.


Legal and Safety Disclaimer

Please read


AqualinkD discussions


Please see Wiki for installation instructions

https://github.com/aqualinkd/AqualinkD/wiki

Release Notes & Changelog

For detailed release notes and version history, see RELEASE.md


AqualinkD built in WEB Interface(s).

Default web interfaceSimple web interface
Both Interfaces
  • If loading the web page in a mobile device browser, you will need to save to desktop where an app will be created for you.
  • The order and options shown are configurable for your individual needs and/or preferences.
Default Interfaces
  • The layout and functionality are from the Apple HomeKit interface. This works in any browser or on any mobile device.
  • Customizable tile icons & background images. (Tiles not used can be hidden).
  • Thermostat, Switch, SWG & Light tiles have more options (ie: setting heater temperature, timers, salt generating percentage and light mode etc). These options are accessible by pressing and holding the tile icon.
  • Supports live background images (ie: poll camera for still image every X seconds).
In web browser/tablet

Simulators

Designed to mimic AqualinkRS devices, used to fully configure the master control panel

In Apple Home app.

  • (NOTE: Salt Water Generator is configured as a Thermostat. It is the closest homekit accessory type; so °=% and Cooling=Generating).
  • Full support for homekit scenes: ie: Create a "Spa scene" to: "turn spa on, set spa heater to X temperature and turn spa blower on", etc etc).

In Home Assistant

All Web interfaces.

ToDo (future release)

  • Create iAqualink Touch Simulator
  • AqualinkD to self configure. (Done for ID's, need to do for Panel type/size)
  • Support for (non Jandy) external ORP and Ph sensors

Call for Help.

  • The only Jandy devices I have not decoded yet are LX heater & Chemical Feeder. If you have either of these devices and are willing to post some logs, please let me know, or post in the Discussions area



Notice

AqualinkD will soon be dropping support for OS's older than debian bullseye. (GLIBC 2.31 will be minimum).

AqualinkD will be moving over to github hosted runners for compiling, currently AqualinkD is using self hosted. This means supporting old OS releases like Stretch is not worth it. AqualinkD will still be tested and support local compiling on old OS's, just the binaries in the release packages will be for bullseye and newer




Updates in 3.0.3 (dev)

  • Fixed setting SWG for PDA v1.2
  • Fixed bug with slider run times in web UI
  • Fixed bug with heater max min in web UI
  • Added light_programming_iaqualink_delay to delay aqualink protocol while light is being programmed, some users have encountered panel slowing down while light is being programmed.

Updates in 3.0.2

  • Fixed bug with SWG being enabled if one is not present.
  • Fixed bug with light_programs ending in 'show' aqualinkd.conf

Updates in 3.0.1

  • UI Update for web config.
  • UI Now support for themes. (auto, dark, light -or- custom)
  • Fixed UI not updating for sensors.
  • Updates to UOM's for HA. gal/min, W, rpm
  • Fix issue with multiple bad sensors in config.

Updates in 3.0.0

  • NOTE:- When upgradeing to v3.0.0 if you see bank AqualinkD screen (ie no buttons), please clear browser cache. This also goes for the mobile/webapp (you may need to delete and re-add to mobile home screen)
  • Serial optimization for AqualinkD HAT.
  • Can now edit webconfig in aqmanager, added many UI customization options.
    • Click for details
    • web/config.js is now web/config.json any custom settings will need to be migrated.
    • Added example plugin of how to get HomeAssistant devices to show up in AqualinkD UI. Click for details
  • upgraded network library ( HTTP(S), MQTT(S), WS )
  • Added support for HTTPS and MQTTS.
    • HTTPS is for two way auth only, ie You create your own cert and load on both AqualinkD server and all client devices.
    • Example script to generate HTTPS certificates is in (./extras/generate-certs.sh)
  • Optimized updates to MQTT, web sockets & WebUI (only update when absolutely necessary)
  • Added option to select version to install, including dev releases.
  • MQTT Discovery for all supporting hubs (HomeAssistant Domoticz Hubitat OpenHAB etc)
  • Moved Domoticz support over to MQTT autodiscovery.
  • Change tile color & label for ph / orp & ppm tiles when values are out of optimal range.
  • Add mV as the UOM for ORP tile.
  • Fixed bug with sensor UOM.
  • UI code cleanup.
  • Included program advance to AqualinkD programmable light mode. (lot quicker for lights that remember state)
  • Changed caching of HTTP server. (Better for UI config updates)
  • Autoconfigure will now get panel size/type for panels that support PC-Dock interface.
  • Autoconfigure will try to work for PDA panels.
  • PDA Color light fixes.
  • PDA Dimmer lights now supported.
  • Cleaned up exit & errors when running as daemon and docker.
  • Fixed issues with external sensors and homekit.
  • Added preliminary support for Jandy Infinite water color lights.
  • Renamed serial_logger to rs485mon (more compliant with unix naming standards)

More Release Notes & Changelog

For detailed release notes and version history, see RELEASE.md

Please see Wiki for install instructions

https://github.com/aqualinkd/AqualinkD/wiki

Aqualink Versions tested

This was designed for Jandy Aqualink RS, so does work with AqualinkRS and iAqualink Combo control panels. It will work with Aqualink PDA/AquaPalm; but with limitations.

AqualinkD is known to work with Panel Versions from Rev H to the Latest Rev Yg

License

Non Commercial Project

All non commercial projects can be run using our open source code under GPLv2 licensing. As long as your project remains in this category there is no charge. See License.md for more details.

Legal and Safety Disclaimer

see Safty & Legal

Donation

If you still like this project, please consider buying me a cup of coffee :)
Donate