ECG Module

这个库是 Module13.2 ECG 的驱动程序，模块通过 UART 进行通信。

支持以下产品：

UiFlow2 应用示例：

心率检测显示

在 UiFlow2 上打开 cores3_ecg_module_base_example.m5f2 项目。

本示例程序用于实时读取心率并显示心电波形。测量过程中，设备将连续绘制 ECG（心电图）波形，并在信号稳定后自动计算并显示心率数据。

心电电极连接：请按照以下方法正确连接心电电极：

右上(RA)：右上导联线放在胸骨右缘，锁骨中线第2肋间靠近右肩的位置。
左上(LA)：左上导联线位于胸骨左缘，锁骨中线第2肋间靠近左肩的位置。
左下(LL)：左下导联线放在左侧下腹部，髂嵴（hip bone）上方，或腹部左下侧。

测量注意事项：为了获得稳定、准确的心电信号，请遵循以下注意事项：

身体放松：避免肌肉紧张，以减少干扰信号。
静止不动：测量过程中尽量避免移动，以获得稳定的心电信号。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例：

心率检测显示

本示例程序用于实时读取心率并显示心电波形。测量过程中，设备将连续绘制 ECG（心电图）波形，并在信号稳定后自动计算并显示心率数据。

心电电极连接：请按照以下方法正确连接心电电极：

右上(RA)：右上导联线放在胸骨右缘，锁骨中线第2肋间靠近右肩的位置。
左上(LA)：左上导联线位于胸骨左缘，锁骨中线第2肋间靠近左肩的位置。
左下(LL)：左下导联线放在左侧下腹部，髂嵴（hip bone）上方，或腹部左下侧。

测量注意事项：为了获得稳定、准确的心电信号，请遵循以下注意事项：

身体放松：避免肌肉紧张，以减少干扰信号。
静止不动：测量过程中尽量避免移动，以获得稳定的心电信号。

MicroPython 应用示例：

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

import os, sys, io
import M5
from M5 import *
from module import ECGModule
import time
import m5utils


label0 = None
title0 = None
label_hr = None
ecg_0 = None
display_width = None
ecg_data = None
last_time = None
points = None
heartrate = None
new_ecg_data = None
new_ecg_data_len = None
data_max = None
data_min = None
i = None
y0 = None
y1 = None


def setup():
    global \
        label0, \
        title0, \
        label_hr, \
        ecg_0, \
        display_width, \
        ecg_data, \
        last_time, \
        points, \
        heartrate, \
        new_ecg_data, \
        new_ecg_data_len, \
        data_max, \
        data_min, \
        y0, \
        i, \
        y1

    M5.begin()
    label0 = Widgets.Label("HearRate:", 5, 35, 1.0, 0xFF0000, 0x000000, Widgets.FONTS.DejaVu24)
    title0 = Widgets.Title("ECGModule Example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu24)
    label_hr = Widgets.Label("  BPM", 142, 35, 1.0, 0xFF0000, 0x000000, Widgets.FONTS.DejaVu24)

    ecg_0 = ECGModule(1, tx=7, rx=1)
    display_width = M5.Lcd.width()
    ecg_data = [0] * display_width
    points = [0] * display_width


def loop():
    global \
        label0, \
        title0, \
        label_hr, \
        ecg_0, \
        display_width, \
        ecg_data, \
        last_time, \
        points, \
        heartrate, \
        new_ecg_data, \
        new_ecg_data_len, \
        data_max, \
        data_min, \
        y0, \
        i, \
        y1
    M5.update()
    ecg_0.poll_data()
    if (time.ticks_diff((time.ticks_ms()), last_time)) > 200:
        last_time = time.ticks_ms()
        heartrate = ecg_0.read_heartrate()
        if heartrate > 0:
            label0.setColor(0x00FF00, 0x000000)
            label_hr.setColor(0x00FF00, 0x000000)
            label_hr.setText(str((str(heartrate) + str("BPM"))))
        else:
            label0.setColor(0xFF0000, 0x000000)
            label_hr.setText(str(" "))
        new_ecg_data = ecg_0.read_raw_ecg_data()
        if new_ecg_data:
            new_ecg_data_len = len(new_ecg_data)
            ecg_data = ecg_data[int((new_ecg_data_len + 1) - 1) :]
            ecg_data = ecg_data + new_ecg_data
            data_max = max(ecg_data)
            data_min = min(ecg_data)
            data_max = data_max + data_max / 10
            data_min = data_min - data_min / 10
            if data_min < 0:
                data_min = 0
            for i in range(display_width):
                points[int((i + 1) - 1)] = m5utils.remap(
                    ecg_data[int((i + 1) - 1)], data_min, data_max, 150, 0
                )

            M5.Lcd.fillRect(0, 70, display_width, 155, 0x000000)
            for i in range(display_width - 1):
                y0 = int(70 + points[int((i + 1) - 1)])
                y1 = int(70 + points[int((i + 2) - 1)])
                M5.Lcd.drawLine(i + 1, y0, i + 2, y1, 0xFF0000)


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")

示例输出：

None

API应用

ECGModule

class module.ecg.ECGModule(id=1, tx=7, rx=1)

基类：object

创建一个 ECGModule 对象。

参数:

id (int) – UART 端口号。
tx (int) – UART 发送引脚。
rx (int) – UART 接收引脚。

UiFlow2 代码块：

MicroPython 应用示例：

from module import ECGModule

module_ecg = ECGModule(id = 1, tx = 7, rx = 1)

poll_data()

轮询数据。

此函数用于检查模块是否有新数据，应在循环中重复调用，以确保持续获取数据。

UiFlow2 代码块：

MicroPython 应用示例：

module_ecg.poll_data()

返回类型:: None

read_heartrate()

读取心率。

返回:: 心率
返回类型:: int

如果心率数据无效，则返回 -1。

UiFlow2 代码块：

MicroPython 应用示例：

module_ecg.read_heartrate()

read_raw_ecg_data()

读取原始 ECG 数据。

返回:: ECG 数据
返回类型:: list

UiFlow2 代码块：

MicroPython 应用示例：

module_ecg.read_raw_ecg_data()