109 lines
3.4 KiB
Markdown
109 lines
3.4 KiB
Markdown
# Arkteos pour Home Assistant
|
||
|
||
## Présentation
|
||
|
||
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.1`.
|
||
- 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
|
||
|
||
1. Ouvre HACS.
|
||
2. Va dans **Intégrations**.
|
||
3. Ouvre le menu **Dépôts personnalisés**.
|
||
4. Ajoute l’URL du miroir GitHub :
|
||
`https://github.com/raph666/home-assistant-arkteos`.
|
||
5. Choisis la catégorie **Intégration**.
|
||
6. Installe **Arkteos**.
|
||
7. Redémarre Home Assistant.
|
||
8. Va dans **Paramètres > Appareils et services**.
|
||
9. Ajoute **Arkteos**.
|
||
10. 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
|
||
|
||
```bash
|
||
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
|
||
|
||
MIT — Copyright (c) 2026 Raph666
|
||
|
||
## 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
|
||
|
||
Le miroir GitHub sert à l’installation HACS.
|