Update README.md
This commit is contained in:
72
README.md
72
README.md
@@ -1,7 +1,5 @@
|
||||
# VESC2X3Bridge
|
||||
|
||||
The VESC2X3Bridge is a project I started at the end of 2025. It aims to integrate the X3 Scooter Series from Ninebot into the world of VESC, an open-source project by Benjamin Vedder.
|
||||
|
||||
This repository provides the PCB files for the VESC2X3Bridge board. It allows an almost plug-and-play installation, with minimal configuration required on both the VESC and Bridge sides.
|
||||
|
||||
Community Telegram channel [Ninebot Bridges](https://t.me/NinebotBridges)
|
||||
@@ -10,6 +8,76 @@ Community Telegram channel [Ninebot Bridges](https://t.me/NinebotBridges)
|
||||
|
||||
Also check out this repository which is used to drive the lights on your X3 Series Scooter [LightBoard](https://gitea.overkill.cc/morss12/LightBoard.git)
|
||||
|
||||
# Features & Abilities
|
||||
|
||||
A simple overview of everything the VESC2G3Bridge can do.
|
||||
|
||||
---
|
||||
|
||||
## What Is It?
|
||||
|
||||
The VESC2X3Bridge is a project I started at the end of 2025. It aims to integrate the X3 Scooter Series from Ninebot into the world of VESC, an open-source project by Benjamin Vedder.
|
||||
The VESC2G3Bridge is a small computer that sits between your scooter's motor controller (VESC) and its dashboard (G3). Without it, the dashboard and the motor controller don't understand each other — the bridge acts like a translator so they can work together.
|
||||
|
||||
---
|
||||
|
||||
## What It Does
|
||||
|
||||
### Shows Your Speed
|
||||
The device reads how fast the motor is spinning and works out your actual riding speed. It then sends that number to the dashboard so you can see it while you ride.
|
||||
|
||||
### Shows Battery Level
|
||||
It checks how much battery you have left and tells the dashboard, so you always know when to charge.
|
||||
|
||||
### Controls the Lights
|
||||
- Turns on the **rear light** when you need it.
|
||||
- Flashes the **left and right indicators** (turn signals) when you signal a turn.
|
||||
- Supports **horn** activation from the dashboard button.
|
||||
|
||||
### Switches Ride Profiles
|
||||
The scooter can have different power modes (like "slow and safe" or "fast and fun"). The bridge listens to the dashboard buttons and tells the VESC which mode to switch to. You can also set it to block the fast modes when the battery is low.
|
||||
|
||||
### Controls the Throttle and Brake
|
||||
By running a small script on the VESC, the bridge can send your throttle and brake inputs directly, giving the VESC full control over how you accelerate and slow down.
|
||||
|
||||
### Updates Itself Over Wi-Fi
|
||||
You don't need any cables to update the firmware. The device creates its own Wi-Fi network and you can upload new firmware right from your phone or computer's web browser.
|
||||
|
||||
### Has a Built-In Settings Page
|
||||
Connect to its Wi-Fi and open a web page to change settings — no apps, no cables, no computer software needed.
|
||||
|
||||
### Works With Different Battery Systems
|
||||
Some scooter battery packs have their own battery management board (BMS). The bridge can read battery info from:
|
||||
- The VESC itself
|
||||
- An NB BMS
|
||||
- A JBD (Xiaoxiang) BMS
|
||||
|
||||
### Supports Two Board Versions
|
||||
There are two hardware versions of the board (V1.0 and V2.1+). You pick which one you have in the settings page and the device automatically uses the right pins.
|
||||
|
||||
### Tracks Multiple Motor Controllers
|
||||
If your scooter has more than one VESC (e.g. dual motors), the bridge reads speed data from all of them and averages the values together for a smooth, accurate speed reading.
|
||||
|
||||
---
|
||||
|
||||
## Quick Summary Table
|
||||
|
||||
| Feature | What it means |
|
||||
|---|---|
|
||||
| Speed display | Shows km/h on the dashboard |
|
||||
| Battery display | Shows battery % on the dashboard |
|
||||
| Turn signals | Flashes left/right lights |
|
||||
| Rear light | Controls the back light |
|
||||
| Horn | Beeps when you press the button |
|
||||
| Ride profiles | Switches power modes from the dashboard |
|
||||
| Low battery lock | Blocks fast modes when battery is too low |
|
||||
| Throttle & brake | Passes your inputs to the VESC |
|
||||
| Wi-Fi OTA updates | Update firmware from a browser |
|
||||
| Web config page | Change settings from a browser |
|
||||
| Multiple BMS support | Works with VESC, NB, or JBD battery boards |
|
||||
| Two board versions | Supports V1.0 and V2.1+ hardware |
|
||||
| Multi-VESC support | Handles more than one motor controller |
|
||||
|
||||
---
|
||||
|
||||
## How to create a PCB from the files
|
||||
|
||||
Reference in New Issue
Block a user