Driver for Septentrio GPS, posting messages to mqtt
Project description
Septentrio GPS
Source Code: https://gitlab.com/roxautomation/components/septentrio-gps
Usage
get docker image (use tag for version)
registry.gitlab.com/roxautomation/components/septentrio-gps:latest
Environment Variables
Configuration is defined in config.py
Set these environment variables to configure MQTT and GPS settings:
MQTT
- MQTT_HOST: MQTT server host (default:
"localhost"
). - MQTT_PORT: MQTT server port (default:
1883
). - MQTT_POSITION_TOPIC: MQTT topic for GPS positions (default:
"/gps/position"
). - MQTT_DIRECTION_TOPIC: MQTT topic for GPS directions (default:
"/gps/direction"
).
GPS
- GPS_PORT: Serial port for GPS (default:
"/dev/gps_nmea"
). - GPS_BAUD: Baud rate for GPS serial communication (default:
115200
). - GPS_REF: gps reference point, provide lat,lon, example:
GPS_REF="51.123,6.456"
Example launch with custom parameters
docker run \
-e MQTT_HOST=192.168.1.100 \
-e MQTT_PORT=8883 \
-e GPS_PORT=/dev/ttyS0 \
registry.gitlab.com/roxautomation/components/septentrio-gps:latest
Documentation
The documentation is automatically generated from the content of the docs directory and from the docstrings of the public signatures of the source code.
Online documentation: https://roxautomation.gitlab.io/components/septentrio-gps/
Development
There should be mqtt broker available on the host system. If not, there is a docker image for that:
docker run -d --name mosquitto --restart unless-stopped -p 1883:1883 registry.gitlab.com/roxautomation/images/mosquitto:latest
- Open in VSCode devcontainer. Virtual com port is located at
/tty/tty_nmea_rx
- Pre-recorded nmea stream can be sent to com port with
replay_data.py
inintegration/data
folder.
TODO
Current setup works, but it can always be made better.
- add tests
- Use uart ports instead of usb. This will make system more robust.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rox_septentrio-0.2.8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f5965566e54488b7d4347d39193fea3cdc0e4f20e4c990813566b01c26b1b6b7 |
|
MD5 | 67c79ff09f7b674de52c9d9c95f7195f |
|
BLAKE2b-256 | 656e6e499b1fa0c7b3d3e5de5de161f0ed730b93c946a24ff92ab55c18d756d3 |