

Scooter board
Open-source ESP32-C3 replacement control board + ESP-IDF firmware for a decommissioned Bird One e-scooter, plus the reverse-engineered Lishui one-wire bus protocol.
- Size
- 61 × 61.2 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 39
- Nets
- 27
- Pads
- 130
- Tracks, vias
- 194, 132
- Pours
- 36
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 6 Oct 2026
- Updated
- 27 Oct 2026
Overview
Scooter board is an open-source printed circuit board by d0ng3o, from the d0ng3o/esp32_turd_scooter_controller repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 61 × 61.2 mm with 39 parts on 27 nets, routed with 194 tracks and 132 vias.
It is built around the LSM6DS3TR-C, SMF3.3A and WS2812B. Its parts include 13 resistors, 10 capacitors, 5 diodes, 3 connectors and 2 ICs. It belongs with the robots and motor control boards and the ESP32 and RISC-V boards of this library.
Main components
3LSM6DS3TR-C
LGA-14(2.5x3)-40℃~+85℃ 1.71V~3.6V 16bit 3uA 4KB IMU (accelerometer + gyroscope) SPI、I2C X,Y,Z X,Y,Z ±16g ±2000dps 运动事件检测、同步与时间戳 LGA-14(2.5x3) Accelerometers ROHSSTMicroelectronicsAccelerometersSMF3.3A
SOD-123FL200W@10/1000us 25A 3.3V 5.2V 500uA 8V IEC 61000-4-2、IEC 61000-4-4 TVS Unidirectional SOD-123FL ESD and Surge Protection (TVS/ESD) ROHSDOWOESD And Surge Protection (TVS/ESD)WS2812B
5mm X 5mm Surface Mount RGB LED with Intelligent ControlWorldsemiUncategorised
README
README.mdScooter control board
A standalone replacement control board for a decommissioned Bird One #590AE shared e-scooter (the operator went bankrupt), built around a Seeed XIAO ESP32-C3.
Tested on: a real Bird One #590AE, driving its stock Nanjing Lishui LSW6G-RF-FOC motor controller over the original one-wire bus. Other Bird One units (and other scooters on the same Lishui colon protocol) are likely compatible but unverified.
⚠️ Safety-critical, experimental, unofficial. This board controls a vehicle's motor, throttle, and braking behavior. It is provided as-is, with no warranty, is not certified by anyone, and is not affiliated with or endorsed by Bird. Build and ride at your own risk — read DISCLAIMER.md first.
The project has two halves:
- Reverse-engineering the scooter's one-wire bus between the original control board and the Lishui motor controller — captured and documented so the controller can be driven directly.
- A custom KiCad control board that replaces the dead original: same harness connector, same bus protocol, plus throttle/brake sensing, pack voltage, a buzzer, an addressable status LED, an on-board IMU for wake-on-motion, and an OLED display.
Repository layout
.
├── PROTOCOL.md the reverse-engineered one-wire bus protocol
├── captures/ raw bus captures backing PROTOCOL.md
├── esp32-scooter-schematic.html interactive overview of the board
│
├── scooter_master.py drive the motor controller as the bus master
├── pi_sniff.py passive ride logger (Raspberry Pi, RX-only)
├── bus_experiment.py scripted bring-up probes
├── bus_listen_poll.py poll at 50 Hz and log non-echo bytes
├── bus_soak.py long idle soak to catch slow telemetry fields
├── install_logger.sh one-shot Pi logger installer
├── pi-scooter-logger.service systemd unit for the Pi logger
│
├── firmware/ the ESP-IDF firmware for the XIAO — see firmware/README.md
└── kicad/ the hardware — see kicad/README.mdThe bus, briefly
Native 3.3 V open-drain half-duplex UART at 115200. The control board is the
master: it polls the controller at 50 Hz with a colon-framed packet
(':' TYPE LEN DATA[LEN] CHK CR LF, CHK = XOR of the header+data) carrying the
throttle and light flags, and the controller answers with telemetry. Full frame
types, flags and field map are in PROTOCOL.md; it was all
confirmed on hardware (the PC drove the motor across the full throttle range).
The hardware
The KiCad 10 design lives in kicad/ — see kicad/README.md for the board overview, kicad/board/BOM.md for the parts and full design rationale, and kicad/board/LAYOUT.md for the layout playbook. The board is DRC-clean; bare boards and parts have been ordered.
Status
- ✅ Bus protocol reverse-engineered and documented.
- ✅ Host/Pi tooling to drive and log the bus.
- ✅ Control board schematic + PCB complete, DRC-clean, ordered.
- ✅ ESP32-C3 firmware (ESP-IDF) in firmware/ — ride control, lights, lock/alarm, IMU wake, OLED UI, WiFi config/OTA; running on hardware.
Note
The Python at the repo root is host-side tooling (PC / Raspberry Pi) used to
reverse-engineer and exercise the bus. It connects to the scooter via a USB
serial adapter (scooter_master.py, bench scripts) or a Pi UART (pi_sniff.py).
The firmware that runs on the XIAO itself lives in firmware/.
License
This project is free/libre and strong-copyleft — multi-licensed by component, with each layer under a share-alike license. Anyone who copies, modifies, or builds on it must release their version under the same license (no closed or proprietary forks):
| Component | Files | License |
|---|---|---|
| Code / firmware / scripts | *.py, *.sh, *.service | GPL-3.0-or-later — LICENSE |
| Hardware design (original) | kicad/board/, original symbols/footprints | CERN-OHL-S-2.0 — LICENSE-HARDWARE.txt |
| Documentation | *.md, BOMs, esp32-scooter-schematic.html | CC-BY-SA-4.0 — LICENSE-DOCS.txt |
Copyright 2026 Taavi Laadung.
Exception: the vendor-sourced symbols, footprints, and 3D models under
kicad/lcsc/ are not covered by the above and keep their original
LCSC/EasyEDA/manufacturer terms — see kicad/lcsc/README.md.
CERN-OHL-S v2 notice (hardware): Copyright 2026 Taavi Laadung. This source
describes Open Hardware and is licensed under the CERN-OHL-S v2. You may
redistribute and modify this source and make products using it under the terms of
the CERN-OHL-S v2 (https://ohwr.org/cern_ohl_s_v2.txt). This source is distributed
WITHOUT ANY EXPRESS OR IMPLIED WARRANTY, INCLUDING OF MERCHANTABILITY,
SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE. Please see the
CERN-OHL-S v2 for applicable conditions. Source location:
https://github.com/d0ng3o/esp32_turd_scooter_controller (CERN-OHL-S requires the
source location to be conveyed and, where practicable, kept visible on the product
itself).
Disclaimer
See DISCLAIMER.md for the full safety warning and the "no affiliation" / reverse-engineering notices. In short: this is an experimental, uncertified board that controls a vehicle — build and ride at your own risk, and check your local road-traffic laws before using it.
Parts
39| Qty | Value | Footprint | References |
|---|---|---|---|
| 7 | 100nF | Capacitor_SMD:C_0805_2012Metric | C1, C2, C3, C5, C8, C9, C11 |
| 6 | 100k | Resistor_SMD:R_0805_2012Metric | R1, R2, R3, R4, R13, R14 |
| 4 | MountingHole_Pad | MountingHole:MountingHole_3.2mm_M3_DIN965_Pad_TopBottom | H1, H2, H3, H4 |
| 3 | 10uF | Capacitor_SMD:C_0805_2012Metric | C6, C7, C10 |
| 3 | 3V3 | Diode_SMD:D_SOD-123 | D1, D2, D3 |
| 2 | 4.7k | Resistor_SMD:R_0805_2012Metric | R11, R12 |
| 1 | 100 | Resistor_SMD:R_0805_2012Metric | R6 |
| 1 | 1M | Resistor_SMD:R_0805_2012Metric | R10 |
| 1 | 1k | Resistor_SMD:R_0805_2012Metric | R9 |
| 1 | 2N7002 | scooter_lcsc:SOT-23-3_L2.9-W1.3-P1.90-LS2.4-BR | Q1 |
| 1 | 33k | Resistor_SMD:R_0805_2012Metric | R8 |
| 1 | 470k | Resistor_SMD:R_0805_2012Metric | R7 |
| 1 | Amphenol 98424-F52-12ALF | scooter_lcsc:CONN-SMD_12P-P2.00-V-R2-C6-LS9.0 | J3 |
| 1 | Buzzer 5V HYG-8503A C18623826 | scooter_lcsc:BUZ-SMD_4P-L8.5-W8.5-P8.50-TL-A | BZ1 |
| 1 | D10/SDA/SCL/5V/3V3/PACK/GND | Connector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_Vertical | J6 |
| 1 | LSM6DS3TR-C | scooter_lcsc:LGA-14_L3.0-W2.5-P0.50-TL | U2 |
| 1 | OLED I2C JST-GH RA | Connector_JST:JST_GH_SM04B-GHS-TB_1x04-1MP_P1.25mm_Horizontal | J4 |
| 1 | SMF3.3A | scooter_lcsc:SOD-123_L2.8-W1.8-LS3.7-RD | D4 |
| 1 | WS2812B | LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm | LED1 |
| 1 | XIAO ESP32-C3 | scooter_lcsc:CONN-SMD_XIAO_ESP32C3 | U3 |
Similar boards
- 4 layers80 × 99 mm

