homebridge-plugin-klares4 1.1.7 → 2.0.0-beta.1

package/CHANGELOG.md

@@ -7,6 +7,107 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.0.0-beta.1] - 2026-03-07
+
+### Changed
+
+- Release version bump for npm publication continuity after `2.0.0-beta.0` version lock.
+
+## [2.0.0-beta.0] - 2026-03-07
+
+### Added
+
+- **Modular architecture rollout** with facade compatibility preserved:
+  - `platform/` split with dedicated lifecycle/discovery/registry/config services
+  - `websocket-client/` split with transport/router/dispatcher/projector internals
+  - `mqtt-bridge/` split with command execution and accessory indexing services
+  - `debug-capture/` split with capture/analysis/file generation modules
+- **Governance quality gates**:
+  - `npm run check:max-lines` enforcing `src/**/*.ts <= 300` lines
+  - `npm run verify` for strict TypeScript + tests + build
+  - CI workflow for automated gate execution on push/PR
+- **Release scripts**:
+  - `npm run release:dry-run`
+  - `npm run release:beta`
+
+### Changed
+
+- Internal architecture now follows explicit layered hierarchy:
+  - `Communication -> Domain -> Infrastructure`
+- `ARCHITECTURE.md` updated to document module responsibilities and flows.
+
+### Compatibility
+
+- No breaking changes to Homebridge runtime contract:
+  - `PLATFORM_NAME` / `PLUGIN_NAME` unchanged
+  - accessory UUID generation unchanged
+  - config schema keys unchanged
+  - MQTT topic/payload contract unchanged
+  - public facades (`Lares4Platform`, `KseniaWebSocketClient`, `MqttBridge`, `DebugCaptureManager`) preserved
+
+## [1.1.9-beta0] - 2026-03-07
+
+### Added
+
+- **Command response timeout control**: Added `commandTimeoutMs` configuration to tune write command ACK timeout.
+- **Refactoring architecture modules** (internal, non-breaking):
+  - `device-id` helpers for canonical ID parsing/building
+  - `thermostat-mode` mapping helpers
+  - `thermostat-state` compatibility adapter (status as canonical)
+  - WebSocket internal components (`command-dispatcher`, `protocol-router`, `device-state-projector`, `ws-transport`)
+  - MQTT internal helpers (`topic-parser`, `state-payload-mapper`)
+  - Platform internal services (`accessory-registry`, `discovery-service`, `platform-lifecycle-service`)
+- **Architecture documentation**: Added `ARCHITECTURE.md`.
+- **Extended automated test suite**: Added characterization/contract tests for lifecycle helpers, WS command flow components, topic/payload contracts, thermostat mappings and ID utilities (`node --test`).
+
+### Fixed
+
+- **Thermostat discovery gap**: Outputs recognized as thermostats are now discovered and exposed correctly.
+- **Login false-positive**: WebSocket `connect()` now resolves only after `LOGIN_RES=OK` with explicit login timeout.
+- **Accessory cache drift**: Added stale accessory pruning after initial sync to remove ghost accessories.
+- **Race conditions on commands**: Added per-device command queueing and command ACK waiting to avoid concurrent command overlap.
+- **Runtime value validation**: Added numeric parsing/clamping guards before HomeKit characteristic updates to avoid `NaN`/out-of-range propagation.
+- **Gate handling consistency**: Added `gate_` normalization in IDs and room mapping validation.
+- **Shutdown cleanup**: Improved disconnect flow for WebSocket and MQTT bridge on Homebridge shutdown.
+- **Debug capture safety**: Masked sensitive parsed payload data and restored WebSocket hooks reliably after capture.
+
+### Security
+
+- **TLS verification policy**: Certificate verification is strict by default; insecure TLS requires explicit `allowInsecureTls=true`.
+
+## [1.1.8] - 2026-03-07
+
+### Fixed
+
+- **WebSocket session leak (firmware crash)**: Replaced `ws.terminate()` with graceful `ws.close(1001, 'Heartbeat timeout')` in `forceReconnect()`. The firmware now receives the WebSocket CLOSE frame and can properly release the session. Previously, abrupt TCP disconnects left "ghost" sessions accumulating on the firmware over weeks, eventually causing firmware lockup requiring full reset.
+- **Double reconnect scheduling**: Added `isManualClose` flag to prevent the `close` event handler from calling `scheduleReconnect()` when the disconnect was intentional (from `forceReconnect()` or `disconnect()`). This fixes the broken exponential backoff caused by double-scheduling.
+- **PIN exposed in logs**: Applied `maskSensitiveData()` to `sendMessage()` log output. The PIN was previously logged in plain text during the login message.
+- **Cover movement simulation race condition**: `updateStatus()` no longer overwrites `currentPosition`/`targetPosition` while a local movement simulation interval is active. This prevents conflicting updates between the local simulation and real-time firmware messages.
+- **Cover simulation not stopped on firmware stop**: The movement simulation interval is now cancelled when the firmware signals `state: 'stopped'` (e.g., user stops cover physically via Ksenia app).
+- **Cover NaN stepTime in setInterval**: Added guard to detect `distance === 0` or invalid `stepTime` before starting the simulation interval, preventing `setInterval(fn, NaN)` which fires immediately and continuously.
+
+### Changed
+
+- Removed all emoji characters from log messages, documentation, and UI schema
+- Version bumped from 1.1.7-beta2 to 1.1.8 (stable release)
+
+## [1.1.7-beta2] - 2026-01-17
+
+### Added
+
+- **System Temperature Sensors**: New automatic sensors for system temperatures
+  - Internal temperature sensor (`Temperatura Interna`) from central unit
+  - External temperature sensor (`Temperatura Esterna`) from external probe (if available)
+  - Sensors are created dynamically only when temperature data is available (not "NA")
+  - Real-time updates via STATUS_SYSTEM messages
+  - Follows the same pattern as BUS_HA sensors for consistency
+  - Can be assigned to different rooms and used in HomeKit automations
+
+### Improved
+
+- Enhanced temperature handling with proper NA (not available) detection
+- Type-safe implementation with updated interfaces for STATUS_SYSTEM data structure
+
 ## [1.1.7] - 2026-01-14
 
 ### Added
