Atom DTU NBIoT2 V11

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

支持以下产品：

备注

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

备注

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

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

UiFlow2 示例

NBIoT HTTP 示例

在 UiFlow2 中打开 atoms3_base_nbiot2v11_http_example.m5f2 项目。

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

UiFlow2 代码块：

示例输出：

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

MQTT 示例

在 UiFlow2 中打开 atoms3_base_nbiot2v11_mqtt_example.m5f2 项目。

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

UiFlow2 代码块：

示例输出：

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

MicroPython 示例

NBIoT HTTP 示例

此示例展示了如何使用 Atom DTU NBIoT2 V11 发送 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 AtomDTUNBIoT2V11


uart2 = None
base_rs485 = None
base_nbiot2v11 = None
base_nbiot2v11_http_req = None


def setup():
    global uart2, base_rs485, base_nbiot2v11, base_nbiot2v11_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_nbiot2v11 = AtomDTUNBIoT2V11(uart2, verbose=False)
    while not (base_nbiot2v11.isconnected()):
        pass
    base_nbiot2v11_http_req = base_nbiot2v11.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_nbiot2v11_http_req.status_code))))
    print((str("content: ") + str((base_nbiot2v11_http_req.content))))


def loop():
    global uart2, base_rs485, base_nbiot2v11, base_nbiot2v11_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 V11 发送 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 AtomDTUNBIoT2V11


label0 = None
base_nbiot2v11 = None
uart2 = None
base_rs485 = None
base_nbiot2v11_mqtt = None


def base_nbiot2v11_testtopic_a_event(data):
    global label0, base_nbiot2v11, uart2, base_rs485, base_nbiot2v11_mqtt
    label0.setText(str(data[1]))


def setup():
    global label0, base_nbiot2v11, uart2, base_rs485, base_nbiot2v11_mqtt

    M5.begin()
    Widgets.fillScreen(0x000000)
    label0 = Widgets.Label("label0", 1, 5, 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_nbiot2v11 = AtomDTUNBIoT2V11(uart2, verbose=False)
    while not (base_nbiot2v11.isconnected()):
        pass
    base_nbiot2v11_mqtt = base_nbiot2v11.MQTTClient(
        "uiflow2-client", "mqtt.m5stack.com", port=1883, user="", password="", keepalive=120
    )
    base_nbiot2v11_mqtt.connect(clean_session=True)
    base_nbiot2v11_mqtt.subscribe("testtopic/a", base_nbiot2v11_testtopic_a_event, qos=0)


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

AtomDTUNBIoT2V11

class base.dtu_nbiot2_v11.AtomDTUNBIoT2V11(uart, verbose=False)

基类：SIM7028

创建一个 AtomDTUNBIoT2V11 对象。

参数:

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

UiFlow2 代码块：

MicroPython 代码块：

from base import AtomDTUNBIoT2V11
from hardware import UART

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

备注

更多详细信息请参阅 NBIOT2Unit。

power_on()

打开DTU NB-IoT模块的电源。

UiFlow2 代码块：

MicroPython 代码块：

base_nbiot2v11.power_on()

power_off()

关闭DTU NB-IoT模块的电源。

UiFlow2 代码块：

MicroPython 代码块：

base_nbiot2v11.power_off()

get_voltage()

获取 RS485 端口电压（单位：伏特）。

UiFlow2 代码块：

MicroPython 代码块：

voltage = base_nbiot2v11.get_voltage()
print("Voltage:", voltage)

返回类型:: float

AtomRS485

备注

更多详细信息请参阅 AtomRS485。