BLE_HeartRate Application Description
How to use the Heart Rate profile as specified by the BLE SIG.
Keywords
Connectivity, BLE, BLE protocol, BLE pairing, BLE profile
Directory contents
- BLE_HeartRate/Core/Inc/app_common.h App Common application configuration file for STM32WPAN Middleware
- BLE_HeartRate/Core/Inc/app_conf.h Application configuration file for STM32WPAN Middleware
- BLE_HeartRate/Core/Inc/app_entry.h Interface to the application
- BLE_HeartRate/Core/Inc/main.h Header for main.c file. This file contains the common defines of the application
- BLE_HeartRate/Core/Inc/stm32wbaxx_hal_conf.h HAL configuration file
- BLE_HeartRate/Core/Inc/stm32wbaxx_it.h This file contains the headers of the interrupt handlers
- BLE_HeartRate/Core/Inc/stm32wbaxx_nucleo_conf.h STM32WBAXX nucleo board configuration file. This file should be copied to the application folder and renamed to stm32wbaxx_nucleo_conf.h
- BLE_HeartRate/Core/Inc/utilities_conf.h Header for configuration file for STM32 Utilities
- BLE_HeartRate/STM32_WPAN/App/app_ble.h Header for ble application
- BLE_HeartRate/STM32_WPAN/App/ble_conf.h Configuration file for BLE Middleware
- BLE_HeartRate/STM32_WPAN/App/ble_dbg_conf.h Debug configuration file for BLE Middleware
- BLE_HeartRate/STM32_WPAN/App/dis.h Header for service2.c
- BLE_HeartRate/STM32_WPAN/App/dis_app.h Header for service2_app.c
- BLE_HeartRate/STM32_WPAN/App/hrs.h Header for service1.c
- BLE_HeartRate/STM32_WPAN/App/hrs_app.h Header for service1_app.c
- BLE_HeartRate/STM32_WPAN/Target/bpka.h This file contains the interface of the BLE PKA module
- BLE_HeartRate/STM32_WPAN/Target/host_stack_if.h This file contains the interface for the stack tasks
- BLE_HeartRate/STM32_WPAN/Target/ll_sys_if.h Header file for ll_sys_if.c
- BLE_HeartRate/System/Config/ADC_Ctrl/adc_ctrl_conf.h Configuration Header for ADC controller module
- BLE_HeartRate/System/Config/CRC_Ctrl/crc_ctrl_conf.h Configuration Header for CRC controller module
- BLE_HeartRate/System/Config/Debug_GPIO/app_debug.h Real Time Debug module application APIs and signal table
- BLE_HeartRate/System/Config/Debug_GPIO/app_debug_signal_def.h Real Time Debug module application signal definition
- BLE_HeartRate/System/Config/Debug_GPIO/debug_config.h Real Time Debug module general configuration file
- BLE_HeartRate/System/Config/Flash/simple_nvm_arbiter_conf.h Configuration header for simple_nvm_arbiter.c module
- BLE_HeartRate/System/Config/Log/log_module.h Configuration Header for log module
- BLE_HeartRate/System/Config/LowPower/app_sys.h Header for app_sys.c
- BLE_HeartRate/System/Config/LowPower/peripheral_init.h Header for peripheral init module
- BLE_HeartRate/System/Config/LowPower/user_low_power_config.h Header for user_low_power_config.c
- BLE_HeartRate/System/Interfaces/hw.h This file contains the interface of STM32 HW drivers
- BLE_HeartRate/System/Interfaces/hw_if.h Hardware Interface
- BLE_HeartRate/System/Interfaces/stm32_lpm_if.h Header for stm32_lpm_if.c module (device specific LP management)
- BLE_HeartRate/System/Interfaces/timer_if.h configuration of the timer_if.c instances
- BLE_HeartRate/System/Interfaces/usart_if.h Header file for stm32_adv_trace interface file
- BLE_HeartRate/System/Modules/adc_ctrl.h Header for ADC client manager module
- BLE_HeartRate/System/Modules/ble_timer.h This header defines the timer functions used by the BLE stack
- BLE_HeartRate/System/Modules/crc_ctrl.h Header for CRC client manager module
- BLE_HeartRate/System/Modules/dbg_trace.h Header for dbg_trace.c
- BLE_HeartRate/System/Modules/otp.h Header file for One Time Programmable (OTP) area
- BLE_HeartRate/System/Modules/scm.h Header for scm.c module
- BLE_HeartRate/System/Modules/stm_list.h Header file for linked list library
- BLE_HeartRate/System/Modules/temp_measurement.h Header file for temperature measurement module
- BLE_HeartRate/System/Modules/utilities_common.h Common file to utilities
- BLE_HeartRate/System/Modules/baes/baes.h This file contains the interface of the basic AES software module
- BLE_HeartRate/System/Modules/baes/baes_global.h This file contains the internal definitions of the AES software module
- BLE_HeartRate/System/Modules/Flash/flash_driver.h Header for flash_driver.c module
- BLE_HeartRate/System/Modules/Flash/flash_manager.h Header for flash_manager.c module
- BLE_HeartRate/System/Modules/Flash/rf_timing_synchro.h Header for rf_timing_synchro.c module
- BLE_HeartRate/System/Modules/Flash/simple_nvm_arbiter.h Header for simple_nvm_arbiter.c module
- BLE_HeartRate/System/Modules/Flash/simple_nvm_arbiter_common.h Common header of simple_nvm_arbiter.c module
- BLE_HeartRate/System/Modules/MemoryManager/advanced_memory_manager.h Header for advance_memory_manager.c module
- BLE_HeartRate/System/Modules/MemoryManager/stm32_mm.h Header for stm32_mm.c module
- BLE_HeartRate/System/Modules/Nvm/nvm.h This file contains the interface of the NVM manager
- BLE_HeartRate/System/Modules/RFControl/rf_antenna_switch.h RF related module to handle dedictated GPIOs for antenna switch
- BLE_HeartRate/System/Modules/RTDebug/debug_signals.h Real Time Debug module System and Link Layer signal definition
- BLE_HeartRate/System/Modules/RTDebug/local_debug_tables.h Real Time Debug module System and Link Layer signal
- BLE_HeartRate/System/Modules/RTDebug/RTDebug.h Real Time Debug module API declaration
- BLE_HeartRate/System/Modules/RTDebug/RTDebug_dtb.h Real Time Debug module API declaration for DTB usage
- BLE_HeartRate/System/Modules/SerialCmdInterpreter/serial_cmd_interpreter.h Header file for the serial commands interpreter module
- BLE_HeartRate/Core/Src/app_entry.c Entry point of the application
- BLE_HeartRate/Core/Src/main.c Main program body
- BLE_HeartRate/Core/Src/stm32wbaxx_hal_msp.c This file provides code for the MSP Initialization and de-Initialization codes
- BLE_HeartRate/Core/Src/stm32wbaxx_it.c Interrupt Service Routines
- BLE_HeartRate/Core/Src/system_stm32wbaxx.c CMSIS Cortex-M33 Device Peripheral Access Layer System Source File
- BLE_HeartRate/STM32_WPAN/App/app_ble.c BLE Application
- BLE_HeartRate/STM32_WPAN/App/dis.c service2 definition
- BLE_HeartRate/STM32_WPAN/App/dis_app.c service2_app application definition
- BLE_HeartRate/STM32_WPAN/App/hrs.c service1 definition
- BLE_HeartRate/STM32_WPAN/App/hrs_app.c service1_app application definition
- BLE_HeartRate/STM32_WPAN/Target/bleplat.c This file implements the platform functions for BLE stack library
- BLE_HeartRate/STM32_WPAN/Target/bpka.c This file implements the BLE PKA module
- BLE_HeartRate/STM32_WPAN/Target/host_stack_if.c Source file for the stack tasks
- BLE_HeartRate/STM32_WPAN/Target/linklayer_plat.c Source file for the linklayer plateform adaptation layer
- BLE_HeartRate/STM32_WPAN/Target/ll_sys_if.c Source file for initiating the system sequencer
- BLE_HeartRate/STM32_WPAN/Target/power_table.c This file contains supported power tables
- BLE_HeartRate/System/Config/ADC_Ctrl/adc_ctrl_conf.c Source for ADC client controller module configuration file
- BLE_HeartRate/System/Config/CRC_Ctrl/crc_ctrl_conf.c Source for CRC client controller module configuration file
- BLE_HeartRate/System/Config/Debug_GPIO/app_debug.c Real Time Debug module application side APIs
- BLE_HeartRate/System/Config/Log/log_module.c Source file of the log module
- BLE_HeartRate/System/Config/LowPower/user_low_power_config.c Low power related user configuration
- BLE_HeartRate/System/Config/LowPower/peripheral_init.c Source for peripheral init module
- BLE_HeartRate/System/Interfaces/hw_aes.c This file contains the AES driver for STM32WBA
- BLE_HeartRate/System/Interfaces/hw_otp.c This file contains the OTP driver
- BLE_HeartRate/System/Interfaces/hw_pka.c This file contains the PKA driver for STM32WBA
- BLE_HeartRate/System/Interfaces/hw_rng.c This file contains the RNG driver for STM32WBA
- BLE_HeartRate/System/Interfaces/pka_p256.c This file is an optional part of the PKA driver for STM32WBA. It is dedicated to the P256 elliptic curve
- BLE_HeartRate/System/Interfaces/stm32_lpm_if.c Low layer function to enter/exit low power modes (stop, sleep)
- BLE_HeartRate/System/Interfaces/timer_if.c Configure RTC Alarm, Tick and Calendar manager
- BLE_HeartRate/System/Interfaces/usart_if.c Source file for interfacing the stm32_adv_trace to hardware
- BLE_HeartRate/System/Modules/adc_ctrl.c Header for ADC client manager module
- BLE_HeartRate/System/Modules/app_sys.c Application system for STM32WPAN Middleware
- BLE_HeartRate/System/Modules/ble_timer.c This module implements the timer core functions
- BLE_HeartRate/System/Modules/crc_ctrl.c Source for CRC client controller module
- BLE_HeartRate/System/Modules/otp.c Source file for One Time Programmable (OTP) area
- BLE_HeartRate/System/Modules/scm.c Functions for the System Clock Manager
- BLE_HeartRate/System/Modules/stm_list.c TCircular Linked List Implementation
- BLE_HeartRate/System/Modules/temp_measurement.c Temperature measurement module
- BLE_HeartRate/System/Modules/baes/baes_cmac.c This file contains the AES CMAC implementation
- BLE_HeartRate/System/Modules/baes/baes_ecb.c This file contains the AES ECB functions implementation
- BLE_HeartRate/System/Modules/Flash/flash_driver.c The Flash Driver module is the interface layer between Flash management modules and HAL Flash drivers
- BLE_HeartRate/System/Modules/Flash/flash_manager.c The Flash Manager module provides an interface to write raw data from SRAM to FLASH
- BLE_HeartRate/System/Modules/Flash/rf_timing_synchro.c The RF Timing Synchronization module provides an interface to synchronize the flash processing versus the RF activity to make sure the RF timing is not broken
- BLE_HeartRate/System/Modules/Flash/simple_nvm_arbiter.c The Simple NVM arbiter module provides an interface to write and/or restore data from SRAM to FLASH with use of NVMs
- BLE_HeartRate/System/Modules/MemoryManager/advanced_memory_manager.c Memory Manager
- BLE_HeartRate/System/Modules/MemoryManager/stm32_mm.c Memory Manager
- BLE_HeartRate/System/Modules/Nvm/nvm_emul.c This file implements the RAM version of the NVM manager for STM32WBX. It is made for test purpose
- BLE_HeartRate/System/Modules/RFControl/rf_antenna_switch.c RF related module to handle dedictated GPIOs for antenna switch
- BLE_HeartRate/System/Modules/RTDebug/RTDebug.c Real Time Debug module API definition
- BLE_HeartRate/System/Modules/RTDebug/RTDebug_dtb.c Real Time Debug module API definition for DTB usage
- BLE_HeartRate/System/Modules/SerialCmdInterpreter/serial_cmd_interpreter.c Source file for the serial commands interpreter module
Hardware and Software environment
- This example runs on STM32WBA55xx devices.
- Connect the Nucleo Board to your PC with a USB cable type A to mini-B to ST-LINK connector (USB_STLINK).
- This application is by default configured to support low power mode ( No traces - No debugger )
- Low Power configuration can be modified in app_conf.h (CFG_LPM_LEVEL)
How to use it?
In order to make the program work, you must do the following: - Open IAR toolchain - Rebuild all files and flash the board with the executable file
On the android/ios device, enable the Bluetooth communications, and if not done before:
- Install the ST BLE Toolbox application on the android device:
- You can also install the ST BLE Sensor application on the android/ios device:
Power on the Nucleo board with the BLE_HeartRate application.
Then, click on the App icon, ST BLE Toolbox (android/ios device), You can either open ST BLE Sensor application (android/ios device).
- In the Heart Rate interface, HearRate and energy measurement are launched and displayed in graphs, you can reset the energy measurement.
- Pairing is supported: button B2 clears the security database when the device is not connected. When connected with a client, button B2 send the slave pairing request, here a popup asks you to associate your device. You can either bond from the smartphone by clicking on Bond button in the ST BLE Toolbox application interface.
- This example supports switch to 2Mbits PHY, pressing button B1 while connected allows to switch between 1Mbits PHY and 2Mbits PHY.
- After 60s of advertising, the application switch from fast advertising to low power advertising, pressing button B1 while advertising allows to restart fast advertising.
- Pressing button B3 while connected allows to update the connection interval.