Installation

This guide covers installing LibreScoot on your unu Scooter Pro.

Before you begin

Installing LibreScoot requires:

  • Physical access to the scooter's internals
  • Technical knowledge of embedded Linux systems
  • A USB-to-serial adapter
  • Patience and willingness to troubleshoot

If you're not comfortable with any of these, join the Discord to find someone who can help.

Prerequisites

Hardware

  • unu Scooter Pro (2020+ model with MDB/DBC architecture)
  • USB-to-serial adapter (3.3V TTL)
  • Tools:
    • PH2 Phillips driver (stock screws) or H4 hex driver (upgraded screws) for panels
    • H5 hex driver to loosen the MDB mounting
    • Torx T10 for MDB case screws

Software

  • Linux or macOS computer
  • Serial terminal (screen, minicom, or similar)
  • Download the latest release from GitHub Releases

Release Channels

Choose the right channel for your needs:

Stable

Not yet available. First stable release coming soon.

Testing

Current recommended channel. Early access to new features.

Nightly

Latest development builds. For developers only.

Installation Steps

Critical Safety Warning

Before unplugging anything or removing the MDB, you MUST disconnect all batteries in this order:

  1. Remove both main batteries from their slots
  2. Disconnect the Connectivity Battery (CB) - located front-left in the floorwell
  3. Disconnect the AUX battery - located back-right in the floorwell

Failure to disconnect batteries can damage the MDB or cause electrical hazards.

1

Download Release

Get the latest .sdimg files for both MDB and DBC from the releases page.

librescoot-mdb-image-unu-mdb.sdimg
librescoot-dbc-image-unu-dbc.sdimg

Note: The .sdimg files are required for initial installation. Mender files are only for OTA updates after LibreScoot is already installed.

2

Access MDB Serial Console

Remove the MDB from the scooter and open its case. Connect your USB-to-serial adapter to the UART pins (3.3V TTL).

Open a serial terminal at 115200 baud. Interrupt the boot by pressing spacebar repeatedly during power-on to reach the bootloader prompt.

3

Flash MDB

At the bootloader prompt, enter USB mass storage mode:

ums 0 mmc 1

The MDB's eMMC will appear as a USB storage device on your computer. Flash the sdimg file using dd or a similar tool.

4

Flash DBC

The DBC must also be removed and flashed via its serial port. Connect to its UART pins, interrupt boot, and enable USB mass storage:

ums 0 mmc 2

Flash the DBC sdimg file the same way as MDB.

5

Reassemble and First Boot

Reinstall both boards, reconnect all batteries (in reverse order of disconnection), and power on the scooter.

The dashboard should display the LibreScoot UI. Use the lsc status command via serial or USB Ethernet to verify everything is working.

Reverting to Stock

There is no backup of your original firmware. If you need to revert, you can reflash using stock firmware images. Join the Discord for details.

After Installation

Set Update Channel

Switch channels using the lsc CLI:

$ lsc ota channel testing   # or: nightly
$ lsc ota check             # Check for updates

Register Keycards

Add your NFC keycards for unlock:

$ lsc keycard add    # Hold card to reader when prompted

Troubleshooting

  • Dashboard doesn't power on - Check DBC USB connection to MDB
  • No serial output - Verify TX/RX are not swapped, check baud rate (115200)
  • OTA updates fail - Check modem connectivity with lsc status

For more help, join the Discord community.

← Services Reference