Skip to content

repos: vshie: Add Marine Magnetics Explorer#171

Merged
patrickelectric merged 2 commits intobluerobotics:masterfrom
vshie:add-marine-magnetics-explorer
May 7, 2026
Merged

repos: vshie: Add Marine Magnetics Explorer#171
patrickelectric merged 2 commits intobluerobotics:masterfrom
vshie:add-marine-magnetics-explorer

Conversation

@vshie
Copy link
Copy Markdown
Collaborator

@vshie vshie commented May 7, 2026

Adds a new extension: Marine Magnetics Explorer, a BlueOS interface for the Marine Magnetics Explorer magnetometer over USB serial.

What the extension does

  • Auto-connects to a saved serial port on startup and reconnects to the last-known device 5 s after extension launch.
  • Configures the Explorer cycle rate (Off / 4 Hz / 2 Hz / 1 Hz) from the UI, runs auto-tune on/off, syncs the magnetometer's RTC to GPS time, and reads the towfish serial number on connect.
  • Logs every received sentence to a session-based CSV (with vessel + estimated towfish layback position derived from GLOBAL_POSITION_INT and VFR_HUD heading) plus a paired RawMag*.txt / RawGPS*.txt (synthesised GPRMC/GPGGA/GPGSA/GPGSV) for use with surveyor toolchains that expect raw NMEA.
  • Computes a rolling moving average over a configurable window (4 / 10 / 15 / 30 / 60 / 120 s) and the deviation from it, with a user-settable alarm threshold and an enable/disable toggle. The alarm fires as a 5-second one-shot pulse on the rising edge and re-arms once the deviation drops back below the setpoint, so it tracks anomalies rather than steady-state offsets.
  • Streams MAG_FIELD, MAG_SIGNAL, MAG_DEPTH, MAG_QUAL, MAG_DEV, and MAG_ALRM NAMED_VALUE_FLOAT messages to the autopilot for Cockpit / dashboards.
  • Ships a standalone /widget endpoint suitable for embedding in Cockpit iframes, with the same alarm/threshold/window controls in the top-left corner.

Files added

  • repos/vshie/marine-magnetics-explorer/metadata.json
  • repos/vshie/marine-magnetics-explorer/extension_logo.png (1024x1024)

repos/vshie/company_logo.png already exists from the Airmar WX submission and is not modified.

Links

Built via the standard BlueOS-Community/Deploy-BlueOS-Extension action (multi-arch: amd64, arm/v7, arm64). The Dockerfile carries both the legacy org.blueos.* labels and the unprefixed version / type / authors / company / readme / links / tags / permissions labels expected by the repository scraper.

Made with Cursor

Adds metadata.json and 1024x1024 extension_logo.png for the
Marine Magnetics Explorer extension under repos/vshie/.

Co-authored-by: Cursor <cursoragent@cursor.com>
"name": "Marine Magnetics Explorer",
"website": "https://github.com/vshie/BlueOS-Marine-Magnetics-Explorer",
"docker": "vshie/blueos-marine-magnetics-explorer",
"description": "Marine Magnetics Explorer magnetometer logging and live monitoring \u2014 CSV + raw NMEA logs, deviation alarm, layback estimation, and NAMED_VALUE_FLOAT bursts to the autopilot."
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.

The unicode \u2014 will probably not render in the markdown viewer.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Good catch — fixed in 5e0f5c9 by replacing the \u2014 JSON escape with a literal UTF-8 em-dash ().

Address PR review feedback: replace the JSON \u2014 escape in the
description with a literal UTF-8 em-dash character so it renders
correctly in markdown viewers that don't decode JSON escapes.

Co-authored-by: Cursor <cursoragent@cursor.com>
@patrickelectric patrickelectric merged commit 5f7f9d6 into bluerobotics:master May 7, 2026
2 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