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