@@ -76,7 +177,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added `forceReconnect()` method for clean reconnection on timeout
 - Added `moveInterval` property to `CoverAccessory` for proper cleanup
 
-
 ## [1.1.5] - 2025-12-28
 
 ### Added

package/README.md

@@ -17,15 +17,18 @@ Complete plugin for Ksenia Lares4 systems integrating security zones, lights, co
 - **Smart Covers**: Percentage control with configurable timing
 - **Thermostats**: Temperature and heating/cooling mode control
 - **Environmental Sensors**: Real-time temperature, humidity, and light levels
+- **System Temperature Sensors**: Internal and external temperature from central unit
 - **Real-time Updates**: WebSocket connection with automatic reconnection
+- **Command ACK & Timeout**: Write commands wait for API response with configurable timeout
 - **UI Configuration**: Complete graphical interface in Homebridge UI
 - **Customization**: Custom names and selective entity exclusion
 - **MQTT Bridge**: State publishing and command reception via MQTT (optional)
+- **Documented Internal Architecture**: See `ARCHITECTURE.md` for module responsibilities and flows
 
 ### Prerequisites
 
 - Homebridge >= 1.6.0
-- Node.js >= 14.18.1
+- Node.js >= 20.0.0
 - Ksenia Lares4 system with WebSocket access enabled
 
 ### Installation
@@ -102,6 +105,8 @@ The plugin can be fully configured via the Homebridge UI graphical interface. Re
 | `maxSeconds`        | number   | 30           | Max cover travel time (seconds) |
 | `reconnectInterval` | number   | 5000         | Reconnection interval (ms)      |
 | `heartbeatInterval` | number   | 30000        | Heartbeat interval (ms)         |
