addon DisplayOut

DisplayOut 用于在 Unit PoE-P4 上启用 HDMI 显示输出。它会将 PoE-P4 的 HDMI 接口注册为显示器，连接外部 HDMI 显示器时即可用于画面输出。

支持以下产品：

UNIT_POEP4

UiFlow2 应用示例

HDMI 输出

在 UiFlow2 中打开 display_out_poep4_example.m5f2 项目。

该示例将 HDMI 输出初始化为 1280x720@60Hz，并在外部显示器上绘制基础控件。

UiFlow2 代码块：

init.png

示例输出：

example.png

MicroPython 应用示例

HDMI 输出

该示例初始化 HDMI 输出，并在外部显示器上绘制基础控件。

MicroPython 代码块：

 1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
 2#
 3# SPDX-License-Identifier: MIT
 4
 5import os, sys, io
 6import M5
 7from M5 import *
 8from addon import DisplayOut
 9
10
11title = None
12circle0 = None
13rect0 = None
14label0 = None
15line0 = None
16triangle0 = None
17addon_display_out_0 = None
18
19
20def setup():
21    global title, circle0, rect0, label0, line0, triangle0, addon_display_out_0
22
23    M5.begin()
24    addon_display_out_0 = DisplayOut(1280, 720, 60)
25    Widgets.fillScreen(0x000000, addon_display_out_0)
26    title = Widgets.Title(
27        "addon Display Out For PoE-P4 Example",
28        3,
29        0xFFFFFF,
30        0x0000FF,
31        Widgets.FONTS.Montserrat18,
32        addon_display_out_0,
33    )
34    circle0 = Widgets.Circle(118, 182, 68, 0xFFFFFF, 0xFFFFFF, addon_display_out_0)
35    rect0 = Widgets.Rectangle(885, 338, 217, 217, 0xFFFFFF, 0xFFFFFF, addon_display_out_0)
36    label0 = Widgets.Label(
37        "label0",
38        556,
39        149,
40        1.0,
41        0xFFFFFF,
42        0x222222,
43        Widgets.FONTS.Montserrat18,
44        addon_display_out_0,
45    )
46    line0 = Widgets.Line(398, 446, 448, 446, 0xFFFFFF, addon_display_out_0)
47    triangle0 = Widgets.Triangle(
48        765, 346, 735, 376, 794, 376, 0xFFFFFF, 0xFFFFFF, addon_display_out_0
49    )
50
51
52def loop():
53    global title, circle0, rect0, label0, line0, triangle0, addon_display_out_0
54    M5.update()
55
56
57if __name__ == "__main__":
58    try:
59        setup()
60        while True:
61            loop()
62    except (Exception, KeyboardInterrupt) as e:
63        try:
64            from utility import print_error_msg
65
66            print_error_msg(e)
67        except ImportError:
68            print("please update to latest firmware")

示例输出：

example.png

API参考

DisplayOut

class addon.display_out.DisplayOut(width=1280, height=720, refresh_rate=60)

基类：object

为 Unit PoE-P4 创建 HDMI 显示输出。

DisplayOut 将 Unit PoE-P4 HDMI 输出注册为显示器，并返回由 M5.addDisplay 创建的显示对象。随后可通过标准显示 API 使用该显示器。

参数:

  • width (int) – HDMI 输出的逻辑宽度。默认值为 1280。

  • height (int) – HDMI 输出的逻辑高度。默认值为 720。

  • refresh_rate (int) – HDMI 输出的刷新率，单位为 Hz。默认值为 60。

返回:

由 M5.addDisplay 注册的显示对象。

返回类型:

object

备注

Unit PoE-P4 HDMI 输出支持 1280x720@60Hz 和 1920x1080@30Hz 时序。

UiFlow2 代码块：

init.png

MicroPython 代码块：

from addon import DisplayOut

display = DisplayOut(1280, 720, 60)