DS03A-NB NB-IoT 门磁传感器

中文使用手册

产品功能 安装与配置 数据报文 告警与维护

本手册介绍 DS03A-NB 的产品规格、门磁检测和告警功能，以及通过 NB-IoT 接入服务器、配置 AT 指令、读取数据和更新固件的方法。适用于设备选型、安装调试和日常维护。

对应 Dragino 在线文档，整理日期为 2026 年 10 月 9 日。命令、参数、协议字段和报文数值保留原文写法；操作截图保留原界面，配有中文图注。

原始文档

Dragino DS03A-NB 在线文档

1 产品介绍

1.1 DS03A-NB 是什么

Dragino DS03A-NB 是面向物联网解决方案的 NB-IoT 门磁传感器。它检测门的开启或关闭状态，并通过 NB-IoT 网络将数据上报至物联网服务器。用户可以在服务器中查看门状态、开门持续时间和开门次数。

DS03A-NB 每 2 小时定期上报一次数据，同时在每次开门或关门时上报。设备还会统计开门次数，并计算上一次开门的持续时间。用户也可以关闭逐次开关门事件的上报，改为记录每次开门事件并定期上报。

译注：第 1.1 节写默认每 2 小时上报，第 2.3 节写每 4 小时上报，两处不一致。请通过 AT+TDC 读取当前配置，并以实际固件和设置为准。

DS03A-NB 支持开门超时告警。启用并设置该功能后，如果门持续开启达到指定时长，设备会发送告警。

DS03A-NB 面向户外使用，采用耐候外壳和工业级电池，可在较低到较高的温度环境中工作。

DS03A-NB 支持 MQTT、MQTTs、UDP、TCP 和 CoAP 等上行通信方式，可根据应用需求接入多种物联网服务器。

DS03A-NB 支持通过 BLE 进行配置和 OTA 固件升级，便于使用和维护。

DS03A-NB 由容量为 8500 mAh 的锂亚硫酰氯电池供电，面向长期使用设计，使用寿命可达数年。

DS03A-NB 提供可选的预装 SIM 卡和默认物联网服务器连接版本，只需简单配置即可使用。

1.2 功能特点

• NB-IoT 频段：B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85，采用 H-FDD。
• 超低功耗。
• 检测门的开启和关闭状态。
• 统计开关门事件。
• 支持开门超时告警。
• 探头线长为 40 cm。
• 支持多次采样后一次上报。
• 支持 Bluetooth 5.1 远程配置和固件升级。
• 支持周期性上报。
• 支持通过下行指令修改配置。
• 8500 mAh 电池，适合长期使用。
• 配备 Nano SIM 卡槽，可安装 NB-IoT SIM 卡。

1.3 技术规格

通用直流电气特性

• 供电电压：2.5 V 至 3.6 V。
• 工作温度：-40 至 85 °C。

NB-IoT 规格

NB-IoT 模组：BC660K-GL。

支持的频段与频率

电池规格

• 锂亚硫酰氯电池，不可充电。
• 容量：8500 mAh。
• 自放电率：在 25 °C 下小于 1%/年。
• 最大持续电流：130 mA。
• 最大脉冲电流：2 A，持续 1 秒。

功耗

• STOP 模式电流：10 μA，供电电压为 3.3 V。
• 最大发射电流：350 mA，供电电压为 3.3 V。

译注：原文此项标签为“Max transmit power”，但单位 mA 表示电流，因此此处译为最大发射电流。数值保持原样。

1.4 应用场景

图中场景依次为：Supermarket 超市、Warehouse 仓库、Garage 车库、Villa 别墅、Home Area 居家区域、Store 商店。

1.5 深度休眠模式与工作模式

深度休眠模式：传感器不启用 NB-IoT 功能。此模式用于存储和运输，以节省电池电量。

工作模式：设备作为 NB-IoT 传感器接入 NB-IoT 网络，并向服务器发送传感器数据。在周期性的采样、发送和接收操作之间，设备进入 IDLE 空闲模式。IDLE 模式的功耗与深度休眠模式相同。

1.6 按键与 LED 指示灯

图中标注：Antenna Attachable 可拆装天线；Push Button 按键；LED Indicator 指示灯；Pressure Balance Valve 压力平衡阀。

