Přeskočit na obsah
chytré nabíjení

MQTT API

Data ze stavového API se publikují také přes MQTT. Každá položka má vlastní téma, přičemž vnořené objekty a seznamy se převádějí na samostatná podtémata (indexování začíná od 1).

Témata jen pro čtení

Sekce “Témata jen pro čtení”

Lokalita

Sekce “Lokalita”
  • evcc/site/siteTitle: název lokality
  • evcc/site/currency: nastavená měna
  • evcc/site/homePower: aktuální spotřeba domu (W)
  • evcc/site/pvPower: aktuální solární výroba (W)
  • evcc/site/grid/power: aktuální výkon sítě (W, kladná hodnota = odběr ze sítě)
  • evcc/site/battery/power: výkon baterie (W, kladná hodnota = vybíjení)
  • evcc/site/battery/soc: stav nabití baterie (%)
  • evcc/site/greenShareHome: podíl vlastní energie na spotřebě domu (0–1)
  • evcc/site/greenShareLoadpoints: podíl vlastní energie na spotřebě nabíjecích bodů (0–1)
  • evcc/site/tariffGrid: aktuální tarif dodávky energie
  • evcc/site/tariffFeedIn: aktuální tarif výkupu energie
  • evcc/site/tariffCo2: aktuální intenzita CO₂
  • evcc/site/batteryGridChargeActive: nabíjení baterie ze sítě aktivní (true/false)

Nabíjecí body

Sekce “Nabíjecí body”

Všechna ID nabíjecích bodů začínají od 1.

  • evcc/loadpoints: počet dostupných nabíjecích bodů
  • evcc/loadpoints/<id>/title: název nabíjecího bodu
  • evcc/loadpoints/<id>/connected: vozidlo připojeno (true/false)
  • evcc/loadpoints/<id>/charging: právě nabíjí (true/false)
  • evcc/loadpoints/<id>/enabled: nabíjecí bod povolen (true/false)
  • evcc/loadpoints/<id>/mode: režim nabíjení (off, smart, now)
  • evcc/loadpoints/<id>/alwaysCharge: volba vždy nabíjet (off, on, once)
  • evcc/loadpoints/<id>/chargePower: aktuální nabíjecí výkon (W)
  • evcc/loadpoints/<id>/chargedEnergy: energie nabitá v relaci (Wh)
  • evcc/loadpoints/<id>/chargeDuration: doba nabíjení (ns)
  • evcc/loadpoints/<id>/chargeRemainingDuration: zbývající doba nabíjení (ns)
  • evcc/loadpoints/<id>/chargeRemainingEnergy: zbývající energie (Wh)
  • evcc/loadpoints/<id>/chargeTotalImport: celkový stav měřiče nabíjení (Wh)
  • evcc/loadpoints/<id>/vehicleName: identifikátor vozidla
  • evcc/loadpoints/<id>/vehicleTitle: zobrazovaný název vozidla
  • evcc/loadpoints/<id>/vehicleSoc: stav nabití vozidla (%)
  • evcc/loadpoints/<id>/vehicleRange: dojezd vozidla (km)
  • evcc/loadpoints/<id>/phasesActive: aktivní fáze
  • evcc/loadpoints/<id>/planActive: plán nabíjení právě aktivní (true/false)
  • evcc/loadpoints/<id>/sessionEnergy: energie relace (Wh)
  • evcc/loadpoints/<id>/sessionSolarPercentage: podíl vlastní energie v relaci (%)
  • evcc/loadpoints/<id>/smartCostActive: chytré nabíjení podle ceny právě aktivní (true/false)
  • evcc/loadpoints/<id>/effectivePriority: efektivní priorita

Zapisovatelná témata

Sekce “Zapisovatelná témata”

Chcete-li změnit hodnotu zapisovatelného tématu, připojte k názvu tématu /set a odešlete novou hodnotu.

Terminál
mosquitto_pub -t "evcc/loadpoints/1/phasesConfigured/set" -m "3"

Časy se zadávají v UTC ve formátu yyyy-mm-ddThh:mm:ssZ, např. 2023-03-05T07:00:00Z (= 5. března 2023, 8:00 SEČ).

