System Console UI
The host console manages installation and the machine supporting the robot. It is a React/Vite frontend backed by FastAPI. Navigation uses hash routes; unknown routes fall back to Overview. The top bar exposes primary pages and a More menu, including links to Robot UI and VS Code. API health and WebSocket state are independent indicators.
Page map
| Page | Task | Relevant backend surfaces |
|---|---|---|
| Overview | Inspect resources and SDK service status | /api/health, /api/system/summary, /api/system/resources, /api/system/services |
| HRSDK | Inspect configuration, containers and configuration updates | /api/hrsdk/summary, /api/hrsdk/config, /api/hrsdk/containers, /api/hrsdk/configs |
| Setup | Prepare installation, check prerequisites and credentials, install or switch release | /api/setup/status, /api/setup/preflight, /api/setup/draft, /api/setup/credentials/validate, /api/setup/install, /api/releases |
| Network | Inspect adapters, routes, internet, Ethernet and Wi-Fi | /api/network/* |
| Audio | Select devices, control levels and channel routing | /api/audio/* |
| Devices | Inspect USB devices | /api/usb/tree |
| Servo | Inspect ports/configuration, scan, read/write registers and move servos | /api/servos/* |
| Jetson | Inspect perception host and provision/update/restart | /api/jetson/* |
| Logs | Inspect host service logs | /api/system/services/{unit}/logs |
| Settings | Remote desktop and console update state | /api/settings/rustdesk, /api/settings/system-console/update |
Read status before acting
- Open Overview and confirm API connectivity.
- Check the SDK service state separately from host resource availability.
- Open the relevant page and inspect its current state before applying a change.
- For asynchronous operations, follow progress to a terminal task result. Refreshing the page does not cancel a server task.
- Recheck the affected resource after completion; retain logs when a task fails.
Network changes
Ethernet endpoints include device selection, apply, confirm, rollback and per-device testing. Confirm connectivity before completing a change; changing the interface used by your browser or SSH session can disconnect that session. Wi-Fi exposes connect, forget, disconnect and rescan operations. Internet sharing has separate status, enable and disable endpoints.
Audio routing
The backend distinguishes default-device selection, application input/output choices, volume, channel maps, routing connections, presets, test tones, reset and container visibility checks. A host device appearing in the list does not prove container access. Routing updates run as tasks and trigger refreshes of device, routing and container-check state.
Servo actions
Port scans, register reads, configuration writes, neutral reset and motion are separate operations. Select the correct controller and robot configuration before writing or moving. A successful API request is not proof that the intended physical motor moved. Detailed field definitions are in the console request model reference.
Evidence and coverage
Sources: hr_system_console/frontend/src/App.jsx, frontend/src/pages, and api/system_console/main.py. Use the detailed installation/SDK, network/audio, and diagnostics/Jetson/settings walkthroughs for controls, expected results and recovery.