MBED firmware for MAXREFDES117 Heart Rate / SpO2 sensor. Tested on KL25Z, K64F, and MAX32600MBED#

Dependencies:   mbed

Embed: (wiki syntax)

« Back to documentation index

Show/hide line numbers main.cpp Source File

main.cpp

Go to the documentation of this file.
00001 /** \file main.cpp ******************************************************
00002 *
00003 * Project: MAXREFDES117#
00004 * Filename: main.cpp
00005 * Description: This module contains the Main application for the MAXREFDES117 example program.
00006 *
00007 *
00008 * --------------------------------------------------------------------
00009 *
00010 * This code follows the following naming conventions:
00011 *
00012 * char              ch_pmod_value
00013 * char (array)      s_pmod_s_string[16]
00014 * float             f_pmod_value
00015 * int32_t           n_pmod_value
00016 * int32_t (array)   an_pmod_value[16]
00017 * int16_t           w_pmod_value
00018 * int16_t (array)   aw_pmod_value[16]
00019 * uint16_t          uw_pmod_value
00020 * uint16_t (array)  auw_pmod_value[16]
00021 * uint8_t           uch_pmod_value
00022 * uint8_t (array)   auch_pmod_buffer[16]
00023 * uint32_t          un_pmod_value
00024 * int32_t *         pn_pmod_value
00025 *
00026 * ------------------------------------------------------------------------- */
00027 /*******************************************************************************
00028 * Copyright (C) 2016 Maxim Integrated Products, Inc., All Rights Reserved.
00029 *
00030 * Permission is hereby granted, free of charge, to any person obtaining a
00031 * copy of this software and associated documentation files (the "Software"),
00032 * to deal in the Software without restriction, including without limitation
00033 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
00034 * and/or sell copies of the Software, and to permit persons to whom the
00035 * Software is furnished to do so, subject to the following conditions:
00036 *
00037 * The above copyright notice and this permission notice shall be included
00038 * in all copies or substantial portions of the Software.
00039 *
00040 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
00041 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
00042 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
00043 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
00044 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
00045 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
00046 * OTHER DEALINGS IN THE SOFTWARE.
00047 *
00048 * Except as contained in this notice, the name of Maxim Integrated
00049 * Products, Inc. shall not be used except as stated in the Maxim Integrated
00050 * Products, Inc. Branding Policy.
00051 *
00052 * The mere transfer of this software does not imply any licenses
00053 * of trade secrets, proprietary technology, copyrights, patents,
00054 * trademarks, maskwork rights, or any other form of intellectual
00055 * property whatsoever. Maxim Integrated Products, Inc. retains all
00056 * ownership rights.
00057 *******************************************************************************
00058 */
00059 /*!\mainpage Main Page
00060 *
00061 * \section intro_sec Introduction
00062 *
00063 * This is the code documentation for the MAXREFDES117# subsystem reference design.
00064 * 
00065 *  The Files page contains the File List page and the Globals page.
00066 * 
00067 *  The Globals page contains the Functions, Variables, and Macros sub-pages.
00068 *
00069 * \image html MAXREFDES117_Block_Diagram.png "MAXREFDES117# System Block Diagram"
00070 * 
00071 * \image html MAXREFDES117_firmware_Flowchart.png "MAXREFDES117# Firmware Flowchart"
00072 *
00073 */
00074 #include "mbed.h"
00075 #include "algorithm.h"
00076 #include "MAX30102.h"
00077 
00078 #define MAX_BRIGHTNESS 255
00079 
00080 uint32_t aun_ir_buffer[500]; //IR LED sensor data
00081 int32_t n_ir_buffer_length;    //data length
00082 uint32_t aun_red_buffer[500];    //Red LED sensor data
00083 int32_t n_sp02; //SPO2 value
00084 int8_t ch_spo2_valid;   //indicator to show if the SP02 calculation is valid
00085 int32_t n_heart_rate;   //heart rate value
00086 int8_t  ch_hr_valid;    //indicator to show if the heart rate calculation is valid
00087 uint8_t uch_dummy;
00088 
00089 Serial pc(USBTX, USBRX);    //initializes the serial port
00090 #ifdef TARGET_KL25Z 
00091 PwmOut led(PTB18);  //initializes the pwm output that connects to the on board LED
00092 DigitalIn INT(PTD1);  //pin PTD1 connects to the interrupt output pin of the MAX30102
00093 #endif
00094 #ifdef TARGET_K64F
00095 DigitalIn INT(PTD1);  //pin PTD1 connects to the interrupt output pin of the MAX30102
00096 #endif
00097 #ifdef TARGET_MAX32600MBED
00098 PwmOut led(LED_RED);    //initializes the pwm output that connects to the on board LED
00099 DigitalIn INT(P2_0);  //pin P20 connects to the interrupt output pin of the MAX30102
00100 #endif
00101 
00102 // the setup routine runs once when you press reset:
00103 int main() { 
00104     uint32_t un_min, un_max, un_prev_data;  //variables to calculate the on-board LED brightness that reflects the heartbeats
00105     int i;
00106     int32_t n_brightness;
00107     float f_temp;
00108     
00109     maxim_max30102_reset(); //resets the MAX30102
00110     // initialize serial communication at 115200 bits per second:
00111     pc.baud(115200);
00112     pc.format(8,SerialBase::None,1);
00113     wait(1);
00114     
00115     //read and clear status register
00116     maxim_max30102_read_reg(0,&uch_dummy);
00117     
00118     //wait until the user presses a key
00119     while(pc.readable()==0)
00120     {
00121         pc.printf("\x1B[2J");  //clear terminal program screen
00122         pc.printf("Press any key to start conversion\n\r");
00123         wait(1);
00124     }
00125     uch_dummy=getchar();
00126     
00127     maxim_max30102_init();  //initializes the MAX30102
00128         
00129         
00130     n_brightness=0;
00131     un_min=0x3FFFF;
00132     un_max=0;
00133   
00134     n_ir_buffer_length=500; //buffer length of 100 stores 5 seconds of samples running at 100sps
00135     
00136     //read the first 500 samples, and determine the signal range
00137     for(i=0;i<n_ir_buffer_length;i++)
00138     {
00139         while(INT.read()==1);   //wait until the interrupt pin asserts
00140         
00141         maxim_max30102_read_fifo((aun_red_buffer+i), (aun_ir_buffer+i));  //read from MAX30102 FIFO
00142             
00143         if(un_min>aun_red_buffer[i])
00144             un_min=aun_red_buffer[i];    //update signal min
00145         if(un_max<aun_red_buffer[i])
00146             un_max=aun_red_buffer[i];    //update signal max
00147         pc.printf("red=");
00148         pc.printf("%i", aun_red_buffer[i]);
00149         pc.printf(", ir=");
00150         pc.printf("%i\n\r", aun_ir_buffer[i]);
00151     }
00152     un_prev_data=aun_red_buffer[i];
00153     
00154     
00155     //calculate heart rate and SpO2 after first 500 samples (first 5 seconds of samples)
00156     maxim_heart_rate_and_oxygen_saturation(aun_ir_buffer, n_ir_buffer_length, aun_red_buffer, &n_sp02, &ch_spo2_valid, &n_heart_rate, &ch_hr_valid); 
00157     
00158     //Continuously taking samples from MAX30102.  Heart rate and SpO2 are calculated every 1 second
00159     while(1)
00160     {
00161         i=0;
00162         un_min=0x3FFFF;
00163         un_max=0;
00164         
00165         //dumping the first 100 sets of samples in the memory and shift the last 400 sets of samples to the top
00166         for(i=100;i<500;i++)
00167         {
00168             aun_red_buffer[i-100]=aun_red_buffer[i];
00169             aun_ir_buffer[i-100]=aun_ir_buffer[i];
00170             
00171             //update the signal min and max
00172             if(un_min>aun_red_buffer[i])
00173             un_min=aun_red_buffer[i];
00174             if(un_max<aun_red_buffer[i])
00175             un_max=aun_red_buffer[i];
00176         }
00177         
00178         //take 100 sets of samples before calculating the heart rate.
00179         for(i=400;i<500;i++)
00180         {
00181             un_prev_data=aun_red_buffer[i-1];
00182             while(INT.read()==1);
00183             maxim_max30102_read_fifo((aun_red_buffer+i), (aun_ir_buffer+i));
00184         
00185             if(aun_red_buffer[i]>un_prev_data)
00186             {
00187                 f_temp=aun_red_buffer[i]-un_prev_data;
00188                 f_temp/=(un_max-un_min);
00189                 f_temp*=MAX_BRIGHTNESS;
00190                 n_brightness-=(int)f_temp;
00191                 if(n_brightness<0)
00192                     n_brightness=0;
00193             }
00194             else
00195             {
00196                 f_temp=un_prev_data-aun_red_buffer[i];
00197                 f_temp/=(un_max-un_min);
00198                 f_temp*=MAX_BRIGHTNESS;
00199                 n_brightness+=(int)f_temp;
00200                 if(n_brightness>MAX_BRIGHTNESS)
00201                     n_brightness=MAX_BRIGHTNESS;
00202             }
00203 #if defined(TARGET_KL25Z) || defined(TARGET_MAX32600MBED)
00204             led.write(1-(float)n_brightness/256);
00205 #endif
00206             //send samples and calculation result to terminal program through UART
00207             pc.printf("red=");
00208             pc.printf("%i", aun_red_buffer[i]);
00209             pc.printf(", ir=");
00210             pc.printf("%i", aun_ir_buffer[i]);
00211             pc.printf(", HR=%i, ", n_heart_rate); 
00212             pc.printf("HRvalid=%i, ", ch_hr_valid);
00213             pc.printf("SpO2=%i, ", n_sp02);
00214             pc.printf("SPO2Valid=%i\n\r", ch_spo2_valid);
00215         }
00216         maxim_heart_rate_and_oxygen_saturation(aun_ir_buffer, n_ir_buffer_length, aun_red_buffer, &n_sp02, &ch_spo2_valid, &n_heart_rate, &ch_hr_valid); 
00217     }
00218 }
00219