From cdbb0f6ac506fdb8b1105e266dbd613a63377fa0 Mon Sep 17 00:00:00 2001 From: Donavan Fritz Date: Sat, 14 Nov 2026 21:54:47 -0600 Subject: [PATCH] Document the cloud fallback, reconfigure step, and availability rules Co-Authored-By: Claude Fable 5.2 --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/README.md b/README.md index 48d3113..a94933b 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,33 @@ local HTTP endpoint instead of subscribed over the cloud broker, keeping monitoring on-LAN and off the vendor cloud. Control still uses the cloud MQTT connection. Leave it blank to use cloud MQTT for reads. +The module has no DNS name and takes its address from DHCP. While the URL does +not answer, telemetry is read from the cloud instead, and the local poll takes +over again when it answers. To change the URL without signing in again, use +**Reconfigure** on the integration entry. + +A Connected Spa kit can have two modules on the LAN that both serve `/status`. +Only the one linked to the control box returns the spa's state; the other +returns the blank document described below. Use the one with temperatures in it. + +## Health and availability + +Every entity is **unavailable** unless telemetry arrived in the last five +minutes and carries control-box data. A module that is online but cut off from +the control box keeps serving, and publishing to the cloud, a full document of +blank and default values: empty `setWaterTemperature`, +`currentWaterTemperature` and `ControlBoxFirmwareVersion`, salt level 0, +lights and jets off. Commands sent in that state change nothing. Power-cycling +the module that is linked to the control box has recovered it; the entities +come back on their own once real data arrives. + +The broker is the only control path and its credentials rotate. If the broker +connection stays down for three minutes the integration reloads itself, which +signs in again and fetches current credentials. + +To be told when the spa stops reporting, trigger an automation on an entity +(for example the climate entity) being `unavailable` for a few minutes. + ## License MIT — see [LICENSE](LICENSE).