Atom DTU NBIoT2

这是 ATOM DTU NBIoT2 的驱动程序库，用于接收和发送来自 DTU NBIoT 的数据。

支持以下产品：

备注

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

备注

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

可以使用来检查固件版本。

UiFlow2 示例

NBIoT HTTP 示例

在 UiFlow2 中打开 atoms3_base_nbiot2_http_example.m5f2 项目。

此示例展示了如何使用 Atom DTU NBIoT2 发送 HTTP 请求。

UiFlow2 代码块：

示例输出：

通过串口接收到的 NBIoT 消息输出数据。

MQTT 示例

在 UiFlow2 中打开 atoms3_base_nbiot2_mqtt_example.m5f2 项目。

此示例展示了如何使用 Atom DTU NBIoT2 发送 MQTT 消息。

UiFlow2 代码块：

示例输出：

屏幕上显示接收到的NBIoT消息数据。

MicroPython 示例

NBIoT HTTP 示例

此示例展示了如何使用 Atom DTU NBIoT2 发送 HTTP 请求。

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
from hardware import UART
from base import AtomRS485
from base import AtomDTUNBIoT2


label0 = None
uart2 = None
base_rs485 = None
base_nbiot2 = None
base_nbiot2_http_req = None


def setup():
    global label0, uart2, base_rs485, base_nbiot2, base_nbiot2_http_req

    M5.begin()
    Widgets.fillScreen(0x000000)
    label0 = Widgets.Label("label0", 8, 7, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    uart2 = UART(2, baudrate=115200, bits=8, parity=None, stop=1, tx=5, rx=6)
    base_rs485 = AtomRS485(
        1,
        baudrate=115200,
        bits=8,
        parity=None,
        stop=1,
        tx=7,
        rx=8,
        txbuf=256,
        rxbuf=256,
        timeout=0,
        timeout_char=0,
        invert=0,
        flow=0,
    )
    base_nbiot2 = AtomDTUNBIoT2(uart2, verbose=False)
    base_nbiot2.connect(apn="cmnbiot")
    while not (base_nbiot2.isconnected()):
        pass
    base_nbiot2_http_req = base_nbiot2.post(
        "http://httpbin.org/post",
        json={"message": "Hello from M5Stack!", "status": "active"},
        headers={
            "Content-Type": "application/json",
            "Custom-Header": "MyHeaderValue",
        },
    )
    print((str("status code: ") + str((base_nbiot2_http_req.status_code))))
    print((str("content: ") + str((base_nbiot2_http_req.content))))


def loop():
    global label0, uart2, base_rs485, base_nbiot2, base_nbiot2_http_req
    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")

示例输出：

通过串口接收到的 NBIoT 消息输出数据。

MQTT 示例

此示例展示了如何使用 Atom DTU NBIoT2 发送 MQTT 消息。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT
import os, sys, io
import M5
from M5 import *
from hardware import UART
from base import AtomRS485
from base import AtomDTUNBIoT2


label0 = None
base_nbiot2 = None
uart2 = None
base_rs485 = None
base_nbiot2_mqtt = None


def base_nbiot2_testtopic_a_event(data):
    global label0, base_nbiot2, uart2, base_rs485, base_nbiot2_mqtt
    label0.setText(str(data[1]))


def setup():
    global label0, base_nbiot2, uart2, base_rs485, base_nbiot2_mqtt

    M5.begin()
    Widgets.fillScreen(0x000000)
    label0 = Widgets.Label("label0", 8, 7, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    uart2 = UART(2, baudrate=115200, bits=8, parity=None, stop=1, tx=5, rx=6)
    base_rs485 = AtomRS485(
        1,
        baudrate=115200,
        bits=8,
        parity=None,
        stop=1,
        tx=7,
        rx=8,
        txbuf=256,
        rxbuf=256,
        timeout=0,
        timeout_char=0,
        invert=0,
        flow=0,
    )
    base_nbiot2 = AtomDTUNBIoT2(uart2, verbose=False)
    base_nbiot2.connect(apn="cmnbiot")
    while not (base_nbiot2.isconnected()):
        pass
    base_nbiot2_mqtt = base_nbiot2.MQTTClient(
        "uiflow2-client", "mqtt.m5stack.com", port=1883, user="", password="", keepalive=0
    )
    base_nbiot2_mqtt.connect(clean_session=False)
    base_nbiot2_mqtt.subscribe("testtopic/a", base_nbiot2_testtopic_a_event, qos=0)


def loop():
    global label0, base_nbiot2, uart2, base_rs485, base_nbiot2_mqtt
    M5.update()
    base_nbiot2_mqtt.check_msg()


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

示例输出：

屏幕上显示接收到的NBIoT消息数据。

API参考

AtomDTUNBIoT2

class base.dtu_nbiot2.AtomDTUNBIoT2(uart, verbose=False)

基类：SIM7028

创建一个 AtomDTUNBIoT2 对象。

参数:

uart (machine.UART) – 要使用的UART对象。
verbose (bool) – 是否打印调试信息。

UiFlow2 代码块：

MicroPython 代码块：

from base import AtomDTUNBIoT2
from hardware import UART

uart2 = UART(2, baudrate=115200, bits=8, parity=None, stop=1, tx=22, rx=19)
base_nbiot2 = AtomDTUNBIoT2(uart2, verbose=False)

备注

更多详细信息请参阅 NBIOT2Unit。

AtomRS485

备注

更多详细信息请参阅 AtomRS485。