Labs / Electronic modules

GraftSense: A Heart Rate and Blood Oxygen Sensor Module Based on MAX30100 (Open Version)

Author: Li Zisheng · Source: FreakStudio open documentation, v1.2 · License: CC BY 4.0 · Driver code (sensors/max30100_driver): MIT License

Contents
MAX30100
LED1 MAX30100 V1.0

I. Module Introduction

The heart rate and blood oxygen sensor module based on MAX30100 is a physiological signal acquisition module with the MAX30100 chip as the core, supports the I2C communication interface, and can accurately collect and output data related to heart rate and blood oxygen concentration;This module integrates 5V-to-3.3V and 5V-to-1.8V DC-DC conversion circuits, a 3.3V-to-1.8V level shifting circuit, a power filter circuit and a power indicator. The main power supply voltage ranges from 1.7V to 1.8V, the LED power supply voltage ranges from 3.1V to 5.0V, the typical current in operating mode is approximately 600μA, and the typical current in sleep mode is only 0.7μA, featuring low power consumption and stable power supply;The device address is 0xAE, the read address is 0xAF, I2C clock frequency supports 0~400kHz, it also features ambient light rejection (ALR) and anti-interference design, which can work stably under strong light environment of 100Klux; equipped with standard I2C interface and mounting holes, it is suitable for scenarios such as wearable health bands, portable heart rate and oximetry monitors, and household health monitoring devices, enabling convenient continuous monitoring of physiological indicators.

2. Introduction to Main Chips

2.1 Chip Overview

MAX30100

MAX30100 is an integrated pulse oximetry and heart rate monitoring sensor chip designed specifically for wearable health scenarios. It integrates two LEDs, a photodetector, optimized optical components, and a low-noise analog signal processing circuit, capable of directly detecting and outputting blood oxygen saturation and heart rate signals; the chip supports dual power supplies of 1.8V and 3.3V, and can achieve low-power shutdown via software. Its typical current in sleep mode is only 0.7μA, allowing the power supply to remain connected for a long time with almost no power consumption;It features a high signal-to-noise ratio, effectively resists motion artifacts, integrates ambient light suppression, supports programmable sampling rate and LED current to optimize power consumption, and boasts high sampling rate and fast data output capability; adopting a compact 14-pin optical-enhanced system-in-package measuring 5.6mm×2.8mm×1.2mm, it simplifies the design of terminal devices, is suitable for scenarios such as wearable devices, fitness assistance devices and medical monitoring devices, and can effectively extend the battery life of wearable devices.

2.2 Pin Definition

MAX30100 1 14 7 8 2 3 I2C 4 5

The pins of the MAX30100 can be categorized into several types according to their functions, as briefly described below:

2.3 Functional Block Diagram

MAX30100 660nm 880nm I2C
MAX30100 660nm 880nm 16 I2C

The functional block diagram of the MAX30100 illustrates its complete working process from optical signal transmission to data output:

  1. The LED driver module inside the chip drives the red (660nm) and infrared (880nm) LEDs to emit pulsed light of specific wavelengths, which penetrate the skin and are then received by the photodetector.
  2. The signal output by the detector enters the analog processing unit, where ambient light interference is first eliminated via the Ambient Light Cancellation (ALC) circuit, before being converted into a digital signal by a 16-bit Σ-Δ ADC.
  3. The digital signal is processed by the built-in discrete-time filter and then stored in the data register. Meanwhile, the on-chip temperature sensor collects temperature data to compensate for environmental errors in blood oxygen calculation.
  4. Finally, the processed heart rate, blood oxygen and temperature data can be output to an external main control device via the I2C communication interface (SCL clock, SDA data), and can also actively trigger external notifications through the interrupt pin (INT).

The entire system is clocked by an internal oscillator, and supports software-configurable parameters such as LED current, pulse width and sampling rate, which optimizes power consumption while ensuring monitoring accuracy to adapt to the low-power requirements of wearable devices.

2.4 Performance Parameters

MAX30100 150 170 1.7V 2.0V 1.8V 3.1V 5.0V 3.3V
MAX30100 870nm 660nm 1
MAX30100 I2C 0.4V 200mV 400kHz 900ns

The key parameters of the MAX30100 cover core dimensions including power supply, sensors, communication and environmental adaptation:

Sensor Performance:

In terms of communication, this device adopts the I2C interface, with a device write address of 0xAE and a read address of 0xAF, supports a clock frequency ranging from 0 to 400kHz, features a typical output low voltage of 0.4V and an input capacitance of 10pF to ensure stable communication; in terms of environmental adaptability, both its operating and storage temperature ranges are -40℃ to + 85℃, making it compatible with complex application scenarios of wearable devices.

MAX30100 30

These typical operating characteristic curves illustrate MAX30100 the performance variation trends under different conditions such as voltage, temperature, current and distance, which can help engineers evaluate and optimize the operating status of the module in practical designs.

1.8V 3.3V 25 30 900nm 25mA

These typical operating characteristic curves focus on the LED optical and electrical properties of the MAX30100, reflect the variation law of its performance with conditions such as temperature and current, and serve as an important basis for optical and driver circuit design:

2.5 Reference Circuit

MAX30100 1.8V 1 3.3V 10 660nm 880nm I2C 4.7k

The typical reference circuit design of the MAX30100 is concise, and only a small number of external components are required to realize its full functions:

The chip has integrated functional modules such as ambient light suppression, ADC conversion, and digital filtering, which can complete the acquisition, processing and output of heart rate and blood oxygen signals without additional complex circuits, and the overall circuit adapts to the design requirements of miniaturization and low power consumption of wearable devices.

2.6 Chip Configuration

None.

MAX30100 0x00 0x02 0x03 0x06 0x09 0x16 0x17 0xFE 0xFF
MAX30100 0x00 SP02_RDY 7 6 5 4 0
MAX30100 0x01 8 0x02 0x03 0x04 0x05 0x02-0x05
MAX30100 I2C
MAX30100
MAX30100 0x06 2 0 010 SPO2 011
MAX30100 SpO2 0x07 6 SPO2_HI_RES_EN 5 4 1 0 2
MAX30100 1 0 0x09 3
MAX30100 0x16 0x17 7 0 3 0x00 0x7E 126

The MAX30100 implements full functional control and data interaction through a structured register system, which is accessible via the I2C interface and covers core functions including status and interrupt management, FIFO data buffering, operating mode configuration, LED parameter adjustment, temperature data reading, and device identification.

The entire register system supports flexible software configuration to adapt to the requirements of low power consumption and multi-scenario monitoring for wearable devices.

MAX30100 8 9 50 1000 200 400 800 1600 13
10 12 11 13 MAX30100
MAX30100 SpO2 3.1mA 35mA 8 16 32 0.1 15ms 30ms
MAX30100 SpO2 1 15 15ms 100ms
MAX30100

This section elaborates on the key design and operational details of the MAX30100 in practical applications:

For power-on, it is recommended to activate VDD first before supplying power to the LEDs; communication is realized via the I2C interface compatible with SMBus, which supports a maximum clock frequency of 400kHz and complies with the standard START/STOP and acknowledge protocols.

2.8 PCB Routing Precautions

None.

III. Instructions for Circuit Engineering and Module Usage

3.1 Circuit Source Engineering

To obtain the circuit source project, please follow the official account [Freak Embedded].

3.2 Module Usage Instructions

The schematic diagram of this module is shown below:

SCH_Blood Oxygen and Heart Rate Sensor Module Based on MAX30100_v1.0.pdf 3.0 MB

MAX30100 LED1 R1-R5 C1-C8 Q1-Q2 U1 I2C
MAX30100 V1.0 I2C

This module provides an I2C communication interface that supports standard I2C communication rates, with a default slave address configured as 0x57 for I2C. It is compatible with 3.3V system logic levels to adapt to mainstream microcontrollers, can stably transmit the heart rate and blood oxygen digital data corresponding to red light and infrared light detection, and is suitable for scenarios such as health monitoring devices and wearable maker projects, providing a convenient hardware connection solution for the digital collection of physiological parameters and system interaction.

During use, you need to keep the pad of your finger pressed continuously on the position shown in the diagram below to measure heart rate and blood oxygen-related data more accurately:

U1 C1 C2

Please note the following points when using it:

3.3 Application Experiment

Here, we use the GraftPort-RP2040 development board for testing, and the MAX30100-based blood oxygen and heart rate sensor module uses the I2C interface to communicate with the main controller.

