# 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.