注意：设备执行程序时，按键操作可能暂时无效。建议在程序执行结束后操作按键。

1.7 BLE 连接

DS03A-NB 支持通过 BLE 远程配置和升级固件。

BLE 可用于配置传感器参数或查看设备的控制台输出。仅在以下情况启用 BLE：

• 按下按键触发一次上行数据发送。
• 按下按键激活设备。
• 设备上电或复位。

如果 60 秒内没有活动的 BLE 连接，设备将关闭 BLE 模块并进入低功耗模式。

1.8 引脚 开关与 SIM 卡方向

1.8.1 JP2 跳线

插上 JP2 跳线后，设备上电。

1.8.2 BOOT MODE 与 SW1 开关

1）ISP：固件升级模式。此模式下设备不输出信号，LED 不工作，应用固件不运行，但已准备好接收固件升级。

2）Flash：正常工作模式。设备开始运行，并输出控制台信息，供进一步调试。

1.8.3 复位按键

按下此按键可重启设备。

1.8.4 SIM 卡安装方向

SIM 卡安装方向请参阅“如何插入 SIM 卡”的说明。

参阅：相关操作说明

1.9 机械尺寸

探头机械尺寸

1.10 磁铁感应距离

• 木门：10 mm 至 30 mm。
• 铁门：30 mm 至 45 mm。

2 与物联网服务器通信

2.1 通过 NB-IoT 网络发送数据

DS03A-NB 内置 NB-IoT 模组。预装固件读取传感器采集的数据，通过 NB-IoT 模组发送到本地 NB-IoT 网络。网络再按照设备配置的协议，将数据转发到物联网服务器。

网络结构如下图所示。

数据路径：门磁传感器 → NB-IoT 网络与基站 → 互联网 → 物联网服务器 → 仪表盘。可使用 MQTT、MQTTs、UDP、TCP 或 CoAP 协议。

DS03A-NB 提供 -GE 和 -1T 两个版本。GE 通用版不包含 SIM 卡，也未预设物联网服务器。用户需要使用 AT 指令完成以下两步配置，才能向服务器发送数据。

• 安装 NB-IoT SIM 卡并配置 APN。操作方法见“接入网络”说明。

参阅：相关操作说明

• 配置传感器连接的物联网服务器。操作方法见“连接不同服务器的配置”说明。

参阅：相关操作说明

下表概览了不同服务器的展示方式。

1T 版本预装 1NCE SIM 卡，并预配置为向 ThingsEye 发送数据。用户只需在 ThingsEye 中选择传感器类型并激活 DS03A-NB，即可在 ThingsEye 中查看数据。具体操作见 ThingsEye 配置说明。

参阅：相关操作说明

2.2 上行数据格式

为满足不同服务器的要求，DS03A-NB 支持多种数据载荷格式。

支持以下类型：

• 通用 JSON 格式，Type=5。
• 十六进制 HEX 格式，Type=0。
• ThingSpeak 格式，Type=1。
• ThingsBoard 格式，Type=3。

选择连接协议时，可以同时指定数据格式。例如：

AT+PRO=2,0 // 使用 UDP 连接和 HEX 数据格式

AT+PRO=2,5 // 使用 UDP 连接和 JSON 数据格式

AT+PRO=3,5 // 使用 MQTT 连接和 JSON 数据格式

2.2.1 通用 JSON 格式 Type 5

通用 JSON 格式在单通道模式与双通道模式下的数据长度不同。

通用 JSON 数据示例一如下。

{
  "IMEI": "863663062798914",
  "IMSI": "460083513507314",
  "Model": "DS03A-NB",
  "level status": 1,
  "alarm status": 0,
  "door open num": 0,
  "last open time": 0,
  "level status2": 1,
  "alarm status2": 0,
  "door open num2": 0,
  "last open time2": 0,
  "battery": 3.22,
  "signal": 14,
  "time": "2024/11/20 07:08:20",
  "1": [1, 0, 0, 1, 0, 0, "2024/11/20 06:54:23"],
  "2": [1, 0, 0, 1, 0, 0, "2024/11/20 06:39:23"],
  "3": [0, 0, 0, 8, 0, 126977, "2024/11/20 05:29:33"],
  "4": [0, 0, 0, 8, 0, 323585, "2024/11/20 05:14:33"],
  "5": [0, 0, 0, 8, 0, 192513, "2024/11/20 04:59:33"],
  "6": [0, 0, 0, 8, 0, 192513, "2024/11/20 04:44:33"],
  "7": [0, 0, 0, 8, 0, 192513, "2024/11/20 04:29:33"],
  "8": [0, 0, 0, 8, 0, 258049, "2024/11/20 04:14:33"]
}

