portapack-mayhem/mayhem-firmware

AIS Boats - Map View - Change "Speed" to "SoG" and "Alt" to "CoG"

Open

#2,784 opened on Sep 8, 2025

View on GitHub
 (2 comments) (0 reactions) (0 assignees)C (877 forks)auto 404
enhancementgood first issue

Repository metrics

Stars
 (5,160 stars)
PR merge metrics
 (Avg merge 6d 15h) (29 merged PRs in 30d)

Description

Description of the feature you're suggesting.

  1. In the Map view screen the label "Speed" is actually showing the "SoG" or Speed over Ground. This is what it is called in the AIS Rx screen.

  2. For boats there are generally two types of speed - SoG and Speed through the Water. They can be different because the water also moves with currents, etc.

  3. To clear up this confusion I would like to suggest that the label "Speed" be replaced with "SoG".

  4. I would also like to suggest that the Alt field be replaced with CoG, which is shown in the AIS Rx screen.

  5. I am not sure that AIS actually sends Altitude, or whether the Mayhem software receives this.

  6. There is no altitude shown in the AIS RX screen.

  7. As AIS is mainly used on the sea altitude is generally zero.

  8. The information that is generally required for a vessels is its CoG and SoG. Most marine GPS devices show these two fields.

  9. For these reasons Alt should be replaced with CoG if possible.

Anything else?

No response

Contributor guide

Research direction
Find the source code where 'Speed' and 'Alt' labels are defined for the AIS boat map view (likely in a UI related file). Change 'Speed' to 'SoG' and 'Alt' to 'CoG'. Verify that the AIS data structure includes SoG and CoG fields, and ensure the display matches the AIS Rx screen.
Tech stack
ccpp
Domain
backend
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitC/C++ compiler
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90