Update README.md

README.md

@@ -34,6 +34,139 @@ Un flow Node-RED prêt à l'emploi est disponible dans ce repo : `nodered/arkteo
 
 ### Fonctionnement
 
+Le flow se connecte en streaming permanent au proxy. Chaque trame reçue est parsée, filtrée puis publiée sur MQTT.
+
+**Filtrage des valeurs aberrantes**
+
+Les valeurs hors plage physiquement plausible sont ignorées et loguées dans la console Node-RED :
+
+| Valeur | Plage valide |
+|---|---|
+| Température extérieure | -50°C à 150°C |
+| Températures circuit primaire | -10°C à 90°C |
+| Consigne départ eau primaire | -10°C à 90°C |
+| Températures ECS | 0°C à 95°C |
+| Consigne ECS | 0°C à 80°C |
+| Température intérieure zone 1 | -10°C à 50°C |
+| Consigne zone 1 | 5°C à 35°C |
+| Puissances | 0 à 50 000 W |
+| Pression eau primaire | 0 à 10 bar |
+| Fréquence compresseur actuelle | 0 à 200 Hz |
+| Fréquence compresseur cible | 0 à 200 Hz |
+| Vitesse ventilateur | 0 à 3 000 rpm |
+| Voltage DC | 0 à 1 000 V |
+| Débit eau primaire | 0 à 10 000 L/h |
+| Circulateur primaire | 0% à 100% |
+| Nb cycles compresseur | 0 à 999 999 |
+| Temps mise sous tension | 0 à 999 999 h |
+
+**Throttling**
+
+Une valeur n'est publiée que si elle a changé au-delà d'un seuil défini, avec un rafraîchissement forcé à intervalle maximum :
+
+| Valeur | Seuil | Intervalle max |
+|---|---|---|
+| Température extérieure | 0.5°C | 60s |
+| Températures circuit primaire | 0.5°C | 60s |
+| Consigne départ eau primaire | 0.5°C | 60s |
+| Températures ECS | 0.5°C | 60s |
+| Consigne ECS | 0.5°C | 60s |
+| Température intérieure zone 1 | 0.5°C | 60s |
+| Consigne zone 1 | 0.5°C | 60s |
+| Puissance produite | 10 W | 30s |
+| Puissance consommée | 10 W | 30s |
+| Pression eau primaire | 0.1 bar | 60s |
+| Fréquence compresseur actuelle | 1 Hz | 30s |
+| Fréquence compresseur cible | 1 Hz | 30s |
+| Vitesse ventilateur | 10 rpm | 30s |
+| Voltage DC | 5 V | 60s |
+| Débit eau primaire | 10 L/h | 60s |
+| Circulateur primaire | 1% | 60s |
+| Nb cycles compresseur | 1 | 5 min |
+| Temps mise sous tension | 1 h | 5 min |
+
+**Statut de connexion**
+
+Un `binary_sensor` HA indique si la PAC est connectée. Il passe à `OFF` si aucune trame n'est reçue depuis plus de 30 secondes.
+
+### Entités créées dans HA
+
+Le flow publie automatiquement via MQTT Discovery dans un appareil **PAC Arkteos Zuran 4** :
+
+**Statut**
+- PAC connectée (binary_sensor)
+
+**Groupe frigorifique**
+- Température extérieure (°C)
+- Fréquence compresseur actuelle (Hz)
+- Fréquence compresseur cible (Hz)
+- Vitesse ventilateur groupe frigo (rpm)
+- Voltage DC compresseur (V)
+
+**Régulation**
+- Puissance instantanée produite (W)
+- Puissance instantanée consommée (W)
+- Temps mise sous tension (h)
+- Consigne température départ eau primaire (°C)
+- Température eau primaire aller (°C)
+- Température eau primaire retour (°C)
+- Débit eau primaire (L/h)
+- Pression eau primaire (bar)
+- Circulateur primaire (%)
+- Température intérieure zone 1 (°C)
+- Consigne température zone 1 (°C)
+- Température ballon ECS milieu (°C)
+- Température ballon ECS bas (°C)
+- Consigne ECS (°C)
+- Nombre de cycles compresseur
+
+## Protocole
+
+La PAC Arkteos REG3 expose un flux binaire TCP (serial-over-IP) sur le port 9641 (IHM).
+Trois types de trames sont émises en continu à environ 1 trame/seconde :
+
+| Taille | Type | Contenu |
+|---|---|---|
+| 163 bytes | Frigo | Données groupe frigorifique Mitsubishi |
+| 227 bytes | Régulation | Données régulation, températures, ECS |
+| 95 bytes | Réseau | Métadonnées de connexion (IP PAC, etc.) |
+
+Toutes les trames commencent par le magic bytes `0x55 0x00`.# Arkteos Proxy — Home Assistant Addon
+
+Proxy TCP pour PAC Arkteos REG3 (Zuran 4, Baguio 4, etc.).
+
+Permet les connexions simultanées de Node-RED et de l'application mobile Arkteos, en relayant le flux binaire de la PAC vers tous les clients connectés.
+
+## Installation
+
+1. Dans Home Assistant : **Paramètres → Modules complémentaires → trois points → Dépôts**
+2. Ajoute l'URL de ce repo : `https://github.com/raph666/arkteos-proxy-addon`
+3. Installe l'addon **Arkteos Proxy**
+4. Configure l'IP de ta PAC dans les options
+5. Configure le port exposé dans la section **Network** (défaut : 9641) et clique **Save**
+6. Démarre l'addon
+
+## Configuration
+
+| Option | Description | Défaut |
+|---|---|---|
+| `pac_host` | Adresse IP de la PAC | `192.168.X.X` |
+| `pac_port` | Port TCP de la PAC | `9641` |
+| `proxy_port` | Port d'écoute interne du proxy | `9641` |
+
+## Intégration Node-RED
+
+Un flow Node-RED prêt à l'emploi est disponible dans ce repo : `nodered/arkteos_reg3_nodered.json`.
+
+### Import
+
+1. Dans Node-RED : menu hamburger → **Import** → colle le contenu du fichier JSON
+2. Double-clique sur le nœud **PAC via proxy** et remplace `<IP_HA>` par l'IP de ton Home Assistant
+3. Double-clique sur le nœud **MQTT publish** → icône crayon → onglet **Security** → renseigne le login et mot de passe Mosquitto
+4. Clique **Deploy**
+
+### Fonctionnement
+
 Le flow se connecte en streaming permanent au proxy. Chaque trame reçue est parsée et les valeurs sont publiées sur MQTT avec un système de throttling :
 
 - une valeur n'est publiée que si elle a changé au-delà d'un seuil défini