Skip to content

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

License

Notifications You must be signed in to change notification settings

maritime-labs/kahn

Repository files navigation

https://pepy.tech/badge/kahn/month

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.

Waveshare USB 3.2 Gen1 HUB HAT for Raspberry Pi

4x USB 3.2 Gen1 port expander.

Example system configuration, prototype.

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

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

License

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

About

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

Resources

License

Stars

Watchers

Forks