Jako prázdné hodnoty se rozpoznávají tyto řetězce: nil, null, none, -. Pomocí nich zrušíte dříve nastavené prahové hodnoty:

Terminál
mosquitto_pub -t "evcc/site/batteryGridChargeLimit/set" -m "none"

Lokalita

Sekce “Lokalita”
  • evcc/site/prioritySoc: prioritní stav nabití baterie
  • evcc/site/bufferSoc: stav nabití baterie pro vyrovnávání nabíjení
  • evcc/site/bufferStartSoc: počáteční stav nabití baterie pro vyrovnávání nabíjení
  • evcc/site/residualPower: zbytkový výkon sítě
  • evcc/site/batteryGridChargeLimit: cenový strop pro nabíjení baterie ze sítě
  • evcc/site/batteryDischargeControl: zapnutí/vypnutí řízení vybíjení baterie (true/false)
  • evcc/site/batteryMode: externí režim baterie (normal, hold, charge, holdcharge, discharge). Přímo řídí všechny řiditelné baterie, má přednost před ostatními režimy evcc a po 60 s se vrátí do původního stavu.
  • evcc/site/smartCostLimit: cenový strop chytrého nabíjení pro všechny nabíjecí body
  • evcc/site/smartFeedInPriorityLimit: limit priority exportu do sítě pro všechny nabíjecí body

Nabíjecí body

Sekce “Nabíjecí body”
  • evcc/loadpoints/<id>/mode: režim nabíjení (off, smart, now)
  • evcc/loadpoints/<id>/alwaysCharge: volba vždy nabíjet (off, on, once), jen v režimu Chytrý
  • evcc/loadpoints/<id>/minSoc: minimální nabití
  • evcc/loadpoints/<id>/limitSoc: limit stavu nabití v %, platí jen pro online vozidla
  • evcc/loadpoints/<id>/limitEnergy: limit energie v kWh, platí jen pro offline vozidla
  • evcc/loadpoints/<id>/planEnergy: energie plánu nabíjení (obsah ve formátu JSON: {"value": 50, "time": "2023-03-05T07:00:00Z"})
  • evcc/loadpoints/<id>/phasesConfigured: nastavené fáze
  • evcc/loadpoints/<id>/minCurrent: minimální nabíjecí proud
  • evcc/loadpoints/<id>/maxCurrent: maximální nabíjecí proud
  • evcc/loadpoints/<id>/solarShare: solární podíl minimálního nabíjecího výkonu (0–1)
  • evcc/loadpoints/<id>/enableThreshold: prahová hodnota pro zapnutí
  • evcc/loadpoints/<id>/enableDelay: zpoždění zapnutí (s)
  • evcc/loadpoints/<id>/disableThreshold: prahová hodnota pro vypnutí
  • evcc/loadpoints/<id>/disableDelay: zpoždění vypnutí (s)
  • evcc/loadpoints/<id>/batteryboost: rychlé dobití zapnuto (1/0)
  • evcc/loadpoints/<id>/batteryBoostLimit: limit stavu nabití pro rychlé dobití
  • evcc/loadpoints/<id>/priority: hodnota priority
  • evcc/loadpoints/<id>/smartCostLimit: cenový strop chytrého nabíjení
  • evcc/loadpoints/<id>/smartFeedInPriorityLimit: limit priority exportu do sítě
  • evcc/loadpoints/<id>/planStrategy: strategie plánu nabíjení (JSON)
  • evcc/loadpoints/<id>/vehicle: přiřazení vozidla podle názvu

Vozidla

Sekce “Vozidla”

Názvy vozidel najdete v evcc/vehicles.

  • evcc/vehicles/<name>/minSoc: minimální nabití v %
  • evcc/vehicles/<name>/limitSoc: limit stavu nabití v %
  • evcc/vehicles/<name>/planSoc: stav nabití plánu nabíjení (obsah ve formátu JSON: {"value": 50, "time": "2023-03-05T07:00:00Z"})
  • evcc/vehicles/<name>/planStrategy: strategie plánu nabíjení (JSON)