Skip to content

repos: vshie: Add Odometer - #188

Merged
patrickelectric merged 1 commit into
bluerobotics:masterfrom
vshie:add-odometer
Nov 19, 2026
Merged

patrickelectric merged 1 commit into
bluerobotics:masterfrom
vshie:add-odometer

Conversation

@vshie

@vshie vshie commented Nov 18, 2026

Copy link
Copy Markdown
Collaborator

Adds a new extension: Odometer, a usage odometer and service record for BlueOS vehicles (ArduSub ROVs and ArduRover boats such as the BlueBoat).

What the extension does

  • Tracks total, armed and per-flight-mode hours, lifetime energy (from the autopilot's BATTERY_STATUS), distance travelled (GPS/EKF speed with an HDOP-aware noise floor), dive time on ArduSub, battery swaps and vehicle startups.
  • Per-thruster/motor run hours and average throttle, mapped from the autopilot's SERVOn_FUNCTION parameters (Motor1–8 on ArduSub, ThrottleLeft/Right on boats). Run time only counts while a thruster is actually driven.
  • Splits usage into sessions (one per power-on, or per hot battery swap) and flags hard-use sessions: peak current over 70 A (ArduSub) / 22 A (ArduRover), or a motor above 80 % throttle for more than 20 % of armed time.
  • Service record: repairs, replacements, inspections, notes, thruster sticking, added devices (with their own run hours), optional run-hour resets. Runs of the BlueOS Self Test extension are imported automatically when it's installed.
  • Instrument-panel UI (night / bench themes) with live gauges, mechanical counters and an oscilloscope view of voltage, CPU temperature and speed/depth; CSV and PDF export.
  • Cockpit widget (advertised through cockpit_extras.json) showing session distance, total hours and lifetime energy, plus counters streamed to Cockpit's data lake over WebSocket.
  • Finds the autopilot's MAVLink system ID and the BlueOS host automatically; data persists in /usr/blueos/extensions/odometer.

Files added

  • repos/vshie/odometer/metadata.json
  • repos/vshie/odometer/extension_logo.png (1024x1024)

repos/vshie/company_logo.png already exists and is not modified.

Links

Built via the standard BlueOS-Community/Deploy-BlueOS-Extension action. The Dockerfile carries the version / type / authors / company / readme / links / tags / permissions / requirements labels expected by the repository scraper. Tested on a BlueBoat (ArduRover 4.7.2, BlueOS 1.4.7): tracking, data migration from earlier versions, Self Test import and the Cockpit widget.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vshie

vshie commented Nov 19, 2026

Copy link
Copy Markdown
Collaborator Author

The failing Consolidate and Deploy check here isn't caused by this PR. Since 2026-11-14 the workflow fails on every run, including the daily deploy on master, at sudo apt install -y yarn ("Unable to locate package yarn"): the runner image no longer provides a yarn apt package. It stops before reading any metadata. #189 fixes the workflow; repos/vshie/odometer passes blueos_repository/check_metadata.py, and the "Test Python cleanliness" check passes.

@patrickelectric patrickelectric left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CI fixed in #189

@patrickelectric
patrickelectric merged commit 7d3e652 into bluerobotics:master Nov 19, 2026
1 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants