Wegmatt dAISy HAT User manual

WEGMATTLLC dAISy HAT AIS Receiver
1Contents
2Disclaimer ..................................................................................................................................2
3Configuring the Raspberry Pi for the dAISy HAT...........................................................................2
3.1 Recent versions of Raspian ...........................................................................................................2
3.2 Older versions of Raspian –Raspberry Pi, Pi 2 and Pi Zero ..........................................................3
3.3 Older versions of Raspian –Raspberry Pi 3 ..................................................................................4
3.4 Configuration in OpenCPN............................................................................................................4
3.5 Connecting dAISy with other software.........................................................................................6
4Using dAISy ................................................................................................................................7
4.1 Interpreting the status LEDs .........................................................................................................7
4.2 Configuration and debug menu....................................................................................................8
5Using the breakout connections................................................................................................10
5.1 Serial 1 header ............................................................................................................................10
5.2 Serial 2 header ............................................................................................................................10
5.3 I2C header...................................................................................................................................11
5.4 Debug header..............................................................................................................................11
5.5 RF connectors..............................................................................................................................11
6Tips for good AIS reception .......................................................................................................12
6.1 Antenna.......................................................................................................................................12
6.2 Location, location, location.........................................................................................................12
6.3 Radio noise..................................................................................................................................13
7Troubleshooting .......................................................................................................................14
8Specifications ...........................................................................................................................15
9Source code and schematics......................................................................................................16
10 Contact.................................................................................................................................16

Wegmatt LLC
6356 138th Ave NE #212
Redmond, WA
United States of America
http://www.wegmatt.com
Designed and assembled in USA
2Disclaimer
dAISy HAT is a reliable, dual-channel AIS Receiver. However, under no circumstances it should be
solely relied on for collision avoidance or navigation. It’s the user’s responsibility to use the product
prudently. Neither Wegmatt LLC nor its dealers accept responsibility or liability to the product user or
their estate for any accident, loss, injury or damage whatsoever arising out of the use of this product.
3Configuring the Raspberry Pi for the dAISy HAT
The dAISy HAT communicates with the Raspberry Pi through the serial port broken out one the
Raspberry Pi’s expansion header. Out-of-the-box, the Raspberry Pi uses these pins for other purposes
like a serial terminal or Bluetooth.
Reconfiguring serial ports is straight forward with recent versions of Raspian (since ca. late 2016).
Configuration can be more complex with older version of Raspian, especially on the Raspberry 3. For
beginners, we recommend starting with a new image of Raspian.
3.1 Recent versions of Raspian
The uart_control shell script Ilker Temir is the easiest way to configure the serial port on a Raspberry Pi.
Open a terminal window on your Raspberry Pi and execute the following commands:
1. wget https://github.com/itemir/rpi_boat_utils/raw/master/uart_control/uart_control
2. chmod +x ./uart_control
3. sudo ./uart_control gpio
4. sudo reboot now
This will download the script, make it executable, run it to reconfigure the serial port for use with a HAT,
and rebooting the Raspberry Pi to make the new configuration active.
After completing the reboot, AIS data is available using the following parameters:
Serial port
/dev/serial0
Baud rate
38400
Data bits
8
Parity
None
Stop bits
1
Flow control
None

Use this information to configure OpenCPN or other programs. Keep in mind, that only one application
at a time can consume serial data.
You can verify the serial connection with a serial terminal program like for example screen. You may
have to install screen first by running:
sudo apt-get install screen
With screen installed, connect to the dAISy HAT with
screen /dev/serial0 38400
If the serial port is properly configured, pressing ESC will bring up the configuration and debug menu.
Pressing ESC again will return dAISy into receive mode. Exit screen by pressing CTRL-A, then K and then
Y.
3.2 Older versions of Raspian –Raspberry Pi, Pi 2 and Pi Zero
Older versions of Raspian require more manual steps to reconfigure serial ports.
If you have a Raspberry Pi, Raspberry Pi 2 or Raspberry Pi Zero, follow the steps outlined in the tutorial
for the Adafruit GPS HAT.
https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/pi-setup
After completing the reboot, AIS data is available using the following parameters:
Serial port
/dev/ttyAMA0
Baud rate
38400
Data bits
8
Parity
None
Stop bits
1
Flow control
None
Use this information to configure OpenCPN or other programs. Keep in mind, that only one application
at a time can consume serial data.
You can verify the serial connection with a serial terminal program like for example screen. You may
have to install screen first by running:
sudo apt-get install screen
With screen installed, connect to the dAISy HAT with
screen /dev/ttyAMA0 38400
If the serial port is properly configured, pressing ESC will bring up the configuration and debug menu.
Pressing ESC again will return dAISy into receive mode. Exit screen by pressing CTRL-A, then K and then
Y.