上述数据的说明如下：

• level status、alarm status、door open num、last open time、level status2、alarm status2、door open sum2、last open time2、Battery、Signal 和 time 表示上报时的实时值。
• 编号 1 至 8 的 JSON 条目表示最近 1 至 8 次采样的数据，由 AT+CLOCKLOG=1,65535,15,8 设置。每条记录从左到右依次包含：

level status、door open num、last open time、采样时间。

通用 JSON 数据示例二如下。

{
  "IMEI": "863663062798914",
  "IMSI": "460083513507314",
  "Model": "DS03A-NB",
  "level status": 1,
  "alarm status": 0,
  "door open num": 0,
  "last open time": 0,
  "level status2": 1,
  "alarm status2": 0,
  "door open num2": 0,
  "last open time2": 0,
  "battery": 3.21,
  "signal": 19,
  "time": "2024/11/20 06:31:03",
  "1": [0, 0, 0, 8, 0, 126977, "2024/11/20 05:29:33"],
  "2": [0, 0, 0, 8, 0, 323585, "2024/11/20 05:14:33"],
  "3": [0, 0, 0, 8, 0, 192513, "2024/11/20 04:59:33"],
  "4": [0, 0, 0, 8, 0, 192513, "2024/11/20 04:44:33"],
  "5": [0, 0, 0, 8, 0, 192513, "2024/11/20 04:29:33"],
  "6": [0, 0, 0, 8, 0, 258049, "2024/11/20 04:14:33"],
  "7": [0, 200, 300, 0, 16319072, 61441, "2024/11/20 02:03:04"],
  "8": [0, 200, 300, 0, 16253640, 192513, "2024/11/14 10:00:21"]
}

上述数据的说明如下：

• level status、alarm status、door open num、last open time、level status2、alarm status2、door open sum2、last open time2、Battery、Signal 和 time 表示上报时的实时值。
• 编号 1 至 8 的 JSON 条目表示最近 1 至 8 次采样的数据，由 AT+CLOCKLOG=1,65535,15,8 设置。每条记录从左到右依次包含：

level status、door open num、last open time、level status2、door open sum2、last open time2、采样时间。

译注：字段说明中的 door open sum2 与示例中的 door open num2 命名不一致，Battery 和 Signal 的大小写也不同。此外，JSON 示例一的历史数组包含双通道值，而后面的字段顺序说明仅列出单通道字段。解析程序应按实际报文和通道设置核对，不能仅依赖此处说明。

2.2.2 HEX 格式 Type 0

HEX 格式在单通道模式与双通道模式下的字节长度不同。

单通道模式的 HEX 数据如下。

f863663062798914f46008351350731412820ca30f010100000000000000673d8fb701000000000000673d8b
2301000000000000673d879f01000000000000673d841b0800000001f001673d73bd0800000004f001673d70
390800000002f001673d6cb50800000002f001673d69310800000002f001673d65ad

以上仅按阅读宽度换行，发送或解析时仍应使用连续的十六进制字符串。

HEX 字段布局与示例值

IMEI 与 IMSI 各占 8 字节；后续实时数据共占 18 字节。图中示例携带最近 8 次历史记录，每条记录占 11 字节。

每条历史记录的字段顺序

使用 MQTT 客户端订阅对应主题后，可在 NB 传感器上报数据时看到下图所示的信息。

双通道模式的数据如下。原文此处写作“JSON 格式”，但所列内容为 HEX 数据。

f863663062798914f46008351350731412820c9f110101000000000000000100000000000000673d8c8a0100
000000000001000000000000673d8b230100000000000001000000000000673d879f01000000000000010000
00000000673d841b0800000001f00100000000000000673d73bd0800000004f00100000000000000673d7039
0800000002f00100000000000000673d6cb50800000002f00100000000000000673d69310800000002f00100
000000000000673d65ad

