Arkteos

Intégration custom Home Assistant en lecture seule pour une PAC Arkteos Zuran 4. Elle expose les données décodées du protocole REG3 par des entités natives Home Assistant.

L’intégration se connecte exclusivement au proxy Arkteos fourni par l’addon Home Assistant séparé. Elle ne se connecte jamais directement à la PAC et n’envoie aucune commande. Le port du proxy est configurable ; sa valeur par défaut est 9641.

Installation avec HACS

1. Dans HACS, ouvre Intégrations puis le menu à trois points.
2. Choisis Dépôts personnalisés.
3. Ajoute https://gitea.i-host.fr/raph666/home-assistant-arkteos avec la catégorie Intégration.
4. Installe Arkteos.
5. Redémarre Home Assistant.
6. Ajoute l’intégration dans Paramètres > Appareils et services.

Le proxy Arkteos doit être disponible avant la configuration de l’intégration.

Migration et validation

Conserve temporairement le flow Node-RED existant pendant la comparaison des valeurs publiées. Il reste la référence fonctionnelle actuelle des champs décodés.

Le protocole REG3 est observé depuis des captures et le flow Node-RED de référence ; aucune documentation officielle complète du protocole n’est actuellement disponible. Les champs et les règles de découpage sont limités à ce qui est démontré par ces références.

Développement

• references/arkteos_nodered_flow.json : flow Node-RED de référence.
• references/proxy_protocol_notes.md : contexte connu sur le proxy.
• tests/fixtures/ : trames réelles anonymisées utilisées par les tests.

Les captures privées et les informations de connexion ne doivent pas être versionnées.