@ifabriziog87/homebridge-bestway-smartspa

Plugin Homebridge per Bestway / Lay-Z-Spa 2025+ con backend AWS IoT / SmartSpa.

Il plugin nasce per i modelli V2 / UltraFit del 2025 in poi, quelli che nell'integrazione ha-bestway usano:

• app Lay-Z-Spa
• QR code RW_Share_...
• endpoint smarthub-*.bestwaycorp.*
• websocket AWS IoT regionale

Stato attuale

Questa prima versione espone:

• un termostato HomeKit per temperatura corrente, target e heating
• switch separati per power, filter, bubbles e lock
• switch Hydrojets per i modelli HydroJet
• polling periodico
• websocket realtime per gli update di stato

Configurazione

Esempio config.json:

{
  "platforms": [
    {
      "platform": "BestwaySmartSpaPlatform",
      "name": "Bestway SmartSpa",
      "region": "EU",
      "location": "GB",
      "qrCode": "RW_Share_XXXXXXXXXXXX",
      "pollIntervalSeconds": 30
    }
  ]
}

Note:

• region seleziona l'endpoint cloud: EU, US, CN.
• location va lasciato coerente con il paese/account dell'app, per esempio GB, IT, US.
• visitorId e token vengono persistiti automaticamente nello storage di Homebridge.
• al primo avvio, se qrCode è presente, il plugin prova a fare il bind della spa all'account visitor.

Installazione

Finché il pacchetto non viene pubblicato su npm, installazione locale:

cd /path/to/homebridge-bestway-smartspa
npm install
npm link
homebridge -D

Oppure copia la cartella sotto la macchina Homebridge e installa con:

npm install /percorso/del/plugin

Limiti noti

• non ho potuto eseguire test locali in questo workspace perché qui non sono installati node e npm
• il flusso QR / region va validato con la tua spa reale
• la UI HomeKit non ha un accessorio “spa”, quindi alcune funzioni sono mappate su switch

Riferimento tecnico

La logica AWS IoT è stata portata a partire da cdpuk/ha-bestway, in particolare dal ramo V2 / UltraFit:

• autenticazione visitor
• bind via QR code
• shadow fetch
• comandi cifrati AES-256-CBC
• websocket regionale