以上仅按阅读宽度换行，发送或解析时仍应使用连续的十六进制字符串。

HEX 字段布局与示例值

IMEI 与 IMSI 各占 8 字节；后续实时数据共占 25 字节。图中示例携带最近 8 次历史记录，每条记录占 18 字节。

每条历史记录的字段顺序

使用 MQTT 客户端订阅对应主题后，可在 NB 传感器上报数据时看到下图所示的信息。

版本信息 Version

这两个字节包含硬件型号和软件版本信息。

高字节指定传感器型号。DS03A-NB 对应 0x12。

低字节指定软件版本。0x82=130，表示固件版本 1.3.0。

电池信息 BAT

示例：0x0DDA = 3546 mV。

信号强度 Signal Strength

表示 NB-IoT 网络信号强度。

示例：0x15 = 21。

0：-113 dBm 或更低。

1：-111 dBm。

2 至 30：-109 dBm 至 -53 dBm。

31：-51 dBm 或更高。

99：未知或无法检测。

PA8 门状态 Door Status

与 JSON 中的 level status 对应，表示 PA8 引脚的状态。

0x00：PA8 为高电平，表示门关闭。

0x01：PA8 为低电平，表示门开启。

PA8 告警状态 Alarm Status

表示此数据包是否由 PA8 引脚的超时告警触发。

0x00：普通上行数据包。

0x01：由 PA8 超时告警触发的上行数据包。

PA8 开门次数 door open num

表示连接至 PA8 的门磁传感器检测到的开门次数。

示例：0x00000A（十六进制）=10（十进制），即累计开门 10 次。

PA8 上一次开门时长 last open time

表示上一次开门持续的时间，单位为秒。

示例：0x00012C（十六进制）=300（十进制），即 300 秒。

PA4 门状态 Door Status

与 JSON 中的 level status2 对应，表示 PA4 引脚的状态。

0x00：PA4 为高电平，表示门关闭。

0x01：PA4 为低电平，表示门开启。

PA4 告警状态 Alarm Status

表示此数据包是否由 PA4 引脚的超时告警触发。

0x00：普通上行数据包。

0x01：由 PA4 超时告警触发的上行数据包。

PA4 开门次数 door open num

表示连接至 PA4 的门磁传感器检测到的开门次数。

示例：0x00000A（十六进制）=10（十进制），即累计开门 10 次。

PA4 上一次开门时长 last open time

表示上一次开门持续的时间，单位为秒。

示例：0x00012C（十六进制）=300（十进制），即 300 秒。

时间戳 Timestamp

Unix 时间戳示例：650ABC40（十六进制）=1695202368（十进制）。

将该十进制数值输入 epochconverter.com，即可转换为日期和时间。

参阅：相关操作说明

2.2.3 ThingsBoard 格式 Type 3

Type 3 数据格式专为 ThingsBoard 设计，同时会将其他默认服务器设置调整为 ThingsBoard。

单通道模式的 Type 3 数据如下。

{
  "topic": "004-NB",
  "payload": {
    "IMEI": "863663062765285",
    "IMSI": "460086859301439",
    "Model": "DS03A-NB",
    "level status": 1,
    "alarm status": 0,
    "door open num": 0,
    "last open time": 0,
    "level status2": 1,
    "alarm status2": 0,
    "door open num2": 0,
    "last open time2": 0,
    "battery": 3.33,
    "signal": 22,
    "time": "2024/12/07 00:56:00",
    "1": [0, 5123224, 5340135, "1970/03/01 07:07:05"],
    "2": [0, 0, 5339235, "1970/07/14 04:20:16"],
    "3": [0, 5123224, 5338335, "1970/03/01 07:07:05"],
    "4": [0, 0, 5337435, "1970/07/14 04:20:16"],
    "5": [0, 5123224, 5336535, "1970/03/01 07:07:05"],
    "6": [0, 0, 5335635, "1970/07/14 04:20:16"],
    "7": [0, 5123224, 5334735, "1970/03/01 07:07:05"],
    "8": [0, 0, 5333835, "1970/07/14 04:20:16"]
  }
}

