An Implementation of the Ant+ Network on top of ant-arduino
- 10/1/2017 v0.1.0 Version released, library added to managers
- 9/24/2017 Proof of concept complete (for system design)
- 9/4/2017 Project Started
- v0.2.0 Build Framework for Channel Master with HR master
- v0.3.0 Build support for non-ANT+ channel interfacing
- v1.0.0 Finalize and verify system
- v1.X.X Adding more profiles
I have created several sketches of configuring the radio with the ant-arduino library. You can find these in the examples folder. Here's an example of configuring a channel with a NRF51 radio:
AntWithCallbacks ant = AntWithCallbacks();
AntPlusRouter router = AntPlusRouter();
ProfileHeartRateMonitor hr = ProfileHeartRateMonitor(WILDCARD_DEVICE);
void previousHeartBeatDataPageHandler(HeartRatePreviousHeartBeat& dp, uintptr_t data) {
Serial.print("HR: ");
Serial.println(dp.getComputedHeartRate());
}
void setup() {
Serial1.begin(BAUD_RATE);
ant.setSerial(Serial1);
delay(10000);
router.setDriver(&ant); // never touch ant again
router.setAntPlusNetworkKey(NETWORK_KEY);
router.setProfile(CHANNEL_0, &hr);
// Delay after initial setup to wait for user to connect on serial
Serial.begin(BAUD_RATE);
Serial.println("Running");
hr.onHeartRatePreviousHeartBeat(previousHeartBeatDataPageHandler, NULL);
hr.begin();
// wait for pair to complete
hr.waitForPair();
}
void loop() {
router.loop();
}
See the examples folder for the full source. There are more examples in the download.
To add ANT support to a new sketch, add "#include <ANTPLUS.h>" (without quotes) to the top of your sketch. You can also add it by selecting the "sketch" menu, and choosing "Import Library->ANT+".
See ant-arduino
This library aims to support all ANT+ devices. This goal will take time but its an attainable one. Check out the wiki for the list of profiles implemented and their versions.
Note: This library depends on ant-arduino. You must have it installed for it to work. If you are using platformio you don't have to worry about this.
Arduino 1.5 and later
Arduino now includes a library manager for easier library installation. From the Sketch menu select include library->Manage Libraries, then type "antplus-arduino" in the filter and install.
Prior to Arduino 1.5 installation is manual
Download a .zip or .tar.gz release from github. Determine the location of your sketchbook by selecting "preferences" on the Arduino menu. Create a "libraries" folder in your sketchbook and unzip the release file in that location.
If you are using platformio you can install the library by running
platformio lib install 1879
Uploading sketches with a Leonardo is as simple as connecting the Arduino to your computer and uploading. When using a single serial port Arduino, such as the Pro Mini (3.3V), the jumpers on the ANT Radio must be disconnected. Then, after upload, reconnect the lines to have access to the serial port. Always remember to power off the Arduino before moving the jumpers.
See ant-arduino
Questions about this project should be posted to http://groups.google.com/group/antplus-api?pli=1 Be sure to provide as much detail as possible (e.g. what radios, firmware versions, configuration and code).
At the current time there is zero support for commercial usage. Contact me via email if you are looking to use this code commercially.
If you are looking for commercial support for ANT radios go to thisisant.com
NOTE: This library is not ANT+ certified and does not intend to be. It is meant to be tool to get quick and easy access to sensors in the ANT+ network. There are edge cases where it will fail to meet the spec of the ANT+ protocol.