LibreScoot

⚠️ WARNING: EXTREMELY EXPERIMENTAL - DO NOT USE ON REAL HARDWARE ⚠️

This project aims to create a free and open source firmware for iMX6-based electric scooters. It is currently in early development stages and will brick your scooter if installed. This is a research project and should not be used on any real hardware yet.

Requirements

• Any Linux distribution
• Docker

Quick Start

git clone https://github.com/librescoot/librescoot.git
cd librescoot
./run.sh

The compiled firmware will be located at:

yocto/build/tmp-glibc/deploy/images/librescoot-mdb/*.wic.gz

for MDB or

yocto/build/tmp-glibc/deploy/images/librescoot-dbc/*.wic.gz

for DBC.

Flashing Instructions

To flash the firmware to the Middle Driver Board (MDB):

1. Connect the MDB via mini-USB
2. Power the MDB with a stable 12V power supply
3. Ensure the MDB is in mass-storage mode
4. Flash using:

gunzip -c firmware.wic.gz | sudo dd of=/dev/sdX bs=4M oflag=direct status=progress

Replace /dev/sdX with your actual device path.

Current Status

This is heavily work-in-progress. The codebase is unstable and changing rapidly. At this stage, the project is for development and research purposes only.

Goals

• Create a fully open source scooter firmware
• Improve safety through transparency
• Enable community-driven development and customization

Contributing

While we welcome contributions, please note that this project is not ready for production use. Feel free to open issues for discussion or submit PRs for review.

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.