双通道模式的 Type 3 数据如下。

{
  "topic": "004-NB",
  "payload": {
    "IMEI": "863663062765285",
    "IMSI": "460086859301439",
    "Model": "DS03A-NB",
    "level status": 1,
    "alarm status": 0,
    "door open num": 0,
    "last open time": 0,
    "level status2": 1,
    "alarm status2": 0,
    "door open num2": 0,
    "last open time2": 0,
    "battery": 3.32,
    "signal": 24,
    "time": "2024/12/07 00:58:29",
    "1": [0, 0, 0, 0, 5123224, 5340135, "1970/03/01 07:07:05"],
    "2": [0, 0, 0, 0, 0, 5339235, "1970/07/14 04:20:16"],
    "3": [0, 0, 0, 0, 5123224, 5338335, "1970/03/01 07:07:05"],
    "4": [0, 0, 0, 0, 0, 5337435, "1970/07/14 04:20:16"],
    "5": [0, 0, 0, 0, 5123224, 5336535, "1970/03/01 07:07:05"],
    "6": [0, 0, 0, 0, 0, 5335635, "1970/07/14 04:20:16"],
    "7": [0, 0, 0, 0, 5123224, 5334735, "1970/03/01 07:07:05"],
    "8": [0, 0, 0, 0, 0, 5333835, "1970/07/14 04:20:16"]
  }
}

2.2.4 ThingSpeak 格式 Type 1

此格式满足 ThingSpeak 平台的要求，包含 8 个字段，仅适用于 ThingSpeak 平台。

数据展示如下图所示。

图中四个字段依次为：门状态、告警状态、开门次数、上一次开门时长。第二通道字段名带后缀 2。

图中四个字段依次为：门状态、告警状态、开门次数、上一次开门时长。第二通道字段名带后缀 2。

2.3 测试上报与修改上报周期

默认情况下，传感器每 4 小时上报一次。

用户可使用以下指令修改上报周期。

AT 指令：AT+TDC。

示例：AT+TDC=7200 // 将上报周期设为 7200 秒，即 2 小时。

下行指令：0x01。

格式：指令码 0x01，后接 3 个字节。

示例：12 小时 = 43200 秒；43200（十进制）=0xA8C0（十六进制）。

下行载荷：01 00 A8 C0 // 对应 AT+TDC=43200，将上报周期设为 12 小时。

注意：按住按键超过 1 秒，也可触发一次上报。

2.4 多次采样后一次上报

注意：AT+NOUD 功能已升级为 Clock Logging 定时记录功能。请参阅第 2.13 节。

为节省电量，DS03A-NB 每 15 分钟采样一次，并每 2 小时上报一次。因此，每次上报包含 8 组已存储的数据和 1 组实时数据，由以下参数定义。原文将此处采样对象写为“水流数据”。

译注：此处的“水流数据”与门磁产品主题不一致，可能是复用文案；AT+TR 和 AT+NOUD 按原文保留。定时记录的新版配置参见第 2.13 节。

• AT+TR=900 // 单位为秒。默认每 900 秒，即 15 分钟记录一次数据，最小可设为 180 秒。
• AT+NOUD=8 // 默认每次上报 8 组记录数据，最多可上报 32 组。

下图进一步说明 TR、NOUD 和 TDC 的关系。

图中 Sample 表示采样，Record 表示存储记录，Tx 表示上报。TR 决定采样间隔，NOUD 决定上报携带的历史记录条数，TDC 决定定期上报间隔。不同组合会影响每次发送所覆盖的记录。

2.5 通过外部中断触发上报

DS03A-NB 支持外部触发中断。用户可以通过 PA8 引脚触发数据包上报。

AT 指令

• AT+INTMOD // 设置中断触发模式。
• AT+INTMOD=0 // 禁用中断。
• AT+INTMOD=1 // 上升沿和下降沿均触发。
• AT+INTMOD=2 // 下降沿触发。
• AT+INTMOD=3 // 上升沿触发。

2.6 启用或禁用开关门事件告警

功能：启用或禁用开关门事件告警，默认值为 0。

AT 指令

下行指令

0xA7 01 // 等同于 AT+DISALARM=1。