+| `commandTimeoutMs`  | number   | 8000         | API command response timeout (ms) |
+| `allowInsecureTls`  | boolean  | false        | Disable TLS certificate validation (trusted LAN only) |
 | `debug`             | boolean  | false        | Detailed logging                |
 | `excludeZones`      | string[] | []           | Zones to exclude                |
 | `excludeOutputs`    | string[] | []           | Outputs to exclude              |
@@ -132,7 +137,7 @@ The plugin can be fully configured via the Homebridge UI graphical interface. Re
 #### Thermostats
 
 - **HomeKit Type**: Thermostat
-- **Modes**: Off/Heat/Cool
+- **Modes**: Off/Heat/Cool/Auto
 - **Control**: Target temperature
 - **Sensors**: Current temperature
 
@@ -169,46 +174,48 @@ Enable the MQTT bridge in the "MQTT Bridge" configuration section:
 
 Accessory states are published to the following topics:
 
-- **Lights**: `homebridge/klares4/light/{id}/state`
-- **Covers**: `homebridge/klares4/cover/{id}/state`
-- **Thermostats**: `homebridge/klares4/thermostat/{id}/state`
-- **Sensors**: `homebridge/klares4/sensor/{id}/state`
-- **Zones**: `homebridge/klares4/zone/{id}/state`
-- **Scenarios**: `homebridge/klares4/scenario/{id}/state`
+- **Lights**: `homebridge/klares4/light/{slug}/state`
+- **Covers**: `homebridge/klares4/cover/{slug}/state`
+- **Thermostats**: `homebridge/klares4/thermostat/{slug}/state`
+- **Sensors**: `homebridge/klares4/sensor/{slug}/state`
+- **Zones**: `homebridge/klares4/zone/{slug}/state`
+- **Scenarios**: `homebridge/klares4/scenario/{slug}/state`
 
 #### Command Reception
 
 Send commands to accessories on the following topics:
 
-- **Lights**: `homebridge/klares4/light/{id}/set`
-- **Covers**: `homebridge/klares4/cover/{id}/set`
-- **Thermostats**: `homebridge/klares4/thermostat/{id}/set`
-- **Scenarios**: `homebridge/klares4/scenario/{id}/set`
+- **Lights**: `homebridge/klares4/light/{device_id_or_slug}/set`
+- **Covers**: `homebridge/klares4/cover/{device_id_or_slug}/set`
+- **Thermostats**: `homebridge/klares4/thermostat/{device_id_or_slug}/set`
+- **Scenarios**: `homebridge/klares4/scenario/{device_id_or_slug}/set`
+
+Examples of canonical device IDs: `light_1`, `cover_2`, `thermostat_3`, `scenario_4`.
 
 #### Usage Examples
 
 ##### Turn on a light:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/light/1/set" -m '{"on": true, "brightness": 80}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/light/light_1/set" -m '{"on": true, "brightness": 80}'
 ```
 
 ##### Move a cover:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/cover/2/set" -m '{"position": 50}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/cover/cover_2/set" -m '{"position": 50}'
 ```
 
 ##### Set thermostat temperature:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/thermostat/3/set" -m '{"targetTemperature": 22, "mode": "heat"}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/thermostat/thermostat_3/set" -m '{"targetTemperature": 22, "mode": "heat"}'
 ```
 
 ##### Trigger a scenario:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/scenario/4/set" -m '{"active": true}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/scenario/scenario_4/set" -m '{"active": true}'
 ```
 
 ### Troubleshooting