3.3 Older versions of Raspian –Raspberry Pi 3
The Raspberry Pi 3 uses its serial port for the built-in Bluetooth module. Reconfiguring this with older
versions of Raspian can be quite complex and error prone. We strongly recommend using an up-to-date
version of Raspian and follow the steps outline in chapter 3.1 above instead.
If you still want to reconfigure an older version of Raspian, this blog post may help you:
https://thepihut.com/blogs/raspberry-pi-tutorials/raspberry-pi-gps-hat-and-python
After completing the reboot, AIS data is available using the following parameters:
Serial port
/dev/ttyAMA0
Baud rate
38400
Data bits
8
Parity
None
Stop bits
1
Flow control
None
Use this information to configure OpenCPN or other programs. Keep in mind, that only one application
at a time can consume serial data.
You can verify the serial connection with a serial terminal program like for example screen. You may
have to install screen first by running:
sudo apt-get install screen
With screen installed, connect to the dAISy HAT with
screen /dev/ttyAMA0 38400
If the serial port is properly configured, pressing ESC will bring up the configuration and debug menu.
Pressing ESC again will return dAISy into receive mode. Exit screen by pressing CTRL-A, then K and then
Y.
3.4 Configuration in OpenCPN
OpenCPN is a free chart plotter and navigation software. Among many other things, OpenCPN supports
input from AIS receivers to display the position of ships on its charts.
You can learn more about OpenCPN on http://opencpn.org
There are several tutorials on the web on running OpenCPN on a Raspberry Pi. The consensus is, that
you should only attempt this on a Raspberry Pi 3 or 4 with an up-to-date version of Raspian. The official
instructions can be found here:
https://opencpn.org/wiki/dokuwiki/doku.php?id=opencpn:opencpn_user_manual:getting_started:open
cpn_installation:raspberrypi_rpi2
Alternatively, users have reported good results by following this procedure:
http://www.agurney.com/raspberry-pi/pi-chart

Once OpenCPN is running on the Raspberry Pi, configure it for the dAISy HAT. Go to the Options dialog,
select the Connections icon and add a new connection. Set Properties to Serial. Enter or select the
Dataport under which dAISy presents itself (see chapters above to determine the correct port). Set
Baudrate to 38400. Leave everything else as preset by OpenCPN.
Configuration of a serial connection for dAISy in OpenCPN

3.5 Connecting dAISy with other software
dAISy presents itself to computers as a serial port. See the configuration chapters above about
installation to learn how to determine the serial port.
The serial communication parameters of dAISy are:
Baud rate
38400
Data bits
8
Parity
None
Stop bits
1
Flow control
None
Depending on the software dAISy is used with, some or all parameters must be configured. For details,
please refer to the instruction manual of the respective application.

4Using dAISy
Using dAISy is as simple as connecting it with an antenna and a PC and powering up your AIS capable
application of choice. When plugged in, dAISy automatically starts to listen for AIS transmissions.
4.1 Interpreting the status LEDs
The dAISy HAT has two two-color status LED, giving us some indication about how it’s feeling. Each LED
represents one of the two AIS channels.
Short GREEN flash every 5 seconds
dAISy is well and alive and in receive mode.
While in receive mode, the mode dAISy starts in when powered up, it will very briefly blink green every 5
seconds to indicate that everything is ok.
Long GREEN flash
Yay! dAISy received a valid AIS packet.
For every packet received and passing all error checks, the LED will turn green for ¼ second. At the same
time, dAISy will send the received message to the Raspberry Pi.
Long RED flash
dAISy received an invalid packet.
dAISy caught the start of a package, but the received data did not pass other sanity checks like encoding
standard or checksum. It might be a ship just out of range, interference from another radio source, or
just random noise.
Don’t panic, you will see a lot of red even under optimal conditions.
RED turned on permanently
dAISy failed to initialize the radio IC.
Shut down the Raspberry Pi and remove power. Plug it in again and see if this resolves the problem. If
the condition persists, there might a hardware issue with your device. Please contact us.
Fast regular blinking RED
dAISy encountered an unexpected system error.
Shut down the Raspberry Pi and remove power. Plug it in again and see if this resolves the problem. If
the condition persists, there might a hardware issue with your device. Please contact us.
No LED activity
Most likely, dAISy is not in receive mode because you are using the configuration menu.
Connect to dAISy with a serial terminal and press ESC. A message should tell you that it entered AIS
receive mode and the green LED should start to blink every 5 seconds.

