NB-IoT2 Unit

NB-IOT2 Unit 是一款适用于全球 Cat-NB 频段的无线通信模块。它集成了 SIM7028 通信模块，并采用串口通信（通过 AT commands 进行控制）。

支持以下产品：

备注

使用前请确保设备支持您所在地区的 NB-IoT 频段。

备注

请确保 SIM7028 的固件版本大于或等于 2110B07SIM7028。

可用于检查固件版本。

UiFlow2 应用示例

NBIoT HTTP 应用示例

在 UiFlow2 中打开 cores3_unit_nbiot2_http_example.m5f2 项目。

该示例演示如何使用 NBIoT2 Unit 发送 HTTP 请求。

点击 Send 按钮发送 HTTP 请求。响应数据将打印在文本区域中。

UiFlow2 代码块：

示例输出：

在屏幕上输出接收到的 NBIoT 消息数据。

MQTT 示例

在 UiFlow2 中打开 cores3_unit_nbiot2_mqtt_example.m5f2 项目。

该示例演示如何使用 NBIoT2 Unit 发送 MQTT 消息。

UiFlow2 代码块：

示例输出：

在屏幕上输出接收到的 NBIoT 消息数据。

MicroPython 应用示例

NBIoT HTTP 应用示例

该示例演示如何使用 NBIoT2 Unit 发送 HTTP 请求。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2026 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 NBIOT2Unit


page0 = None
label0 = None
label1 = None
button0 = None
textarea0 = None
textarea1 = None
nbiot2_0_http_req = None
nbiot2_0 = None


def button0_short_clicked_event(event_struct):
    global page0, label0, label1, button0, textarea0, textarea1, nbiot2_0_http_req, nbiot2_0
    nbiot2_0_http_req = nbiot2_0.post(
        "http://httpbin.org/post",
        json={"message": "Hello from M5Stack!", "status": "active"},
        headers={
            "Content-Type": "application/json",
            "Custom-Header": "MyHeaderValue",
        },
    )
    textarea1.set_text(str(nbiot2_0_http_req.text))


def button0_event_handler(event_struct):
    global page0, label0, label1, button0, textarea0, textarea1, nbiot2_0_http_req, nbiot2_0
    event = event_struct.code
    if event == lv.EVENT.SHORT_CLICKED and True:
        button0_short_clicked_event(event_struct)
    return


def setup():
    global page0, label0, label1, button0, textarea0, textarea1, nbiot2_0_http_req, nbiot2_0

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    textarea0 = m5ui.M5TextArea(
        text="http://httpbin.org/post",
        placeholder="Placeholder...",
        x=46,
        y=10,
        w=195,
        h=21,
        font=lv.font_montserrat_14,
        bg_c=0xFFFFFF,
        border_c=0xE0E0E0,
        text_c=0x212121,
        parent=page0,
    )
    textarea1 = m5ui.M5TextArea(
        text="textarea1",
        placeholder="Placeholder...",
        x=10,
        y=68,
        w=300,
        h=162,
        font=lv.font_montserrat_14,
        bg_c=0xFFFFFF,
        border_c=0xE0E0E0,
        text_c=0x212121,
        parent=page0,
    )
    label0 = m5ui.M5Label(
        "url:",
        x=10,
        y=10,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_16,
        parent=page0,
    )
    label1 = m5ui.M5Label(
        "Response",
        x=10,
        y=44,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_14,
        parent=page0,
    )
    button0 = m5ui.M5Button(
        text="Send",
        x=251,
        y=10,
        bg_c=0x2196F3,
        text_c=0xFFFFFF,
        font=lv.font_montserrat_14,
        parent=page0,
    )

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

    nbiot2_0 = NBIOT2Unit(1, port=(18, 17), verbose=False)
    page0.screen_load()
    nbiot2_0.connect(apn="cmnbiot")
    while not (nbiot2_0.isconnected()):
        pass
    textarea0.set_one_line(True)


def loop():
    global page0, label0, label1, button0, textarea0, textarea1, nbiot2_0_http_req, nbiot2_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")

示例输出：

在屏幕上输出接收到的 NBIoT 消息数据。

MQTT 示例

该示例演示如何使用 NBIoT2 Unit 发送 MQTT 消息。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2026 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 NBIOT2Unit


page0 = None
label0 = None
nbiot2_0_mqtt = None
nbiot2_0 = None


def nbiot2_0__testtopic_a_event(data):
    global page0, label0, nbiot2_0_mqtt, nbiot2_0
    label0.set_text(str(data[1]))


def setup():
    global page0, label0, nbiot2_0_mqtt, nbiot2_0

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    label0 = m5ui.M5Label(
        "label0",
        x=130,
        y=105,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_14,
        parent=page0,
    )

    nbiot2_0 = NBIOT2Unit(1, port=(18, 17), verbose=False)
    page0.screen_load()
    nbiot2_0.connect(apn="cmnbiot")
    while not (nbiot2_0.isconnected()):
        pass
    nbiot2_0_mqtt = nbiot2_0.MQTTClient(
        "uiflow2-client", "mqtt.m5stack.com", port=1883, user="", password="", keepalive=0
    )
    nbiot2_0_mqtt.connect(clean_session=False)
    nbiot2_0_mqtt.subscribe("testtopic/a", nbiot2_0__testtopic_a_event, qos=0)


def loop():
    global page0, label0, nbiot2_0_mqtt, nbiot2_0
    M5.update()
    nbiot2_0_mqtt.check_msg()


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

示例输出：

在屏幕上输出接收到的 NBIoT 消息数据。

API参考

NBIOT2Unit

class unit.nbiot2.NBIOT2Unit(id=1, port=None, verbose=False)

基类：SIM7028

创建一个 NBIOT2Unit 对象。

参数:

id (int) – UART ID。
port (list | tuple) – 包含 RX 和 TX 引脚编号的列表或元组。
verbose (bool) – 是否打印调试信息。

UiFlow2 代码块：

MicroPython 代码块：

from unit import NBIOT2Unit

# Using UART ID 1 and pins (rx=16, tx=17)
nbiot2 = NBIOT2Unit(1, port=(16, 17))

备注

更多详细信息请参阅 NBIOTUnit。