Arkteos est une intégration Home Assistant personnalisée pour une PAC Arkteos Zuran 4. Elle lit localement les données du proxy Arkteos, selon un protocole REG3 observé à partir de captures réelles et du flow Node-RED de référence.

L’intégration est strictement en lecture seule : elle n’envoie aucune commande à la PAC et ne contacte jamais directement celle-ci. Elle ne dépend ni de MQTT, ni de Node-RED une fois la migration terminée.

État du projet

Version actuelle : 0.1.2.
Statut : expérimental.
Testée avec les captures d’une Arkteos Zuran 4.
Le protocole n’est pas officiellement documenté.
Conserve Node-RED en parallèle pendant la validation sur l’installation réelle.

Prérequis

Home Assistant.
HACS pour l’installation recommandée.
Un proxy Arkteos accessible sur le réseau.
Le port par défaut du proxy est 9641.
La PAC ne doit pas être contactée directement.
Le proxy conserve la connexion unique vers la PAC et accepte les clients.

Installation avec HACS

Ouvre HACS.
Va dans Intégrations.
Ouvre le menu Dépôts personnalisés.
Ajoute l’URL du miroir GitHub : https://github.com/raph666/home-assistant-arkteos.
Choisis la catégorie Intégration.
Installe Arkteos.
Redémarre Home Assistant.
Va dans Paramètres > Appareils et services.
Ajoute Arkteos.
Saisis l’hôte du proxy et le port 9641.

Le miroir GitHub sert à l’installation HACS.

Configuration

La configuration demande l’hôte et le port du proxy. Elle est validée par une connexion au proxy et la réception d’une trame valide. La reconfiguration est possible depuis Home Assistant.

Entités exposées

L’intégration expose des entités natives Home Assistant pour :

la connectivité ;
le groupe frigorifique ;
la régulation ;
le circuit primaire ;
l’eau chaude sanitaire ;
les statuts et diagnostics.

Certaines entités de diagnostic sont désactivées par défaut.

Diagnostics

Les diagnostics sont téléchargeables depuis Home Assistant. L’hôte est masqué et aucune trame brute, socket ou donnée interne sensible n’est exposée.

Validation parallèle avec Node-RED

Le flow Node-RED doit rester actif au début. Compare les anciennes entités MQTT avec les nouvelles entités natives, puis retire Node-RED uniquement après une validation des valeurs en conditions réelles.

Limites connues

Le protocole est déduit de captures.
Aucun checksum n’est démontré.
Seules les trames observées de 95, 163 et 227 octets sont reconnues.
L’intégration est en lecture seule et ne permet aucune commande de pilotage.
La compatibilité est confirmée uniquement avec la configuration testée.
Arkteos ne fournit aucun support officiel pour cette intégration.

Développement

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements_test.txt
python3 -m pytest -v
python3 -m compileall custom_components/arkteos

Licence

Support

Tant que le dépôt principal reste sur Gitea, utilise ces URLs pour le code et les tickets :

Dépôt : https://gitea.i-host.fr/raph666/home-assistant-arkteos
Tickets : https://gitea.i-host.fr/raph666/home-assistant-arkteos/issues