@@ -232,6 +239,57 @@ Enable debug logging for detailed diagnostics:
 }
 ```
 
+### Development Quality Gates
+
+For local validation before publishing:
+
+```bash
+npm run verify
+```
+
+This runs:
+
+- max file size gate (`src/**/*.ts` <= 300 lines),
+- strict TypeScript checks (`--noUnusedLocals --noUnusedParameters`),
+- full test suite,
+- build compatibility gate.
+
+### Roadmap
+
+#### Planned for v1.2.0
+
+The following entity types are currently not supported but are planned for the next beta release:
+
+##### Irrigation Systems (IRR)
+
+- **Type**: Switch (bistable)
+- **Examples**: Drip irrigation, garden zones, lawn sprinklers
+- **HomeKit Mapping**: Valve/Switch accessories
+- **Status**: Planned
+
+##### Indicators & Status LEDs (GEN, MOD:S)
+
+- **Type**: Read-only sensors/switches
+- **Examples**: Zone status indicators, system LEDs
+- **HomeKit Mapping**: Contact Sensor (read-only)
+- **Status**: Planned
+
+##### Sirens & Alarms (GEN, MOD:AT)
+
+- **Type**: Switch (manual control)
+- **Examples**: External siren, internal siren
+- **HomeKit Mapping**: Switch with security considerations
+- **Status**: Under evaluation
+
+##### Alarm Bridges (GEN, MOD:A)
+
+- **Type**: Read-only sensors
+- **Examples**: State bridges, alarm bridges
+- **HomeKit Mapping**: Contact Sensor (read-only)
+- **Status**: Planned
+
+**Note**: These features will be implemented based on user feedback and testing. If you have one of these devices and would like to help with testing, please open an issue on GitHub.
+
 ### License
 
 This project is released under the MIT license.
@@ -240,7 +298,7 @@ This project is released under the MIT license.
 
 - [Homebridge](https://homebridge.io/)
 - [Homebridge UI](https://github.com/homebridge/homebridge-config-ui-x)
-- [Ksenia Security](https://www.ksenia.it/)
+- [Ksenia Security](https://www.kseniasecurity.com/)
 
 ---
 
@@ -253,6 +311,7 @@ This project is released under the MIT license.
 - **Tapparelle Intelligenti**: Controllo percentuale con timing configurabile
 - **Termostati**: Controllo temperatura e modalita riscaldamento/raffreddamento
 - **Sensori Ambientali**: Temperatura, umidita e luminosita in tempo reale
+- **Sensori Temperatura Sistema**: Temperatura interna ed esterna dalla centrale
 - **Aggiornamenti Real-time**: Connessione WebSocket con riconnessione automatica
 - **Configurazione UI**: Interfaccia grafica completa in Homebridge UI
 - **Personalizzazione**: Nomi personalizzati ed esclusione selettiva di entita
@@ -261,7 +320,7 @@ This project is released under the MIT license.
 ### Prerequisiti
 
 - Homebridge >= 1.6.0
-- Node.js >= 14.18.1
+- Node.js >= 20.0.0
 - Sistema Ksenia Lares4 con accesso WebSocket abilitato
 
 ### Installazione
@@ -368,7 +427,7 @@ Il plugin puo essere configurato completamente tramite l'interfaccia grafica di
 #### Termostati
 
 - **Tipo HomeKit**: Thermostat
-- **Modalita**: Off/Heat/Cool
+- **Modalita**: Off/Heat/Cool/Auto
 - **Controllo**: Temperatura target
 - **Sensori**: Temperatura corrente
 
@@ -405,46 +464,48 @@ Abilita il bridge MQTT nella sezione "MQTT Bridge" della configurazione:
 
 Gli stati degli accessori vengono pubblicati sui seguenti topic:
 
-- **Luci**: `homebridge/klares4/light/{id}/state`
-- **Tapparelle**: `homebridge/klares4/cover/{id}/state`
-- **Termostati**: `homebridge/klares4/thermostat/{id}/state`
-- **Sensori**: `homebridge/klares4/sensor/{id}/state`
-- **Zone**: `homebridge/klares4/zone/{id}/state`
-- **Scenari**: `homebridge/klares4/scenario/{id}/state`
+- **Luci**: `homebridge/klares4/light/{slug}/state`
+- **Tapparelle**: `homebridge/klares4/cover/{slug}/state`
+- **Termostati**: `homebridge/klares4/thermostat/{slug}/state`
+- **Sensori**: `homebridge/klares4/sensor/{slug}/state`
+- **Zone**: `homebridge/klares4/zone/{slug}/state`
+- **Scenari**: `homebridge/klares4/scenario/{slug}/state`
 
 #### Ricezione Comandi
 
 Invia comandi agli accessori sui seguenti topic:
 
-- **Luci**: `homebridge/klares4/light/{id}/set`
-- **Tapparelle**: `homebridge/klares4/cover/{id}/set`
-- **Termostati**: `homebridge/klares4/thermostat/{id}/set`
-- **Scenari**: `homebridge/klares4/scenario/{id}/set`
+- **Luci**: `homebridge/klares4/light/{device_id_or_slug}/set`
+- **Tapparelle**: `homebridge/klares4/cover/{device_id_or_slug}/set`
+- **Termostati**: `homebridge/klares4/thermostat/{device_id_or_slug}/set`
+- **Scenari**: `homebridge/klares4/scenario/{device_id_or_slug}/set`
+
+Esempi di ID canonici: `light_1`, `cover_2`, `thermostat_3`, `scenario_4`.
 
 #### Esempi di Utilizzo
 
 ##### Accendere una luce:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/light/1/set" -m '{"on": true, "brightness": 80}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/light/light_1/set" -m '{"on": true, "brightness": 80}'
 ```
 
 ##### Muovere una tapparella:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/cover/2/set" -m '{"position": 50}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/cover/cover_2/set" -m '{"position": 50}'
 ```
 
 ##### Impostare temperatura termostato:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/thermostat/3/set" -m '{"targetTemperature": 22, "mode": "heat"}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/thermostat/thermostat_3/set" -m '{"targetTemperature": 22, "mode": "heat"}'
 ```
 
 ##### Attivare uno scenario:
 
 ```bash
-mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/scenario/4/set" -m '{"active": true}'
+mosquitto_pub -h 192.168.1.100 -t "homebridge/klares4/scenario/scenario_4/set" -m '{"active": true}'
 ```
 
 ### Risoluzione Problemi
