incyclist-ant-plus

Module to interface ANT+ Sensors/Devices, developed and maintained for Incyclist Indoor Cycling App

Prerequisites

Libusb is included as a submodule. On Linux, you'll need libudev to build libusb. On Ubuntu/Debian: sudo apt-get install build-essential libudev-dev

Windows

Using the AntDevice binding

Use Zadig to install the WinUSB driver for your USB device. Otherwise you will get LIBUSB_ERROR_NOT_SUPPORTED when attempting to open devices.

Using the AntServerBinding binding

The antserver.exe needs to be deployed together with your app. You can find a pre-compiled version in the ./bin directory, or you can compile it yourself based on the sources provided in the ./antserver directory

Install

npm install incyclist-ant-plus

Usage

Create and connect to USB Device (stick)

const {AntDevice} = require('incyclist-ant-plus/lib/bindings')

const ant = new AntDevice({startupTimeout:2000})
const success = await ant.open()

The library will automatically detect the matching Stick type ( Garmin2 / Garmin3)

Reserve the next available channel

const channel = ant.getChannel();

Use channel to scan for Sensors

const {BicyclePowerSensor,FitnessEquipmentSensor,HeartRateSensor} = require('incyclist-ant-plus');

//channel.on('detect', (profile, id) => console.log('detected',profile,id))

//channel.on('data', (profile, id, data) => console.log('data',profile,id, data))

channel.attach(new BicyclePowerSensor())
channel.attach(new HeartRateSensor())
channel.attach(new FitnessEquipmentSensor())

const detected = await channel.startScanner({timeout:10000})
console.log(detected)

Stop ongoing scan

might be used when scan should be stopped as soon as first/specific device is detected

has to be called explicitly if scan is done without timeout

channel.stopScanner()

Use channel to connect to a specific Sensor

const {FitnessEquipmentSensor} = require('incyclist-ant-plus');

channel.on('data', (profile, id, data) => console.log('data',profile,id, data))

const sensor = new FitnessEquipmentSensor()
const success = await channel.startSensor(sensor)
console.log(detected)

if (success) {
	console.log( "set User Weight = 78kg, Bike Weight= 10kg" );
	await sensor.sendUserConfiguration(78,10);
	
	console.log( "set slope to 1.1%" );
	await sensor.sendTrackResistance(1.1);
}

Important notes

• In order to avoid problems at next launch, always call ant.close() at the end of the program

Writing your customized Classes

The library was designed so that the implemention of the interfaces can be customized

As Incyclist is developed as React app running in Electron, it will require a special implementions of the IAntDevice interface

• IpcAntDevice: to be used in the renderer process to communicate with the AntDevice class in the Electron main process
• WinAntDevice: A special implementation using ANT.DLL, to remove the dependency to Zadig

Classes

AntDevice (IAntDevice)

Constructor

constructor( props?: {
	deviceNo?: number;
	startupTimeout?: number;
	detailedStartReport?:boolean
	debug?: boolean;
	logger?: { logEvent?: (event)=>void, log:(...args)=>void};
})

deviceNo: In case you have multiple sticks connected, identifies the stick number. (0=first,1=second,...). Adding/removing a stick will not be recognized during the session ( i.e. after first use of constructor)

startupTimeout: timeout (in ms) after which the startup attempt should be stopped. If no timeout is given, the open()call will be blocking.

detailedStartReport: if set to true, the open() method will provide more detailed result (AntOpenResult type), otherwise it will return a boolean

debug: enables debug mode ( message logging)

logger: logger to be use for debug logging

Methods

open

open():Promise<boolean|AntOpenResult>

Tries to open the stick. In case the property detailedStartReport has been set, it will return any of 'Success', 'NoStick', 'StartupError' Returns true on success and false on failure.

close

close():Promise<boolean>

Tries to close the stick and all opened channels. Returns true on success and false on failure.

getMaxChannels

getMaxChannels():number

returns the maximum number of channels that this stick supports; valid only after stick was opened successfully.

getDeviceNumber

getDeviceNumber():number

returns the current device(stick) number (0=first,1=second,...); valid only after stick was opened successfully.

getChannel

getChannel():IChannel

Tries to reserve the next available channel - up to the maximum number of channels as indicated by getMaxChannels()

Returns a Channel object on success and null on failure.

freeChannel

closeChannel(IChannel):void

removes the reservation for a channel.
Note This should never be called directly. It will be called by the methods of stopScanner() and stopSensor()

write

write(data:Buffer):void

sends a message to the ANT+Device

Channel (IChannel)

TODO

Sensor

TODO

Available Sensors

TODO