Host software for the MAXREFDES220 Heart Rate Monitor Smart Sensor. Hosted on the MAX32630FTHR.

Dependencies:   max32630fthr USBDevice

Fork of MAXREFDES220_HEART_RATE_MONITOR by Maxim Integrated

Finger Heart Rate Monitor and SpO2 Monitor

The MAXREFDES220 Smart Sensor FeatherWing board is a integrated solution for providing finger-based heart rate measurements and SpO2 (blood oxygen saturation). This evaluation board interfaces to the host computer using the I2C interface. Heart rate outpu is available in beats per minute (BPM) and SpO2 is reported in percentages.; the PPG (photoplethysmography) raw data is also available. The board has an MAX30101 chip which is a low power heart rate monitor with adjustable sample rates and adjustable LED currents. The low cost MAX32664 microcontroller is pre-flashed with C code for finger-based pulse rate and SpO2 monitoring. Bootloader software is included to allow for future algorithms or updates to the algorithm from Maxim Integrated.

Ordering information will be available soon.

Note: SpO2 values are not calibrated. Calibration should be performed using the final end product.

Warning

The MAXREFDES220 source code listed is dated and only compatible with the 1.2.8a.msbl. The latest sample host source code is available on the MAX32664 website.

MAXREFDES220 FeatherWing Pinout Connections

/media/uploads/phonemacro/maxrefdes220_pinouts_heart_rate_monitor.jpg

Revision:
5:e458409e913f
Parent:
1:7a55c0c7d6d9
Child:
7:3e2a5545f1d8
--- a/Interfaces/SensorComm/SmartSensorComm/SSBootloader/SSBootloaderComm.cpp	Thu May 24 14:51:55 2018 -0700
+++ b/Interfaces/SensorComm/SmartSensorComm/SSBootloader/SSBootloaderComm.cpp	Thu May 24 14:54:28 2018 -0700
@@ -47,11 +47,18 @@
     "set_iv",
     "set_auth",
     "erase",
+    "page_erase",
     "flash",
+	"set_cfg bl enter_mode",
+	"set_cfg bl enter_pin",
+	"set_cfg bl enter_pol",
+	"set_cfg bl exit_mode",
+	"set_cfg bl exit_to",
+	"set_cfg bl save",
 };
 
 SSBootloaderComm::SSBootloaderComm(USBSerial *USB, SSInterface* ssInterface, DSInterface* dsInterface)
-    :SensorComm("bootldr", false), m_USB(USB), ss_int(ssInterface), ds_int(dsInterface)
+    :SensorComm("bl", false), m_USB(USB), ss_int(ssInterface), ds_int(dsInterface)
 {
 }
 
