Arduino library for the Maxim Integrated MAX30102 oximetry / heart rate sensor by Shivam Gupta [email protected]
Based on a library written for the older MAX30100 sensor by OXullo Intersecans [email protected] in 2016. It has been ported to work with MAX30102 sensor breakouts, and new functions have been added to the library such as channel control, so that all available functions of the device can be accessed with ease.
All algorithms and example codes are written by the above author [OXullo Intersecans [email protected]], this is a fork building on that to extend support. Original Library can be found here : https://github.com/oxullo/Arduino-MAX30100
vvvvvvvvvvvvvv Carried over content, changed to fit the experiments I performed: vvvvvvvvvvvvvv
The library is offered only for educational purposes and it is not meant for medical uses. Use it at your sole risk.
IMPORTANT: when submitting issues, make sure to fill ALL the fields indicated in the template text of the issue. The issue will be marked as invalid and closed immediately otherwise.
This library has been tested with two different breakout boards for MAX30102
https://robokits.co.in/sensors/heart-beat-sensor/max30102-oximetry-sensor-module
along with an Arduino UNO r3. Any Arduino supporting the Wire library should work.
The only required connection to the sensor is the I2C bus (SDA, SCL lines, pulled up).
An example which shows a possible way to wire up the sensor is shown in extras/arduino-wiring.pdf
Note: The schematics above shows also how to wire up the interrupt line, which is currently not used by the library.
Since the I2C interface is clocked at 400kHz, make sure that the SDA/SCL lines are pulled up by 4,7kOhm or less resistors.
The library offers a low-level driver class, MAX30102. This component allows for low level communication with the device.
A rather simple but working implementation of the heart rate and SpO2 calculation can be found in the PulseOximeter class.
This high level class sets up the sensor and data processing pipelines in order to offer a very simple interface to the data:
- Sampling frequency set to 100Hz
- 1600uS pulse width, full sampling 16bit dynamic
- IR LED current set to 50mA
- Heart-rate + SpO2 mode
The PulseOximeter class is not optimised for battery-based projects.
The included examples show how to use the PulseOximeter class:
- MAX30102_Minimal: a minimal example that dumps human-readable results via serial
- MAX30102_Debug: used in conjunction with the Processing pde "rolling_graph" (extras folder), to show the sampled data at various processing stages
- MAX30102_RawData: demonstrates how to access raw data from the sensor
- MAX30102_Tester: this sketch helps to find out potential issues with the sensor
Run the MAX30102_Tester example to inspect the state of your rig. When run with a properly connected sensor, it should print:
Initializing MAX30102..Success
Enabling HR/SPO2 mode..done.
Configuring LEDs biases to 50mA..done.
Lowering the current to 7.6mA..done.
Shutting down..done.
Resuming normal operation..done.
Sampling die temperature..done, temp=24.94C
All test pass. Press any key to go into sampling loop mode
Pressing any key, a data stream with the raw values from the photodiode sampling red and infrared is presented. With no finger on the sensor, both values should be close to zero and jump up when a finger is positioned on top of the sensor.
Typical issues when attempting to run the examples:
In particular when the tester fails with:
Initializing MAX30102..FAILED: I2C error
This is likely to be caused by an improper pullup setup for the I2C lines. Make sure to use 4,7kOhm resistors, checking if the breakout board in use is equipped with pullups.
If you're using a 5V-based microcontroller but the sensor breakout board pulls SDA and SCL up to 3.3V, you should ensure that its inputs are compatible with the 3.3V logic levels. An original Atmel ATMega328p considers anything above 3V as HIGH, so it might work well without level shifting hardware.
Since the MAX30102 I2C pins maximum ratings aren't bound to Vdd, a cheap option to avoid level shifting is to simply pull SDA and SCL up to 5V instead of 3.3V.
The beat detector uses the IR LED to track the heartbeat. The IR LED is biased by default at 50mA on all examples, excluding the Tester (which sets it to 7.6mA). This value is somehow critical and it must be experimented with.
The current can be adjusted using PulseOximeter::setIRLedCurrent(). Check the MAX30102_Minimal example.
Two tools are available for further inspection and error reporting:
- extras/recorder: a python script that records a session that can be then analysed with the provided collection of jupyter notebooks
- extras/rolling_graph: to be used in conjunction with MAX30102_Debug example, it provides a visual feedback of the LED tracking and heartbeat detector
Both tools have additional information on the README.md in their respective directories.
#todo
This breakout board: http://www.sunrom.com/m/5337
Has pullups on the Vdd (1.8V) line. To make it work, the three 4k7 pullups must be desoldered and external 4.7k pullups to Vcc of the MCU must be added.