lsc and lsd Reference

lsd web interface

Development images include lsd on the MDB. With the dashboard on, connect your computer to the MDB's USB network and open http://192.168.7.1:8090. The manual installation guide describes USB access.

• Dashboard: live vehicle and battery status, faults, alarm controls and Service Mode.
• Settings: search and change settings; advanced mode reveals additional keys.
• Keycards: add or remove physical cards and start teach-in.
• Navigation: destinations, saved locations and the route plan.
• Files and Updates: transfer files, select update channels and install firmware.
• System and Services: download logs, inspect journals and manage services.
• Cloud: connect the scooter to Sunshine or import a cloud-client configuration.

The setting keys shown in the lsc examples below are also searchable in lsd. Use lsc over SSH for command-line work and scripts.

Quick Reference

lsc status                     # Overall vehicle dashboard
lsc unlock                     # Unlock the scooter
lsc lock                       # Lock the scooter
lsc open                       # Open the seatbox
lsc battery                    # Battery diagnostics
lsc faults                     # Show active faults
lsc ota status                 # OTA update status
lsc settings list              # View all settings
lsc set <key> <val>           # Change a setting
lsc alarm arm                  # Arm the motion alarm
lsc alarm disarm               # Disarm the alarm
lsc service list               # List running services
lsc logs                       # Extract log bundle

Commands

status

Show a dashboard of key metrics: vehicle state, speed, odometer, battery levels, connectivity, and GPS.

lsc status

watch

Monitor Redis pub/sub channels. Shows state changes in real-time.

lsc watch vehicle battery:0 # One or more channels (at least one required)

monitor

Record metrics over time for one or more subsystems. Writes timestamped data to files and produces a compressed archive.

lsc monitor gps battery          # Record GPS and battery data
lsc monitor all                  # Record everything
lsc monitor --duration 5m motor  # Record motor data for 5 minutes

Subsystems: gps, battery, vehicle, motor, power, modem, events, all.

vehicle

Control vehicle lock/unlock state, hibernation, and seatbox.

All vehicle subcommands accept --no-block to return immediately without waiting for state change confirmation.

Shortcuts at the top level: lsc lock, lsc unlock, lsc open.

alarm

Control the motion-based alarm system.

ota

OTA update management for MDB and DBC.

settings

View and modify persistent scooter settings stored in Redis. For the maintenance overlay and its controls, see Service Mode.

Shortcuts at the top level: lsc get <key>, lsc set <key> <value>, lsc del <key>.

You can set multiple key-value pairs in a single command: lsc set alarm.enabled true alarm.honk false.

Common settings:

gps

GPS tracking and position information.

keycard

Manage NFC keycard authentication.

UIDs can be in any hex format: 042A3D6A0D6580, 04:2A:3D:6A:0D:65:80, or 04 2A 3D 6A 0D 65 80.

power

Power management commands.

service (alias: svc)

Inspect and manage Librescoot systemd services.

usb

Control USB port mode (network vs. mass storage).

locations (alias: loc)

Manage saved locations used by navigation.

nav

Show navigation state and edit the ordered stop list the dashboard guides through.

led

Control LED indicators (for development/testing).

lsc led cue <index|name>       # Trigger cue sequence
lsc led fade <channel> <index|name>  # Trigger fade animation

Cue names: all-off, standby-to-parked-brake-off, parked-to-drive, brake-off-to-brake-on, brake-on-to-brake-off, drive-to-parked, blink-left, blink-right, blink-both, blink-none.

Channels: headlight, front-ring, brake, blinker-front-left, blinker-front-right, number-plates, blinker-rear-left, blinker-rear-right (or numeric 0–7).

logs

Extract service logs and Redis state snapshots as a compressed bundle (useful for bug reports).

lsc logs                         # All services, last 24h
lsc logs vehicle battery         # Specific services only
lsc logs --since 1h              # Last hour only
lsc logs --priority err          # Errors only

diag

Diagnostic commands for hardware inspection and control.

diag events flags

Shortcuts

Common commands are available as top-level shortcuts:

Provider enrollment CLI

The MDB also includes the separate connect administrative CLI. It does not start automatically or enable reporting. With a compatible installed client, run these commands explicitly:

connect register
connect code
connect wait
connect status

Use the code or pairing link to select a provider and approve the connection, then run connect wait to finish. Existing provider ownership and credentials are preserved. An existing working Sunshine connection does not require re-enrollment. The scooter needs HTTPS access to the rendezvous and provider and access to the provider's verified-TLS MQTT endpoint. Reachability depends on the network and APN. See the enrollment protocol.

Global Flags

--json              Output in JSON format (for scripting)
--redis-addr        Redis server address (default: 192.168.7.1:6379)
-v, --verbose       Enable verbose logging

Source

github.com/librescoot/lsc →

Event-service rules

ext

Manage event-service rules through the event-service RPC API on the selected Redis endpoint. The rules live in the service: there is no local rule-file fallback, and the CLI does not restart the service for you. A change takes effect after the next explicit restart, and ext show reports the current revision and whether a restart is pending.

Hibernation and web interface

lsc hibernate and lsc hibernate-for 8h coordinate shutdown from parked and begin power preparation directly from standby. Other vehicle states reject the request without retaining it for later. A relative duration needs no synchronized clock. lsd also provides a web interface.