Heart Rate collector demo application

Overview

This application is a sample implementation of Heart Rate collector as defined by HRP specification 1.0. All features are supported (i.e. both mandatory and optional features).

The application is controlled using command line interface exposed over UART2.

The application supports up to 8 simultaneous connections.

Installation procedure

The project is located in the projects/dk_apps/ble_profiles/hrp_collector folder.

To install the project follow the General Installation and Debugging Procedure.

Suggested Configurable parameters

Manual testing

The application is controlled using command line interface (CLI) which can be accessed using serial port available when platform is connected to PC using USB2 connector (e.g. /dev/ttyUSBx or COMx).

Quick start

To quickly scan and connect to sensor device:

1. Type scan start to start scanning for HRP Sensor devices.
2. When device is found, type scan stop to stop scanning.

   Scanning...
   [01] Device found: public C3:26:2B:63:B1:11 (Wahoo HRM v2.1)
   Scan stopped

3. Now you can connect to a device by using one of following methods:
   • type connect 1 to connect to 1st device found
   • type connect C3:26:2B:63:B1:11 to connect to device with given address

4. The connection is established and device is automatically discovered:

   Note

   The collector stores services of bonded sensors. Any subsequent connection to already bonded sensor will not generate additional GATT traffic. The sensor information is to be read from storage. During first connection bonding will not start automatically. Application verifies bond status on reconnection, thus any lose of encryption keys information will trigger pairing procedure and re-discovery of all services.

   Connecting to C3:26:2B:63:B1:11 ...
   Device connected
           Address: public C3:26:2B:63:B1:11
           Connection index: 0
   Security level changed
           Connection index: 0
           Security level: 2
   Browsing...
   Pairing completed
           Connection index: 0
           Status: 0x00
           Bond: 1
           MITM: 0
   Browse completed
           Heart Rate service found
           Device Information Service found
   Querying device...
           Manufacturer: Wahoo Fitness
           Body Sensor Location: chest
           Firmware version: 2.1
   Heart Rate Measurement notifications enabled
   Ready.

   As can be seen above, discovery includes following actions:

   • search for Device Information Service and read available characteristics,
   • search for Heart Rate Service and read available characteristics, e.g. sensor location,
   • enable notifications for measurement characteristic.
5. Initialization is finished when Ready. message is received, as above. You should see incoming measurement notifications as below.

   Heart Rate Measurement notification received
           Value: 67 bpm
           Sensor Contact: supported, not detected
           RR-Intervals: 918 932
    
   Heart Rate Measurement notification received
           Value: 67 bpm
           Sensor Contact: supported, not detected
           RR-Intervals: 935

6. To use full functionality of the application, check the complete list of commands below.

Available commands

<tt>scan <start|stop> [any]</tt>

Start and stop scanning procedure.

By default, the application scans for devices which include Heart Rate service UUID (0x180D) in advertising data. To scan for any device in range use optional any parameter, i.e. scan start any.

The returned list of devices includes an index, a device address and a device name (if available).

Note

The application can cache up to 25 devices. When this limit is reached, application stops filtering duplicated devices and any new devices found are reported with index 00.

<tt>connect <address [public|private] | index></tt>

Connect to peripheral device.

The device can be specified by either providing an address or an index of device found during last scan session.

The optional address type applies only when connecting to a device using an address. If not specified, the address type is searched on results from previous scan session or public is used when not available.

<tt>connect cancel</tt>

Cancel ongoing connection attempt.

Connection completed
        Status: 0x0c

<tt>notifications <conn_idx> <on|off></tt>

Enable and disable Heart Rate Measurement notifications on device with specified <conn_idx>.

This command is provided for debugging purposes. Notifications are always enabled after sensor is connected and there is no need to enable them explicitly.

<tt>disconnect [<conn_idx>]</tt>

Disconnect sensor with specified <conn_idx>. If <conn_idx> is not specified disconnect with first sensor on list of connected devices

Note

To see that list use command: show connected.

Disconnected from C3:26:2B:63:B1:11
Device disconnected
        Connection index: 0
        Reason: 0x16

<tt>reset_ee <conn_idx></tt>

Reset energy expended value

Note

Support for this command depends on capabilities of the sensor device since support for this features is optional as per HRP specification.

<tt>show [connected|bonded]</tt>

Show list of connected/bonded sensors

<tt>unbond [[public|private] <address> | all]</tt>

Unbond sensor with specified address or unbond all bonded sensors

Note

Write show bonded to see list of bonded sensors to unbond