| nRF5 SDK v12.0.0 |

Choose documentation: | nRF5 SDK | S130 SoftDevice API | S132 SoftDevice API | S212 SoftDevice API | S332 SoftDevice API

All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Heart Rate Application
This example requires one of the following SoftDevices: S130, S132, S332

Important: Before you run this example, make sure to program a SoftDevice.

The Heart Rate Application is an example that implements the Heart Rate profile using the hardware delivered in the nRF5 Development Kit.

The application includes the three services in the Heart Rate profile:

- Heart Rate Service
- Battery Service
- Device Information Service

When the application starts, the Board Support Package is initialized. Next, three timers are started. These timers control the generation of various parts of the Heart Rate Measurement characteristic value:

- Heart Rate
- RR Interval
- Sensor Contact Detected

Also, a timer for generating battery measurements is started.

The sensor measurements are simulated the following way:

- Heart Rate: See Sensor Data Simulator.
- RR Interval: See Sensor Data Simulator.
- Sensor Contact: The state is toggled each time the timer expires.
- Battery Level: See Sensor Data Simulator.

When notification of Heart Rate Measurement characteristic is enabled, the Heart Rate Measurement, containing the current value for all the components of the Heart Rate Measurement characteristic, is notified each time the Heart Rate measurement timer expires. When notification of Battery Level characteristic is enabled, the Battery Level is notified each time the Battery Level measurement timer expires.

Note
  This application is not power optimized!
  The application will stop advertising after 3 minutes and go to system-off mode. Push the button 1 to restart advertising.

# Setup

You can find the source code and the project file of the example in the following folder: `<InstallFolder>\examples\ble_peripheral\ble_app_hrs`

Button assignments: BSP BLE Button Assignments

# Testing

Test the Heart Rate Application with the nRF Toolbox app, which is available on both iOS (App Store) and Android (Google Play).

You can also test the application with the Master Control Panel by performing the following steps:

1. Compile and program the application. Observe that the BSP_INDICATE_ADVERTISING state is indicated.
2. Connect to the device from Master Control Panel (the device will be advertising as 'Nordic_HRM'), then perform service discovery. Observe that the BSP_INDICATE_CONNECTED state is indicated.
3. Click the 'Enable services' button on the Master Control Panel. Observe that Heart Rate notifications are received every second, and Battery Level notifications are received every two seconds.