# API MQTT > Elenca i topic MQTT che evcc pubblica per sito, punti di ricarica, veicoli e batteria domestica, e quelli scrivibili per cambiare modalità, limiti o piani di ricarica. Lo [stato dell’API](/it/reference/state) viene pubblicato anche via MQTT. Ogni campo diventa un topic a sé; gli oggetti annidati e le liste vengono convertiti in singoli sotto-topic (l’indice parte da `1`). ## Topic di sola lettura ### Sito * `evcc/site/siteTitle`: titolo del sito * `evcc/site/currency`: valuta configurata * `evcc/site/homePower`: consumo domestico attuale (W) * `evcc/site/pvPower`: produzione solare attuale (W) * `evcc/site/grid/power`: potenza di rete attuale (W, positivo = prelievo) * `evcc/site/battery/power`: potenza della batteria (W, positivo = scarica) * `evcc/site/battery/soc`: livello di carica della batteria (%) * `evcc/site/greenShareHome`: quota di energia autoprodotta nel consumo domestico (0–1) * `evcc/site/greenShareLoadpoints`: quota di energia autoprodotta nel consumo dei punti di ricarica (0–1) * `evcc/site/tariffGrid`: tariffa di prelievo attuale * `evcc/site/tariffFeedIn`: tariffa di immissione attuale * `evcc/site/tariffCo2`: intensità di CO₂ attuale * `evcc/site/batteryGridChargeActive`: carica della batteria dalla rete in corso (true/false) ### Punti di ricarica Tutti gli ID dei punti di ricarica partono da `1`. * `evcc/loadpoints`: numero di punti di ricarica disponibili * `evcc/loadpoints//title`: titolo del punto di ricarica * `evcc/loadpoints//connected`: veicolo collegato (true/false) * `evcc/loadpoints//charging`: ricarica in corso (true/false) * `evcc/loadpoints//enabled`: punto di ricarica abilitato (true/false) * `evcc/loadpoints//mode`: modalità di ricarica (`off`, `smart`, `now`) * `evcc/loadpoints//alwaysCharge`: opzione carica sempre (`off`, `on`, `once`) * `evcc/loadpoints//chargePower`: potenza di ricarica attuale (W) * `evcc/loadpoints//chargedEnergy`: energia caricata nella sessione (Wh) * `evcc/loadpoints//chargeDuration`: durata della ricarica (ns) * `evcc/loadpoints//chargeRemainingDuration`: durata residua della ricarica (ns) * `evcc/loadpoints//chargeRemainingEnergy`: energia residua (Wh) * `evcc/loadpoints//chargeTotalImport`: lettura del contatore del punto di ricarica (Wh) * `evcc/loadpoints//vehicleName`: identificativo del veicolo * `evcc/loadpoints//vehicleTitle`: nome visualizzato del veicolo * `evcc/loadpoints//vehicleSoc`: livello di carica del veicolo (%) * `evcc/loadpoints//vehicleRange`: autonomia del veicolo (km) * `evcc/loadpoints//phasesActive`: fasi attive * `evcc/loadpoints//planActive`: piano di ricarica attualmente attivo (true/false) * `evcc/loadpoints//sessionEnergy`: energia della sessione (Wh) * `evcc/loadpoints//sessionSolarPercentage`: quota di energia autoprodotta nella sessione (%) * `evcc/loadpoints//smartCostActive`: ricarica intelligente con la rete attualmente attiva (true/false) * `evcc/loadpoints//effectivePriority`: priorità effettiva > **Altri topic** > > Questo elenco è incompleto. Per tutti i topic disponibili usa [MQTT Explorer](https://mqtt-explorer.com/). ## Topic scrivibili Per modificare un topic scrivibile, aggiungi `/set` al topic e invia il nuovo valore. ```bash mosquitto_pub -t "evcc/loadpoints/1/phasesConfigured/set" -m "3" ``` Gli orari sono in UTC nel formato `yyyy-mm-ddThh:mm:ssZ`, ad es. `2023-03-05T07:00:00Z` (= 5 marzo 2023, 8:00 CET). Le seguenti stringhe vengono riconosciute come valori vuoti: `nil`, `null`, `none`, `-`. Usale per cancellare le soglie impostate in precedenza: ```bash mosquitto_pub -t "evcc/site/batteryGridChargeLimit/set" -m "none" ``` ### Sito * `evcc/site/prioritySoc`: livello di carica prioritario della batteria * `evcc/site/bufferSoc`: livello di carica tampone della batteria * `evcc/site/bufferStartSoc`: livello di carica della batteria per l’avvio del tampone * `evcc/site/residualPower`: potenza residua di rete * `evcc/site/batteryGridChargeLimit`: limite di prezzo per la carica della batteria dalla rete * `evcc/site/batteryDischargeControl`: abilita/disabilita il controllo della scarica della batteria (true/false) * `evcc/site/batteryMode`: modalità esterna della batteria (`normal`, `hold`, `charge`, `holdcharge`, `discharge`), controlla direttamente tutte le batterie controllabili, ha la precedenza sulle altre modalità di evcc e si reimposta dopo 60 s * `evcc/site/smartCostLimit`: limite per la ricarica intelligente con la rete per tutti i punti di ricarica * `evcc/site/smartFeedInPriorityLimit`: limite di priorità dell’immissione in rete per tutti i punti di ricarica ### Punti di ricarica * `evcc/loadpoints//mode`: modalità di ricarica (`off`, `smart`, `now`) * `evcc/loadpoints//alwaysCharge`: opzione carica sempre (`off`, `on`, `once`), solo in modalità intelligente * `evcc/loadpoints//minSoc`: livello di carica minimo * `evcc/loadpoints//limitSoc`: limite di carica in %, applicabile solo ai veicoli online * `evcc/loadpoints//limitEnergy`: limite di energia in kWh, applicabile solo ai veicoli offline * `evcc/loadpoints//planEnergy`: energia del piano di ricarica (payload JSON: `{"value": 50, "time": "2023-03-05T07:00:00Z"}`) * `evcc/loadpoints//phasesConfigured`: fasi configurate * `evcc/loadpoints//minCurrent`: corrente di ricarica minima * `evcc/loadpoints//maxCurrent`: corrente di ricarica massima * `evcc/loadpoints//solarShare`: quota solare della potenza di ricarica minima (0–1) * `evcc/loadpoints//enableThreshold`: soglia di attivazione * `evcc/loadpoints//enableDelay`: ritardo di attivazione (s) * `evcc/loadpoints//disableThreshold`: soglia di disattivazione * `evcc/loadpoints//disableDelay`: ritardo di disattivazione (s) * `evcc/loadpoints//batteryboost`: boost da batteria abilitato (1/0) * `evcc/loadpoints//batteryBoostLimit`: limite del livello di carica per il boost da batteria * `evcc/loadpoints//priority`: valore di priorità * `evcc/loadpoints//smartCostLimit`: limite per la ricarica intelligente con la rete * `evcc/loadpoints//smartFeedInPriorityLimit`: limite di priorità dell’immissione in rete * `evcc/loadpoints//planStrategy`: strategia del piano di ricarica (JSON) * `evcc/loadpoints//vehicle`: seleziona il veicolo tramite il nome ### Veicoli Per i nomi dei veicoli vedi `evcc/vehicles`. * `evcc/vehicles//minSoc`: livello di carica minimo in % * `evcc/vehicles//limitSoc`: limite di carica in % * `evcc/vehicles//planSoc`: livello di carica del piano di ricarica (payload JSON: `{"value": 50, "time": "2023-03-05T07:00:00Z"}`) * `evcc/vehicles//planStrategy`: strategia del piano di ricarica (JSON)