Settings Reference

This reference lists the settings available in Librescoot 1.2.x. For everyday changes, use the dashboard or the settings controls described in the Handbook. Settings can also be inspected or changed with lsc.

Settings marked user-visible are listed below. All other settings are in the collapsed Advanced settings section. Service Mode temporarily overrides several keys and stays active across reboots.

Settings

alarm-service

Setting	Description	Default	Values / range
Alarm Duration alarm.duration	Duration in seconds for alarm sound	30	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

dbc-backlight

Setting	Description	Default	Values / range
Backlight dashboard.backlight-mode	Display backlight level (auto = ambient light sensor)	"auto"	Auto (auto), Low (low), Medium (medium), High (high)

scootui

Setting	Description	Default	Values / range
Battery Display dashboard.battery-display-mode	Battery display mode	"percentage"	Percentage (percentage), Range (range), Icons Only (icon)
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
Milestone Celebrations dashboard.milestone-celebrations	Celebrate odometer milestones (every 500 km) and special-number easter eggs with on-screen confetti and a banner when parking. Disable to turn all milestone celebrations off.	false	bool
Default Screen dashboard.mode	Default screen mode	"speedometer"	Speedometer (speedometer), Navigation (navigation), Debug (debug)
Power Display dashboard.power-display-mode	Power display unit	"kw"	Kilowatts (kw), Amps (amps)
12V Battery dashboard.show-aux-battery	12V battery charge icon visibility in the status bar (warning = only when SoC <= 50%)	"warning"	Always (always), When Low (warning), Never (never)
Bluetooth Indicator dashboard.show-bluetooth	Bluetooth indicator visibility	"active-or-error"	Always (always), Active or Error (active-or-error), Error Only (error), Never (never)
CBB Battery dashboard.show-cb-battery	CBB charge icon visibility in the status bar (warning = only when SoC <= 50%)	"warning"	Always (always), When Low (warning), Never (never)
Show Clock dashboard.show-clock	Clock visibility	"always"	Always (always), Never (never)
Cloud Indicator dashboard.show-cloud	Cloud indicator visibility	"active-or-error"	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	"active-or-error"	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)
Horn While Seatbox Open scooter.horn-when-seatbox-open	Allow the manual horn button to sound while the seatbox is open and the scooter is unlocked. Disabled by default so the open seat lid resting on the button does not honk.	false	bool

Advanced settings

Show advanced settings (65)

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
Buttons Alarm Trigger alarm.trigger.buttons	Enable brake/horn/seatbox button presses as an alarm trigger source	true	bool
Handlebar Alarm Trigger alarm.trigger.handlebar	Enable handlebar lock-sensor / position as an alarm trigger source	true	bool
Motion Alarm Trigger alarm.trigger.motion	Enable BMX055 motion as an alarm trigger source	true	bool

battery-service

Setting	Description	Default	Values / range
Aux-Low Keep-Active Enter Threshold scooter.battery-aux-low-keep-active-enter-mv	Aux battery voltage (mV) below which the keep-active-on-seatbox-open override engages automatically	11500	0–any mV
Aux-Low Keep-Active Exit Threshold scooter.battery-aux-low-keep-active-exit-mv	Aux battery voltage (mV) at or above which the aux-low keep-active override disengages (must be > enter threshold)	12000	0–any mV
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	LTE attach + data bearer APN. Empty = use SIM operator defaults.	""	string
Cellular APN auth cellular.auth	APN authentication type for data bearer. One of: none, pap, chap.	"none"	string
Cellular APN password cellular.password	APN password (PAP/CHAP authentication). Empty = none.	""	string
SIM PIN cellular.sim-pin	PIN for SIM unlock and lock-enable (4-8 digits, empty = leave SIM as-is)	""	string
Cellular APN username cellular.username	APN username (PAP/CHAP authentication). Empty = none.	""	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.	"suspend"	Run (stay awake) (run), Suspend (auto-sleep) (suspend)
Hibernation Timer pm.hibernation-timer	Hibernation timeout in seconds (0=disabled). Values between 1 and 299 are clamped up to the 300 second floor.	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
Suspend While Online pm.suspend-when-online	Allow a locked scooter with a main battery inserted to suspend while it has internet connectivity. When false, it stays awake so cloud commands can still reach it.	true	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
Recent Destination Label dashboard.recent-destinations.0.label	Recent destination label	not set	string
Recent Destination Latitude dashboard.recent-destinations.0.latitude	Latitude	not set	-90–90
Recent Destination Longitude dashboard.recent-destinations.0.longitude	Longitude	not set	-180–180
Recent Destination Used At dashboard.recent-destinations.0.used-at	Last used timestamp	not set	string
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
Service Mode Active dashboard.service-mode-active	Runtime status: service mode is active. Published by settings-service; not user-settable.	false	read-only, reset on reboot
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	true	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)
Handlebar Unlocked scooter.handlebar-unlocked	When true, the handlebar lock latch is released and auto re-lock is suppressed. Set by the service-mode overlay; transient so it never persists.	false	reset on reboot
Lock on Bluetooth disconnect scooter.lock-on-bluetooth-disconnect-seconds	Grace period in seconds before locking the scooter after the connected phone disconnects while parked (0=disabled)	0	0–any seconds
USB Link Policy scooter.usb0-policy	MDB to DBC USB link behavior. auto brings usb0 down when the scooter is in standby (default). always-on keeps usb0 up regardless of dashboard state for installer/diag reachability — transient, so the override lasts only until the next reboot.	"auto"	Always On (always-on), Auto (track dashboard) (auto), reset on reboot