Skip to the content
2 layers61 × 61.2 mmScooter board, the printed circuit board in 3D

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

3

README

README.md

Scooter 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:

  1. 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.
  2. 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

text
.
├── 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.md

The 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):

ComponentFilesLicense
Code / firmware / scripts*.py, *.sh, *.serviceGPL-3.0-or-later — LICENSE
Hardware design (original)kicad/board/, original symbols/footprintsCERN-OHL-S-2.0 — LICENSE-HARDWARE.txt
Documentation*.md, BOMs, esp32-scooter-schematic.htmlCC-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
QtyValueFootprintReferences
7100nFCapacitor_SMD:C_0805_2012MetricC1, C2, C3, C5, C8, C9, C11
6100kResistor_SMD:R_0805_2012MetricR1, R2, R3, R4, R13, R14
4MountingHole_PadMountingHole:MountingHole_3.2mm_M3_DIN965_Pad_TopBottomH1, H2, H3, H4
310uFCapacitor_SMD:C_0805_2012MetricC6, C7, C10
33V3Diode_SMD:D_SOD-123D1, D2, D3
24.7kResistor_SMD:R_0805_2012MetricR11, R12
1100Resistor_SMD:R_0805_2012MetricR6
11MResistor_SMD:R_0805_2012MetricR10
11kResistor_SMD:R_0805_2012MetricR9
12N7002scooter_lcsc:SOT-23-3_L2.9-W1.3-P1.90-LS2.4-BRQ1
133kResistor_SMD:R_0805_2012MetricR8
1470kResistor_SMD:R_0805_2012MetricR7
1Amphenol 98424-F52-12ALFscooter_lcsc:CONN-SMD_12P-P2.00-V-R2-C6-LS9.0J3
1Buzzer 5V HYG-8503A C18623826scooter_lcsc:BUZ-SMD_4P-L8.5-W8.5-P8.50-TL-ABZ1
1D10/SDA/SCL/5V/3V3/PACK/GNDConnector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_VerticalJ6
1LSM6DS3TR-Cscooter_lcsc:LGA-14_L3.0-W2.5-P0.50-TLU2
1OLED I2C JST-GH RAConnector_JST:JST_GH_SM04B-GHS-TB_1x04-1MP_P1.25mm_HorizontalJ4
1SMF3.3Ascooter_lcsc:SOD-123_L2.8-W1.8-LS3.7-RDD4
1WS2812BLED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmLED1
1XIAO ESP32-C3scooter_lcsc:CONN-SMD_XIAO_ESP32C3U3

Similar boards

  • 4 layers70 × 50 mmFinalized bluetooth remote, the printed circuit board in 3D

    Finalized bluetooth remote

    3pnguyen/esp32-bluetooth-media-keyboard

    Electronic project that provides the same control as wireless earbuds.

    62 partsMIT
  • 4 layers68 × 29.3 mmSFP xSPI Bridge, the printed circuit board in 3D

    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 layers50 × 100 mmCAN Interface Board, the printed circuit board in 3D

    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 mmFlightcomputer2, the printed circuit board in 3D

    Flightcomputer2

    UTS-Rocketry/ODIN-FlightController2026

    Primary avionics flight controller for the 2026 AURC rocket.

    114 parts1
  • 6 layers38.1 × 50.8 mmBadgesao, the printed circuit board in 3D

    Badgesao

    kevinjuszczyk/SuperXBit192

    Lo-fi handheld gaming

    269 partsGPL-3.0
  • 2 layers83.5 × 122 mmPico activity tracker, the printed circuit board in 3D

    Pico activity tracker

    mgagvani/pico_activity_tracker

    ECE 362 Final Project

    35 partsMIT

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).