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
- Dans Home Assistant : Paramètres → Modules complémentaires → trois points → Dépôts
- Ajoute l'URL de ce repo :
https://github.com/raph666/arkteos-proxy-addon - Installe l'addon Arkteos Proxy
- Configure l'IP de ta PAC dans les options
- Configure le port exposé dans la section Network (défaut : 9641) et clique Save
- 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
- Dans Node-RED : menu hamburger → Import → colle le contenu du fichier JSON
- Double-clique sur le nœud PAC via proxy et remplace
<IP_HA>par l'IP de ton Home Assistant - Double-clique sur le nœud MQTT publish → icône crayon → onglet Security → renseigne le login et mot de passe Mosquitto
- Clique Deploy
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
- Dans Home Assistant : Paramètres → Modules complémentaires → trois points → Dépôts
- Ajoute l'URL de ce repo :
https://github.com/raph666/arkteos-proxy-addon - Installe l'addon Arkteos Proxy
- Configure l'IP de ta PAC dans les options
- Configure le port exposé dans la section Network (défaut : 9641) et clique Save
- 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
- Dans Node-RED : menu hamburger → Import → colle le contenu du fichier JSON
- Double-clique sur le nœud PAC via proxy et remplace
<IP_HA>par l'IP de ton Home Assistant - Double-clique sur le nœud MQTT publish → icône crayon → onglet Security → renseigne le login et mot de passe Mosquitto
- 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
- une publication forcée a lieu toutes les 30 ou 60 secondes même sans changement
| Valeur | Seuil | Intervalle max |
|---|---|---|
| Températures | 0.5°C | 60s |
| Puissances | 0.1 kW | 30s |
| Pression | 0.1 bar | 60s |
| Fréquence compresseur | 1 Hz | 30s |
| Voltage DC | 5 V | 60s |
Entités créées dans HA
Le flow publie automatiquement 12 entités via MQTT Discovery dans un appareil PAC Arkteos Zuran 4 :
Groupe frigorifique
- Température extérieure (°C)
- Fréquence compresseur actuelle (Hz)
- Voltage DC compresseur (V)
Régulation
- Puissance instantanée produite (kW)
- Puissance instantanée consommée (kW)
- Température eau primaire aller (°C)
- Température eau primaire retour (°C)
- Pression eau primaire (bar)
- 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)
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.