Integrazione V2C Trydan Modbus per Home Assistant

Questa integrazione personalizzata permette di collegare Home Assistant direttamente al wallbox V2C Trydan tramite protocollo Modbus TCP. Tutti i dati provengono dalla memoria Modbus del caricatore: non sono necessari account cloud o connessioni a Internet.

Caratteristiche principali

• Comunicazione locale: lettura ciclica dei registri Holding tramite Modbus TCP (unità di default 1).
• Entità già pronte: sensori per potenza, energia, stato di carica, tempo di sessione, tensione di rete e molto altro.
• Controllo in scrittura: interruttori e number entity per pausa/lock, modalità dinamica, intensità, potenza contrattuale e luminosità del LED frontale.
• Selezione modalità FV: select entity per scegliere il profilo di potenza dinamica pubblicato da V2C.
• Opzioni configurabili: intervallo di polling e timeout Modbus regolabili dall'interfaccia.
• Traduzioni: interfaccia disponibile in italiano e inglese.

Requisiti

• Firmware Trydan aggiornato con supporto Modbus TCP.
• Porta TCP 502 raggiungibile dal server Home Assistant.
• Home Assistant 2025.4 o successivo.

Installazione

1. Copia la cartella custom_components/v2c_modbus nella directory custom_components della tua istanza Home Assistant.
2. Riavvia Home Assistant.
3. Vai su Impostazioni → Dispositivi e servizi → Aggiungi integrazione e cerca V2C Trydan Modbus.
4. Inserisci l'indirizzo IP del caricatore e, se necessario, personalizza porta, timeout e intervallo di aggiornamento.

Suggerimento: se utilizzi HACS puoi aggiungere questo repository come sorgente personalizzata e installare l'integrazione direttamente dall'interfaccia web.

Entità esposte

• Sensori: stato di carica, energia erogata, potenze per fase, potenza di casa, FV, batteria, tensione impianto, errori, intensità minima/massima, valore PWM, durata sessione.
• Sensori binari: stato pausa, blocco connettore, programma orario, controllo dinamico, pagamenti, OCPP, LED logo.
• Switch: abilita/disabilita pausa, lock, programma, controllo dinamico, pagamenti, OCPP, LED logo.
• Number: intensità istantanea, limiti minimi/massimi, potenza contrattuale, luminosità LED.
• Select: scelta della modalità di potenza dinamica (Timed, Exclusive, Min Power, Grid+PV, Stop).

Servizi

• v2c_modbus.push_power_measurements: invia al caricatore i valori di potenza letti da Home Assistant (grid L1/L2/L3, produzione FV, batteria e tensione impianto) per alimentare il controllo dinamico previsto dal manuale Modbus V2C.

Limiti e note

• Il caricatore espone i valori energetici come float big-endian a 32 bit; l'integrazione li arrotonda ai valori più significativi per semplificare la consultazione.
• Alcuni registri di scrittura (es. potenze di rete L1/L2/L3 o valori FV) sono pensati per scenari avanzati con misuratori esterni: non sono ancora mappati come entità dedicate.
• In caso di errore di comunicazione, l'integrazione tenta la riconnessione automatica al successivo ciclo di polling.

Debug

Per abilitare un log dettagliato aggiungi nel tuo configuration.yaml:

logger:
  logs:
    custom_components.v2c_modbus: debug

Licenza

Il codice è distribuito con licenza MIT. Consulta il file LICENSE per tutte le informazioni.