ANT: ANT+ Bicycle Speed and Cadence Receiver
The Bicycle Speed and Cadence Receiver sample shows the usage of the ANT+ Bicycle Speed and Cadence profile.
Overview
This sample simulates the Bicycle Speed and Cadence Receiver. The Receiver application connects to the nearest speed and cadence transmitter in range and prints out incoming page data. The actual channel state is indicated by the ANT channel state indicator.
On dual core, this sample uses sysbuild to add a network core image to the build by defining the ‘’NRF_DEFAULT_ANT_ONLY’’ with a default value of ‘’y’’ in Kconfig.sysbuild.
Channel configuration
This example uses the default channel configuration for the combined BSC sensor:
Parameter |
Transmitter |
Receiver |
|---|---|---|
Channel type |
Master (0x10) |
Slave (0x00) |
Network key |
ANT+ |
ANT+ |
RF channel |
57 (2457 MHz) |
57 (2457 MHz) |
Device number |
0x31 (49) |
0x31 (49) |
Device type* |
0x79 (121) |
0x79 (121) |
Transmission type |
0x01 |
0x01 |
Channel period* |
8086 (4.05 Hz) |
8086 (4.05 Hz) |
*Parameters depend on type of BSC sensor configured
Requirements
Hardware platforms |
PCA |
Board name |
Build target |
nRF5340 DK |
PCA10095 |
nrf5340dk/nrf5340 |
nrf5340dk/nrf5340/cpuapp |
nRF52840 DK |
PCA10056 |
nrf52840dk/nrf52840 |
nrf52840dk/nrf52840 |
Building and running
This sample can be found under ant/samples/ant_plus/ant_bsc/bsc_rx in the nRF Connect SDK folder structure.
You can select the sensor type with the ‘’CONFIG_SENSOR_TYPE’’ value. There are three types of sensors that change which data can be received (speed, cadence, or both):
Combined Sensor (121), which can receive both speed and cadence data.
Cadence Sensor (122), which can only receive cadence data.
Speed Sensor (123), which can only receive speed data.
ANT+ Network Key
This sample selects CONFIG_ANT_KEY_MANAGER to provide access to ant_plus_key_set() (See ANT Key Manager Library). This library function configures the pre-defined ANT+ Network Key for ANT+ devices. Note that network keys, transmission type, device type IDs and RF channels are assigned and regulated to maintain
network integrity, and interoperability, except for the default public network.
For more information on Network Keys, visit https://www.thisisant.com/developer/ant-plus/ant-plus-basics/network-keys.
Testing
You can test the Bicycle Speed and Cadence Receiver by performing the following steps:
Compile and program the Bicycle Speed and Cadence Receiver.
Compile and program the BSC Transmitter to another supported board to act as a peer ANT device. Alternatively, use SimulANT+ as described below.
On the nRF DK side, connect to the virtual COM port to view the ANT+ BSC pages received. Below is an example from the combined speed and cadence reciever.
[00:00:00.276,611] <inf> ant_bsc: BSC RX Page Number: "Combined Speed & Cadence Page" [00:00:00.366,912] <inf> ant_bsc_combined_page_0: Cadence Revolution count: 183 [00:00:00.366,912] <inf> ant_bsc_combined_page_0: Cadence event time: 55.000s [00:00:00.366,912] <inf> ant_bsc_combined_page_0: Speed Revolution count: 347 [00:00:00.366,943] <inf> ant_bsc_combined_page_0: Speed event time: 54.988s [00:00:00.273,498] <inf> bsc_rx: Computed speed value: 14 kph [00:00:00.275,329] <inf> bsc_rx: Computed cadence value: 60 rpms [00:00:00.276,611] <inf> ant_bsc: BSC RX Page Number: "Combined Speed & Cadence Page" [00:00:00.366,912] <inf> ant_bsc_combined_page_0: Cadence Revolution count: 183 [00:00:00.366,912] <inf> ant_bsc_combined_page_0: Cadence event time: 55.000s [00:00:00.366,912] <inf> ant_bsc_combined_page_0: Speed Revolution count: 347 [00:00:00.366,943] <inf> ant_bsc_combined_page_0: Speed event time: 55.463s [00:00:00.273,498] <inf> bsc_rx: Computed speed value: 14 kph [00:00:00.275,329] <inf> bsc_rx: Computed cadence value: 60 rpms
Testing the BSC examples with the ANT+ Simulator tools
You can use the SimulANT+ Bicycle Speed and Cadence Sensor Simulators to test the Bicycle Speed and Cadence Receiver. Make sure the Device Number matches the Channel Configuration above (0x31) and use the correct Simulator depending on the BSC sensor type configured (speed, cadence, or speed and cadence sensor). See the documentation of the ANT+ Simulator tools at thisisant.com for information about how to use these tools.