Settings Reference

This reference lists the settings available in Librescoot 1.0.x. For everyday changes, use the dashboard or the settings controls described in the Handbook. Settings can also be inspected or changed with lsc. The markers identify settings added or changed in a patch release.

Available from this patch Definition changed in this patch

Settings marked user-visible are listed below. All other settings are in the collapsed Advanced settings section.

Settings

alarm-service

Setting	Description	Default	Values / range
Alarm Duration alarm.duration	Duration in seconds for alarm sound	60	0–300 seconds
Alarm alarm.enabled	Enable or disable the alarm system	true	bool
Alarm Horn alarm.honk	Enable horn during alarm trigger	false	bool

battery-service

Setting	Description	Default	Values / range
Dual Battery Mode scooter.dual-battery	Enable dual battery mode (battery 1 active instead of idle)	false	bool

scootui

Setting	Description	Default	Values / range
Battery Display dashboard.battery-display-mode	Battery display mode	"percentage"	Percentage (percentage), Range (range)
Blinker Style dashboard.blinker-style	Blinker indicator style	"icon"	Icon (icon), Overlay (overlay)
Language dashboard.language	Dashboard UI language	"en"	string
Traffic Overlay dashboard.map.traffic-overlay	Show live traffic overlay on the map (requires online tiles)	false	bool
Map Type dashboard.map.type	Map tile source	"offline"	Online (online), Offline (offline)
Auto-download Maps dashboard.maps.auto-download	Automatically download map updates when available (uses mobile data)	false	bool
Map Update Check dashboard.maps.check-for-updates	Automatically check for map tile updates (weekly when online)	false	bool
Default Screen dashboard.mode	Default screen mode	"speedometer"	Speedometer (speedometer), Navigation (navigation)
Power Display dashboard.power-display-mode	Power display unit	"kw"	Kilowatts (kw), Amps (amps)
Bluetooth Indicator dashboard.show-bluetooth	Bluetooth indicator visibility	"active-or-error"	Always (always), Active or Error (active-or-error), Error Only (error), Never (never)
Show Clock dashboard.show-clock	Clock visibility	"always"	Always (always), Never (never)
Cloud Indicator dashboard.show-cloud	Cloud indicator visibility	"never"	Always (always), Active or Error (active-or-error), Error Only (error), Never (never)
GPS Indicator dashboard.show-gps	GPS indicator visibility	"error"	Always (always), Active or Error (active-or-error), Error Only (error), Never (never)
Internet Indicator dashboard.show-internet	Internet indicator visibility	"never"	Always (always), Active or Error (active-or-error), Error Only (error), Never (never)
Temperature dashboard.show-temperature	Ambient temperature widget visibility (warning = only when below 10 °C)	"warning"	Always (always), Warning Only (warning), Never (never)
Theme dashboard.theme	UI theme	"auto"	Light (light), Dark (dark), Auto (auto)

vehicle-service

Setting	Description	Default	Values / range
DBC Blinker LED scooter.dbc-blinker-led	Blink DBC boot LED in sync with blinkers (green for single, red for hazards)	"disabled"	Enabled (enabled), Disabled (disabled)

Advanced settings

Show advanced settings (49)

These settings are intended for setup, diagnostics, or service configuration.

alarm-service

Setting	Description	Default	Values / range
Hair Trigger alarm.hairtrigger	Enable hair trigger mode (immediate short alarm on first motion)	false	bool
Hair Trigger Duration alarm.hairtrigger-duration	Duration in seconds for hair trigger alarm	3	1–30 seconds
L1 Cooldown Duration alarm.l1-cooldown	Level 1 cooldown duration in seconds	15	1–60 seconds
Seatbox Alarm Trigger alarm.seatbox-trigger	Trigger alarm on unauthorized seatbox opening	true	bool

battery-service

Setting	Description	Default	Values / range
Keep Battery Active On Seatbox Open scooter.battery-keep-active-on-seatbox-open	Keep a running battery active when the seatbox opens instead of deactivating it	false	bool
Max Battery Voltage Delta scooter.max-voltage-delta	Maximum voltage delta between batteries for dual battery activation (0 to disable)	1000	0–any mV

dbc-dispatcher

Setting	Description	Default	Values / range
Dashboard App dashboard.app	Display application to launch on DBC boot	"scootui-qt"	ScootUI (Qt) (scootui-qt), ScootUI (TUI) (scootui-tui)

ecu-service

Setting	Description	Default	Values / range
Boost Mode engine-ecu.boost	Enable motor boost mode	false	bool
KERS engine-ecu.kers	Kinetic energy recovery system (KERS)	"enabled"	Enabled (enabled), Disabled (disabled)
KERS Power engine-ecu.kers-power	KERS regeneration current	not set	0–65535 mA
KERS Power (Dual Battery) engine-ecu.kers-power-dual	KERS regeneration current when both batteries are active	not set	0–65535 mA

modem-service

Setting	Description	Default	Values / range
Cellular APN cellular.apn	Cellular APN string	not set	string
SIM PIN cellular.sim-pin	PIN for SIM unlock and lock-enable (4-8 digits, empty = leave SIM as-is)	""	string

pm-service

