Update README.md

This commit is contained in:
2026-04-01 11:00:05 +02:00
committed by GitHub
parent 5110173467
commit e7d616c888
+26 -85
View File
@@ -57,7 +57,11 @@ Les valeurs hors plage physiquement plausible sont ignorées et loguées dans la
| Voltage DC | 0 à 1 000 V | | Voltage DC | 0 à 1 000 V |
| Débit eau primaire | 0 à 10 000 L/h | | Débit eau primaire | 0 à 10 000 L/h |
| Circulateur primaire | 0% à 100% | | Circulateur primaire | 0% à 100% |
| Nb cycles compresseur | 0 à 999 999 | | Statut frigo | 0 à 3 |
| Statut PAC | 0 à 9 |
| Signal RF sonde | -128 à 127 dBm |
| Nb cycles compresseur | 0 à 9 999 999 |
| Temps fonctionnement compresseur | 0 à 999 999 h |
| Temps mise sous tension | 0 à 999 999 h | | Temps mise sous tension | 0 à 999 999 h |
**Throttling** **Throttling**
@@ -80,10 +84,16 @@ Une valeur n'est publiée que si elle a changé au-delà d'un seuil défini, ave
| Fréquence compresseur cible | 1 Hz | 30s | | Fréquence compresseur cible | 1 Hz | 30s |
| Vitesse ventilateur | 10 rpm | 30s | | Vitesse ventilateur | 10 rpm | 30s |
| Voltage DC | 5 V | 60s | | Voltage DC | 5 V | 60s |
| Débit eau primaire | 10 L/h | 60s | | Débit eau primaire | 1 L/h | 60s |
| Circulateur primaire | 1% | 60s | | Circulateur primaire | 1% | 60s |
| Nb cycles compresseur | 1 | 5 min | | Modèle PAC | changement | 1h |
| Statut frigo | changement | 60s |
| Statut PAC | changement | 60s |
| Erreurs | changement | 60s |
| Nb cycles compresseur | 100 | 5 min |
| Temps fonctionnement compresseur | 1 h | 5 min |
| Temps mise sous tension | 1 h | 5 min | | Temps mise sous tension | 1 h | 5 min |
| Signal RF sonde | 1 dBm | 5 min |
**Statut de connexion** **Statut de connexion**
@@ -98,16 +108,23 @@ Le flow publie automatiquement via MQTT Discovery dans un appareil **PAC Arkteos
**Groupe frigorifique** **Groupe frigorifique**
- Température extérieure (°C) - Température extérieure (°C)
- Nombre de dégivrages
- Temps fonctionnement compresseur (h)
- Nombre de cycles compresseur
- Fréquence compresseur actuelle (Hz) - Fréquence compresseur actuelle (Hz)
- Fréquence compresseur cible (Hz) - Fréquence compresseur cible (Hz)
- Vitesse ventilateur groupe frigo (rpm) - Vitesse ventilateur groupe frigo (rpm)
- Voltage DC compresseur (V) - Voltage DC compresseur (V)
- Statut frigo (0-3)
- Statut frigo texte (Arret / Refroidissement / Chauffage / Degivrage)
- Erreur active frigo
**Régulation** **Régulation**
- Puissance instantanée produite (W) - Puissance instantanée produite (W)
- Puissance instantanée consommée (W) - Puissance instantanée consommée (W)
- Temps mise sous tension (h) - Temps mise sous tension (h)
- Consigne température départ eau primaire (°C) - Modèle PAC (texte)
- Consigne départ eau primaire (°C)
- Température eau primaire aller (°C) - Température eau primaire aller (°C)
- Température eau primaire retour (°C) - Température eau primaire retour (°C)
- Débit eau primaire (L/h) - Débit eau primaire (L/h)
@@ -118,87 +135,11 @@ Le flow publie automatiquement via MQTT Discovery dans un appareil **PAC Arkteos
- Température ballon ECS milieu (°C) - Température ballon ECS milieu (°C)
- Température ballon ECS bas (°C) - Température ballon ECS bas (°C)
- Consigne ECS (°C) - Consigne ECS (°C)
- Nombre de cycles compresseur - Cycles compresseur (régulation)
- Statut PAC (0-9)
## Protocole - Statut PAC texte (Arret / Attente / Chaud / Froid / Hors Gel / ECS / Piscine / etc.)
- Erreur active régulation
La PAC Arkteos REG3 expose un flux binaire TCP (serial-over-IP) sur le port 9641 (IHM). - Signal RF sonde zone 1 (dBm)
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
- 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 ## Protocole