1043717432 / home-assistant-niu-component

niu scooter integration for Home assistant.

niu

This is a custom component for Home Assistant to integrate your Niu Scooter.

Suitable for users in mainland China.

Install

You can install this custom component by adding this repository (https://github.com/marcelwestrahome/home-assistant-niu-component) to HACS in the settings menu of HACS first. You will find the custom component in the integration menu afterwards, look for 'Niu Scooter Integration'. Alternatively, you can install it manually by copying the custom_components folder to your Home Assistant configuration folder.

Setup

# configuration.yaml

sensor:
  - platform: niu
    username: [e-mail]
    password: mysecretpassword
    country: 86
    scooter_id: 0
    monitored_variables:
      - BatteryCharge          # Battery
      - Isconnected            # Battery
      - TimesCharged           # Battery
      - temperatureDesc        # Battery
      - Temperature            # Battery
      - BatteryGrade           # Battery
      - CurrentSpeed           # Moto
      - ScooterConnected       # Moto
      - IsCharging             # Moto
      - IsLocked               # Moto
      - TimeLeft               # Moto
      - EstimatedMileage       # Moto
      - centreCtrlBatt         # Moto
      - HDOP                   # Moto
      - Longitude              # Moto
      - Latitude               # Moto
      - totalMileage           # OverAll
      - DaysInUse              # OverAll
      - Distance               # Distance
      - RidingTime             # Distance
      - LastTrackStartTime     # LastTrack
      - LastTrackEndTime       # LastTrack
      - LastTrackDistance      # LastTrack
      - LastTrackAverageSpeed  # LastTrack
      - LastTrackRidingtime    # LastTrack
      - LastTrackThumb         # LastTrack

Configuration variables:

• username (Required): EMail address or mobile phone number or username.
• password (Required): Niu Account password.
• country (Required): Telephone country count without leading zeros or + sign, e.g. 49 instead of 0049 or +49.
• scooter_id (Optional): The scooter_id to monitor. Defaults to 0.

If you own multiple scooters just add the niu sensor platform multiple times and increase the scooter_id.

Known bugs

At this moment the NIU sport plus has a bug, at least this type scooter stops after a certain time updating. When this happen, component will show the last updated values. With a restart of your your HA, you need to turn on your scooter for a short time to see all sensor values. Niu promises to solve this issue with a new firmware.

The known bug that's causing the updates to stop is fixed by Niu in the scooters firmware v3 (TRA01E18). This update has to be manually installed at an authorized dealer (so no automagical OTA install). @rmettes reported this firmware as stable.

Roadmap

Some day this component shall become an official HA integration. Until then just use this custom component.