Atom DTU NBIoT

这是 ATOM DTU NBIoT 的驱动程序库，用于从DTU NBIoT 接受和发送数据。

支持以下产品：

备注

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

备注

请确保 SIM7020 的固件版本大于或等于 1752B12SIM7020C。

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

UiFlow2 示例

NBIoT HTTP 示例

在 UiFlow2 中打开 atoms3_base_nbiot_http_example.m5f2 项目。

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

UiFlow2 代码块：

示例输出：

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

MQTT 示例

在 UiFlow2 中打开 atoms3_base_nbiot_mqtt_example.m5f2 项目。

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

UiFlow2 代码块：

示例输出：

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

MicroPython 示例

NBIoT HTTP 示例

此示例展示了如何使用 Atom DTU NBIoT 发送 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 AtomDTUNBIoT
from base import AtomRS485


uart2 = None
base_rs485 = None
base_nbiot = None
base_nbiot_http_req = None


def setup():
    global uart2, base_rs485, base_nbiot, base_nbiot_http_req

    M5.begin()
    Widgets.fillScreen(0x000000)

    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_nbiot = AtomDTUNBIoT(uart2, verbose=False)
    base_nbiot.connect(apn="cmnbiot")
    while not (base_nbiot.isconnected()):
        pass
    base_nbiot_http_req = base_nbiot.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_nbiot_http_req.status_code))))
    print((str("content: ") + str((base_nbiot_http_req.content))))


def loop():
    global uart2, base_rs485, base_nbiot, base_nbiot_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 NBIoT 发送 MQTT 消息。

MicroPython 代码块：

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


label0 = None
base_nbiot = None
uart2 = None
base_rs485 = None
base_nbiot_mqtt = None


def base_nbiot_testtopic_a_event(data):
    global label0, base_nbiot, uart2, base_rs485, base_nbiot_mqtt
    label0.setText(str(data[1]))


def setup():
    global label0, base_nbiot, uart2, base_rs485, base_nbiot_mqtt

    M5.begin()
    Widgets.fillScreen(0x000000)
    label0 = Widgets.Label("label0", 4, 6, 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_nbiot = AtomDTUNBIoT(uart2, verbose=False)
    base_nbiot.connect(apn="cmnbiot")
    while not (base_nbiot.isconnected()):
        pass
    base_nbiot_mqtt = base_nbiot.MQTTClient(
        "uiflow2-client", "mqtt.m5stack.com", port=1883, user="", password="", keepalive=0
    )
    base_nbiot_mqtt.connect(clean_session=False)
    base_nbiot_mqtt.subscribe("testtopic/a", base_nbiot_testtopic_a_event, qos=0)


def loop():
    global label0, base_nbiot, uart2, base_rs485, base_nbiot_mqtt
    M5.update()
    base_nbiot_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参考

AtomDTUNBIoT

class base.dtu_nbiot.AtomDTUNBIoT(uart, verbose=False)

基类：SIM7020

创建 AtomDTUNBIoT 对象。

参数:

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

UiFlow2 代码块：

MicroPython 代码块：

from base import AtomDTUNBIoT
from hardware import UART

uart0 = UART(2, baudrate=115200, bits=8, parity=None, stop=1, tx=22, rx=19)
dtu_nbiot = AtomDTUNBIoT(uart0, verbose=False)

备注

更多详细信息请参阅 NBIOTUnit。

AtomRS485

备注

更多详细信息请参阅 AtomRS485。