@@ -116,7 +123,6 @@
 
 bool SSBootloaderComm::parse_command(const char* cmd)
 {
-    const char *ptr_ch = NULL;
     int ret = EXIT_SUCCESS;
     bool recognizedCmd = false;
 
@@ -130,9 +136,7 @@
     }
 
     for (int i = 0; i < NUM_CMDS; i++) {
-        ptr_ch = strstr(cmd, cmd_tbl[i]);
-
-        if (*ptr_ch) {
+        if (starts_with(cmd, cmd_tbl[i])) {
             cmd_state_t user_cmd = (cmd_state_t)i;
             recognizedCmd = true;
 
@@ -142,9 +146,19 @@
 					SS_STATUS status;
 					status = ss_int->reset_to_bootloader();
 					if (status == SS_SUCCESS)
-	                    m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+	                    m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
 					else
-	                    m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+	                    m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER, SS_CMDIDX_STAY_IN_BTLRD };
+					status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
 
                     ds_int->set_fw_platform(ss_int->get_ss_platform_name());
                     ds_int->set_fw_version(ss_int->get_ss_fw_version());
@@ -157,9 +171,9 @@
                 {
 					SS_STATUS status = ss_int->reset_to_main_app();
                     if (status == SS_SUCCESS)
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
                     else
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
 
                     ds_int->set_fw_platform(ss_int->get_ss_platform_name());
                     ds_int->set_fw_version(ss_int->get_ss_fw_version());
@@ -170,10 +184,10 @@
                 {
 					SS_STATUS status = ss_int->reset();
                     if (status == SS_SUCCESS)
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
                     else
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
-                    m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, ret);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+                    m_USB->printf("\r\n%s err=%d\r\n", cmd, ret);
 
                     ds_int->set_fw_platform(ss_int->get_ss_platform_name());
                     ds_int->set_fw_version(ss_int->get_ss_fw_version());
@@ -195,19 +209,20 @@
                         page_size = (256*(int)rxbuf[1]) + rxbuf[2];
                         assert_msg(page_size <= MAX_PAGE_SIZE, "Page size exceeds maximum allowed");
 
-                        m_USB->printf("\r\n%s value=%d err=%d\r\n", ptr_ch, page_size, COMM_SUCCESS);
+                        m_USB->printf("\r\n%s value=%d err=%d\r\n", cmd, page_size, COMM_SUCCESS);
                         got_page_size = true;
 
                     } else {
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
                     }
                 } break;
 
                 case cmd_num_pages:
                 {
-                    int num_tok = sscanf(ptr_ch, "num_pages %d", &num_pages);
+                    int num_tok = sscanf(cmd, "num_pages %d", &num_pages);
                     if (num_tok != 1) {
-                        m_USB->printf("\r\n%s value=%d err=%d\r\n", ptr_ch, 0, COMM_INVALID_PARAM);
+                        m_USB->printf("\r\n%s value=%d err=%d\r\n", cmd, 0, COMM_INVALID_PARAM);
+						break;
                     }
 
                     uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER, SS_CMDIDX_SETNUMPAGES };
@@ -219,20 +234,20 @@
                             &data[0], ARRAY_SIZE(data));
 
                     if (status == SS_SUCCESS) {
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
                         sent_num_pages = true;
 
                     } else {
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
                     }
                 } break;
 
                 case cmd_set_iv:
                 {
                     uint8_t iv_bytes[AES_NONCE_SIZE];
-                    ret = parse_iv(ptr_ch, &iv_bytes[0]);
+                    ret = parse_iv(cmd, &iv_bytes[0]);
                     if (ret != COMM_SUCCESS) {
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, ret);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, ret);
                     }
                     else
                     {
@@ -243,10 +258,10 @@
                             &iv_bytes[0], ARRAY_SIZE(iv_bytes));
 
                         if (status == SS_SUCCESS) {
-                            m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                            m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
 
                         } else {
-                            m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                            m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
                         }
                     }
                 } break;
@@ -254,9 +269,9 @@
                 case cmd_set_auth:
                 {
                     uint8_t auth_bytes[AES_AUTH_SIZE];
-                    ret = parse_auth(ptr_ch, &auth_bytes[0]);
+                    ret = parse_auth(cmd, &auth_bytes[0]);
                     if (ret != COMM_SUCCESS) {
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, ret);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, ret);
                     }
                     else
                     {
@@ -267,10 +282,10 @@
                             &auth_bytes[0], ARRAY_SIZE(auth_bytes));
 
                         if (status == SS_SUCCESS) {
-                            m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                            m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
 
                         } else {
-                            m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                            m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
                         }
                     }
                 } break;
