Dashboard Interface Documentation¶

Overview¶

The Dashboard Controller (DBC) provides the primary user interface for the scooter, displaying critical information such as speed, battery status, and navigation. It runs a Qt/QML-based UI application that communicates with other system components via Redis.

Implementation¶

The dashboard UI is implemented as a Qt/QML application (unu-dashboard-ui) that: - Runs on the DBC (Dashboard Controller) - Connects to Redis at 192.168.7.1:6379 in production (defaults to 127.0.0.1:6379, configurable via command-line options) - Subscribes to Redis pub/sub channels for real-time updates - Monitors vehicle state, battery status, engine ECU, GPS, and internet connectivity - Renders the user interface on the integrated display - Reads hardware serial number from /sys/fsl_otp/HW_OCOTP_CFG0 and /sys/fsl_otp/HW_OCOTP_CFG1 - Reads OS version from /etc/os-release and sets system dbc-version to VERSION_ID+BUILD_ID - Sets dashboard ready true only after successfully reading serial number - Stores hardware serial number in dashboard serial-number Redis key

Display Modes¶

The dashboard operates in three primary modes, controlled via the dashboard mode Redis key:

Note: The navigation-related functionality is not normally accessible and will not be triggered during normal use, but there is vestigial code from an abandoned implementation by unu. Information about navigation functionality is derived from the remaining code in the binary as well as an implementation demo video uploaded by unu's development partner.

Note: Debug mode is partially broken, the following documentation is based on binary analysis, but only the FPS / animation metrics have been triggered.

Debug Mode¶

The debug mode provides a development and diagnostic interface that is not intended for regular users. It displays:

• System logs and diagnostic messages
• Redis key values in real-time
• Service status information
• Performance metrics (like FPS)
• System version information

Activating Debug Mode¶

Debug mode can be activated by: 1. Push to the command list: LPUSH scooter:dashboard-mode debug 2. The dashboard uses BLPOP to read from this list and switches to debug view 3. The dashboard then writes the mode to dashboard:mode as confirmation

Debug Data Structure¶

The debug data is stored in a Redis sorted set:

ZRANGE dashboard:debug 0 -1 WITHSCORES

The values are other Redis keys to be displayed on the screen, e.g.

ZADD dashboard:debug 0 "aux-battery charge-status"

would show the charge-status of the 12V AUX battery on the screen. The scores indicate the priority. As many values as possible are fit on the screen, based on their score.

UI Components¶

Central Content¶

The central display area adapts based on the current mode:

Speedometer Display¶

The speedometer shows: - Current speed (km/h or mph based on user settings) - Energy recuperation status during braking - Throttle status indicators - Battery charge levels

Speed display can adapt to the user's preferred unit system (metric/imperial), but only metric is used in shipped scooters.

Navigation View¶

The navigation interface includes: - Interactive map with route visualization - Turn-by-turn instruction banners - Distance to destination - Estimated arrival information

The view adapts based on vehicle state: - Parked: Route overview mode - Driving: Tracking mode with upcoming instructions - Rerouting: Rerouting status display

Status Bar¶

The dashboard features a status bar at the top of the screen displaying:

• Current time (left side)
• Status icons (left-center)
• Total distance/odometer (right side)

Status Icons¶

The status bar displays several icons that indicate system status:

Connection Strength Indicator¶

The connection strength icon adapts based on multiple factors:

Internet Status Redis Keys¶

The connection status is determined by these Redis keys:

HGET internet status       # "connected" or "disconnected"
HGET internet unu-cloud    # "connected" or "disconnected"
HGET internet signal-quality  # 0-100 signal strength percentage
HGET internet access-tech  # Network type (LTE, UMTS, etc.)

Notification System¶

The dashboard displays various notifications for: - Battery status (low charge warnings, charging status) - System warnings (faults, errors) - Navigation events - Vehicle state changes

Redis Interface¶

Dashboard Service Keys¶

HGETALL dashboard

Navigation View States¶

The navigation view has several states that adapt based on vehicle status:

Theme Adaptation¶

The dashboard automatically switches between: - Dark theme (Speedometer mode) - Light theme (Navigation mode)

Theme transitions include animation timing for smooth visual changes.

Behavior Patterns¶

Startup Sequence¶

1. Dashboard application starts (unu-dashboard-ui)
2. Connects to Redis (192.168.7.1:6379 in production, defaults to 127.0.0.1:6379, configurable via -b and -p options)
3. Subscribes to all service Redis pub/sub channels
4. Reads OS version from /etc/os-release and sets system dbc-version to VERSION_ID+BUILD_ID
5. Reads hardware serial number from /sys/fsl_otp/HW_OCOTP_CFG0 and /sys/fsl_otp/HW_OCOTP_CFG1
6. Sets dashboard serial-number to combined serial number value
7. Sets dashboard ready true (only if serial number read succeeds, otherwise logs warning)
8. Defaults to Speedometer mode
9. Starts periodic polling timer for non-published properties

Mode Switching Logic¶

Mode switching occurs when: - Navigation is started/stopped (via LPUSH scooter:navigation start/stop) - Debug mode is explicitly enabled/disabled (via LPUSH scooter:dashboard-mode debug) - Dashboard reads mode commands from Redis lists using BLPOP with infinite timeout

Navigation Behavior¶

The navigation system responds to several states: - Navigation triggered by LPUSH scooter:navigation start (using the Mapbox API - doesn't work anymore) - Navigation stopped by LPUSH scooter:navigation stop - Automatic rerouting when deviating from route (doesn't seem work) - Trip summary displayed upon arrival (assumed from decompilation, could not trigger)

Notification Types¶

The dashboard displays various notification types:

Command-Line Options¶

The dashboard UI application accepts these command-line options that affect externally observable behavior:

System Integration¶

Files Read¶

• /sys/fsl_otp/HW_OCOTP_CFG0 - Hardware serial number (first part, hex format)
• /sys/fsl_otp/HW_OCOTP_CFG1 - Hardware serial number (second part, hex format)
• /etc/os-release - OS version (VERSION_ID and BUILD_ID fields)

System Commands¶

• poweroff - Executed during shutdown sequence (can be disabled with --disable-poweroff)

Log Output Examples¶

• "Could not read serial number. NOT setting dashboard:ready = true" - Serial number read failure
• "Could not load translations for any of the languages requested: [list]" - Translation loading failure
• "Power off is disabled." - Poweroff disabled via command-line flag
• "Could not power off the system!" - Poweroff command failed
• "Could not set up keep-alive socket, Redis connection handling might not work properly" - Socket setup issue

Redis Dependencies¶

The dashboard UI depends on these Redis services: