{"id":15031627,"url":"https://github.com/aerorust/nmea","last_synced_at":"2025-10-03T22:16:47.965Z","repository":{"id":42014962,"uuid":"80834837","full_name":"AeroRust/nmea","owner":"AeroRust","description":"NMEA 0183 - for communication between marine electronics such as echo sounder, sonars, anemometer, gyrocompass, autopilot, GNSS receivers and many other types of instruments. Defined and controlled by the National Marine Electronics Association (NMEA)","archived":false,"fork":false,"pushed_at":"2025-09-01T09:07:42.000Z","size":973,"stargazers_count":88,"open_issues_count":30,"forks_count":49,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-10-02T12:51:40.738Z","etag":null,"topics":["embedded","galileo","glonass","gps","hacktoberfest","marine-robotics","nmea","no-std","protocol","rust","rustlang"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/nmea","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"flxo/rust-nmea","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AeroRust.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.txt","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-03T14:11:20.000Z","updated_at":"2025-09-26T19:18:40.000Z","dependencies_parsed_at":"2023-12-21T09:32:40.009Z","dependency_job_id":"df5fbbfb-e9c7-4db0-a0eb-f900050c1c32","html_url":"https://github.com/AeroRust/nmea","commit_stats":{"total_commits":441,"total_committers":35,"mean_commits":12.6,"dds":0.7369614512471656,"last_synced_commit":"832895945a82f5248473d0809dca46d805541132"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/AeroRust/nmea","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AeroRust%2Fnmea","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AeroRust%2Fnmea/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AeroRust%2Fnmea/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AeroRust%2Fnmea/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AeroRust","download_url":"https://codeload.github.com/AeroRust/nmea/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AeroRust%2Fnmea/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278235194,"owners_count":25953297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["embedded","galileo","glonass","gps","hacktoberfest","marine-robotics","nmea","no-std","protocol","rust","rustlang"],"created_at":"2024-09-24T20:16:12.941Z","updated_at":"2025-10-03T22:16:47.960Z","avatar_url":"https://github.com/AeroRust.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [NMEA][doc]\n\n[![Version](https://img.shields.io/crates/v/nmea.svg)](https://crates.io/crates/nmea)\n[![Build Status](https://github.com/AeroRust/nmea/actions/workflows/ci.yml/badge.svg)](https://github.com/AeroRust/nmea/actions/workflows/ci.yml)\n[![License Apache-2](https://img.shields.io/crates/l/nmea.svg)](./LICENSE.txt)\n\n[Complete documentation can be found on www.docs.rs/nmea][doc]\n\n## NMEA 0183 sentence parser\n\nSupported sentences (alphabetically ordered):\n\n\n- `AAM` - Waypoint Arrival Alarm (feature: `waypoint`)\n- `ALM` - GPS Almanac Data (feature: `GNSS`)\n- `APA` - Autopilot Sentence \"A\" (feature: `GNSS`)\n- `BOD` - Bearing - Waypoint to Waypoint (feature: `waypoint`)\n- `BWC` - Bearing \u0026 Distance to Waypoint - Great Circle (feature: `waypoint`)\n- `BWW` - Bearing - Waypoint to Waypoint (feature: `waypoint`)\n- `DBK` - Depth Below Keel (feature: `water`)\n- `DBS` - Depth Below Surface (feature: `water`)\n- `DPT` - Depth of Water (feature: `water`)\n- `GBS` - GPS Satellite Fault Detection (feature: `GNSS`)\n- `GGA` - * Global Positioning System Fix Data (feature: `GNSS`)\n- `GLL` - * Geographic Position - Latitude/Longitude (feature: `GNSS`)\n- `GNS` - * Fix data (feature: `GNSS`)\n- `GSA` - * GPS DOP and active satellites (feature: `GNSS`)\n- `GST` - GPS Pseudorange Noise Statistics (feature: `GNSS`)\n- `GSV` - * Satellites in view (feature: `GNSS`)\n- `HDT` - Heading - True (feature: `other`)\n- `MDA` - Meterological Composite (feature: `other`)\n- `MTW` - Mean Temperature of Water (feature: `water`)\n- `MWV` - Wind Speed and Angle (feature: `other`)\n- `RMC` - * Recommended Minimum Navigation Information (feature: `GNSS`)\n- `RMZ` - PGRMZ - Garmin Altitude (feature: `vendor-specific`)\n- `TTM` - Tracked target message (feature: `radar`)\n- `TXT` - * Text message (feature: `other`)\n- `VHW` - Water speed and heading (feature: `water`)\n- `VTG` - * Track made good and Ground speed (feature: `GNSS`)\n- `WNC` - Distance - Waypoint to waypoint (feature: `waypoint`)\n- `ZDA` - Time \u0026 Date - UTC, day, month, year and local time zone (feature: `other`)\n- `ZFO` - UTC \u0026 Time from origin Waypoint (feature: `waypoint`)\n- `ZTG` - UTC \u0026 Time to Destination Waypoint (feature: `waypoint`)\n\n**\\* [`Nmea::parse()`] supported sentences**\n\n[`Nmea::parse()`]: https://docs.rs/nmea/latest/nmea/struct.Nmea.html#method.parse\n\n## How to contribute\n\nWe have an ongoing effort to support as many sentences from `NMEA 0183` as possible,\nstarting with the most well-known.\nIf you'd like to contribute by writing a parser for a given message, check out the [Supporting additional sentences (AeroRust/nmea#54)](https://github.com/AeroRust/nmea/issues/54) issue and contribute in **3** easy steps:\n\n1. Write a comment in the issue for the sentence(s) you'd like to implement, you will be mentioned on the task to avoid duplicate efforts.\n2. Implement each sentence in it's own branch alongside:\n   - At least **2 tests** (**1 passing** and **1 failing**) in its own module under the [`./src/sentences`](./src/sentences) directory using the `nom` crate.\n   - Re-export the structures and parsing function in [`./src/sentences.rs`](./src/sentences.rs) \n   - Add a **passing** test to [`tests/all_supported_messages.rs`](./tests/all_supported_messages.rs)\n   - Add the sentence to the features list in `Cargo.toml` in **alphabetical order** and assign it to proper category (if you are unsure which category to use, open a PR to discuss it)\n   - Add the sentence to the `README.md` list of [supported sentences above](./README.md#nmea-0183-sentence-parser-for-rust)\n   - Passing linters checks. Just run `cargo fmt` and fix any issues raised by `cargo clippy`\n   - Appropriate documentation following the rest of the sentences format. For proper documentation you can take a look at `GSV`, `APA` and `WNC` sentences.\n3. Open a PR 🎉\n\n**NB:** We use [https://gpsd.gitlab.io/gpsd/NMEA.html](https://gpsd.gitlab.io/gpsd/NMEA.html) as a reference for most sentences as it's a very well documented project.\n\n## What is NMEA 0183?\n\n\u003e NMEA 0183 is a combined electrical and data specification for communication\n\u003e between marine electronics such as echo sounder, sonars, anemometer,\n\u003e gyrocompass, autopilot, GPS receivers and many other types of instruments.\n\n- _https://en.wikipedia.org/wiki/NMEA_0183_\n\n[doc]: https://docs.rs/nmea\n\n## Usage\n\nAdd the `nmea` dependency in your `Cargo.toml`:\n\n```toml\n[dependencies]\nnmea = \"0.7\"\n```\n\n### For `no_std`\n\nThis crate support `no_std` without the use of an allocator ( `alloc` ),\njust add the `nmea` crate without the default features:\n\n```toml\n[dependencies]\nnmea = { version = \"0.7\", default-features = false }\n```\n\n### Parse\n\nTo use the NMEA parser create a `Nmea` struct and feed it with NMEA sentences (only supports `GNSS` messages, otherwise use the `parse_str()` and `parse_bytes()`):\n\n```rust\nuse nmea::Nmea;\n\nfn main() {\n    let mut nmea = Nmea::default();\n    let gga = \"$GPGGA,092750.000,5321.6802,N,00630.3372,W,1,8,1.03,61.7,M,55.2,M,,*76\";\n\n    // feature `GGA` should be enabled to parse this sentence.\n    #[cfg(feature = \"GGA\")]\n    {\n        nmea.parse(gga).unwrap();\n        println!(\"{}\", nmea);\n    }\n}\n```\n\n## Supported Rust Versions\n\nThe Minimum supported Rust version (or MSRV) is **1.87.0**.\n\n## Unsafe-free crate\n\nWe use `#![deny(unsafe_code)]` for a fully `unsafe`-free crate.\n\n## License\n\nThis project is licensed under the [Apache-2.0](./LICENSE.txt).\n\n### Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in the project by you, shall be licensed as Apache-2.0,\nwithout any additional terms or conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faerorust%2Fnmea","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faerorust%2Fnmea","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faerorust%2Fnmea/lists"}