@@ -482,11 +543,47 @@ I contributi sono benvenuti! Per contribuire:
 
 Questo progetto e rilasciato sotto licenza MIT.
 
+### Roadmap
+
+#### Pianificato per v1.2.0
+
+I seguenti tipi di entità non sono attualmente supportati ma sono pianificati per la prossima release beta:
+
+##### Sistemi di Irrigazione (IRR)
+
+- **Tipo**: Switch (bistabile)
+- **Esempi**: Irrigazione a goccia, zone giardino, irrigatori
+- **Mappatura HomeKit**: Accessori Valve/Switch
+- **Stato**: Pianificato
+
+##### Indicatori e LED di Stato (GEN, MOD:S)
+
+- **Tipo**: Sensori/switch in sola lettura
+- **Esempi**: Spie stato zone, LED di sistema
+- **Mappatura HomeKit**: Sensore di contatto (sola lettura)
+- **Stato**: Pianificato
+
+##### Sirene e Allarmi (GEN, MOD:AT)
+
+- **Tipo**: Switch (controllo manuale)
+- **Esempi**: Sirena esterna, sirena interna
+- **Mappatura HomeKit**: Switch con considerazioni di sicurezza
+- **Stato**: In valutazione
+
+##### Ponti Allarme (GEN, MOD:A)
+
+- **Tipo**: Sensori in sola lettura
+- **Esempi**: Ponti di stato, ponti allarme
+- **Mappatura HomeKit**: Sensore di contatto (sola lettura)
+- **Stato**: Pianificato
+
+**Nota**: Queste funzionalità verranno implementate in base al feedback degli utenti e ai test. Se hai uno di questi dispositivi e desideri aiutare con i test, apri una issue su GitHub.
+
 ### Link Utili
 
 - [Homebridge](https://homebridge.io/)
 - [Homebridge UI](https://github.com/homebridge/homebridge-config-ui-x)
-- [Ksenia Security](https://www.ksenia.it/)
+- [Ksenia Security](https://www.kseniasecurity.com/)
 
 ---
 

package/config.schema.json

@@ -4,7 +4,7 @@
     "singular": true,
     "customUi": false,
     "headerDisplay": "<div class='text-center mb-3'><h3>klares4 - Ksenia Lares4 per Homebridge</h3><p class='text-muted'>Integrazione professionale per sistemi di sicurezza Ksenia Lares 4.0</p></div><div class='alert alert-info'><strong>Prima di iniziare, verifica che:</strong><ul class='mb-0 mt-2'><li>La centrale Lares4 sia raggiungibile in rete locale</li><li>L'accesso WebSocket sia abilitato sulla centrale</li><li>Tu disponga di un PIN utente</li></ul></div>",
-    "footerDisplay": "<div class='text-center mt-4 pt-3 border-top'><p class='text-muted mb-2'>Versione 1.1.6 • Sviluppato da Paolo Trivisonno</p><a href='https://github.com/paolo-trivi/homebridge-plugin-klares4' target='_blank' class='btn btn-sm btn-outline-primary mr-2'>Documentazione</a> <a href='https://github.com/paolo-trivi/homebridge-plugin-klares4/issues' target='_blank' class='btn btn-sm btn-outline-secondary mr-2'>Segnala Bug</a> <a href='https://github.com/sponsors/paolo-trivi' target='_blank' class='btn btn-sm btn-outline-success'>Supporta</a></div>",
+    "footerDisplay": "<div class='text-center mt-4 pt-3 border-top'><p class='text-muted mb-2'>Versione 1.1.9-beta0 • Sviluppato da Paolo Trivisonno</p><a href='https://github.com/paolo-trivi/homebridge-plugin-klares4' target='_blank' class='btn btn-sm btn-outline-primary mr-2'>Documentazione</a> <a href='https://github.com/paolo-trivi/homebridge-plugin-klares4/issues' target='_blank' class='btn btn-sm btn-outline-secondary mr-2'>Segnala Bug</a> <a href='https://github.com/sponsors/paolo-trivi' target='_blank' class='btn btn-sm btn-outline-success'>Supporta</a></div>",
     "schema": {
         "type": "object",
         "properties": {
@@ -38,6 +38,12 @@
                 "default": true,
                 "description": "Usa connessione crittografata - raccomandata per la sicurezza"
             },
+            "allowInsecureTls": {
+                "title": "Consenti TLS Insicuro",
+                "type": "boolean",
+                "default": false,
+                "description": "Disabilita la verifica del certificato TLS (solo per certificati self-signed in rete locale fidata)"
+            },
             "sender": {
                 "title": "Identificativo Client",
                 "type": "string",
@@ -113,6 +119,14 @@
                 "maximum": 300000,
                 "description": "Millisecondi tra i ping di keep-alive per verificare la connessione"
             },
+            "commandTimeoutMs": {
+                "title": "Timeout Comandi API",
+                "type": "integer",
+                "default": 8000,
+                "minimum": 1000,
+                "maximum": 30000,
+                "description": "Timeout massimo (ms) per attendere la risposta ai comandi inviati alla centrale"
+            },
             "coverStepSize": {
                 "title": "Step Animazione Tapparelle",
                 "type": "integer",
@@ -337,7 +351,7 @@
                                             "deviceId": {
                                                 "title": "ID Dispositivo",
                                                 "type": "string",
-                                                "pattern": "^(light_|cover_|sensor_temp_|sensor_hum_|sensor_light_|zone_|thermostat_|scenario_)[0-9]+$"
+                                                "pattern": "^(light_|cover_|gate_|sensor_temp_|sensor_hum_|sensor_light_|zone_|thermostat_|scenario_)[0-9]+$"
                                             },
                                             "deviceName": {
                                                 "title": "Nome Dispositivo",
@@ -357,6 +371,12 @@
                         }
                     }
                 }
+            },
+            "generateDebugFile": {
+                "title": "Genera File Debug",
+                "type": "boolean",
+                "default": false,
+                "description": "Attiva per generare un file di diagnostica completo al prossimo riavvio (si disabilita automaticamente dopo la generazione)"
             }
         },
         "required": [
@@ -735,6 +755,16 @@
                                     "key": "heartbeatInterval",
                                     "flex": "1 1 200px",
                                     "description": "Frequenza ping keep-alive con timeout PONG (v1.1.6)"
+                                },
+                                {
+                                    "key": "commandTimeoutMs",
+                                    "flex": "1 1 200px",
+                                    "description": "Timeout risposta per comandi write/cmd_usr"
+                                },
+                                {
+                                    "key": "allowInsecureTls",
+                                    "flex": "1 1 220px",
+                                    "description": "Solo per impianti con certificato self-signed"
                                 }
                             ]
                         }
