Skip to content
EN | DE

NIU E-Scooter

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

Parameters

NameDescriptionValueLevel
userUsername

e.g. email address, user id, etc.

optional
passwordPassword

Service account password

optional
serialScooter serial number like shown in NIU appoptional
titleTitle

Will be displayed in the user interface

optional
capacity [kWh]Battery capacity
Default: 4
Example: 50
optional
iconIcon

Will be displayed in the user interface

Default: scooter
advanced
phasesMaximum 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
identifiersRFID 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
priorityPriority

Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority).

advanced
climaterdisabledDisable 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
autodetectdisabledExclude from auto detection

Ignore the vehicle for auto detection of connected vehicles

advanced
wakeupdisabledDisable 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: niu-e-scooter
user: # Username, e.g. email address, user id, etc.
password: # Password, Service account password
serial: # Scooter serial number like shown in NIU app
title: # Title, Will be displayed in the user interface (optional)
capacity: 4 # Battery capacity (kWh), optional
icon: scooter # 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)
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: # 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)