ecg3 2.0.0.0
Main Page

ECG 3 click

ECG 3 click is a complete solution for ECG and HR application development, utilizing a specialized IC with a clinical-grade analog front-end (AFE). ECG 3 click uses the MAX30003 IC, an ultra-low power, single-channel bio-sensor, which features a wide range of different options, making it an ideal solution for development of heart rate and ECG monitoring applications, fitness applications, for the ECG bio-authentication, and similar applications related to heart monitoring. ECG 3 click is also equipped with the 3.5mm electrodes connector, making it ready to be used out of the box.

click Product page

Click library

  • Author : MikroE Team
  • Date : Jan 2020.
  • Type : SPI type

Software Support

We provide a library for the Ecg3 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly form compilers IDE(recommended way), or downloaded from our LibStock, or found on mikroE github account.

Library Description

‍This library contains API for Ecg3 Click driver.

Standard key functions :

  • Config Object Initialization function.

    ‍void ecg3_cfg_setup ( ecg3_cfg_t *cfg );

    - Initialization function.

    ‍ECG3_RETVAL ecg3_init ( ecg3_t *ctx, ecg3_cfg_t *cfg );

  • Click Default Configuration function.

    ‍void ecg3_default_cfg ( ecg3_t *ctx );

Example key functions :

  • Function reads ECG data from FIFO register.

    ‍void ecg3_get_ecg ( ecg3_t *ctx, uint32_t *out_ecg );

    - Function checks a status flag for the desired interrupt.

    ‍uint8_t ecg3_check_status ( ecg3_t *ctx, uint32_t bit_mask );

  • Function reads Heart Rate and R - R data and calculates HR data to BPM, and RR data to ms.

    ‍void ecg3_get_rtor ( ecg3_t *ctx, uint16_t *out_hr, uint16_t *out_rr );

    Examples Description

‍This click is made for ECG and HR, equipped with an ultra-low power, single channel, integrated biopotential AFE, with the ECG and R-to-R detection functionality.

The demo application is composed of two sections :

Application Init

‍Initializes SPI interface and performs the all necessary configuration for device to work properly.

void application_init ( void )
{
log_cfg_t log_cfg;
ecg3_cfg_t cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
ecg3_cfg_setup( &cfg );
ECG3_MAP_MIKROBUS( cfg, MIKROBUS_1 );
ecg3_init( &ecg3, &cfg );
ecg3_sw_reset( &ecg3 );
ecg3_fifo_reset( &ecg3 );
Delay_ms ( 100 );
ecg3_default_cfg ( &ecg3 );
Delay_ms ( 300 );
}
ECG3_MAP_MIKROBUS
#define ECG3_MAP_MIKROBUS(cfg, mikrobus)
Definition ecg3.h:67
ecg3_init
ECG3_RETVAL ecg3_init(ecg3_t *ctx, ecg3_cfg_t *cfg)
Initialization function.
ecg3_fifo_reset
void ecg3_fifo_reset(ecg3_t *ctx)
FIFO Reset function.
ecg3_sw_reset
void ecg3_sw_reset(ecg3_t *ctx)
SW Reset function.
ecg3_default_cfg
void ecg3_default_cfg(ecg3_t *ctx)
Click Default Configuration function.
ecg3_cfg_setup
void ecg3_cfg_setup(ecg3_cfg_t *cfg)
Config Object Initialization function.
application_init
void application_init(void)
Definition main.c:76
ecg3_cfg_t
Click configuration structure definition.
Definition ecg3.h:345

Application Task

‍Reads ECG Data every 8ms and sends this data to the serial plotter.

void application_task ( void )
{
ecg3_get_ecg( &ecg3, &ecg_data );
plot_ecg( );
}
ecg3_get_ecg
void ecg3_get_ecg(ecg3_t *ctx, uint32_t *out_ecg)
ECG Get function.
application_task
void application_task(void)
Definition main.c:108
plot_ecg
void plot_ecg()
Definition main.c:45

Note

‍Additional Functions :

  • void plot_ecg() - Sends ECG Data to the serial plotter.
  • void log_rtor_() - Sends Heart Rate and R - R Data to the uart terminal.

The full application code, and ready to use projects can be installed directly form compilers IDE(recommneded) or found on LibStock page or mikroE GitHub accaunt.

Other mikroE Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.Ecg3

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all Mikroelektronika compilers, or any other terminal application of your choice, can be used to read the message.