Cat1CN Unit

这是 Cat1CN Unit 的驱动库，用于接收和发送数据。

支持以下产品：

UiFlow2 应用示例

HTTP 示例

在 UiFlow2 中打开 cat1cn_core2_http_example.m5f2 项目。

该示例演示如何发送 HTTP 请求。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

HTTP 示例

该示例演示如何发送 HTTP 请求。

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
import m5ui
import lvgl as lv
from unit import Cat1Unit


page0 = None
button0 = None
label0 = None
label1 = None
cat1cn_0 = None


def button0_clicked_event(event_struct):
    global page0, button0, label0, label1, cat1cn_0
    cat1cn_0.http_request(
        1,
        "http://httpbin.org/post",
        {"Content-Type": "application/json", "Custom-Header": "MyHeaderValue"},
        {"message": "Hello from M5Stack!", "status": "active"},
    )
    label0.set_text(str((str("Data content:") + str((cat1cn_0.data_content)))))
    label1.set_text(str((str("Response status code:") + str((cat1cn_0.response_code)))))


def button0_event_handler(event_struct):
    global page0, button0, label0, label1, cat1cn_0
    event = event_struct.code
    if event == lv.EVENT.CLICKED and True:
        button0_clicked_event(event_struct)
    return


def setup():
    global page0, button0, label0, label1, cat1cn_0

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    button0 = m5ui.M5Button(
        text="Send HTTP POST",
        x=82,
        y=104,
        bg_c=0x2196F3,
        text_c=0xFFFFFF,
        font=lv.font_montserrat_14,
        parent=page0,
    )
    label0 = m5ui.M5Label(
        "Data content:",
        x=3,
        y=8,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_14,
        parent=page0,
    )
    label1 = m5ui.M5Label(
        "Response status code:",
        x=4,
        y=35,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_14,
        parent=page0,
    )

    button0.add_event_cb(button0_event_handler, lv.EVENT.ALL, None)

    cat1cn_0 = Cat1Unit(2, port=(33, 32))
    page0.screen_load()


def loop():
    global page0, button0, label0, label1, cat1cn_0
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            m5ui.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

MQTT 应用示例

在 UiFlow2 中打开 cat1cn_core2_mqtt_example.m5f2 项目。

该示例演示如何发送 MQTT 消息。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

MQTT 应用示例

该示例演示如何发送 MQTT 消息。

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
import m5ui
import lvgl as lv
from unit import Cat1Unit


page0 = None
button0 = None
cat1cn_0 = None


import random


def cat1cn_0_subscription_event(_topic, _msg):
    global page0, button0, cat1cn_0
    print(_topic)
    print(_msg)


def button0_clicked_event(event_struct):
    global page0, button0, cat1cn_0
    cat1cn_0.mqtt_publish_topic(
        "Push", (str("Random num:") + str((str((random.randint(1, 100)))))), 0
    )


def button0_event_handler(event_struct):
    global page0, button0, cat1cn_0
    event = event_struct.code
    if event == lv.EVENT.CLICKED and True:
        button0_clicked_event(event_struct)
    return


def setup():
    global page0, button0, cat1cn_0

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    button0 = m5ui.M5Button(
        text="Send Msg",
        x=107,
        y=100,
        bg_c=0x2196F3,
        text_c=0xFFFFFF,
        font=lv.font_montserrat_14,
        parent=page0,
    )

    button0.add_event_cb(button0_event_handler, lv.EVENT.ALL, None)

    cat1cn_0 = Cat1Unit(2, port=(33, 32))
    page0.screen_load()
    cat1cn_0.mqtt_server_connect("broker-cn.emqx.io", 1883, "mqttx_b899ee59", "", "", 120)
    cat1cn_0.mqtt_subscribe_topic("Subscription", cat1cn_0_subscription_event, 0)


def loop():
    global page0, button0, cat1cn_0
    M5.update()
    cat1cn_0.mqtt_polling_loop()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            m5ui.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

API参考

Cat1Unit

class unit.cat1.Cat1Unit(uart_or_id, port=None, verbose=True)

基类：ML307R, Modem

创建一个 Cat1Unit 对象

参数:

• id (int) – 要使用的 UART ID（0、1 或 2）。默认值为 2。

• port (list | tuple) – 包含 TX 和 RX 引脚编号的列表或元组。

• verbose (bool) – 启用详细输出以进行调试。默认值为 False。

UiFlow2 代码块：

MicroPython 代码块：

from base import Cat1Unit

cat1cn_0 = Cat1Unit(2, port=(33, 32))

更多详情请参阅 NBIOTUnit 。