继电器

继电器用于控制主机设备的继电器。

UiFlow2 应用示例

继电器控制

在 UiFlow2 中打开 stamplc_relay_example.m5f2 项目。

此示例演示如何使用按钮控制继电器的状态并在屏幕上显示继电器的状态值。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

继电器控制

此示例演示如何使用按钮控制继电器的状态并在屏幕上显示继电器的状态值。

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
from hardware import Relay


label0 = None
relay_0 = None


def btnA_wasClicked_event(state):  #  noqa: N802
    global label0, relay_0
    relay_0.on()


def btnB_wasClicked_event(state):  #  noqa: N802
    global label0, relay_0
    relay_0.off()


def btnC_wasClicked_event(state):  #  noqa: N802
    global label0, relay_0
    relay_0.set_status(not (relay_0.get_status()))


def setup():
    global label0, relay_0

    M5.begin()
    label0 = Widgets.Label("label0", 75, 28, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    BtnA.setCallback(type=BtnA.CB_TYPE.WAS_CLICKED, cb=btnA_wasClicked_event)
    BtnB.setCallback(type=BtnB.CB_TYPE.WAS_CLICKED, cb=btnB_wasClicked_event)
    BtnC.setCallback(type=BtnC.CB_TYPE.WAS_CLICKED, cb=btnC_wasClicked_event)

    relay_0 = Relay(1)


def loop():
    global label0, relay_0
    M5.update()
    label0.setText(str(relay_0.value()))


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参考

继电器

class Relay(id: int)

初始化继电器对象。

参数:

id (int) – The ID of the relay. The range of ID is 1-4.

UiFlow2 代码块：

继电器的ID，范围是1-4。

MicroPython 代码块：

from hadrware import Relay

relay = Relay(1)

on() → None

打开继电器

UiFlow2 代码块：

MicroPython 代码块：

relay.on()

off() → None

关闭继电器

UiFlow2 代码块：

MicroPython 代码块：

relay.off()

value() → int

获取继电器的值。

返回:

继电器的值。

返回类型:

int

UiFlow2 代码块：

MicroPython 代码块：

relay.value(1)
relay.value()

get_status() → bool

获取继电器的状态。

返回:

The status of the relay.

返回类型:

bool

UiFlow2 代码块：

MicroPython 代码块：

relay.get_status()

set_status(status: bool) → None

设置继电器的状态。

参数:

status (bool) – The status of the relay.

UiFlow2 代码块：

MicroPython 代码块：

relay.set_status(True)