Setting	Description	Default	Values / range
Default Power State pm.default-state	Default power target state when idle. 'run' keeps the system awake, 'suspend' triggers auto-suspend after the pre-suspend delay.	"run"	Run (stay awake) (run), Suspend (auto-sleep) (suspend)
Hibernation Timer pm.hibernation-timer	Hibernation timeout in seconds	259200	0–any seconds
Scheduled Hibernation Cron pm.scheduled-hibernate-cron	5-field cron expression (minute hour day-of-month month day-of-week) defining when scheduled hibernation fires. Empty disables.	""	string
Scheduled Hibernation Duration pm.scheduled-hibernate-duration	How long the scheduled hibernation should last. The system wakes at fire-time + this duration (wall-clock target wake time).	"0s"	0–any
Scheduled Hibernation pm.scheduled-hibernate-enabled	Enable scheduled hibernation defined by pm.scheduled-hibernate-cron and pm.scheduled-hibernate-duration	false	bool
Wake Timer Ack Timeout pm.wake-timer-ack-timeout	How long pm-service waits for the nRF52 to confirm a wake-timer was armed before aborting hibernation	"10s"	0–any
Wake Timer Max pm.wake-timer-max-seconds	Safety cap on the wake-timer duration sent to the nRF52. Requests above this value are clamped.	604800	60–604800 seconds

scootui

Setting	Description	Default	Values / range
Hop-on Combo dashboard.hop-on-combo	User-defined hop-on / hop-off unlock combo as pipe-delimited tokens (e.g. 'LB|RB|HORN'). Empty = no combo defined. Managed by the dashboard learning UI.	""	string
Map Render Mode dashboard.map.render-mode	Map rendering mode	"vector"	Vector (vector), Raster (raster)
Maps Available dashboard.maps-available	Whether offline map tiles are available (system-managed)	false	read-only
Navigation Available dashboard.navigation-available	Whether full navigation is available (maps + routing engine, system-managed)	false	read-only
Saved Location Created At dashboard.saved-locations.0.created-at	Creation timestamp	not set	string
Saved Location Label dashboard.saved-locations.0.label	Location label	not set	string
Saved Location Last Used dashboard.saved-locations.0.last-used-at	Last used timestamp	not set	string
Saved Location Latitude dashboard.saved-locations.0.latitude	Latitude	not set	-90–90
Saved Location Longitude dashboard.saved-locations.0.longitude	Longitude	not set	-180–180
Show Raw Speed dashboard.show-raw-speed	Show raw uncorrected speed from ECU	false	bool
Valhalla URL dashboard.valhalla-url	Valhalla routing service endpoint	"http://localhost:8002/"	url

settings-service

Setting	Description	Default	Values / range
Log Server URL scooter.logserver	systemd-journal-remote URL to ship journald entries to (e.g. http://logs.example:19532). Unset or empty disables log shipping.	not set	url

update-service

Setting	Description	Default	Values / range
DBC Release Channel updates.dbc.channel	Release channel override for DBC. Transient: lives in Redis only; on reboot update-service falls back to the channel inferred from the installed image.	not set	Stable (stable), Testing (testing), Nightly (nightly), reset on reboot
DBC Update Check Interval updates.dbc.check-interval	Time between update checks for DBC (0 to disable)	"6h"	0–any
DBC Update Dry Run updates.dbc.dry-run	Enable dry-run mode for DBC updates (no reboot)	false	bool
DBC Last Update Check updates.dbc.last-check-time	Last time DBC checked for updates (ISO8601 timestamp)	not set	string
DBC Update Method updates.dbc.method	Update method for DBC	"delta"	Delta (delta), Full (full)
DBC Releases URL updates.dbc.releases-url	Release index base URL for DBC	"https://downloads.librescoot.org/releases"	url
MDB Release Channel updates.mdb.channel	Release channel override for MDB. Transient: lives in Redis only; on reboot update-service falls back to the channel inferred from the installed image.	not set	Stable (stable), Testing (testing), Nightly (nightly), reset on reboot
MDB Update Check Interval updates.mdb.check-interval	Time between update checks for MDB (0 to disable)	"6h"	0–any
MDB Update Dry Run updates.mdb.dry-run	Enable dry-run mode for MDB updates (no reboot)	false	bool
MDB Last Update Check updates.mdb.last-check-time	Last time MDB checked for updates (ISO8601 timestamp)	not set	string
MDB Update Method updates.mdb.method	Update method for MDB	"delta"	Delta (delta), Full (full)
Orchestrate DBC Updates updates.mdb.orchestrate-dbc	Automatically power on DBC and trigger update checks when a newer DBC release is available	false	bool
MDB Releases URL updates.mdb.releases-url	Release index base URL for MDB	"https://downloads.librescoot.org/releases"	url

vehicle-service

Setting	Description	Default	Values / range
Auto Standby Timeout scooter.auto-standby-seconds	Auto-lock timeout when parked in seconds (0=disabled)	900	0–any seconds
Brake Hibernation scooter.brake-hibernation	Enable brake lever hibernation	"enabled"	Enabled (enabled), Disabled (disabled)
Horn scooter.enable-horn	Horn enable mode	"true"	Always (true), Disabled (false), In Drive Only (in-drive)
USB Link Policy scooter.usb0-policy	MDB to DBC USB link behavior. always-on keeps usb0 up regardless of dashboard state so installer and diag tools stay reachable. auto brings usb0 down when the scooter is in standby and only needs to be used on units with WWAN as a backup channel.	"auto"	Always On (always-on), Auto (track dashboard) (auto)