0xA7 00 // 等同于 AT+DISALARM=0。

2.7 状态持续超时告警

DS03A-NB 可监测某一状态持续的时间，并在超时后告警，例如监测门开启过久。相关参数如下。

• Keep Status：需要监测的状态。

Keep Status=1：监测从关闭变为开启的事件。

Keep Status=0：监测从开启变为关闭的事件。

• Keep Time：发送告警前的超时时长。

范围为 0 至 65535 秒，即 0xFFFF。

Keep Time=0 时，禁用状态持续超时告警。

Keep Time>0 时，设备监测 Keep Status 指定的状态变化；若超时后状态仍未改变，则发送告警。

• 下行指令

指令格式：0xA9 aa bb cc dd。

A9：指令类型码。

aa：01 表示 TTRIG1，02 表示 TTRIG2。

bb：需要监测的状态。

cc dd：超时时长。

1）AT+TTRIG1：对应 PA8 引脚。

AT 配置指令

• AT+TTRIG1=1,30：当门由关闭变为开启，并持续开启超过 30 秒时，DS03A-NB 发送上行数据包，将 Alarm1 位设为 1。原文将该位描述为载荷第 1 字节的第 2 位。
• AT+TTRIG1=0,30：原文描述为门由开启变为关闭，但随后“保持开启超过 30 秒”时发送告警，并将 Alarm1 位设为 1。原文将该位描述为载荷第 1 字节的第 2 位。此状态描述存在矛盾，见本节译注。
• AT+TTRIG1=0,0：默认值，禁用超时告警。

下行配置指令

0xA9 01 01 00 1E 等同于 AT+TTRIG1=1,30；0xA9 01 00 00 00 等同于 AT+TTRIG1=0,0。

2）AT+TTRIG2：对应 PA4 引脚，需要先设置 AT+TTRCHANNEL=2。

AT 配置指令

• AT+TTRIG2=1,30：当门由关闭变为开启，并持续开启超过 30 秒时，DS03A-NB 发送上行数据包，将 Alarm2 位设为 1。原文将该位描述为载荷第 12 字节的第 2 位。
• AT+TTRIG2=0,30：原文描述为门由开启变为关闭，但随后“保持开启超过 30 秒”时发送告警，并将 Alarm2 位设为 1。原文将该位描述为载荷第 12 字节的第 2 位。此状态描述存在矛盾，见本节译注。
• AT+TTRIG2=0,0：默认值，禁用超时告警。

下行配置指令

0xA9 02 00 00 1E 等同于 AT+TTRIG2=0,30；0xA9 02 00 00 00 等同于 AT+TTRIG2=0,0。

译注：Keep Status=0 的定义是监测关门状态，但两个 =0,30 示例的英文仍写“保持开启”，存在矛盾。原文关于 Alarm1 和 Alarm2 的字节位置描述也与本节 HEX 布局图难以直接对应。实施时应结合实际固件、通道和载荷格式验证告警位，必要时向厂商确认。

2.8 TTRIG1 与 TTRIG2 持续超时告警

此功能需要配合 AT+TTRIG1 或 AT+TTRIG2 使用。TTRIG1 或 TTRIG2 超时触发告警后，如果状态继续保持不变，设备将按照设定的告警间隔重复发送告警数据包。

AT 指令

下行指令

示例：0C aa 对应 AT+TTRALARM=aa。

2.9 计数模式

功能：手动设置计数模式。

AT 指令

译注：原文括注使用 Last Close Duration，其他章节使用 last open time，两者含义不同。此处保留其说明，不将关门时长直接改为开门时长。

下行指令

示例：0B aa 对应 AT+COUNTMOD=aa，第二个字节表示计数模式。

2.10 门磁通道数量

功能：设置门磁传感器的通道数量。

AT 指令

下行指令

示例：0D aa 对应 AT+TTRCHANNEL=aa，第二个字节表示通道数量。

2.11 清除开门次数与上一次开门时长

AT 指令

下行指令：0xA6 01。

执行后，设备清除开门次数和上一次开门持续时间。

2.12 设置开门计数值

AT 指令

译注：AT+SETCNT=2,50 和下行数据 0xA6 02 00 00 32 都对应 50，原文表格中的“100 次”疑为笔误。

