Zigbee Module

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

支持以下产品：

MicroPython TX 应用示例：

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

import os, sys, io
import M5
from M5 import *
from module import ZigbeeModule
import time


label0 = None
com_zigbee_0 = None
zigbee_0 = None


def setup():
    global label0, com_zigbee_0, zigbee_0

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

    com_zigbee_0 = ZigbeeModule(2, 17, 18, verbose=True)
    com_zigbee_0.set_module_param(
        ZigbeeModule.DEVICE_TYPE_COORDINATOR,
        0x1620,
        11,
        ZigbeeModule.TRANSFER_MODE_PASS_THROUGH,
        0x6677,
    )
    label0.setText(str("start"))


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


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            com_zigbee_0.stop_receive()
            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 module import ZigbeeModule


label0 = None
com_zigbee_0 = None


zigbee_str_data = None
zigbee_dest_address = None
zigbee_src_address = None


def com_zigbee_0_receive_event(dest_address, src_address, received_data):
    global label0, com_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, com_zigbee_0, zigbee_str_data, zigbee_dest_address, zigbee_src_address

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

    com_zigbee_0 = ZigbeeModule(2, 14, 13, verbose=True)
    com_zigbee_0.set_module_param(
        ZigbeeModule.DEVICE_TYPE_ROUTER,
        0x1620,
        11,
        ZigbeeModule.TRANSFER_MODE_PASS_THROUGH,
        0x0066,
    )
    while not (com_zigbee_0.isconnected()):
        pass
    label0.setText(str(com_zigbee_0.get_custom_address()))
    com_zigbee_0.receive_none_block(com_zigbee_0_receive_event)


def loop():
    global label0, com_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:
            com_zigbee_0.stop_receive()
            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 ZigbeeModule

Constructors

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

创建一个 Zigbee 单元。

参数:

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

UIFLOW2：

Methods

ZigbeeModule.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)