IR

IR 用于控制主机设备内置的红外接收/发射管。

主机对 IR 的具体支持如下：

控制器	IR 发射器	IR 接收器
Atom Lite	✔
Atom Matrix	✔
Atom U	✔
AtomS3 Lite	✔
AtomS3U	✔
StickC	✔
StickC-Plus	✔
StickC-Plus2	✔
Cardputer	✔
Capsule	✔
StickS3	✔	✔

UiFlow2 示例

IR 发射

在 UiFlow2 中打开 sticks3_ir_tx_example.m5f2 项目。

本示例演示红外（IR）发射功能。按下 A 键时，会以指定地址和数据值发送 IR 数据，并显示正在发送的地址和数据。

UiFlow2 代码块：

示例输出：

无

IR 接收

在 UiFlow2 中打开 sticks3_ir_rx_example.m5f2 项目。

本示例演示使用 NEC 解码协议的红外（IR）接收功能。收到 IR 数据时，在屏幕上显示地址和数据值。

UiFlow2 代码块：

示例输出：

无

MicroPython 示例

IR 发射

本示例演示红外（IR）发射功能。按下 A 键时，会以指定地址和数据值发送 IR 数据，并显示正在发送的地址和数据。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT
import os, sys, io
import M5
from M5 import *
from hardware import IR


label_title = None
label_addr = None
label_data = None
label_tip = None
ir = None
data = None
addr = None


def btna_click_event_cb(state):
    global label_title, label_addr, label_data, label_tip, ir, data, addr
    data = (data if isinstance(data, (int, float)) else 0) + 1
    ir.tx(addr, data)
    print((str("IR: Send addr: ") + str((str(addr) + str((str(" data: ") + str(data)))))))
    label_data.setText(str((str("data: ") + str(data))))


def setup():
    global label_title, label_addr, label_data, label_tip, ir, data, addr
    M5.begin()
    Widgets.setRotation(0)
    Widgets.fillScreen(0x000000)
    label_title = Widgets.Label("IR", 58, 5, 1.0, 0x1AEAEB, 0x000000, Widgets.FONTS.DejaVu18)
    label_addr = Widgets.Label("addr:", 5, 45, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    label_data = Widgets.Label("data:", 5, 70, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    label_tip = Widgets.Label(
        "BtnA Send", 18, 200, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18
    )
    BtnA.setCallback(type=BtnA.CB_TYPE.WAS_CLICKED, cb=btna_click_event_cb)
    ir = IR()
    ir.rx_cb(ir_rx_event)
    addr = 56
    data = 0
    Power.setExtOutput(True)
    label_addr.setText(str((str("addr: ") + str(addr))))


def loop():
    global label_title, label_addr, label_data, label_tip, ir, data, addr
    M5.update()


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

示例输出：

无

IR 接收

本示例演示使用 NEC 解码协议的红外（IR）接收功能。收到 IR 数据时，在屏幕上显示地址和数据值。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT
import os, sys, io
import M5
from M5 import *
from hardware import IR


label_title = None
label0 = None
label_addr = None
label_data = None
ir = None
data = None
addr = None


def ir_rx_event(_data, _addr, _ctrl):
    global label_title, label0, label_addr, label_data, ir, data, addr
    data = _data
    addr = _addr
    label_addr.setText(str((str("addr: ") + str(addr))))
    label_data.setText(str((str("data: ") + str(data))))


def setup():
    global label_title, label0, label_addr, label_data, ir, data, addr

    M5.begin()
    Widgets.setRotation(0)
    Widgets.fillScreen(0x000000)
    label_title = Widgets.Label("IR RX", 41, 5, 1.0, 0x0FBAE1, 0x000000, Widgets.FONTS.DejaVu18)
    label0 = Widgets.Label("NEC Decode", 8, 50, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    label_addr = Widgets.Label("addr:", 5, 115, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)
    label_data = Widgets.Label("data:", 5, 145, 1.0, 0xFFFFFF, 0x000000, Widgets.FONTS.DejaVu18)

    Speaker.setPA(False)
    ir = IR()
    ir.rx_cb(ir_rx_event)


def loop():
    global label_title, label0, label_addr, label_data, ir, data, addr
    M5.update()


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

示例输出：

无

class IR

构造函数

class IR

根据 M5Stack 开发板类型，使用相应的引脚初始化 IR 单元。

UiFlow2：

方法

IR.tx(cmd, data)

使用 NEC 协议，通过指定的命令和数据发送 IR 信号。

参数:

• cmd – 要传输的命令代码。

• data – 与该命令关联的数据。

UiFlow2：

IR.rx_cb(cb)

注册红外接收的回调。当收到 NEC 格式的 IR 信号时，会以两个参数 (data, addr) 调用该回调。

仅支持带 IR 接收器的开发板（如 StickS3）。

参数:

cb – 回调函数签名为 cb(data, addr)。data 和 addr 为 8 位值（0–255）。

UiFlow2：