下行指令

0xA6 01 00 00 64 对应 AT+SETCNT=1,100。

0xA6 01 00 00 00 对应 AT+SETCNT=1,0。

0xA6 02 00 00 32 对应 AT+SETCNT=2,50。

2.13 定时记录 固件 v1.2.1 起支持

当现场部署多个终端时，可能需要让所有传感器在相同时间采样，并汇总上报以便分析。此时可使用 Clock Logging 定时记录功能。

此指令可设置数据记录的起始时间和时间间隔，以满足指定采集时间的需求。

• AT 指令：AT+CLOCKLOG=a,b,c,d。

a：0 表示禁用定时记录，1 表示启用定时记录。

b：指定首次采样开始的秒数，范围为 0 至 3599，或特殊值 65535。设为 65535 时，记录周期在终端接入网络并发送数据包后开始。

c：采样间隔，范围为 0 至 255 分钟。

d：每个 TDC 上报周期中携带的记录条数，最大为 32 条。

注意：原文给出的停止记录参数为 AT+CLOCKLOG=1,65535,0,0。

译注：参数 a 的定义为 0 禁用、1 启用；但原文给出的停止记录示例仍为 a=1，并将间隔和记录条数设为 0。本文保留该示例，具体行为请按实际固件核对。

图示示例为 AT+CLOCKLOG=1,0,15,8：设备在 10:34:35 接入网络后立即首次上报，从 11:00:00 开始每隔 15 分钟采样并记录。TDC 上报周期设为 2 小时；第二次上报携带电池信息、最近 8 条历史记录及时间戳，并包含上报时的最新采样值。

示例

AT+CLOCKLOG=1,65535,1,5

终端发送第一个数据包后，每隔 1 分钟向存储器记录一次数据。每次按 TDC 周期上报时，载荷包含电池信息和最近 5 条存储记录，每条记录包含数据载荷及时间戳。

注意：配置此指令前，需要同步服务器时间。如果未先同步时间，则该指令要在终端复位后才生效。

• 下行指令：0x0A。

格式：指令码 0x0A，后接 5 个字节。

• 示例一：下行载荷 0A01FFFF0F08，对应 AT+CLOCKLOG=1,65535,15,8，设置记录时间。原文将采样对象写作 SHT。
• 示例二：下行载荷 0A0104B00F08，对应 AT+CLOCKLOG=1,1200,15,8，设置记录时间。原文将采样对象写作 SHT。

注意：输入下行载荷时，字节之间不得包含空格。

2.14 查询已保存的历史记录

• AT 指令：AT+CDP。

此指令可查询已保存的历史记录，最多记录 32 组数据，每组历史数据最大为 100 字节。

2.15 查询上行日志

• AT 指令：AT+GETLOG。

此指令可查询数据包的上行发送日志。

2.16 定时域名解析

此指令用于设置定时域名解析。

AT 指令

• AT+DNSTIMER=XX // 单位为小时。

设置后，设备会定期进行域名解析。

2.17 设置 MQTT QoS 等级

此指令用于设置 MQTT 的 QoS 等级。

AT 指令

• AT+MQOS=xx // 可设为 0 至 2。

下行指令：0x07。

格式：指令码 0x07，后接 1 个字节。

示例一：下行载荷 0x0700，对应 AT+MQOS=0。

示例二：下行载荷 0x0701，对应 AT+MQOS=1。

2.18 下行调试模式 固件 v1.3.0 起支持

功能：启用或禁用下行调试模式。TE 平台更新后，不再需要选择平台版本，只需切换下行调试模式。

AT 指令：AT+DOWNTE。

注意：第一个参数固定为 0，仅第二个参数可配置。

示例

• AT+DOWNTE=0,1：启用下行调试模式。
• AT+DOWNTE=0,0：禁用下行调试模式。

下行指令

此功能不提供下行指令。

2.19 域名解析设置 固件 v1.3.0 起支持

功能：设置动态域名解析及备用 IP 地址。

AT 指令：AT+BKDNS。

示例