@@ -763,8 +793,33 @@
                             ]
                         }
                     ]
+                },
+                {
+                    "type": "section",
+                    "title": "Diagnostica & Debug",
+                    "expandable": true,
+                    "expanded": false,
+                    "items": [
+                        {
+                            "type": "help",
+                            "helpvalue": "<div class='alert alert-warning'><strong>Strumento di Diagnostica Completa</strong><p class='mb-2'>Genera un file di debug con TUTTO il necessario per diagnosticare problemi:</p><ul class='mb-2'><li><strong>Tutti i messaggi WebSocket RAW</strong> per 60 secondi</li><li><strong>Lista completa dispositivi</strong> dalla centrale Ksenia</li><li><strong>Tutti i comandi disponibili</strong> (ZONES, OUTPUTS, BUS_HAS, SCENARIOS, STATUS)</li><li><strong>Stati in tempo reale</strong> durante la cattura</li></ul><p class='mb-0 text-danger'><strong>IMPORTANTE:</strong> Durante i 60 secondi di cattura, <strong>prova tutte le entità che non funzionano usando l'app Ksenia</strong> (accendi/spegni luci, apri/chiudi tapparelle, cambia zone, ecc). Questo ci permetterà di vedere esattamente come la centrale risponde ai comandi.</p></div>"
+                        },
+                        {
+                            "key": "generateDebugFile",
+                            "title": "Genera File Debug al Prossimo Avvio",
+                            "description": "Si disattiverà automaticamente dopo la generazione del file"
+                        },
+                        {
+                            "type": "help",
+                            "helpvalue": "<div class='alert alert-info'><strong>Procedura consigliata:</strong><ol class='mb-0'><li><strong>Attiva</strong> l'opzione sopra e <strong>salva</strong> la configurazione</li><li><strong>Riavvia Homebridge</strong> (il debug inizierà automaticamente)</li><li><strong>Nei prossimi 60 secondi</strong>: apri l'app Ksenia e <strong>testa TUTTE le entità che non funzionano</strong> (luci on/off, tapparelle su/giù, scenari, zone, ecc)</li><li><strong>Attendi</strong> che la cattura finisca (vedrai conferma nei log con il percorso del file)</li><li><strong>Trova il file</strong> usando il pulsante qui sotto o nei log</li><li><strong>Condividi</strong> il file per supporto (PIN già mascherati automaticamente)</li></ol></div>"
+                        },
+                        {
+                            "type": "help",
+                            "helpvalue": "<div class='alert alert-success'><strong>Percorso File Debug:</strong><p class='mb-2'>I file di debug vengono salvati in:</p><p class='mb-2'><code>~/.homebridge/klares4-debug-*.json</code></p><p class='mb-2'>oppure su macOS:</p><p class='mb-2'><code>/Users/[tuo-username]/.homebridge/klares4-debug-*.json</code></p><p class='mb-0'><strong>Suggerimento:</strong> Cerca il file più recente con nome <code>klares4-debug-</code> seguito dalla data/ora. Il percorso esatto viene mostrato nei log di Homebridge quando il file viene generato.</p></div>"
+                        }
+                    ]
                 }
             ]
         }
     ]
