Maritime Labs Kahn

About

A light-weight and energy-efficient NMEA message broker.

Note

Please note this is PRE-ALPHA quality software.

Features

• Read NMEA sentences from serial devices
• Submit NMEA sentences via UDP broadcast

Hardware

Works best with plenty of UART ports. For example, supplied by the Waveshare USB 3.2 Gen1 HUB HAT for Raspberry Pi.

4x USB 3.2 Gen1 port expander.

Example system configuration, prototype.

Setup

pip install --upgrade kahn

To install the latest development version from the repository, invoke:

pip install --upgrade git+https://github.com/maritime-labs/kahn#egg=kahn

Usage

# Read data from serial device and display on the terminal.
kahn forward --source=serial:///dev/ttyUSB0 --target=file:///dev/stdout

# Read data from serial device and forward to UDP broadcast.
kahn forward --source=serial:///dev/ttyUSB0 --target=udp+broadcast+nmea0183://255.255.255.255:10110

Other projects

• ROS NMEA NavSat driver: https://github.com/ros-drivers/nmea_navsat_driver (nmea_serial_driver, nmea_socket_driver)
• Waterlinked nmeaoutput.py waterlinked-nmeaoutput.py

Project information

Contributions

Any kind of contribution, feedback or patches are very much welcome! Just create an issue or submit a patch if you think we should include a new feature, or to report or fix a bug.

Development

In order to setup a development environment on your workstation, please head over to the development sandbox documentation. When you see the software tests succeed, you should be ready to start hacking.

Resources

• Source code repository
• Documentation
• Python Package Index (PyPI)

License

The project is licensed under the terms of the GNU AGPL license.