primo caricamento

concentratore/README.md

@@ -0,0 +1,51 @@
+# Concentratore Modbus
+
+Si presenta al CCI come se fosse il gateway degli inverter: stessi slave ID,
+stessi registri. Risponde alle scritture in poche decine di millisecondi invece
+di ~310 ms, propaga il comando agli inverter veri e lo tiene rinfrescato, perche'
+i 50KTL-V3 lasciano decadere il limite se nessuno lo riscrive.
+
+## Opzioni
+
+| Opzione | Cosa e' |
+|---|---|
+| `gateway` | IP del Waveshare a cui sono appesi gli inverter |
+| `gateway_porta` | Porta Modbus TCP del Waveshare, di norma 502 |
+| `slaves` | Slave ID degli inverter, separati da virgola |
+| `refresh` | Ogni quanti secondi riscrivere il setpoint, in secondi |
+| `timeout` | Timeout delle transazioni verso il gateway |
+| `log` | Traccia a video ogni transazione |
+
+Il CCI si collega alla **porta 5020** dell'impianto.
+
+## Registri
+
+Uguali a quelli degli inverter ZCS serie V3:
+
+| Registro | Hex | Cosa | |
+|---|---|---|---|
+| 4357 | 0x1105 | abilitazione controllo remoto | R/W |
+| 4358 | 0x1106 | setpoint in decimi di percento | R/W |
+| 1157 | 0x0485 | potenza attiva, decine di W | R |
+
+Aggiunti da noi, **da dichiarare ad AiLux**:
+
+| Registro | Hex | Cosa |
+|---|---|---|
+| 8192 | 0x2000 | 1 = comando confermato su questo inverter |
+| 8193 | 0x2001 | decimi di secondo dall'ultima conferma (65535 = mai) |
+| 8194 | 0x2002 | quanti inverter hanno il comando confermato |
+| 8195 | 0x2003 | potenza totale d'impianto, decine di W |
+
+## Prova
+
+```
+mbpoll -a 1 -t 4 -p 5020 -r 4358 <ip-impianto> 1 200
+mbpoll -a 1 -t 4 -p 5020 -r 8192 -c 4 -1 <ip-impianto>
+```
+
+## Attenzione
+
+Fermando l'add-on gli inverter **restano con l'ultimo comando ricevuto**, e il
+limite decade da solo dopo qualche secondo. Non e' un modo per togliere il
+limite in sicurezza.