Documentation

// MAX30102 Heart Rate Sensor - Arduino Example
// Uses the SparkFun MAX3010x library
// Install: Arduino Library Manager -> search "SparkFun MAX3010x"
// I2C Pins: A4 (SDA), A5 (SCL)

#include <Wire.h>
#include "MAX30105.h"
#include "heartRate.h"

MAX30105 particleSensor;

const byte RATE_SIZE = 4;
byte rates[RATE_SIZE];
byte rateSpot = 0;
long lastBeat = 0;
float beatsPerMinute;
int beatAvg;

void setup() {
  Serial.begin(9600);
  Serial.println("MAX30102 Heart Rate Sensor");

  // Initialize sensor
  if (!particleSensor.begin(Wire, I2C_SPEED_FAST)) {
    Serial.println("MAX30102 not found. Check wiring.");
    while (1);
  }

  Serial.println("Place your finger on the sensor.");
  particleSensor.setup();
  particleSensor.setPulseAmplitudeRed(0x0A);
  particleSensor.setPulseAmplitudeGreen(0);
}

void loop() {
  long irValue = particleSensor.getIR();

  if (checkForBeat(irValue) == true) {
    long delta = millis() - lastBeat;
    lastBeat = millis();

    beatsPerMinute = 60 / (delta / 1000.0);

    if (beatsPerMinute < 255 && beatsPerMinute > 20) {
      rates[rateSpot++] = (byte)beatsPerMinute;
      rateSpot %= RATE_SIZE;

      // Calculate average BPM
      beatAvg = 0;
      for (byte x = 0; x < RATE_SIZE; x++)
        beatAvg += rates[x];
      beatAvg /= RATE_SIZE;
    }
  }

  Serial.print("IR=");
  Serial.print(irValue);
  Serial.print(", BPM=");
  Serial.print(beatsPerMinute);
  Serial.print(", Avg BPM=");
  Serial.println(beatAvg);

  if (irValue < 50000)
    Serial.println("No finger detected");
}

#!/usr/bin/env python3
# MAX30102 Heart Rate Sensor - Raspberry Pi Example
# Install: pip3 install max30102 smbus2
# I2C Pins: GPIO 2 (SDA), GPIO 3 (SCL)
# Enable I2C first: sudo raspi-config -> Interface Options -> I2C

from max30102 import MAX30102
import time

# Initialize the sensor on I2C bus 1
sensor = MAX30102(bus=1)

# Check if sensor is connected
if not sensor.check():
    print("MAX30102 not found. Check wiring.")
    exit(1)

print("MAX30102 Heart Rate Sensor")
print("Place your finger on the sensor...")
print("Press Ctrl+C to stop")

try:
    while True:
        # Read a batch of samples from the sensor
        red, ir = sensor.read_sequential()

        if len(ir) > 0:
            # Calculate average IR value (used for finger detection)
            avg_ir = sum(ir) / len(ir)

            if avg_ir < 50000:
                print("No finger detected")
            else:
                print("IR: {:.0f}, Red: {:.0f}".format(
                    sum(ir) / len(ir),
                    sum(red) / len(red)
                ))

        time.sleep(0.1)

except KeyboardInterrupt:
    print("\nMeasurement stopped by user")
finally:
    sensor.shutdown()

# MAX30102 Heart Rate Sensor - Pico MicroPython Example
# Install library: import mip; mip.install("github:n-undertaker/micropython-max30102")
# I2C Pins: GP0 (SDA), GP1 (SCL)

from machine import Pin, I2C, SoftI2C
from max30102 import MAX30102
import time

# Initialize I2C bus
i2c = SoftI2C(sda=Pin(0), scl=Pin(1), freq=400000)

# Scan for devices to verify connection
devices = i2c.scan()
print("I2C devices found:", [hex(d) for d in devices])

# Initialize the MAX30102 sensor
sensor = MAX30102(i2c=i2c)

# Check sensor is responding
if sensor.i2c_address not in devices:
    print("MAX30102 not found. Check wiring.")
    raise SystemExit

# Configure the sensor
sensor.setup_sensor()

print("MAX30102 Heart Rate Sensor")
print("Place your finger on the sensor...")

while True:
    # Check if new data is available
    sensor.check()

    if sensor.available():
        # Read red and IR values
        red = sensor.pop_red_from_storage()
        ir = sensor.pop_ir_from_storage()

        if ir < 50000:
            print("No finger detected")
        else:
            print("IR: {}, Red: {}".format(ir, red))

    time.sleep_ms(10)

# MAX30102 Heart Rate Sensor - ESP32 MicroPython Example
# Install library: import mip; mip.install("github:n-undertaker/micropython-max30102")
# I2C Pins: GPIO 21 (SDA), GPIO 22 (SCL)

from machine import Pin, SoftI2C
from max30102 import MAX30102
import time

# Initialize I2C bus (ESP32 default I2C pins)
i2c = SoftI2C(sda=Pin(21), scl=Pin(22), freq=400000)

# Scan for devices
devices = i2c.scan()
print("I2C devices found:", [hex(d) for d in devices])

# Initialize the MAX30102 sensor
sensor = MAX30102(i2c=i2c)

if sensor.i2c_address not in devices:
    print("MAX30102 not found. Check wiring.")
    raise SystemExit

# Configure the sensor
sensor.setup_sensor()

print("MAX30102 Heart Rate Sensor")
print("Place your finger on the sensor...")

while True:
    sensor.check()

    if sensor.available():
        red = sensor.pop_red_from_storage()
        ir = sensor.pop_ir_from_storage()

        if ir < 50000:
            print("No finger detected")
        else:
            print("IR: {}, Red: {}".format(ir, red))

    time.sleep_ms(10)