Another possibility is, that dAISy failed to boot or crashed.
In this case, shut down the Raspberry Pi and remove power. Plug it in again and see if this resolves the
problem. If the condition persists, there might a hardware issue with your device. Please contact me.
4.2 Configuration and debug menu
When connecting to dAISy with a serial terminal (e.g. screen), pressing ESC will bring up a menu with a
few configuration and debug options.
The most commonly used options are:
0-3: Controls the Serial 2 header on the HAT. 1 enables the port at 4800 baud, 2 is for 9600, and 3 is for
38400 baud. 0 turns Serial 2 off.
S: Selects the function of Serial 2. Serial 2 can either:
-Output AIS messages, for example to a Bluetooth module, RS-422/NMEA0183 adapter, or a data
logger.
-Act as an input for NMEA messages, for example from a GPS module. All data received through
Serial 2 will be forwarded to the Raspberry Pi.
D: Toggles debug messages, when in receive mode signal strength as well as information about invalid
packets will be displayed. It’s normal to receive a lot of broken packages, as there always will be radio
noise and ships just barely out of reach. With some experience, you can use the debug messages to
analyze and improve reception issues.

#: Save current settings (serial, C, L, R and D) as startup defaults. This is particularly useful when you
want to persist the settings for the auxiliary serial output.
ESC: Resume receiving AIS messages.
Other options:
N: Keep pressed to get an idea of the current noise level. -120 to -100 dBm is normal. dAISy will only be
able to receive valid packets roughly 15 dBm above that level, consistent reception 25+ dBm above
noise.
V: If valid packages were received, this gives a summary of the signal strength at which they arrived
(min, max, average).
T: Enter test mode. In this mode, dAISy outputs a test message every 5 seconds. You can enter your own
message or have it output a preprogrammed AIS message. This mode is useful when you want to test
dAISy but don’t have AIS reception at your current location. You can exit test mode by pressing ESC or
power-cycling dAISy.
C: Configure receiving channel. The dAISy HAT has two radios, which by default are configured to listen
on channel A and B respectively. For experimental purposes, the channel assignment of the radios can
be changed to A/A, B/B, A/B or B/A. The recommended setting is A/B.
R: Turn RSSI Detect on or off. When RSSI detect is on, dAISy will ignore signals that are too weak for
reliable communication. This may increase the number of local messages received, but it will also reduce
the maximum range. The recommended setting is OFF.
L: Turn Low Power Mode on or off: In low power mode, the CPU of dAISy will be powered down when
idle. This will reduce power consumption by about 10-15%. As this is insignificant in typical applications,
the recommended setting is OFF.
B: Enter boot loader mode for firmware updates. dAISy only exits this mode through power-cycling or
after completing firmware upgrade. Check our website for the latest firmware updates.

5Using the breakout connections
The dAISy HAT AIS Receiver breaks out several interfaces as unpopulated footprints for 0.1” headers.
All digital interfaces are 3.3V only.
5.1 Serial 1 header
The header Serial 1 exposes the primary serial
interface of the dAISy AIS Receiver. It is connected
in parallel with the serial interface of the Raspberry
Pi, and offers the same data and functionality.
Serial 1 is always active and runs at 38400 baud. It
can be used to run the dAISy HAT standalone,
without being connected to a Raspberry Pi.
When connected to a Raspberry Pi, Serial 1 should
only be used to receive the same data as the
Raspberry Pi. Do not send data through the RX pin
while the HAT is connected to a Raspberry Pi.
The 5V pad is connected to the 5V power rail of the
Raspberry Pi. When the dAISy HAT is not connected
to the Raspberry Pi, the 5V pad can be used to power the AIS Receiver. When running standalone, the
dAISy HAT will draw a maximum current of 40mA in receive mode.
dAISy Serial 1
dAISy MCU
Raspberry Pi
Comment
5V
5V to 3.3V LDO
Pin 2, 5V
5V power rail of Raspberry Pi and HAT. Can
be used to power HAT standalone.
GND
GND
GND
Connected to the GND plane of the HAT
TX
Serial 1 TXD
Pin 10, UART0_RXD
Serial data out, 3.3V signal level, 38400 bps
RX
Serial 1 RXD
Pin 8, UART0_TXD
Serial data in, 3.3V signal level, 38400 bps.
Don’t use when HAT is connected to
Raspberry Pi.
IO
GPIO
-
Currently not in use.
5.2 Serial 2 header
The header Serial 2 exposes the secondary serial interface of the dAISy AIS Receiver. This serial port is
controlled by dAISy’s MCU and not connected to the Raspberry Pi.
Speed and function of Serial 2 are configured in the debug menu. It can operate as secondary output or
as NMEA input. The pinout is compatible with the Adafruit Ultimate GPS module.
The 5V pad is connected to the 5V power rail of the Raspberry Pi. When the dAISy HAT is not connected
to a Raspberry Pi, the 5V pad can be used to power the AIS Receiver. When running standalone, the
dAISy HAT will draw a maximum current of 40mA in receive mode.