43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# 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.
|