From 7e276fabdde699be217ae4e8593b03337ecf28d5 Mon Sep 17 00:00:00 2001
From: raph666 <raph999@free.fr>
Date: Tue, 31 Mar 2026 18:07:08 +0200
Subject: [PATCH] Update README.md

---
 README.md | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 2a6a4ab..7d7aa26 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,35 @@
-# arkteos-proxy-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.
+# 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 → 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. 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 du proxy | `9641` |
+
+## Utilisation avec Node-RED
+
+Dans le nœud `tcp in` de Node-RED, connecte-toi à `172.30.33.1:<proxy_port>` au lieu de l'IP directe de la PAC.
+
+## 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 :
+- 163 bytes : données groupe frigorifique
+- 227 bytes : données régulation
+- 95 bytes : métadonnées réseau
+
+Toutes les trames commencent par le magic bytes `0x55 0x00`.