@signalk/nmea0183-signalk

signalk-parser-nmea0183

A node.js/javascript parser of NMEA0183 sentences. Sentences are parsed to Signal K delta format.

Supported sentences

• ALK - Seatalk
• APB - Autopilot Sentence "B"
• DBT - Depth Below Transducer
• DSC - Digital Selective Calling Class-D Radios
• GGA - Global Positioning System Fix Data
• GLL - Geographic Position - Latitude/Longitude
• HDM - Heading - Magnetic
• HDT - Heading - True
• MTW - Mean Temperature of Water
• MWV - Wind Speed and Angle
• RMC - Recommended Minimum Navigation Information
• ROT - Rate of Turn
• RPM - Revolutions
• VDM - AIS Other Vessel Data
• VDO - AIS Own Vessel Data
• VDR - Set and Drift
• VHW - Water Speed and Heading
• VPW - Speed - Measured Parallel to Wind
• VTG - Track Made Good and Ground Speed
• VWR - Relative Wind Speed and Angle
• ZDA - UTC day, month, and year, and local time zone offset

Todo

• Sentence support (parity with old parser)
• Tests for every sentence
• Update readme
• Include parsing to full Signal K format
• Extend sentence support beyond current set (continuing)

Usage

const Parser = require('@signalk/nmea0183-signalk')
const parser = new Parser()

parser.on('error', error => {
  console.error(`[error] ${error.message}`)
})

parser.on('warning', warning => {
  console.warn(`[warning] ${warning.message}`)
})

parser.on('signalk:delta', delta => {
  console.log(`[delta] ${JSON.stringify(delta, null, 2)}`)
})

// Parse sentence
parser.parse('$SDDBT,17.0,f,5.1,M,2.8,F*3E')

In addition to usage in your code, the parser can be used on the command-line if installed globally (npm install --global). This allows you to pipe data from one program into the parser directly, without using a Signal K server. The parser holds no Signal K tree in memory (a big change vs. 1.x), so the output will be stringified Signal K delta messages.

$ echo '$SDDBT,17.0,f,5.1,M,2.8,F*3E' | nmea0183-signalk

NMEA0183v4 tag blocks

This parser has (limited) support of NMEA0183v4 tag blocks (e.g. \s:airmar dst800,c:1438489697*13\$SDDBT,17.0,f,5.1,M,2.8,F*3E). Keep in mind that, since NMEA uses the backslash \ as the start and end character of the tag block, you need to escape these characters before parsing them. This is necessary because javascript treats the backslash as the escape character causing it not to be included in the resulting string (unless escaped).

Example:

const Parser = require('@signalk/nmea0183-signalk')
const parser = new Parser()

parser.on('error', error => {
  console.error(`[error] ${error.message}`)
})

parser.on('warning', warning => {
  console.warn(`[warning] ${warning.message}`)
})

parser.on('signalk:delta', delta => {
  console.log(`[delta] ${JSON.stringify(delta, null, 2)}`)
})

parser.parse('\\s:airmar dst800,c:1438489697*13\\$SDDBT,17.0,f,5.1,M,2.8,F*3E')

Note: at this time, the checksum of the tag block (c:1438489697*13) is not validated.

License

Copyright 2016/2017 Signal K and Fabian Tollenaar <[e-mail]>.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.