Skip to content

Latest commit

 

History

History
81 lines (65 loc) · 4.12 KB

File metadata and controls

81 lines (65 loc) · 4.12 KB

VESC Scooter Support

Allows you to connect a Xiaomi or Ninebot display to a VESC controller.

Installation

Install this package, then pick your model in the app UI (VESC Tool -> Navigation Bar -> App UI). Read one of the guides below to get started.

Requirements

Requires VESC firmware 7.00, available at https://vesc-project.com/

Models

One VESC package for everything:

  • G30: Ninebot G30 dashboard (Ninebot protocol)
  • M365/1S/PRO2: Xiaomi M365, 1S, Essential and PRO 2 dashboards (Xiaomi protocol)
  • Slave: secondary ESC in a dual setup - only runs the CAN code server, the master controls it

After changing the model, save in the UI - the script restarts on its own with the new model.

Wiring

Red to 5V
Black to GND
Yellow to TX (UART-HDX)
Green to RX (Button)
1k Ohm Resistor from 3.3V to RX (Button)

image

Features

  • One package for G30, M365/1S/PRO2 and Slave ESCs
  • Settings in the UI
  • Speed mode switch (Press twice)
  • Secret speed mode (Hold throttle and brake and press twice)
  • Lock mode with alarm, beeping and braking (Press twice while holding brake)
  • Shutdown support (Long press to turn off)
  • Motor start speed
  • Idle display (battery, motor and controller temperature, voltage, trip or top speed)
  • Temperature notification icon (configurable threshold)

TODO

  • App communication (support third-party Xiaomi/NineBot apps)
  • More secret profile button combinations (e.g. 3x press without brake)
  • Cruise control (throttle gesture in secret mode)
  • Idle timeout (shut down after X seconds of inactivity)
  • Rear light and brake light output
  • mph/km display toggle
  • Overmodulation factor per mode
  • Throttle/brake plausibility check (detect disconnected sensor)
  • Use BMS SoC for battery display when available
  • Wheelie Control (take vl_bike_39p and dash35b pkg as reference)

Tested Hardware

BLE Displays

  • Clone M365 PRO Dashboard (AliExpress)
  • Original DE-Edition PRO 2 Dashboard
  • Original DE-Edition G30 Dashboard

Known Compatible VESCs

See Also

https://github.com/Koxx3/SmartESC_STM32_v2 (VESC firmware for Xiaomi ESCs)