-}
+}

package/dist/accessories/cover-accessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cover-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/cover-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAW,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAEzD;;;GAGG;AACH,qBAAa,cAAc;IAUnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV9B,OAAO,CAAC,OAAO,CAAU;IAClB,MAAM,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAGjC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,iBAAiB;IAsDpC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC5D,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIjD,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIlD,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI7D,OAAO,CAAC,gBAAgB;IAoDjB,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CAmCpD"}
+{"version":3,"file":"cover-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/cover-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAW,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;GAGG;AACH,qBAAa,cAAc;IAUnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV9B,OAAO,CAAC,OAAO,CAAU;IAClB,MAAM,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAGjC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,iBAAiB;IAsDpC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC5D,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIjD,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIlD,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI7D,OAAO,CAAC,gBAAgB;IA2DjB,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;CA8CpD"}

package/dist/accessories/cover-accessory.js

@@ -89,6 +89,12 @@ class CoverAccessory {
         const stepSize = this.platform.config.coverStepSize ?? 5;
         const totalTime = (distance / 100) * (this.maxSeconds * 1000);
         const stepTime = totalTime / (distance / stepSize);
+        // Guard: nothing to simulate (position already reached during async moveCover, or invalid values)
+        if (distance === 0 || isNaN(stepTime) || stepTime <= 0) {
+            this.positionState = 2; // Stopped
+            this.service.updateCharacteristic(this.platform.Characteristic.PositionState, this.positionState);
+            return;
+        }
         let currentStep = 0;
         const totalSteps = Math.ceil(distance / stepSize);
         this.moveInterval = setInterval(() => {
@@ -110,11 +116,21 @@ class CoverAccessory {
     }
     updateStatus(newDevice) {
         this.device = newDevice;
-        if (this.device.status?.position !== this.currentPosition) {
-            this.currentPosition = this.device.status?.position ?? 0;
-            this.targetPosition = this.device.status?.position ?? 0;
-            this.service.updateCharacteristic(this.platform.Characteristic.CurrentPosition, this.currentPosition);
-            this.service.updateCharacteristic(this.platform.Characteristic.TargetPosition, this.targetPosition);
+        // If firmware signals the cover has stopped, cancel any running simulation
+        if (this.moveInterval && newDevice.status?.state === 'stopped') {
+            clearInterval(this.moveInterval);
+            this.moveInterval = undefined;
+            this.platform.log.debug(`${this.device.name}: Simulation cancelled by firmware stop`);
+        }
+        // Only update position/target from firmware when simulation is not active,
+        // to avoid the simulation and real firmware updates conflicting
+        if (!this.moveInterval) {
+            if (this.device.status?.position !== this.currentPosition) {
+                this.currentPosition = this.device.status?.position ?? 0;
+                this.targetPosition = this.device.status?.position ?? 0;
+                this.service.updateCharacteristic(this.platform.Characteristic.CurrentPosition, this.currentPosition);
+                this.service.updateCharacteristic(this.platform.Characteristic.TargetPosition, this.targetPosition);
+            }
         }
         switch (this.device.status?.state) {
             case 'opening':

package/dist/accessories/cover-accessory.js.map

@@ -1 +1 @@
-{"version":3,"file":"cover-accessory.js","sourceRoot":"","sources":["../../src/accessories/cover-accessory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cover-accessory.js","sourceRoot":"","sources":["../../src/accessories/cover-accessory.ts"],"names":[],"mappings":"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"}

package/dist/accessories/gate-accessory.d.ts

@@ -0,0 +1,20 @@
+import type { CharacteristicValue, PlatformAccessory } from 'homebridge';
+import type { Lares4Platform } from '../platform';
+import type { KseniaGate } from '../types';
+/**
+ * Gate Accessory Handler
+ * Handles HomeKit Switch service for Ksenia Lares4 monostable gates (GATE/M)
+ * Gates are exposed as momentary switches that trigger on press
+ */
+export declare class GateAccessory {
+    private readonly platform;
+    private readonly accessory;
+    private service;
+    device: KseniaGate;
+    private autoOffTimeout?;
+    constructor(platform: Lares4Platform, accessory: PlatformAccessory);
+    setOn(value: CharacteristicValue): Promise<void>;
+    getOn(): Promise<CharacteristicValue>;
+    updateDevice(device: KseniaGate): void;
+}
+//# sourceMappingURL=gate-accessory.d.ts.map

package/dist/accessories/gate-accessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/gate-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAW,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,aAAa;IAMlB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN9B,OAAO,CAAC,OAAO,CAAU;IAClB,MAAM,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAiB;gBAGnB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,iBAAiB;IA8BpC,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChD,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAK3C,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;CAIhD"}