HeartHat

MAX30102 is a complete pulse oximetry and heart-rate sensor system solution designed for the demanding requirements of wearable devices.

Support the following products:

Micropython Example:

# SPDX-FileCopyrightText: 2024 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
from hardware import *
from hat import HeartHat


Heart = None
SPO2 = None
label0 = None
label1 = None
i2c0 = None
hat_heart_0 = None


def setup():
    global Heart, SPO2, label0, label1, i2c0, hat_heart_0

    M5.begin()
    Heart = Widgets.Label("Heart", 1, 2, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    SPO2 = Widgets.Label("SPO2", 3, 122, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label0 = Widgets.Label("0", 5, 45, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu40)
    label1 = Widgets.Label("0", 7, 169, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu40)

    i2c0 = I2C(0, scl=Pin(26), sda=Pin(0), freq=100000)
    hat_heart_0 = HeartHat(i2c0, 0x57)
    hat_heart_0.start()


def loop():
    global Heart, SPO2, label0, label1, i2c0, hat_heart_0
    M5.update()
    label0.setText(str(hat_heart_0.get_heart_rate()))
    label1.setText(str(hat_heart_0.get_spo2()))


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

UIFLOW2 Example:

stickc_heart_example.m5f2

class HeartHat

Constructors

class HeartHat(i2c, address)

Initialize the HeartHat.

• i2c: I2C port to use.

• address: I2C address of the HeartHat.

UIFLOW2:

Methods

HeartHat.stop()

Stop the HeartHat.

UIFLOW2:

HeartHat.start()

Start the HeartHat.

UIFLOW2:

HeartHat.deinit()

Deinitialize the HeartHat.

UIFLOW2:

HeartHat.get_heart_rate()

Get the heart rate.

UIFLOW2:

HeartHat.get_spo2()

Get the SpO2.

UIFLOW2:

HeartHat.get_ir()

Get the IR value.

UIFLOW2:

HeartHat.get_red()

Get the red value.

UIFLOW2:

HeartHat.set_mode(mode)

Set the mode of the HeartHat.

Parameters:

mode (int) – The detect mode of the HeartHat. Options: - HeartHat.MODE_HR_ONLY: Only heart rate - HeartHat.MODE_SPO2_HR: Heart rate and SpO2

UIFLOW2:

HeartHat.set_led_current(led_current)

Set the LED current of the HeartHat.

Parameters:

led_current (int) – The LED current of the HeartHat. Options: - HeartHat.LED_CURRENT_0MA: 0mA - HeartHat.LED_CURRENT_4_4MA: 4.4mA - HeartHat.LED_CURRENT_7_6MA: 7.6mA - HeartHat.LED_CURRENT_11MA: 11mA - HeartHat.LED_CURRENT_14_2MA: 14.2mA - HeartHat.LED_CURRENT_17_4MA: 17.4mA - HeartHat.LED_CURRENT_20_8MA: 20.8mA - HeartHat.LED_CURRENT_24MA: 24mA - HeartHat.LED_CURRENT_27_1MA: 27.1mA - HeartHat.LED_CURRENT_30_6MA: 30.6mA - HeartHat.LED_CURRENT_33_8MA: 33.8mA - HeartHat.LED_CURRENT_37MA: 37mA - HeartHat.LED_CURRENT_40_2MA: 40.2mA - HeartHat.LED_CURRENT_43_6MA: 43.6mA - HeartHat.LED_CURRENT_46_8MA: 46.8mA - HeartHat.LED_CURRENT_50MA: 50mA

UIFLOW2:

HeartHat.set_pulse_width(pulse_width)

Set the pulse width of the HeartHat.

Parameters:

pulse_width (int) – The pulse width of the HeartHat. Options: - HeartHat.PULSE_WIDTH_200US_ADC_13: 200us - HeartHat.PULSE_WIDTH_400US_ADC_14: 400us - HeartHat.PULSE_WIDTH_800US_ADC_15: 800us - HeartHat.PULSE_WIDTH_1600US_ADC_16: 1600us

UIFLOW2:

HeartHat.set_sampling_rate(sampling_rate)

Set the sampling rate of the HeartHat.

Parameters:

sampling_rate (int) – The sampling rate of the HeartHat. Options: - HeartHat.SAMPLING_RATE_50HZ: 50Hz - HeartHat.SAMPLING_RATE_100HZ: 100Hz - HeartHat.SAMPLING_RATE_167HZ: 167Hz - HeartHat.SAMPLING_RATE_200HZ: 200Hz - HeartHat.SAMPLING_RATE_400HZ: 400Hz - HeartHat.SAMPLING_RATE_600HZ: 600Hz - HeartHat.SAMPLING_RATE_800HZ: 800Hz - HeartHat.SAMPLING_RATE_1000HZ: 1000Hz

UIFLOW2:

Constants

HeartHat.MODE_HR_ONLY

Detect heart rate only.

HeartHat.MODE_SPO2_HR

Detect heart rate and SpO2.