• AT+BKDNS=1,0 // 禁用动态域名更新。
• AT+BKDNS=2,1 // 启用动态域名更新，将自动更新周期设为 1 小时。
• AT+BKDNS=2,4,3.69.98.183,1883 // 启用动态域名更新，周期设为 4 小时，并手动指定 IP 地址和端口。域名解析失败时，使用该 IP 通信；下次解析成功时，更新为新解析出的 IP。

下行指令

此功能不提供下行指令。

3 配置 DS03A-NB

3.1 配置方式

DS03A-NB 支持以下配置方式：

• 通过蓝牙连接发送 AT 指令，推荐使用。详见 BLE 配置说明。

参阅：相关操作说明

• 通过 UART 连接发送 AT 指令。详见 UART 连接说明。

参阅：相关操作说明

3.2 串口访问密码

成功建立蓝牙或 UART 连接后，使用串口访问密码进入 AT 指令窗口。

终端包装盒标签印有初始密码，格式为 AT+PIN=xxxxxx。登录时直接输入六位密码即可进入 AT 指令窗口，不需要输入 AT+PIN= 前缀。

截图提示：不要输入 AT+PIN=xxxxxx，只需输入 xxxxxx 本身。

如需修改密码，使用 AT+PWORD=xxxxxx，密码长度为 6 个字符。原文说明 NB 终端只支持小写字母。

译注：原文将初始密码称为“六位密码”，同时说明修改密码只支持小写字母，截图中又展示字母和数字组合。密码字符规则的表述不一致，修改前应核对设备固件支持的字符。

注意：输入指令后需要添加换行符，也可在蓝牙工具或 UART 连接工具中设置自动换行。

截图中勾选 Auto add line feed when send，在发送指令时自动添加换行符。

3.3 AT 指令集

通用指令

参阅：相关操作说明

MQTT 管理指令

信息与维护指令

4 电池与功耗

DS03A-NB 使用 ER26500 与 SPC1520 组成的电池组。电池信息、功耗分析和更换方法详见以下说明。

电池信息与功耗分析。

参阅：相关操作说明

5 固件升级

用户可以通过更新固件实现以下目的：

• 获得新增功能。
• 修复程序缺陷。

固件和更新日志可通过固件下载链接获取。

参阅：相关操作说明

固件升级方式

• 推荐方式：通过 BLE 进行 OTA 固件升级，详见操作说明。

参阅：相关操作说明

• 通过 UART TTL 接口升级，详见操作说明。

参阅：相关操作说明

6 常见问题

6.1 如何访问 BC660K-GL 的 AT 指令

用户可以直接访问 BC660K-GL 模组并发送 AT 指令。

详见 BC660K-GL AT 指令集。

参阅：相关操作说明

6.2 如何配置证书

请参阅证书配置说明，按照其中的步骤完成配置。

参阅：相关操作说明

6.3 太阳能板型号按键后 LED 为什么不亮

按下按键后 LED 不亮，可能是因为电池进入了保护状态。

解决方法：将太阳能板置于阳光直射处，即可重新激活电池。更多信息见“电池保护状态”说明，该说明适用于太阳能板与锂离子电池组合。

参阅：相关操作说明

译注：此问答针对太阳能板与锂离子电池型号；标准 DS03A-NB 的不可充电锂亚硫酰氯电池不应按太阳能充电方式处理。

7 订购信息

产品型号：DS03A-NB-XX。

XX 表示以下版本：

• GE：通用版，不包含 SIM 卡。
• 1T：附带 1NCE SIM 卡，包含 10 年期限和 500 MB 流量，并已预配置为连接 ThingsEye 服务器。

8 包装信息

包装清单

• DS03A-NB NB-IoT 门磁传感器 1 台。
• 外置天线 1 根。

尺寸与重量

• 设备尺寸：13.0 × 5 × 4.5 cm。
• 设备重量：150 g。
• 单件包装尺寸：14.0 × 8 × 5 cm。
• 单件包装重量：180 g。

9 技术支持

• 技术支持时间为周一至周五 09:00 至 18:00，时区为 GMT+8。由于存在时差，无法提供实时支持，但会在上述工作时间内尽快回复。
• 咨询时请尽可能提供完整信息，包括产品型号、准确的问题描述及复现步骤，并发送邮件至 support@dragino.com。

参阅：发送邮件至技术支持