- 4 layers70 × 50 mm

Finalized bluetooth remote
3pnguyen/esp32-bluetooth-media-keyboard
Electronic project that provides the same control as wireless earbuds.
62 partsMIT - 4 layers68 × 29.3 mm

SFP xSPI Bridge
bartkepl/SFP-xSPI_Bridge
Mostek OCTOSPI/QUADSPI/SPI <-> SFP na FPGA Gowin GW1N-9: lacze swiatlowodowe 100 Mbaud 8b/10b z programowym odzyskiem zegara, biblioteka C dla STM32
53 partsMIT - 4 layers40.5 × 59.5 mm
/NEWSuperCapacitorController-master/hardware/SuperCap2024_Control_V1.1R_F3_ISOPWR/SuperCap2024Control_V1.1R_F3_ISOPWR.kicad_pcb.jpg?size=s&soon)
- 4 layers50 × 100 mm

CAN Interface Board
UTS-Rocketry/KESTREL-Control-Board2026
Control Actuation System (CAS) Interface Board for the UTS Rocketry avionics stack.
70 parts1 - 4 layers80 × 80 mm

Flightcomputer2
UTS-Rocketry/ODIN-FlightController2026
Primary avionics flight controller for the 2026 AURC rocket.
114 parts1 - 6 layers38.1 × 50.8 mm

- 2 layers83.5 × 122 mm

Questions
How big is the Scooter board PCB?
It measures 61 × 61.2 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Scooter board use?
39 parts, built around the LSM6DS3TR-C, SMF3.3A and WS2812B. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Scooter board KiCad files?
From the d0ng3o/esp32_turd_scooter_controller repository on GitHub, at the commit this page was made from: the board is kicad/board/scooter_board.kicad_pcb and its schematic kicad/board/scooter_board.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Scooter board design in my own project?
Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).