vehicles

Vozidlo představuje konkrétní elektromobil (EV) včetně jeho baterie. Když je vozidlo nakonfigurované a přiřazené k nabíjecímu bodu, může uživatelské rozhraní zobrazovat stav nabíjení, stav nabití, zbývající dobu nabíjení a další data, která se z vozidla automaticky načítají a zpracovávají.

Nabíjení lze také omezit na určitý stav nabití (pouze v uživatelském rozhraní). Většina nabíječek tuto informaci nezná (přenáší se jen u velmi specifických kombinací nabíječky a vozidla), proto evcc díky této konfiguraci komunikuje přímo s vozidlem přes online rozhraní (API) výrobce vozidla.

Konfigurace vehicles je seznam různých vozidel.

Příklad:

vehicles:
  - name: Zoe
    type: ...
    ...

Konfigurace známých vozidel najdete v části Zařízení – vozidla.

Níže jsou vysvětleny jednotlivé parametry.

Povinné parametry

`name`

Krátké označení nakonfigurovaného vozidla. Hodnota se používá při odkazování na vozidlo v konfiguraci nabíjecího bodu.

Příklad:

name: zoe

`title`

Název vozidla, který se zobrazí v uživatelském rozhraní.

Příklad:

title: Zoe

`type`

Typ rozhraní evcc, který umožňuje komunikaci s vozidlem. Známá vozidla lze připojit pomocí typu template. Vhodný typ (šablonu) pro známá vozidla a návod k ruční konfiguraci custom najdete v části Zařízení – vozidla.

Volitelné parametry

`capacity`

Využitelná kapacita baterie vozidla v kilowatthodinách (kWh).

Slouží k výpočtu potřebné energie při plánování nabíjení.

Příklad:

capacity: 50 # kWh

`phases`

Maximální počet fází, které toto vozidlo může využít (případně včetně nabíjecího kabelu). Interní výchozí hodnota je 3. Možné hodnoty jsou 1, 2 nebo 3.

Některá vozidla, zejména plug-in hybridy, nevyužívají k nabíjení maximálně možné 3 fáze. Pokud je instalován měřič nabíječky, dokáže sice evcc zjistit skutečně používané fáze na začátku nabíjení, před zahájením nabíjení však tato informace k dispozici není. Když u vozidla nakonfigurujete parametr phases, může evcc v režimu Chytrý zahájit nabíjení i s nižším dostupným výkonem.

Příklad:

phases: 2

`cache`

Jak dlouho se uchovávají data načtená z datového rozhraní (API) vozidla, než se evcc rozhraní znovu dotáže.

Aby měl aktuální stavová data vozidla (např. stav nabití trakční baterie), dotazuje se evcc pravidelně online na rozhraní výrobce. Aby však servery výrobce nebyly zahlceny neustálými požadavky (což by mohlo vést k zablokování účtu), je implementována cache, která tyto požadavky zachytí a odpoví nedávno načtenými daty až do zde uvedeného maximálního stáří. Protože většina vozidel aktualizuje data jen během probíhajícího nabíjení a ve velmi dlouhých intervalech (běžně 10 až 30 minut), častější dotazy nic nepřinesou.

Výchozí hodnota: 15m

Příklad:

cache: 5m

`identifiers`

Seznam jednoho nebo více identifikátorů, podle kterých se vozidlo rozpozná. Pokud je potřeba vozidlo identifikovat u různých nabíječek, může být nutných více identifikátorů. Identifikace je možná pomocí následujících mechanismů:

RFID

Pokud má nabíječka rozhraní RFID, lze vozidlu k identifikaci přiřadit kartu RFID. V tom případě je potřeba RFID Token ID.

Příklad:

identifiers:
  - 12345ABC # ID tokenu RFID

Poznámka: pokud by se identifikátor mohl interpretovat jako číslo, je nutné ho uvést v uvozovkách.

Příklad:

identifiers:
  - "012345"
  - "12345e2"
  - "0x1234"

Identifikátor vozidla

Pokud to nabíječka podporuje, přijímá od vozidla identifikátor vozidla. Může to být buď MAC adresa palubní nabíječky, nebo identifikátor trvale nainstalovaného certifikátu Plug & Charge (jiného certifikátu než pro stejnosměrné nabíjení!).

Příklad:

identifiers:
  - 01:23:45:67:89:0A # MAC adresa

Některá vozidla generují každý den novou MAC adresu. V tom případě lze použít zástupné znaky, pokud se existující vozidla liší v neměnné části MAC adresy.

identifiers:
  - 01:23:45:*

`features: ["coarsecurrent"]`

Označuje, že vozidlo nelze regulovat plynulým omezením proudu.

Toto nastavení je vhodné použít pro následující kombinaci:

Vozidlo dokáže nabíjecí proud měnit jen po celých ampérech
Nabíječka dokáže zpracovat jemnější zadání nabíjecího proudu (např. 1 mA)

Při této kombinaci se může stát, že změna proudu o několik mA vede při regulaci k neočekávané změně fázového proudu o 1 A. Regulace pak může začít oscilovat. Tato funkce také omezuje regulaci na hrubé kroky po 1 A.

NELZE ji použít ve spojení se šablonou vozidla. Aby ji bylo možné použít, musí být vozidlo nakonfigurováno jako nativní typ.

Příklad:

features: ["coarsecurrent"]

`icon`

Vozidla lze v uživatelském rozhraní zobrazit s různými ikonami. K dispozici jsou tyto možnosti:

car
bike
scooter
moped
motorcycle
van
bus
tractor
generic
heater
cooler
waterheater

Příklad:

icon: heater