purpl3F0x / openant

ANT and ANT-FS Python Library

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Features

  • ANT base interface.
  • ANT-FS (with command pipe, file listings, downloading, uploading, etc).
  • ANT+ device profiles and base class for custom ones (openant.devices).
  • Four libs:
    • openant.base basic ANT library.
    • openant.easy blocking version using openant.base.
    • openant.fs ANT-FS library.
    • openant.device ANT+ like devices.
  • Command-line tool openant:
    • openant scan: Scan for nearby devices and optionally print device data.
    • openant influx: Stream device data to InfluxDB instance.

A note on ANT/ANT-FS/ANT+: this module is for development and testing of devices and not intended to be used as a reference. Refer to the thisisant.com website for full ANT documentation and ANT+ device profiles. The intention of this module is for quick R&D of ANT capable devices. In case non-obvious, this module is not an official tool.

Installation

Requirements

  • Python >= 3.7
  • libusb 1.0 (for pyusb)

Run pip install openant or pip install git+https://github.com/Tigge/openant#egg=openant for HEAD. A 'Pipfile' is also provided for use with pipenv.

If using on Linux, a udev rule for the Dynastream ANTUSB stick can be installed with sudo python setup.py udev_rules. Windows does not use udev_rules and therefore does not need to be installed. Follow libusb's driver installation instructions for Windows. macOS should work with just libusb installed.

ANT USB Stick

A USB stick that provides a ANT node is probably required. Here are ones made by Dynastream (Garmin):

See the note regarding Linux and the udev rule above to ensure the user has permission to run this module without elevated privileges.

InfluxDB CLI Tool

Requires install with [influx] (pip install openant[influx]) or influxdb-client module installed manually and InfluxDB server >= 2.0. See openant influx --help for the server setup. To quickly get a local instance running with Docker:

docker run --rm -p 8086:8086 \
      -v $PWD:/var/lib/influxdb2 \
      influxdb:latest

Navigate to 'http://localhost:8086' and setup a user/org (default org used is 'my-org'). Then setup a bucket to use (default 'my-bucket') and a API access token (Load Data > API Tokens).

Module Usage

Explore the examples in './examples', and docstrings within module code. Further documentation to be developed in './docs'.

CLI Tools

Accessed from module binary openant. Logging output can be enabled using the --logging flag.

Scan

Scan for nearby devices, for example to obtain device IDs. Can search for specific devices --device_type or all. Found devices can be saved to file with --outfile.

Example Usage

# print devices found to terminal
openant scan
# capture devices found to devices.json for use with antinflux
openant scan --outfile devices.json
# instantiate object when found so that device data is also printed
openant scan --auto_create

ANT+ to InfluxDB

Stream DeviceData from a ANT+ device to a InfluxDB instance. Useful for plotting real-time data and for post review. See openant influx --help. See the notes on installation for this tool. Refer to the InfluxDB documentation for the required flags.

Example Usage

# attach to first trainer found and push data to localhost InfluxDB
openant influx --verbose FitnessDevice
# attach to power meter with device id 12345 and push to localhost InfluxDB
openant influx --id 12345 --verbose PowerMeter
# attach to devices in 'devices.json' - allows connection to multiple devices
openant influx --config --verbose devices.json config

Supported ANT-FS Devices

Any compliant ANT-FS device should in theory work, but those specific devices have been reported as working:

  • Garmin Forerunner 60
  • Garmin Forerunner 405CX
  • Garmin Forerunner 310XT
  • Garmin Forerunner 610
  • Garmin Forerunner 910XT
  • Garmin FR70
  • Garmin Swim
  • Garmin vĂ­voactive HR

Please let me know if you have any success with devices that are not listed here.

Develop

Create Documentation

Install requirements from './docs'. From './docs' run make html. To auto-generate any new module content run make rst or sphinx-apidoc -f -o docs/src openant in root directory.

About

ANT and ANT-FS Python Library

License:MIT License


Languages

Language:Python 100.0%