calypso-anemometer 0.4.0

About

Features

• Run device discovery

• Acquire device status and readings (one shot)

• Acquire device readings continuously (subscribe/notify)

• Set device data rate

• Telemetry with NMEA-0183 and SignalK over UDP

Setup

pip install --upgrade calypso-anemometer

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

pip install --upgrade git+https://github.com/maritime-labs/calypso-anemometer

Pre-flight checks

There is some documentation about investigating and configuring your Bluetooth/BLE stack and about simulating the telemetry messaging. On this matter, you might want to run through a sequence of preflight checks before going into production.

Usage

Getting started

Discover the ULTRASONIC BLE device and run a conversation on it:

# Get device information.
calypso-anemometer info

# Get device reading.
calypso-anemometer read

# Get device readings, continuously at 4 Hz (default).
calypso-anemometer read --subscribe

# Get device readings, continuously at 1 Hz.
calypso-anemometer read --subscribe --rate=hz_1

# Generate fake device readings, continuously at 8 Hz.
pip install --upgrade calypso-anemometer[fake]
calypso-anemometer fake --subscribe --rate=hz_8

If you already discovered your device, know its address, and want to connect directly without automatic device discovery, see skip discovery.

Telemetry setup

The program can optionally submit telemetry messages in different formats.

SignalK telemetry

Continuously receive device readings and submit them in SignalK Delta Format via UDP:

calypso-anemometer read --subscribe --rate=hz_1 --target=udp+signalk+delta://openplotter.local:4123

To make a SignalK server receive the data, create an “UDP receiver” data connection on the Server » Data Connections dialog of your OpenPlotter instance.

NMEA-0183 telemetry

Continuously receive device readings and submit them in NMEA-0183 format via UDP broadcast:

calypso-anemometer read --subscribe --rate=hz_1 --target=udp+broadcast+nmea0183://255.255.255.255:10110

To make OpenCPN receive the data, create a corresponding data connection like outlined in those screenshots.

An example NMEA-0183 sentence emitted is:

$IIVWR,154.0,L,11.06,N,5.69,M,20.48,K*65

Other projects

• The signalk-calypso-ultrasonic project by Fabian Tollenaar is a Signal K server plugin for the Calypso Ultrasonic wireless anemometer.

Acknowledgements

• Kudos to Henrik Blidh, David Lechner, and contributors for conceiving and maintaining the excellent Bleak library.

• Special thanks to Fabian Tollenaar for creating signalk-calypso-ultrasonic.

Project information