Zigbee Unit

Zigbee 是 M5Stack 推出的自组网通信模块。该模块采用 CC2630F128 方案，内部集成 Zigbee 协议栈，并提供开放的串口通信接口。其配备外置天线，单节点稳定通信距离最远可达 1 km，并支持最高 200 级路由深度。通过 MESH 组网，可显著扩展 IoT 应用的覆盖范围，同时具备超低功耗与高灵敏度。Zigbee 网络可支持数百个节点，并提供增强的安全特性，为家庭与楼宇自动化提供完整且可互操作的 IoT 解决方案。

支持以下产品：

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
from unit import ZigbeeUnit
import time


label0 = None
zigbee_0 = None


def setup():
    global label0, zigbee_0

    M5.begin()
    Widgets.fillScreen(0x222222)
    label0 = Widgets.Label("label0", 67, 43, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    zigbee_0 = ZigbeeUnit(1, port=(18, 17), verbose=True)
    zigbee_0.set_module_param(
        ZigbeeUnit.DEVICE_TYPE_COORDINATOR,
        0x1620,
        11,
        ZigbeeUnit.TRANSFER_MODE_PASS_THROUGH,
        0x6677,
    )
    label0.setText(str("start"))


def loop():
    global label0, zigbee_0
    M5.update()
    zigbee_0.p2p_transmission(0x0066, "p2p")
    time.sleep(3)
    zigbee_0.broadcast("broadcast")
    time.sleep(3)


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

MicroPython 应用示例：

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

import os, sys, io
import M5
from M5 import *
from unit import ZigbeeUnit


label0 = None
zigbee_0 = None


zigbee_str_data = None
zigbee_dest_address = None
zigbee_src_address = None


def zigbee_0_receive_event(dest_address, src_address, received_data):
    global label0, zigbee_0, zigbee_str_data, zigbee_dest_address, zigbee_src_address
    zigbee_dest_address = dest_address
    zigbee_src_address = src_address
    try:
        zigbee_str_data = received_data.decode()
    except:
        zigbee_str_data = str(received_data)
    label0.setText(str(zigbee_str_data))


def setup():
    global label0, zigbee_0, zigbee_str_data, zigbee_dest_address, zigbee_src_address

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

    zigbee_0 = ZigbeeUnit(1, port=(33, 32), verbose=True)
    zigbee_0.set_module_param(
        ZigbeeUnit.DEVICE_TYPE_ROUTER, 0x1620, 11, ZigbeeUnit.TRANSFER_MODE_PASS_THROUGH, 0x0066
    )
    while not (zigbee_0.isconnected()):
        pass
    label0.setText(str(zigbee_0.get_custom_address()))
    zigbee_0.receive_none_block(zigbee_0_receive_event)


def loop():
    global label0, zigbee_0, zigbee_str_data, zigbee_dest_address, zigbee_src_address
    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")

UIFLOW2 TX 应用示例：

UiFlow2 RX 应用示例：

cores3_zigbee_tx_example.m5f2

stickc_plus2_zigbee_rx_example.m5f2

class ZigbeeUnit

Constructors

class ZigbeeUnit(id: Literal[0, 1, 2], port: list | tuple, verbose: bool = True)

创建一个 Zigbee unit。

参数:

id – 单元的 ID。
port – 设备连接到的端口。
verbose – 打印日志信息。默认为 True。

UiFlow2

Methods

ZigbeeUnit.set_module_param(device_type: int, pan_id: int, channel: int, transfer_mode: int, custom_address: int, ant_type: int, encryption_enable=ENCRYPTION_ENABLE, encryption_key=b'\x11\x12\x13\x14', node_type=DEVICE_TYPE_ROUTER, node_ant_type=ANT_TYPRE_ON_BOARD, node_transfer_mode=TRANSFER_MODE_PASS_THROUGH, node_custom_address=0x0066)