vesc_scooter_support

VESC Scooter Support

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

Installation

1. Open VESC Tool and connect to your VESC over Bluetooth, USB or WiFi.
2. Go to VESC Packages and press Update Archive.
3. Select VESC Scooter Support under Applications and press Install.
4. Open the App UI (VESC Tool -> Navigation Bar -> App UI), pick your Model and press Save.
5. Set up the ADC app, see below.

Setup videos: on a phone | on a PC

The PC video installs the .vescpkg from Releases through VESC Packages -> Load Custom, which is how you get a version that is not in the store yet.

Guides: DE Guide | German Rollerplausch Guide

ADC Setup

Throttle and brake reach the motor through the ADC app, so it has to be set up once:

• App Settings -> General: set APP to Use to ADC, then Write
• App Settings -> ADC -> General: Control Type Current, Use Filter True, Safe Start Regular, Update Rate 1000 Hz
• App Settings -> ADC -> Mapping: open ADC Mapping, pull throttle and brake through their full range, then Apply and Write
• Dual setup: turn on Multiple VESCs Over CAN and install the package on the second ESC with model Slave

Software ADC in the App UI means throttle and brake come from the dashboard over UART. Turn it off when they are wired to the ADC pins of the VESC instead.

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)

Features

• One package for G30, M365/1S/PRO2 and Slave ESCs
• Settings in the UI
• Speed mode switch (Press twice)
• Secret speed mode (Button combination picked in the UI)
• 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)
• mph/km display toggle

TODO

• App communication (support third-party Xiaomi/NineBot apps)
• Cruise control (throttle gesture in secret mode)
• Idle timeout (shut down after X seconds of inactivity)
• Rear light and brake light output
• 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

• Spintend (Reliable & High Performance):

  • Ubox Single Lite 100V 100A
  • Ubox Single 85V 250A V2

• Makerbase:

  • Makerbase VESC 60100HP V2 60V 100A
  • Makerbase VESC 84100HP 84V 100A
  • Makerbase VESC 84200HP 84V 200A

• 75100 Alu PCB (Not recommended):

  • Makerbase 75100 Alu PCB
  • Flipsky 75100 Alu PCB

• More recommended VESCs:

  • MP2 300A 100V/150V VESC
  • and many more - use whatever you like.

See Also

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