AIVDM/AIVDO AIS Message Parser

The Automatic Identification System (AIS) allows ships to be tracked in realtime based on information transmitted by each ship. They are equipped with either a Class A or Class B AIS transponder which includes a GPS for accurate position and speed reporting. AIS receivers decode the transmitted information and output the data as AIVDM messages.

The structure of the AIVDM message is described in IEC 61993-2 and it is a variation of the NMEA 0183 sentence format that includes the raw data encoded in a 6-bit format. A Message 1 example looks like this:

    !AIVDM,1,1,,B,19NS7Sp02wo?HETKA2K6mUM20<L=,0*27

The meaning of each data element in the AIS messages is covered by the ITU M.1371 and IEC 62287 documents. These documents are available from the websites of these organizations:

To fully understand the data produced by this library you should read the above documents.

This library allows you to write programs that accept ASCII AIVDM or AIVDO messages and parse their packed 6-bit data into structures containging the message data. The general flow of a typical aisparser program would look like this:

Receive ASCII data (via serial port, file or network socket)
Pass the data to assemble_vdm() to reassemble multipart messages and extract their 6-bit data.
Fetch the first 6 bits from the data stream, this is the message id and determines which parser function to call and what structure to store the results in.
Call the appropriate parse_ais_XX function with aismsg_XX structure passed to it.
Act on the message data: display a position, ship name, etc.

This library is thread safe, all variables used are contained in the ais_state structure. To support multiple data streams all you need to do is used 2 different instances of ais_state.

To get started you should read the documentation on the vdm_parse.c module and look at the example code in the example directory of the source distribution.

Generated on Fri Mar 28 18:00:47 2008 for AIS Parser by

1.5.2