rov-autonomy/widgets

Argonaut 3 — Cockpit DIY Widgets

Requirements

• Cockpit native desktop app v1.17.0 (Windows .exe installer)
• The BlueOS browser extension version does NOT support DIY widgets
• Download from: https://github.com/bluerobotics/cockpit/releases/tag/v1.17.0

How to install a widget

1. Open the Cockpit native desktop app
2. Connect to the vehicle / VM (100.84.141.120 for dev VM)
3. Enter edit mode (pencil icon, top right)
4. Click Add Widget at the bottom of the screen
5. Scroll right to find the </> DIY widget — drag it onto the view
6. Click the gear icon on the widget to open the editor
7. Click Import and select the .json file for the widget you want
8. The widget will load immediately

Note: Widget files are .json format (not .html). Cockpit expects a JSON file with html, css, and js fields.

Widget index

File	Widget	Notes
w0_data_lake_inspector.json	Data Lake Inspector	Diagnostic — shows all data lake variables. Not production.
w1_system_health_indicator.json	System Health Indicator	Traffic light GREEN/AMBER/RED. Reads rov_failsafe from data lake.
w2_mission_status.json	Mission Status	Progress bar + state. Reads rov_mission_state and rov_mission_progress.
w3_abort_button.json	Abort Button	Confirm dialog → POST /abort to FastAPI. Edit FASTAPI_HOST before use.
w4_mission_setup_button.json	Mission Setup Button	Opens setup page in new tab. Edit SETUP_URL before use.
w5_battery_return_budget.json	Return Budget	Headroom warning. Reads SYS_STATUS/battery_remaining (native) + rov_return_budget.

Config values to edit before field use

In w3_abort_button.json (line 1 of the JS section):

var FASTAPI_HOST = 'http://blueos.local:8081';

In w4_mission_setup_button.json (line 1 of the JS section):

var SETUP_URL = 'http://blueos.local:8081/setup';

Both values are correct for real hardware. For the dev VM, replace blueos.local with the VM Tailscale IP.

Widget data dependencies

Widget	Works without backend?	Requires
W0 Data Lake Inspector	Yes — shows live MAVLink data immediately	Vehicle connected
W1 System Health	Shows "waiting" until bridge runs	NAMED_VALUE bridge node
W2 Mission Status	Shows "waiting" until bridge runs	NAMED_VALUE bridge node
W3 Abort Button	Button visible, POST will fail	FastAPI backend container
W4 Setup Button	Button visible, opens 404	Extension backend serving setup page
W5 Return Budget	Battery% shows live, budget shows 0%	FastAPI backend for return budget calc