ANT and ANT-FS Python Library
Python
Latest commit ed89281 Jan 18, 2017 @Tigge committed on GitHub Merge pull request #29 from Echelon9/feature/test-base
Add tests for base/test_message.py and fs/test_beacon.py

README.md

openant

Build Status Coverage Status

A python library to download and upload files from ANT-FS compliant devices (Garmin products).

Features

  • ANT
  • ANT-FS (with command pipe, file listings, downloading, uploading, etc)
  • Three libs (ant.base basic ANT library, ant.easy blocking version using ant.base, ant.fs ANT-FS library)

Requirements

  • Python 2.7+
  • PyUSB > 1.0a2 (seems to be a bug which makes it segfaults on version before Alpha 2)
  • Root access (for installation only)

Automatic install

  • Install setuptools:

    apt-get install python-setuptools
    

    or

    wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python
    
  • Run the following command:

    sudo python setup.py install
    

This will install everything required on your active python installation.

Manual install

These should only be necessary to install manually, if you don't want to use the Automatic installation script.

  • Install PyUSB.

    pip install pyusb
    

    (Or alternatively from sources available on GitHub)

  • Install udev rules (Only required to avoid running the program as root).

    sudo cp resources/ant-usb-sticks.rules /etc/udev/rules.d
    sudo udevadm control --reload-rules
    sudo udevadm trigger --subsystem-match=usb --attr-match=idVendor=0fcf --action=add
    

Supported devices

ANT USB Sticks

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

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