Here, we first use the HY2.0-4P cable to connect the module to the GraftPort-RP2040 development board's I2C0 interface:

GraftPort-RP2040 HY2.0-4P I2C0

The module connections are shown in the following table:

Development Board Pins

Module Pins

Description

Pin 4

SDA

I2C data transmission line, corresponding to I2C0 's SDA

Pin 5

SCL

I2C clock signal line, corresponding to I2C0 's SCL

Here, we need to search for the relevant driver packages on uPyPI: https://upypi.net/zh/

106 0.0.20240521 max30100_driver MAX30100

Enter max30100_driver to search, and the following will be displayed:

max30100_driver 1.0.0 MAX30100

Click to copy the local installation command:

max30100_driver MAX30100 1.0.0

Here, we can import the module driver library code via the mip tool. The following are the usage commands for the mpremote tool:

mpremote mip install github:FreakStudioCN/GraftSense-Drivers-MicroPython/sensors/max30100_driver

Import the oximeter sensor module based on the MAX30100 chip - MicroPython driver code, then copy the following main.py code into our project:

# Python env   : MicroPython v1.27.0
# -*- coding: utf-8 -*-
# @Time    : 2026/02/03 11:00
# @Author  : hogeiha
# @File    : main.py
# @Description : MAX30100 IR + red + blood oxygen reading and calculation example

# ======================================== Import Modules =========================================

from machine import I2C, Pin
import max30100
import time

# ======================================== Global Variables ============================================

# ======================================== Functions ============================================

# ======================================== Custom Classes ============================================

# ======================================== Initialization ==========================================

# Power-on delay of 3 s
time.sleep(3)
# Print debug message
print("FreakStudio: Use the MAX30100 to read values and calculate blood oxygen levels..")

# I2C: SDA=GP4, SCL=GP5
i2c = I2C(0, scl=Pin((5)), sda=Pin((4)))

# Start scanning for devices on the I2C bus and return a list of slave addresses
devices_list: list[int] = i2c.scan()
print('START I2C SCANNER')
# If the devices list is empty, no device is connected to the I2C bus
if len(devices_list) == 0:
    # If not empty, print the slave device addresses
    print("No i2c device !")
else:
    # Iterate over the slave device address list
    print('i2c devices found:', len(devices_list))
for device in devices_list:
    # Check whether the device address is the BH_1750 address
    if device is 0x57:
        # Assume the first device found is the BH_1750 address
        print("I2c hexadecimal address:", hex(device))
        # Initialize the sensor instance
        sensor = max30100.MAX30100(i2c=i2c)
    else:
        raise Exception("No MAX30100 found")
# Load the default configuration
sensor.enable_spo2()

# Get the sensor ID
part_id = sensor.get_part_id()
# Get the chip revision ID
rev_id = sensor.get_rev_id()
print(f"MAX30100 Part ID: {part_id}, Revision ID: {rev_id}")

# ========================================  Main Program  ===========================================

while True:
    # Read the sensor data
    sensor.read_sensor()

    # Get the red light data
    red = sensor.red

    # Get the infrared data
    ir = sensor.ir

    # Calculate the blood oxygen saturation
    if ir:
        har = 100 - 25 * (red / ir)
        print(f"har:{har}")
    print(f"red:{red}")
    print(f"ir:{ir}")

    # Print all register values of the current sensor
    print(sensor.get_registers())
    time.sleep_ms(200)

Burn the code, open the terminal, and use the mpremote tool to connect to the main controller, place your finger on the sensor, and the output will be as follows:

65.9073 16504

As you can see, the routine can run properly and outputs RED, IR, and HAR; after sufficient data is collected, the blood oxygen value and register value will be output.

4. Drivers

max30100_driver.rar 9 KB

None.

VI. Revision History

Document Version

Date of Modification

Modifier

Revised Content

v1.0

2025-11-22

Li Zisheng

Initialize Document

v1.1

2026-02-12

Xin Ruili

Create an open version of the document based on the internal document version v1.0.

v1.2

2026-03-29

Xin Ruili

Modified the application experiment section

VII. Relevant Materials

7.1 Chip Datasheet

C92512_Heart Rate Sensor_MAX30100EFD+_Datasheet_Heart Rate Sensor_MAX30100EFD+_English Datasheet.PDF 875 KB

7.2 Unique Icons for PCB Silk Screen

7.2