vehicles

Een voertuig staat voor een bepaalde elektrische auto (EV) met zijn batterij. Als een voertuig is geconfigureerd en aan een laadpunt is toegewezen, kan de gebruikersinterface de laadstatus, het laadniveau, de resterende laadtijd en andere gegevens tonen die automatisch uit het voertuig worden opgehaald en verwerkt.

Het is ook mogelijk om het laden te beperken tot een bepaald laadniveau (alleen via de gebruikersinterface). Omdat de meeste laders het laadniveau niet kennen (het wordt alleen bij zeer specifieke combinaties van lader en voertuig doorgegeven), kan evcc met deze configuratie rechtstreeks met het voertuig communiceren via de online-interface (API) van de voertuigfabrikant.

De configuratie vehicles is een lijst van verschillende voertuigen.

Voorbeeld:

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

Configuraties voor bekende voertuigen vindt u onder Apparaten - Voertuigen.

Hieronder worden de verschillende parameters toegelicht.

Verplichte parameters

`name`

Een korte aanduiding van het geconfigureerde voertuig. De waarde wordt gebruikt om naar het voertuig te verwijzen in de configuratie van het laadpunt.

Voorbeeld:

name: zoe

`title`

Een omschrijving van het voertuig die in de gebruikersinterface wordt weergegeven.

Voorbeeld:

title: Zoe

`type`

Dit is het evcc-interfacetype waarmee met het voertuig wordt gecommuniceerd. Bekende voertuigen kunnen met het type template worden geïntegreerd. Het passende (template-)type voor bekende voertuigen en instructies voor de handmatige configuratie custom vindt u onder Apparaten - Voertuigen.

Optionele parameters

`capacity`

De bruikbare capaciteit van de voertuigbatterij in kilowattuur (kWh).

Deze waarde wordt gebruikt om de benodigde energie voor laadplannen te berekenen.

Voorbeeld:

capacity: 50 # kWh

`phases`

Het maximale aantal fasen dat dit voertuig kan gebruiken (eventueel inclusief de laadkabel). De interne standaardwaarde is 3. Mogelijke waarden zijn 1, 2 of 3.

Sommige voertuigen, vooral plug-in hybrides, gebruiken bij het laden niet de maximaal mogelijke 3 fasen. Als er een laadmeter is geïnstalleerd, kan evcc de daadwerkelijk gebruikte fasen bij het begin van een laadsessie bepalen, maar vóór de start van het laden is deze informatie niet beschikbaar. Door de parameter phases bij het voertuig te configureren, kan evcc het laden in de modus Slim al bij een lager beschikbaar vermogen starten.

Voorbeeld:

phases: 2

`cache`

Hoe lang opgehaalde gegevens worden bewaard en nieuwe verzoeken aan de online-interface (API) van de voertuigfabrikant worden tegengehouden.

Om actuele statusgegevens van het voertuig te bepalen (bijv. het laadniveau van de tractiebatterij), wordt de online-interface van de voertuigfabrikant regelmatig opgevraagd. Om de servers van de voertuigfabrikant echter niet te overspoelen met voortdurende verzoeken (wat tot blokkering van het account kan leiden), is er een cache die deze verzoeken onderschept en, zolang de hier ingestelde tijd niet is verstreken, met de laatst opgehaalde gegevens antwoordt. Omdat de meeste voertuigen hun gegevens alleen tijdens een lopende laadsessie en met zeer grote tussenpozen bijwerken (10 tot 30 minuten is gebruikelijk), hebben frequentere verzoeken geen meerwaarde.

Standaardwaarde: 15m

Voorbeeld:

cache: 5m

`identifiers`

Een lijst van een of meer ID’s om het voertuig te herkennen. Als het voertuig bij verschillende laders moet worden herkend, kunnen meerdere ID’s nodig zijn. De herkenning kan via de volgende mechanismen plaatsvinden:

RFID

Als de lader een RFID-interface heeft, kan voor de herkenning een RFID-kaart aan een voertuig worden toegewezen. In dat geval is de RFID Token ID nodig.

Voorbeeld:

identifiers:
  - 12345ABC # RFID-token-ID

Let op: als de ID als getal kan worden geïnterpreteerd, zijn aanhalingstekens verplicht.

Voorbeeld:

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

Voertuig-ID

Als de lader dit ondersteunt, ontvangt hij van het voertuig een voertuig-ID. Dit kan het MAC-adres van de boordlader zijn of een ID van een vast geïnstalleerd Plug & Charge-certificaat (niet hetzelfde certificaat als bij DC-laden!).

Voorbeeld:

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

Sommige voertuigen genereren elke dag een nieuw MAC-adres. In dat geval kunnen wildcards worden gebruikt als de aanwezige voertuigen verschillen in het deel van het MAC-adres dat niet verandert.

identifiers:
  - 01:23:45:*

`features: ["coarsecurrent"]`

Geeft aan dat een voertuig niet met een traploze stroombegrenzing kan worden geregeld.

Deze instelling moet voor de volgende combinatie worden gebruikt:

Voertuig kan alleen in stappen van hele ampères regelen
Lader kan fijnere laadstroomwaarden verwerken (bijv. 1 mA)

Bij deze combinatie kan het gebeuren dat wijzigingen van enkele mA in de stroom bij het regelen tot een onverwachte verandering van de fasestroom met 1 A leiden. De regeling kan dan gaan oscilleren. Deze functievlag beperkt de regeling daarom tot grove stappen van 1 A.

De functievlag kan NIET samen met een voertuigtemplate worden gebruikt. Om de functievlag te gebruiken, moet het voertuig als native type worden geconfigureerd.

Voorbeeld:

features: ["coarsecurrent"]

`icon`

Voertuigen kunnen in de gebruikersinterface met verschillende pictogrammen worden weergegeven. De beschikbare opties zijn:

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

Voorbeeld:

icon: heater