summaryrefslogtreecommitdiff
path: root/www
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>2014-05-21 00:35:01 -0400
committerEric S. Raymond <esr@thyrsus.com>2014-05-21 00:35:01 -0400
commit79fb0d6d8d43fdc7913b3ce7c61043df6f469e8b (patch)
tree9a8421624ef3b1226ae2cd47ab4ec1c24b9d9c8e /www
parent5b511d159c61adea1245b61704f751a3e6aa3006 (diff)
downloadgpsd-79fb0d6d8d43fdc7913b3ce7c61043df6f469e8b.tar.gz
Some things learned about NMEA 4.00.
Diffstat (limited to 'www')
-rw-r--r--www/AIVDM.txt44
-rw-r--r--www/NMEA.txt7
2 files changed, 49 insertions, 2 deletions
diff --git a/www/AIVDM.txt b/www/AIVDM.txt
index 350f174e..8438eef6 100644
--- a/www/AIVDM.txt
+++ b/www/AIVDM.txt
@@ -4768,6 +4768,45 @@ language time function. Both date and time to the nearest second can be
derived from this field. This field is always provided, regardless of
the type of AIS equipment.
+== NMEA 4.0 Tag Blocks ==
+
+Beginning with NMEA 4.00, the standard describes a way to intersperse
+"tag blocks" with AIS sentences in order to supply additional
+metadata, notably a Unix timestamp to be associated with a sentence
+(or contiguous group of sentences such as an armored AIS Type 5).
+
+The general format of a tag block is: an opening backslash, followed
+by multiple comma-separated fields none of which may contain
+backslashes, followed by an asterisk and NMEA checksum, followed by a
+closing backslash.
+
+The following is an example of an AIS Type 1 sentence preceded by a tag:
+
+-------------------------------------------------------------------------------------------------
+\g:1-2-73874,n:157036,s:r003669945,c:1241544035*4A\!AIVDM,1,1,,B,15N4cJ`005Jrek0H@9n`DW5608EP,0*13
+-------------------------------------------------------------------------------------------------
+
+Each comma-separated field is expected to be a type key, followed by a
+colon, followed by content. The semantics of the type keys are as
+follows (table from <<NMEA-ADVANCE>>):
+
+.NMEA 4.00 Field Types
+[frame="topbot",options="header"]
+|===========================================================================
+| Code | Type | Description
+| c | int>0 | UNIX time in seconds or milliseconds
+| d | string | Destination (at most 15 chars)
+| g | int | Sentence grouping
+| n | int>0 | line count
+| r | int>0 | relative time
+| s | string | Source / station
+| t | string | Text string (at most 15 chars)
+|===========================================================================
+
+We do not yet have information on the meaing of these fields or how
+they are related to nearby AIVDM/AIVDO sentences. We hope to add this
+in a future revision.
+
== AIS Payload Byte Alignment, Padding, and Bit Stuffing ==
Warning: Here there be dragons. Read with care. Once you get through
@@ -5166,6 +5205,8 @@ Identification System]
- [[[GITTIP]]] https://www.gittip.com/esr/
+- [[NMEA-ADVANCE]] http://www.nmea.org/Assets/0183_advancements_nmea_oct_1_2010%20(2).pdf
+
== Change history ==
Version 1.0 was the initial release covering messages 1-3, 4, and 5.
@@ -5308,4 +5349,5 @@ waterways. Also Inland AIS standard messages are now covered.
Version 1.44 adds substantial new information on MMSIs and updates
the <<MMSI link>>, which was stale.
-Version 1.45 adds a description of variant AIS talker IDs.
+Version 1.45 adds a description of variant AIS talker IDs and NMEA
+4.00 tag blocks.
diff --git a/www/NMEA.txt b/www/NMEA.txt
index 1fcb2557..0f9ee27e 100644
--- a/www/NMEA.txt
+++ b/www/NMEA.txt
@@ -1,6 +1,6 @@
= NMEA Revealed =
Eric S. Raymond <esr@thyrsus.com>
-v2.13, Nov 2013
+v2.14, May 2014
NMEA 0183 is a proprietary protocol issued by the National Marine
Electronics Association for use in boat navigation and control
@@ -100,6 +100,7 @@ FAA Mode Indicator
M = Manual Input Mode
S = Simulated Mode
N = Data Not Valid
+ P = Precise (4.00 and later)
This field may be empty. In pre-2.3 versions it is omitted. <<NTUM>> says
that according to the NMEA specification, it dominates the Status field --
@@ -2367,3 +2368,7 @@ Described in <<MALTESE>>, actually a Maltese government document.
- [[[MALTESE]]]
"Procurement of a Fixed-Wing Maritime Patrol Aircraft"
https://secure2.gov.mt/eprocurement/Tenders/file.ashx?f=9832DB05E65C774258580284031EC72CC315D954A7108B5E.
+
+- [[NMEA-ADVANCE]]
+ "NMEA 0183 Advancements" (describes 'P' value of FAA mode)
+ http://www.nmea.org/Assets/0183_advancements_nmea_oct_1_2010%20(2).pdf