@@ -284,23 +299,162 @@
                             0, 0,
 							SS_BOOTLOADER_ERASE_DELAY);
                     if (status == SS_SUCCESS)
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
                     else
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+                } break;
+
+                case cmd_page_erase:
+                {
+					int page_num_to_erase;
+                    int num_tok = sscanf(cmd, "page_erase %d", &page_num_to_erase);
+                    if (num_tok != 1) {
+                        m_USB->printf("\r\n%s value=%d err=%d\r\n", cmd, 0, COMM_INVALID_PARAM);
+						break;
+                    }
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER, SS_CMDIDX_ERASE_PAGE };
+                    //num pages = 256*MSB + LSB
+                    uint8_t data[] = { (uint8_t)((page_num_to_erase >> 8) & 0xFF), (uint8_t)(page_num_to_erase & 0xFF) };
+
+                    SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            &data[0], ARRAY_SIZE(data), 50);
+
+                    if (status == SS_SUCCESS) {
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                        sent_num_pages = true;
+                    } else {
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+                    }
                 } break;
 
                 case cmd_flash:
                 {
                     if (got_page_size && sent_num_pages) {
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_SUCCESS);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
                         flash_page_data();
                     } else {
                         pr_err("Can't enter flash mode. Need number of pages, and size of page"
                                 "(num_pages, page_size, commands)\r\n");
-                        m_USB->printf("\r\n%s err=%d\r\n", ptr_ch, COMM_GENERAL_ERROR);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
                     }
                 } break;
 
+				case cmd_setcfg_bl_enter_mode:
+				{
+					uint8_t mode;
+					ret = parse_cmd_data(cmd, cmd_tbl[i], &mode, 1, false);
+					if (ret != 1) {
+						pr_err("parse_cmd_data=%d\r\n", ret);
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_INVALID_PARAM);
+						break;
+					}
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER_CFG, SS_CMDIDX_BL_ENTRY, SS_BL_CFG_ENTER_BL_MODE, mode };
+					SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+				} break;
+
+				case cmd_setcfg_bl_ebl_pin:
+				{
+					uint8_t pin[2];
+					ret = parse_cmd_data(cmd, cmd_tbl[i], &pin[0], 2, false);
+					if (ret != 2) {
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_INVALID_PARAM);
+						break;
+					}
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER_CFG, SS_CMDIDX_BL_ENTRY, SS_BL_CFG_EBL_PIN,
+											pin[0], pin[1]};
+					SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+				} break;
+
+				case cmd_setcfg_bl_ebl_pol:
+				{
+					uint8_t mode;
+					ret = parse_cmd_data(cmd, cmd_tbl[i], &mode, 1, false);
+					if (ret != 1) {
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_INVALID_PARAM);
+						break;
+					}
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER_CFG, SS_CMDIDX_BL_ENTRY, SS_BL_CFG_EBL_POL, mode };
+					SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+				} break;
+
+				case cmd_setcfg_bl_exit_mode:
+				{
+					uint8_t mode;
+					ret = parse_cmd_data(cmd, cmd_tbl[i], &mode, 1, false);
+					if (ret != 1) {
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_INVALID_PARAM);
+						break;
+					}
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER_CFG, SS_CMDIDX_BL_EXIT, SS_BL_CFG_EXIT_BL_MODE, mode };
+					SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+				} break;
+				case cmd_setcfg_bl_timeout:
+				{
+					uint8_t to;
+					ret = parse_cmd_data(cmd, cmd_tbl[i], &to, 1, false);
+					if (ret != 1) {
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_INVALID_PARAM);
+						break;
+					}
+
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER_CFG, SS_CMDIDX_BL_EXIT, SS_BL_CFG_TIMEOUT, to };
+					SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+				} break;
+				case cmd_setcfg_bl_save:
+				{
+                    uint8_t cmd_bytes[] = { SS_FAM_W_BOOTLOADER_CFG, SS_CMDIDX_BL_SAVE };
+
+					SS_STATUS status = ss_int->write_cmd(
+                            &cmd_bytes[0], ARRAY_SIZE(cmd_bytes),
+                            0, 0, 50);
+                    if (status == SS_SUCCESS)
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_SUCCESS);
+                    else
+                        m_USB->printf("\r\n%s err=%d\r\n", cmd, COMM_GENERAL_ERROR);
+
+				} break;
+
                 default:
                 {
                     assert_msg(false, "Invalid switch case!");