LiveWire S2

← Vehicles

evcc reads the charging state through the cloud API of the LiveWire app. It only answers devices that have been paired with the motorcycle once. The livewire-pair.py script (Python 3, no extra packages) performs the pairing. It asks for your credentials and the code the motorcycle shows on its display, then prints the device UUID to enter here. You need to be at the motorcycle with the ignition on once.

The motorcycle only reports "plugged in" once the charger is powered. Automatic vehicle detection is therefore disabled by default.

Parameters

Name	Description	Level
`user`	Username e.g. email address, user id, etc.	optional
`password`	Password Service account password	optional
`deviceuuid`	Device UUID Printed by the pairing script from github.com/j4velin/livewire-pairing. A different UUID needs pairing at the motorcycle again. Example: `6ba7b810-9dad-11d1-80b4-00c04fd430c8`	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 Default: `10.5` Example: `50`	optional
`icon`	Icon Will be displayed in the user interface Default: `motorcycle`	advanced
`phases`	Maximum number of phases Used to determine the minimum solar surplus and plan duration.	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
`autodetectdisabled`	Exclude from auto detection Ignore the vehicle for auto detection of connected vehicles Default: `true`	advanced
`wakeupdisabled`	Disable wake-up calls Do not send wake-up calls to the vehicle or charger, useful for vehicles that refuse to charge after repeated wake-ups.	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: livewire
      user: # Username, e.g. email address, user id, etc.
      password: # Password, Service account password
      deviceuuid: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 # Device UUID, Printed by the pairing script from [github.com/j4velin/livewire-pairing](https://github.com/j4velin/livewire-pairing). A different UUID needs pairing at the motorcycle again.
      vin: W... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer (optional)
      title: # Title, Will be displayed in the user interface (optional)
      capacity: 10.5 # Battery capacity (kWh), optional
      icon: motorcycle # 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)
      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)
      autodetectdisabled: true # Exclude from auto detection, Ignore the vehicle for auto detection of connected vehicles (optional)
      wakeupdisabled: # Disable wake-up calls, Do not send wake-up calls to the vehicle or charger, useful for vehicles that refuse to charge after repeated wake-ups. (optional)