librescoot-update (update-service)¶

Description¶

Manages over-the-air (OTA) updates for MDB and DBC components. Runs as two separate instances (one per component), each checking a release index for available updates, downloading them via Mender, and orchestrating installation with safe reboot scheduling. Uses a power inhibitor client to prevent updates during critical vehicle operations.

Command-Line Options¶

  --component string         Component to update: mdb or dbc (required)
  --redis-addr string        Redis server address (default: localhost:6379)
  --channel string           Update channel: stable, testing, nightly (default: nightly; auto-detected from installed version)
  --releases-url string      Release index base URL (default: https://downloads.librescoot.org/releases)
  --check-interval duration  Interval between update checks; 0 to disable (default: 6h)
  --download-dir string      OTA file download directory (default: /data/ota/{component})
  --dry-run                  Log reboot actions instead of executing them
  --boot-update              Enable boot partition updates
  --boot-mount string        Boot partition mount point (default: /uboot)
  --boot-device string       U-Boot device path (auto-detected if empty)
  --boot-dtb string          DTB filename (default: librescoot-{component}.dtb)
  --boot-uboot-seek int64    512-byte blocks to seek before writing U-Boot (default: 2)

CLI flags override Redis settings. --component and --redis-addr are CLI-only.

Systemd Units¶

Binary: /usr/bin/update-service

Redis Operations¶

Hash: ota (written)¶

All fields are namespaced by component (mdb or dbc):

Published channel: ota - All field updates are published atomically on state transitions

Hash: settings (read/written)¶

Fields read: - updates.{component}.channel — update channel (stable, testing, nightly) - updates.{component}.check-interval — check interval (e.g. 6h, 30m) - updates.{component}.releases-url — release index base URL - updates.{component}.dry-run — dry-run mode (true/false) - updates.{component}.method — update method (full or delta) - updates.mdb.orchestrate-dbc — MDB-only: whether MDB orchestrates DBC updates

Fields written: - updates.{component}.last-check-time — RFC3339 timestamp of last update check

Subscribed channel: settings - All updates.{component}.* field changes are applied at runtime

Hash: version:{component} (read)¶

• version_id — installed version string (used to detect channel and for delta base)
• variant_id — hardware variant identifier

Lists consumed (BRPOP)¶

• scooter:update:{component} — component-specific commands:
• check-now — trigger immediate update check
• update-from-file:/path/to/file.mender — install from local file
• update-from-file:/path/to/file.mender:sha256:<hex> — with checksum
• update-from-url:https://... — install from URL

• update-from-url:https://...:sha256:<hex> — with checksum

• scooter:update — shared lifecycle commands (both instances listen):

• start-dbc — signal DBC update is starting
• complete-dbc — signal DBC update completed

Lists published (LPUSH)¶

• scooter:power → reboot — triggers system reboot after MDB update installs

Hash: power:inhibits (written via inhibitor client)¶

Written during download/install to prevent suspend/hibernate. See pm-service docs for inhibitor details.

Configuration via Redis¶

# Change update channel
redis-cli HSET settings updates.mdb.channel stable
redis-cli PUBLISH settings updates.mdb.channel

# Change check interval
redis-cli HSET settings updates.dbc.check-interval 12h
redis-cli PUBLISH settings updates.dbc.check-interval

# Switch to delta updates
redis-cli HSET settings updates.mdb.method delta
redis-cli PUBLISH settings updates.mdb.method

# Enable dry-run
redis-cli HSET settings updates.dbc.dry-run true
redis-cli PUBLISH settings updates.dbc.dry-run

Commands¶

# Force immediate check (both instances)
redis-cli LPUSH scooter:update check-now

# Force check on one component only
redis-cli LPUSH scooter:update:mdb check-now

# Install from local file
redis-cli LPUSH scooter:update:dbc "update-from-file:/data/ota/librescoot-dbc-nightly-20251212T024719.mender"

# Install from URL
redis-cli LPUSH scooter:update:mdb "update-from-url:https://example.com/update.mender:sha256:abc123..."

Update Method¶

• full — downloads and installs a complete Mender artifact
• delta — downloads a delta patch relative to the current version, applies it with xdelta; falls back to full if no base file exists

Configured via updates.{component}.method in Redis settings. Default is delta.

Reboot Behavior¶

• MDB: waits until vehicle is in stand-by state for 3 minutes, then triggers reboot via scooter:power
• DBC: sets status to pending-reboot; reboot applied on next natural power-on (no active trigger)
• With --dry-run: logs reboot intent only

File Locations¶

Building¶

make dist          # ARM dist binary → update-service-arm-dist
make host          # Host binary for development
make install       # Install to /usr/bin/update-service
make tidy fmt test # Lint and test

Related Documentation¶

• LibreScoot Services
• Power Management — inhibitor integration
• UMS Service — USB-based update delivery