Aiways

← Vehicles

This page shows the nightly version. Switch to the release version.

Parameters

Name	Description	Value	Level
user	Username e.g. email address, user id, etc.		optional
password	Password Service account password		optional
vin	Vehicle Identification Number If you own multiple vehicles from the same manufacturer Example: W...		optional
title	Title Will be displayed in the user interface		optional
capacity [kWh]	Battery capacity Example: 50		optional
icon	Icon Will be displayed in the user interface Default: car	carbikebusmopedmotorcyclerocketscootertaxitractorrickshawshuttlevanairpurifierbatterybulbclimatecoffeemakercomputecookingcoolerdesktopdevicedishwasherdryerfloorlampgenericheaterheatexchangeheatpumpkettlelaundrylaundry2machinemetermicrowavepumpsmartconsumertoolwaterheater	advanced
phases	Maximum number of phases Used to determine the minimum solar surplus and plan duration.	123	advanced
mode	Default charging mode Applied when a vehicle is connected. Leave empty to keep the current mode.		advanced
minCurrent [A]	Minimum current The minimum current per connected phase that can be used Example: 6		advanced
maxCurrent [A]	Maximum current The maximum current per connected phase that can be used Example: 16		advanced
maxPower [W]	Maximum charging power hint Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. The offered current of the loadpoint is not affected. Example: 10000		advanced
identifiers	RFID identification Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. Learn more.		advanced
priority	Priority Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority).		advanced
cache	Cache Time interval for data refresh Default: 15m Example: 5m		advanced
climaterdisabled	Disable climater detection Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request.		advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

vehicles:
    - name: my_car
      type: template
      template: aiways
      user: # Username, e.g. email address, user id, etc.
      password: # Password, Service account password
      vin: W... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer
      title: # Title, Will be displayed in the user interface (optional)
      capacity: 50 # Battery capacity (kWh), optional
      icon: car # Icon, Will be displayed in the user interface [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
      phases: # Maximum number of phases, Used to determine the minimum solar surplus and plan duration. [1, 2, 3] (optional)
      mode: # Default charging mode, Applied when a vehicle is connected. Leave empty to keep the current mode. (optional)
      minCurrent: 6 # Minimum current (A), The minimum current per connected phase that can be used (optional)
      maxCurrent: 16 # Maximum current (A), The maximum current per connected phase that can be used (optional)
      maxPower: 10000 # Maximum charging power hint (W), Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. _The offered current of the loadpoint is not affected._ (optional)
      identifiers: # RFID identification, Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. [Learn more.](https://docs.evcc.io/en/docs/features/vehicle) (optional)
      priority: # Priority, Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority). (optional)
      cache: 15m # Cache, Time interval for data refresh (optional)
      climaterdisabled: # Disable climater detection, Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request. (optional)