morss12/VESC2X3Bridge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

Update README.md

Browse Source
This commit is contained in:
morss12
2026-03-21 20:43:42 +00:00
parent 818606b3b5
commit 4e936201d6
1 changed files with 10 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@@ -28,26 +28,26 @@ The device reads how fast the motor is spinning and works out your actual riding
It checks how much battery you have left and tells the dashboard, so you always know when to charge. It checks how much battery you have left and tells the dashboard, so you always know when to charge.
### Controls the Lights ### Controls the Lights
- Turns on the **rear light** when you need it. - Turns on the **rear light** just like the stock X3 Series.
- Flashes the **left and right indicators** (turn signals) when you signal a turn. - Flashes the **left and right indicators** (turn signals) when you signal a turn.
- Supports **horn** activation from the dashboard button. - Supports **horn** activation from the dashboard button (GT3).
### Switches Ride Profiles ### 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. The scooter can have different power modes (WALK,ECO,NORMAL,SPORT). The bridge listens to the dashboard buttons and tells the VESC which mode to switch to. You can also set it to block the switching of modes when the battery is low, bypassing the dashboards auto apply of a slow profile.
### Controls the Throttle and Brake ### 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. By running a small script on the VESC, the VESC can directly read the inputs from the dashboard, giving the VESC full control over how you accelerate and slow down.
### Updates Itself Over Wi-Fi ### 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. 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 ### 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. Connect to its Wi-Fi and open a web page to change settings. [Config page](https://192.168.5.1/)
### Works With Different Battery Systems ### Works With Different Battery Systems
Some scooter battery packs have their own battery management board (BMS). The bridge can read battery info from: Some scooter battery packs have their own battery management board (BMS). The bridge can read battery info from:
- The VESC itself - The VESC itself
- An NB BMS - The Ninebot Original BMS
- A JBD (Xiaoxiang) BMS - A JBD (Xiaoxiang) BMS
### Supports Two Board Versions ### Supports Two Board Versions
@@ -56,8 +56,6 @@ There are two hardware versions of the board (V1.0 and V2.1+). You pick which on
### Tracks Multiple Motor Controllers ### 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. 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 ## Quick Summary Table
| Feature | What it means | | Feature | What it means |
@@ -68,11 +66,11 @@ If your scooter has more than one VESC (e.g. dual motors), the bridge reads spee
| Rear light | Controls the back light | | Rear light | Controls the back light |
| Horn | Beeps when you press the button | | Horn | Beeps when you press the button |
| Ride profiles | Switches power modes from the dashboard | | Ride profiles | Switches power modes from the dashboard |
| Low battery lock | Blocks fast modes when battery is too low | | Low battery lock | Blocks the dashboard profile application when the battery is low |
| Throttle & brake | Passes your inputs to the VESC | | Throttle & brake | VESC reads the throttle and brake directly from the Dashboard |
| Wi-Fi OTA updates | Update firmware from a browser | | Wi-Fi OTA updates | Update firmware from a browser |
| Web config page | Change settings from a browser | | Web config page | Change settings from a browser |
| Multiple BMS support | Works with VESC, NB, or JBD battery boards | | Multiple BMS support | Works with VESC, Ninebot, or JBD battery boards |
| Two board versions | Supports V1.0 and V2.1+ hardware | | Two board versions | Supports V1.0 and V2.1+ hardware |
| Multi-VESC support | Handles more than one motor controller | | Multi-VESC support | Handles more than one motor controller |