NMEAParser.jl

Introduction

NMEAParser.jl is a Julia package for parsing NMEA GPS protocol sentences.

Note: This package has recently been adopted from the original author. If you have any thoughts about improving the design or would like to contribute, please let us know.

NMEA strings are sentences that follow the NMEA 0183 messaging protocol. The NMEA 0183 messaging protocol was originally adopted in 1983 for interfacing marine electronics, but its use has expanded to terrestrial electronics as well.

Data in this messaging protocol is transmitted in ASCII strings or “sentences” from one “talker” to multiple “listeners” at a time. These sentences contain information such as position, speed, depth, wind direction and speed, and other navigation data. NMEA strings are commonly used by GPS receivers and other navigation equipment to communicate with each other and with other devices such as computers and chart plotters.

Getting Started

Installation

To install NMEAParser.jl, use the Julia package manager:

using Pkg
Pkg.add("NMEAParser")

Usage

Here’s a simple example that demonstrates how to parse an NMEA sentence:

using NMEAParser

example = nmea_parse(raw"$GPGGA,134740.000,5540.3248,N,01231.2992,E,1,09,0.9,20.2,M,41.5,M,,0000*61")
println(example.latitude)

GGA("GPS", 49660.0, 55.67208, 12.521653333333333, "GPS (SPS)", 9, 0.9, 20.2, 41.5, 0.0, 0, true)
55.67208

Documentation

Standard Types

GGA: Global Positioning System Fix Data.
GSA: GNSS DOP and Active Satellites.
ZDA: Time and Date.
GBS: RAIM GNSS Satellite Fault Detection.
GLL: Geographic Position - Latitude/Longitude.
GSV: GNSS Satellites in View.
RMC: Recommended Minimum Specific GNSS Data.
VTG: Course over Ground and Ground Speed.
DTM: Datum.

Store obj for standard types

NMEAData: Stores data for the last parsed sentence of all NMEA message types.

Proprietary Types

PASHR: Inertial altitude data - source.
PTWPOS: 2D Position data.
PTWVCT: movement vector.
PTWPLS: position pulses.
PTWWHE: wheel information.
PTWHPR: heading, pitch, roll.
PTACC: imu acceleration.
PTGYR: imu gyroscope.

Methods

parse_msg!: Parses an NMEA line/sentence and stores data in an NMEAData object; returns the message type.
nmea_parse: Parses nmea strings to nmea type structs.
is_string_supported: Checks if a string is a valid standard type (also NMEAParser.is_string_proprietary checks for valid proprietary types).
update: Update the last received message of type T in the NMEAData object s with the given message msg.