AIS Dispatcher

Version

1.4

Release Date

18-August-2015

Download Link
AIS DISPATCHER 1.4
Release Notes:

1) Output filters by message type
2) “TCP server” input's

 

1. INSTALLATION

Download AISDispatcher ZIP file and unzip it in a separate folder.

2. START UP

After the first start, the program runs with default configuration. You can place a shortcut to aisDispatcher.exe on your desktop or into the “Startup” folder for an automatic startup.

3. CONFIGURATION

The configuration dialog is displayed by pressing “Configuration” button on the main window. The “Configuration” dialog contains four configuration panels – “Input”, “Output”, “Google Earth” and “Miscellaneous”.

3.1 "INPUT" CONFIGURATION
ais-dispatcher-config-input

INPUT MODE

You can choose one of the following types of data input:

TCPAISDispatcher creates TCP connection to the remote data source
UDPAISDispatcher listens on the specified port
SerialAISDispatcher receives data from a local serial port (or USB serial device)

TCP input (only if TCP input mode is selected)
  • Remote IP – IP address (or domain name) of the remote data source (example: IP 192.168.1.102)
  • Remote port – TCP port of the remote data source (example: port 4001)
UDP input (only if UDP input mode is selected)
  • Local port – port on the local Windows machine, where AISDispatcher listens for incoming UDP packets (example: udp port 5000)
Serial input (only if Serial input mode is selected)
  • COM port – serial port name (example: COM1)
  • Baud rate – baud rate selection (example: 38400).

Serial input uses 8,N,1 serial settings, according to NMEA specification.

3.2 "OUTPUT" CONFIGURATION
ais-dispatcher-config-output
UDP Output
Downsampling intervaltime window of downsampling algorithm. For more details see: AIS Dispatcher – Description
Destinationsup to 12 destination IP addresses/ports. AISDispatcher forwards AIS data to all configured and enabled destinations. In our example, there are two destinations.
Filtersfiltering by polygon and message types may be used for each destination
aisdispatcher-config-output-filter

3.3 “GOOGLE EARTH” CONFIGURATION

ais-dispatcher-config-google-earth

Delete old vessels
Expriation time – AIS Dispatcher keeps list of all received vessels since the startup. Each minute, the application purges the list and removes the vessels with last packet timestamp older than the defined “expiration time”.

HTTP Server configuration
Host / Port – AIS Dispatcher listens for network connections from Google Earth clients on the specified host / port. When host is “0.0.0.0″ (by default), the application listens on all network interfaces.
Enable HTTP server – enable/disable the HTTP server
Allow localhost only - disables connection to all external interfaces. AIS Dispatcher listens for connections only from Google Earth clients started on the user’s PC.

KML / KMZ export
Enable – enable/disable the regular export of KML/KMZ file into the local hard drive. AISDispatcher saves the file in its installation directory, “kml_export” folder. The file is named “aisDispatcherSnapshot.kml” or “aisDispatcherSnapshot.kmz”.
Export interval – time interval between sequential KML/KMZ exports

Miscellaneous
Use ZIP compression
- when ZIP compression is enabled, AISDispatcher generates KMZ instead of KML file format. In this case, the application consumes more CPU time, but reduces the network traffic several times. KMZ format also consumes more CPU time by the Google Earth client.
Show vessel names - displays all vessels names.

3.4 “MISCELLANEOUS” CONFIGURATION

ais-dispatcher-config-miscellaneous

Miscelaneous
Auto connect on startupautomatically creates connection after the start of the application
Minimize to system tray on closewhen pressing ALt+F4 or “X” button, the application is minimized to the system tray. It can be closed by clicking on the system tray with the right mouse button and selecting “Exit”.
Start application minimizedafter startup, the application is minimized to the system tray
Show system tray hintdisplays hint with the current status when mouse cursor hovers over the icon in the system tray
Dispatch VDM/VDO messages onlyfilters only VDM/VDO messages from AIS sources. If the filter is off, the AISDispatcher will forward all other NMEA messages (like GPS devices for example).
Don’t dispatch channel Cfilters AIS channel C (secure AIS)

4. MAIN WINDOW
AIS Dispatcher’s main window contains connection controls and detailed statistics of the input data feed.

ais-dispatcher-main-window
Input section
Modecurrent input mode (TCP,UDP or serial) and connection parameters
Statuscurrent connection status
“Start”/”Stop” buttonsconnection control

Input statistics
Message counters and byte counters of the incoming data feed. For more information about the meaning of the fields, check the AIS specification.

Input statistics (by AIS message type 1..24)
There are 24 different types of AIS messages. This panel displays separate message counter for each message type. Additional details about each message type are displayed by hovering with the mouse over the counter.

“NMEA Dump” button
Displays last received AIS messages

“Clear” button
Clears all counters

“Configuration” button
Displays configuration window described in the previous chapter

Output statistics
In/Out ratio - ratio between input and output data counters. This parameter shows the efficiency of the downsampling algorithm.
Bandwidth (kB/s) – average output bandwidth in Kilobytes per Second
Distinct vessels – current number of vessels kept in AIS Dispatcher memory buffer.