USB File Transfer (UMS Mode)

USB Mass Storage mode exposes a virtual drive on your computer. Copy files to it, eject, and the scooter processes them automatically.

Entering UMS mode

There are two ways to enter UMS mode:

From the dashboard

  1. Double-tap the left brake to open the menu
  2. Go to Settings → System → Enter UMS Mode

From the CLI

lsc usb ums

To switch back to normal (network) mode:

lsc usb normal

Transferring files

  1. Connect a USB cable between the scooter's USB Mini-B port and your computer
  2. A drive appears on your computer
  3. Copy files into the appropriate folder (see below)
  4. Safely eject the drive. The scooter processes the files and reboots automatically

What you can transfer

Map display tiles

Copy any .mbtiles file into the maps/ folder on the drive. The scooter installs it as the offline map source.

Download pre-built tiles from LibreScoot OSM Tiles releases.

Valhalla routing tiles

Rename your downloaded .tar archive so its name ends in tiles.tar (e.g. valhalla_tiles.tar), then copy it into the maps/ folder.

Download pre-built routing tiles from LibreScoot Valhalla Tiles releases.

Firmware updates

Copy a .mender update artifact to the drive to install a firmware update without a SIM card.

How it works

UMS mode is managed by ums-service on the MDB. It switches the USB port from network mode (USB Ethernet) to mass storage mode, exposing a partition on the scooter's eMMC as a removable drive.

When the drive is ejected, ums-service detects the eject event, copies any new files to the correct locations on the data partition, and reboots the scooter to apply them.

Troubleshooting

  • Drive doesn't appear: make sure the scooter is in UMS mode (check dashboard or run lsc usb status). Try a different USB cable.
  • Files not applied after eject: check that you safely ejected (not just unplugged). The scooter needs the eject event to trigger processing.
  • Scooter doesn't reboot: reconnect USB and eject again, or reboot manually with lsc power reboot.