addon DisplayIn

DisplayIn 用于捕获连接至 Unit PoE-P4 的 Display In Add-on (U220) 的 HDMI 输入，并将单帧保存为 JPEG 文件。创建对象时会初始化 LT6911 HDMI 接收器，并通过 DisplayIn.deinit() 释放采集资源。

当前采集格式为 1280x720。调用 DisplayIn.capture() 前请连接 HDMI 信号源。

支持以下产品：

UiFlow2 应用示例

HDMI 输入

创建 DisplayIn 对象，将单帧抓拍并保存到指定文件路径。

在 UiFlow2 中打开 display_in_poep4_example.m5f2 项目。

UiFlow2 代码块：

MicroPython 应用示例

HDMI 输入

该示例从 HDMI 输入抓拍一帧，并将其作为 JPEG 文件保存到设备闪存文件系统中。

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
from addon import DisplayIn
import time


addon_display_in_0 = None


def setup():
    global addon_display_in_0

    M5.begin()
    addon_display_in_0 = DisplayIn()
    time.sleep(1)
    print(
        (
            str("saved /flash/lt6911_capture.jpg, ")
            + str(
                (str((addon_display_in_0.capture("/flash/capture.jpg", 75, 1000))) + str("bytes"))
            )
        )
    )


def loop():
    global addon_display_in_0
    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")

API参考

DisplayIn

class addon.display_in.DisplayIn

基类：object

将 Display In Add-on (U220) 的 HDMI 输入捕获为 JPEG 图像。

DisplayIn 会初始化 LT6911 HDMI 接收器。调用 capture() 保存单帧图像；不再需要采集时，调用 deinit()。

UiFlow2 代码块：

MicroPython 代码块：

from addon import DisplayIn

display_in = DisplayIn()
size = display_in.capture("/flash/capture.jpg", quality=75)
display_in.deinit()

capture(path, quality=75, timeout_ms=1000)

捕获一帧 HDMI 图像并将其保存为 JPEG 文件。

参数:

path (str) – 目标 JPEG 文件路径。
quality (int) – JPEG 质量，范围为 1 至 100。默认值为 75。
timeout_ms (int) – 最大帧等待时间，单位为毫秒。默认值为 1000。

返回:

写入 path 的字节数。

返回类型:

int

UiFlow2 代码块：

MicroPython 代码块：

size = display_in.capture("/flash/capture.jpg", quality=75)

deinit()

释放 Display In Add-on (U220) 的 HDMI 输入资源。

UiFlow2 代码块：

MicroPython 代码块：

display_in.deinit()

返回类型:: None