From 5110173467f08327313ff26437ed889c58b409b1 Mon Sep 17 00:00:00 2001 From: raph666 Date: Wed, 1 Apr 2026 10:10:53 +0200 Subject: [PATCH] Update README.md --- README.md | 133 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) diff --git a/README.md b/README.md index 74fb76a..6d40de6 100644 --- a/README.md +++ b/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 `` 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