Hide last authors
Xiaoling 82.36 1
Edwin Chen 1.1 2
3
Xiaoling 96.4 4 (% style="text-align:center" %)
5 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/D2x.jpg?rev=1.1||alt="D2x.jpg" height="327" width="1315"]]
Ellie Zhang 26.1 6
Xiaoling 82.36 7
8
9
10
11
12
13
Xiaoling 96.4 14
Xiaoling 82.23 15 **Table of Contents:**
Ellie Zhang 30.1 16
Edwin Chen 1.1 17 {{toc/}}
18
19
20
21
22
23
kai 31.1 24 = 1. Introduction =
Edwin Chen 1.1 25
Xiaoling 82.36 26 == 1.1 What is D2x-NB NB-IoT Temperature Sensor ==
Edwin Chen 1.1 27
Xiaoling 39.6 28
Xiaoling 83.5 29 The Dragino D2x-NB is a (% style="color:blue" %)**NB-IoT Temperature Sensor**(%%) for Internet of Things solution. D2x-NB has 1 ~~ 3 temperature probes. D2x-NB will convert the Temperature reading to upload the sensor data send to IoT platform via NB-IoT network.
Edwin Chen 1.1 30
Xiaoling 83.5 31 The temperature sensor used in D2x-NB can (% style="color:blue" %)**measure -55°C ~~ 125°C with accuracy ±0.5°C (max ±2.0 °C)**.
Edwin Chen 1.1 32
Xiaoling 83.16 33 D2x-NB supports (% style="color:blue" %)**temperature alarm feature**(%%), user can set temperature alarm for instant notice. D2x-NB supports Datalog feature, it can save the data when there is no NB-IoT network and uplink when network recover.
Edwin Chen 1.1 34
Xiaoling 83.3 35 D2x-NB has max 3 probes which measure maximum 3 temperature points.
Edwin Chen 1.1 36
Xiaoling 83.5 37 D2x-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
Edwin Chen 1.1 38
Xiaoling 83.5 39 D2x-NB (% style="color:blue" %)**supports BLE configure and OTA update**(%%) which make user easy to use.
Edwin Chen 1.1 40
Xiaoling 83.23 41 D2x-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
Xiaoling 82.37 42
Xiaoling 83.3 43 D2x-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
Xiaoling 82.37 44
Xiaoling 83.2 45 [[image:image-20230913142955-1.png||height="323" width="937"]]
Xiaoling 82.37 46
Edwin Chen 1.1 47
48 == 1.2 ​Features ==
49
Xiaoling 39.6 50
Xiaoling 70.3 51 * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
Edwin Chen 1.1 52 * Ultra-low power consumption
Xiaoling 83.4 53 * 1 ~~ 3 External Temperature Probes
54 * Measure range -55°C ~~ 125°C
55 * Temperature alarm
Xiaoling 70.3 56 * Multiply Sampling and one uplink
57 * Support Bluetooth v5.1 remote configure and update firmware
Edwin Chen 1.1 58 * Uplink on periodically
59 * Downlink to change configure
60 * 8500mAh Battery for long term use
Xiaoling 70.3 61 * Nano SIM card slot for NB-IoT SIM
Edwin Chen 1.1 62
63 == 1.3 Specification ==
64
65
Xiaoling 82.28 66 (% style="color:blue" %)**Common DC Characteristics:**
Edwin Chen 1.1 67
Xiaoling 83.6 68 * Supply Voltage: 2.5v ~~ 3.6v
Edwin Chen 1.1 69 * Operating Temperature: -40 ~~ 85°C
70
Xiaoling 82.30 71 (% style="color:blue" %)**Temperature Sensor:**
Edwin Chen 1.1 72
Xiaoling 83.3 73 * Dallas DS18B20
74 * Range: -55 to + 125°C
Xiaoling 83.7 75 * Accuracy ±0.5°C (max ±2.0 °C)
Edwin Chen 1.1 76
Xiaoling 82.28 77 (% style="color:blue" %)**NB-IoT Spec:**
Edwin Chen 1.1 78
Xiaoling 82.28 79 (% style="color:#037691" %)**NB-IoT Module: BC660K-GL**
Edwin Chen 1.1 80
Xiaoling 82.29 81 (% style="color:#037691" %)**Support Bands:**
Xiaoling 70.4 82
83 * B1 @H-FDD: 2100MHz
84 * B2 @H-FDD: 1900MHz
85 * B3 @H-FDD: 1800MHz
86 * B4 @H-FDD: 2100MHz
87 * B5 @H-FDD: 860MHz
88 * B8 @H-FDD: 900MHz
89 * B12 @H-FDD: 720MHz
90 * B13 @H-FDD: 740MHz
91 * B17 @H-FDD: 730MHz
92 * B18 @H-FDD: 870MHz
93 * B19 @H-FDD: 870MHz
94 * B20 @H-FDD: 790MHz
95 * B25 @H-FDD: 1900MHz
96 * B28 @H-FDD: 750MHz
97 * B66 @H-FDD: 2000MHz
98 * B70 @H-FDD: 2000MHz
99 * B85 @H-FDD: 700MHz
100
Xiaoling 82.28 101 (% style="color:blue" %)**Battery:**
Edwin Chen 1.1 102
103 * Li/SOCI2 un-chargeable battery
104 * Capacity: 8500mAh
Xiaoling 70.5 105 * Self Discharge: <1% / Year @ 25°C
Edwin Chen 1.1 106 * Max continuously current: 130mA
107 * Max boost current: 2A, 1 second
108
Xiaoling 82.28 109 (% style="color:blue" %)**Power Consumption**
Edwin Chen 1.1 110
Xiaoling 70.4 111 * STOP Mode: 10uA @ 3.3v
112 * Max transmit power: 350mA@3.3v
Edwin Chen 1.1 113
Xiaoling 83.20 114 (% class="wikigeneratedid" %)
115 (% style="display:none" %) (%%)
116
117
Xiaoling 73.2 118 == 1.4 Applications ==
Edwin Chen 1.1 119
120
Xiaoling 70.5 121 * Smart Buildings & Home Automation
122 * Logistics and Supply Chain Management
123 * Smart Metering
124 * Smart Agriculture
125 * Smart Cities
126 * Smart Factory
127
Xiaoling 73.2 128 == 1.5 Sleep mode and working mode ==
129
130
Xiaoling 84.2 131 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
Xiaoling 73.2 132
Xiaoling 84.2 133 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
Xiaoling 73.2 134
135
136 == 1.6 Button & LEDs ==
137
138
Edwin Chen 6.1 139 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
Edwin Chen 1.1 140
141
Xiaoling 96.5 142 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
143 |=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width:226px;background-color:#4F81BD;color:white" %)**Action**
Edwin Chen 1.1 144 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
Xiaoling 73.2 145 If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
Edwin Chen 1.1 146 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
147 )))
148 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
Xiaoling 73.2 149 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to attach NB-IoT network.
Edwin Chen 1.1 150 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
Xiaoling 73.2 151 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not.
Edwin Chen 1.1 152 )))
Edwin Chen 6.1 153 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
Edwin Chen 1.1 154
Xiaoling 94.2 155 (% style="color:red" %)**Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.**
156
157
Xiaoling 73.2 158 == 1.7 BLE connection ==
Edwin Chen 1.1 159
160
Xiaoling 83.10 161 D2x-NB support BLE remote configure and firmware update.
Edwin Chen 1.1 162
163
164 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
165
166 * Press button to send an uplink
167 * Press button to active device.
168 * Device Power on or reset.
169
170 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
171
172
Xiaoling 96.3 173 == 1.8 Pin Definitions , Switch & SIM Direction ==
Edwin Chen 1.1 174
Xiaoling 73.3 175
Xiaoling 83.18 176 D2x-NB use the mother board from D2x-NB which as below.
Xiaoling 73.3 177
Xiaoling 73.2 178 [[image:image-20230819104805-5.png]]
Edwin Chen 1.1 179
Saxer Lin 43.1 180
Xiaoling 73.3 181 === 1.8.1 Jumper JP2 ===
Saxer Lin 43.1 182
Xiaoling 73.3 183
184 Power on Device when put this jumper.
185
186
187 === 1.8.2 BOOT MODE / SW1 ===
188
189
Xiaoling 82.31 190 **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
Xiaoling 73.3 191
Xiaoling 82.31 192 **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
Xiaoling 73.3 193
194
195 === 1.8.3 Reset Button ===
196
Xiaoling 80.2 197
Xiaoling 73.3 198 Press to reboot the device.
199
200
Xiaoling 96.3 201 === 1.8.4 SIM Card Direction ===
202
203 See this link. [[How to insert SIM Card>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
204
205
Xiaoling 73.3 206 == 1.9 Hardware Variant ==
207
208
Xiaoling 96.5 209 (% border="1" cellspacing="3" style="width:510px" %)
Xiaoling 83.8 210 |=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 190px;background-color:#4F81BD;color:white" %)Photo|=(% style="width: 218px;background-color:#4F81BD;color:white" %)Probe Info
211 |(% style="width:102px" %)D20-NB|(% style="width:190px" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/image-20230526153320-2.jpeg?rev=1.1||alt="image-20230526153320-2.jpeg"]](((
212
213 )))|(% style="width:297px" %)(((
214 1 x DS28B20 Probe
Edwin Chen 1.1 215
Xiaoling 83.8 216 Cable Length : 2 meters
Edwin Chen 1.1 217
218
219 )))
Xiaoling 83.8 220 |(% style="width:102px" %)D20S-NB|(% style="width:190px" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/image-20230526150859-1.jpeg?rev=1.1||alt="image-20230526150859-1.jpeg"]](((
221
222 )))|(% style="width:297px" %)(((
223 1 x DS28B20 Probe (Suitable for bury in soil)
224
225 Material: TPE, Cable Length: 2meters
226 )))
227 |(% style="width:102px" %)D22-NB|(% style="width:190px" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/image-20230526153345-3.jpeg?rev=1.1||alt="image-20230526153345-3.jpeg"]](((
228
229 )))|(% style="width:297px" %)(((
230 2 x DS28B20 Probes
231
232 Cable lengths total 1.5meters per probe
233
234 Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K21G-210811.pdf]]
235 )))
Saxer Lin 44.1 236 |(% style="width:102px" %)(((
Xiaoling 83.8 237 (((
238 D23-NB
239 )))
Edwin Chen 1.1 240
Xiaoling 83.8 241 (((
242
Edwin Chen 1.1 243 )))
Xiaoling 83.8 244 )))|(% style="width:190px" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/image-20230526153417-4.jpeg?rev=1.1||alt="image-20230526153417-4.jpeg"]](((
245
246 )))|(% style="width:297px" %)(((
247 3 x DS28B20 Probes
Edwin Chen 1.1 248
Xiaoling 83.8 249 Cable lengths total 1.5meters per probe
250
251 Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K31G-210811.pdf]]
252 )))
253
Edwin Chen 1.1 254 (% style="display:none" %)
255
Xiaoling 95.11 256
257
Xiaoling 83.9 258 = 2. Use D2x-NB to communicate with IoT Server =
Edwin Chen 1.1 259
Xiaoling 80.2 260 == 2.1 Send data to IoT server via NB-IoT network ==
Edwin Chen 1.1 261
262
Xiaoling 83.9 263 The D2x-NB is equipped with a NB-IoT module, the pre-loaded firmware in D2x-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by D2x-NB.
Edwin Chen 1.1 264
Xiaoling 80.2 265 Below shows the network structure:
Edwin Chen 1.1 266
Xiaoling 83.9 267 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-NB_D20S-NB_D22-NB_D23-NB_NB-IoT_Temperature_Sensor_User_Manual/WebHome/image-20230913142955-1.png?width=937&height=323&rev=1.1||alt="image-20230913142955-1.png"]]
Edwin Chen 1.1 268
269
Xiaoling 83.9 270 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of D2x-NB.
Edwin Chen 1.1 271
272
Xiaoling 83.9 273 (% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set D2x-NB send data to IoT server.
Edwin Chen 1.1 274
Xiaoling 82.19 275 * Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
Xiaoling 80.4 276
Xiaoling 82.19 277 * Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]]. 
Edwin Chen 1.1 278
Xiaoling 80.2 279 Below shows result of different server as a glance.
Edwin Chen 1.1 280
Xiaoling 96.6 281 (% border="1" cellspacing="3" style="width:515px" %)
Xiaoling 81.2 282 |(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments**
Xiaoling 82.24 283 |(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)(((
284 (% style="text-align:center" %)
285 [[image:image-20230819113244-8.png||height="183" width="367"]]
286 )))|(% style="width:170px" %)
287 |(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)(((
288 (% style="text-align:center" %)
Xiaoling 82.25 289 [[image:image-20230819113244-9.png||height="119" width="367"]]
Xiaoling 82.24 290 )))|(% style="width:170px" %)
Xiaoling 80.9 291 |(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %)
292 |(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
293 |(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
Xiaoling 82.24 294 |(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)(((
295 (% style="text-align:center" %)
Xiaoling 82.25 296 [[image:image-20230819113244-10.png||height="104" width="367"]]
Xiaoling 82.24 297 )))|(% style="width:170px" %)
298 |(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)(((
299 (% style="text-align:center" %)
Xiaoling 82.25 300 [[image:image-20230819113244-11.png||height="141" width="367"]]
Xiaoling 82.24 301 )))|(% style="width:170px" %)
Xiaoling 80.2 302
Xiaoling 83.9 303 (% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate D2x-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
Xiaoling 80.2 304
305
306 == 2.2 ​Payload Types ==
307
308
Xiaoling 83.9 309 To meet different server requirement, D2x-NB supports different payload type.
Edwin Chen 1.1 310
Xiaoling 81.2 311 **Includes:**
Edwin Chen 1.1 312
Xiaoling 82.21 313 * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
Xiaoling 80.7 314
Xiaoling 82.21 315 * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
Xiaoling 80.7 316
Xiaoling 82.21 317 * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
Xiaoling 80.7 318
Xiaoling 82.21 319 * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
Edwin Chen 1.1 320
Xiaoling 80.3 321 User can specify the payload type when choose the connection protocol. Example:
Edwin Chen 1.1 322
Xiaoling 81.2 323 (% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
Edwin Chen 1.1 324
Xiaoling 80.8 325 (% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
Edwin Chen 1.1 326
Xiaoling 81.2 327 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
Edwin Chen 1.1 328
329
Xiaoling 82.20 330 === 2.2.1 General Json Format(Type~=5) ===
Edwin Chen 1.1 331
Xiaoling 80.8 332
Xiaoling 80.3 333 This is the General Json Format. As below:
Edwin Chen 1.1 334
Mengting Qiu 88.1 335 (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"D23-NB","temperature1":28.3,"temperature2":28.3,"temperature3":28.2,"battery":3.24,"signal":23,"1":{-409.5,-409.5,-409.5,2023/10/11 05:51:11},"2":{-409.5,-409.5,-409.5,2023/10/11 05:36:11},"3":{-409.5,-409.5,-409.5,2023/10/11 05:21:10},"4":{-409.5,-409.5,-409.5,2023/10/11 05:06:10},"5":{-409.5,-409.5,-409.5,2023/10/11 04:51:11},"6":{-409.5,-409.5,-409.5,2023/10/11 04:36:11},"7":{-409.5,-409.5,-409.5,2023/10/11 04:21:11},"8":{-409.5,-409.5,-409.5,2023/10/11 04:06:10}}**
Edwin Chen 1.1 336
337
Mengting Qiu 88.1 338 [[image:image-20231011142613-2.png||height="701" width="946"]]
339
340
Xiaoling 81.2 341 (% style="color:red" %)**Notice, from above payload:**
Edwin Chen 1.1 342
Xiaoling 83.17 343 * Temperature , Battery & Signal are the value at uplink time.
Edwin Chen 1.1 344
Xiaoling 83.20 345 * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Temperature, Sampling time.
Edwin Chen 1.1 346
Xiaoling 81.2 347 === 2.2.2 HEX format Payload(Type~=0) ===
Edwin Chen 1.1 348
349
Xiaoling 80.3 350 This is the HEX Format. As below:
Edwin Chen 1.1 351
Mengting Qiu 88.1 352 (% style="color:#4472c4" %)**f86620705837844303640cc61801000000011301140113652640edf001f001f001652637cff001f001f0016526344bf001f001f001652630c6f001f001f00165262d42f001f001f001652629bff001f001f0016526263bf001f001f001652622b7f001f001f00165261f32**
Edwin Chen 1.1 353
Mengting Qiu 93.1 354 [[image:image-20231011163534-6.png||height="190" width="1111"]]
Edwin Chen 6.1 355
Edwin Chen 1.1 356
Mengting Qiu 88.1 357 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
358
359
360 [[image:image-20231011143052-3.png||height="691" width="938"]]
361
362
Xiaoling 80.4 363 (% style="color:blue" %)**Version:**
Edwin Chen 1.1 364
Xiaoling 80.3 365 These bytes include the hardware and software version.
Edwin Chen 1.1 366
Bei Jinggeng 84.1 367 (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x03 for D2x-NB
Edwin Chen 1.1 368
Xiaoling 80.4 369 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
Edwin Chen 1.1 370
371
Xiaoling 81.2 372 (% style="color:blue" %)**BAT (Battery Info):**
Edwin Chen 1.1 373
Mengting Qiu 88.2 374 Ex1: 0x0CC6 = 3270mV
Edwin Chen 1.1 375
376
Xiaoling 80.4 377 (% style="color:blue" %)**Signal Strength:**
Edwin Chen 1.1 378
Xiaoling 80.3 379 NB-IoT Network signal Strength.
Edwin Chen 1.1 380
Mengting Qiu 88.2 381 **Ex1: 0x18 = 24**
Edwin Chen 1.1 382
Xiaoling 80.3 383 **0**  -113dBm or less
Edwin Chen 1.1 384
Xiaoling 80.3 385 **1**  -111dBm
Edwin Chen 1.1 386
Xiaoling 80.3 387 **2...30** -109dBm... -53dBm
Edwin Chen 1.1 388
Xiaoling 80.3 389 **31**   -51dBm or greater
Edwin Chen 1.1 390
Xiaoling 80.3 391 **99**    Not known or not detectable
Edwin Chen 1.1 392
393
Xiaoling 80.4 394 (% style="color:blue" %)**Temperature: **
Edwin Chen 1.1 395
396 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
397
398 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
399
Xiaoling 82.27 400 (FF3F & 8000: Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Edwin Chen 1.1 401
402
Xiaoling 80.4 403 (% style="color:blue" %)**TimeStamp:   **
Edwin Chen 1.1 404
Xiaoling 80.3 405 Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
Edwin Chen 1.1 406
Mengting Qiu 88.2 407 Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
Edwin Chen 1.1 408
409
Xiaoling 81.2 410 === 2.2.3 ThingsBoard Payload(Type~=3) ===
Edwin Chen 1.1 411
Xiaoling 80.8 412
Xiaoling 80.3 413 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
Edwin Chen 1.1 414
Mengting Qiu 90.2 415 (% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "S31x-NB","temperature1": 27.3,"temperature2": 27.4,"temperature3": 27.4,"battery": 3.35,"signal": 17}**
Saxer Lin 46.1 416
Edwin Chen 1.1 417
Mengting Qiu 90.2 418 [[image:image-20231011155047-5.png||height="507" width="963"]]
419
420
Xiaoling 81.2 421 === 2.2.4 ThingSpeak Payload(Type~=1) ===
Edwin Chen 1.1 422
Xiaoling 80.8 423
Mengting Qiu 89.3 424 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~5 are:
Edwin Chen 1.1 425
Mengting Qiu 89.3 426 Temperature1, Temperature 2, Temperature 3,Battery & Signal. This payload type only valid for ThingsSpeak Platform
Xiaoling 14.22 427
Xiaoling 80.3 428 As below:
Edwin Chen 1.1 429
Mengting Qiu 89.2 430 (% style="color:#4472c4" %)**field1=temp1 value&field2=temp2 value&field3=temp3 value&field4=Battery value&field5=Signal value**
Edwin Chen 1.1 431
Mengting Qiu 94.3 432 [[image:image-20231011152448-4.png||height="972" width="1009"]]
Edwin Chen 10.1 433
Mengting Qiu 89.2 434
Mengting Qiu 94.3 435 == 2.3 Uplink Payload ==
Xiaoling 83.12 436
437
Mengting Qiu 94.4 438 (((
Mengting Qiu 94.3 439 D2x-NB will uplink payload via NB-IoT with below payload format:
Mengting Qiu 94.4 440 )))
Xiaoling 83.12 441
Mengting Qiu 94.4 442 (((
443 Uplink payload includes in total 27 bytes.
Xiaoling 83.12 444 )))
445
Xiaoling 96.6 446 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 95.6 447 |=(% style="width: 60px; background-color:#4F81BD;color:white" %)Size(bytes)|=(% style="width: 40px; background-color:#4F81BD;color:white" %)8|=(% style="width: 30px; background-color:#4F81BD;color:white" %)2|=(% style="width: 30px;background-color:#4F81BD;color:white" %)2|=(% style="width: 50px;background-color:#4F81BD;color:white" %)1|=(% style="background-color: #4F81BD; color: white; width: 30px;" %)1|=(% style="width: 30px;background-color:#4F81BD;color:white" %)2|=(% style="background-color: #4F81BD; color: white; width: 50px;" %)1|=(% style="width: 45px;background-color:#4F81BD;color:white" %)2|=(% style="width: 45px;background-color:#4F81BD;color:white" %)2|=(% style="width: 45px;background-color:#4F81BD;color:white" %)2|=(% style="width: 55px;background-color:#4F81BD;color:white" %)4
Mengting Qiu 94.4 448 |(% style="width:95px" %)Value|(% style="width:61px" %)f+IMEI|(% style="width:61px" %)Ver|(% style="width:61px" %)BAT|(% style="width:61px" %)(((
Mengting Qiu 96.1 449 Signal Strength
Mengting Qiu 94.4 450 )))|(% style="width:49px" %)Mod|(% style="width:79px" %)ADC |(% style="width:61px" %)Interrupt|(% style="width:61px" %)(((
Xiaoling 95.5 451 Temp1 (% style="color:red" %)**(PC13)**
Mengting Qiu 94.4 452 )))|(% style="width:61px" %)(((
Xiaoling 95.5 453 Temp2 (% style="color:red" %)**(PB9)**
Mengting Qiu 94.4 454 )))|(% style="width:61px" %)(((
Xiaoling 95.5 455 Temp3 (% style="color:red" %)**(PB8)**
Mengting Qiu 94.4 456 )))|(% style="width:61px" %)Timestamp
Xiaoling 83.12 457
Mengting Qiu 94.4 458 (((
459 If the cache upload mechanism is turned on, you will receive the payload shown in the figure below.
460 )))
Xiaoling 83.12 461
Xiaoling 96.6 462 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:512px" %)
Mengting Qiu 94.4 463 |(% style="width:115px" %)**Frame header**|(% style="width:118px" %)**Frame data(1)**|(% style="width:116px" %)**Frame data(2)**|(% style="width:39px" %)**F…**|(% style="width:117px" %)**Frame data(X)**
Xiaoling 83.12 464
Xiaoling 83.15 465 === (% style="color:blue" %)**Decode corresponding probe color**(%%) ===
Xiaoling 83.12 466
467 **D20:**
468
469 Red <~-~-> C1
470
471
472 **D22:**
473
474 White <~-~-> C1 , Red <~-~-> C2
475
476
477 **D23:**
478
479 White <~-~->C1  , Red <~-~-> C2  , Black <~-~-> C3
480
481
Xiaoling 83.15 482 === (% style="color:blue" %)**Temperature RED or Temperature White**(%%) ===
Xiaoling 83.12 483
Xiaoling 83.14 484 (% style="color:red" %)**This point to the Red probe in D20-NB or the probe of D22-NB/D23-NB White**
Xiaoling 83.12 485
Mengting Qiu 105.1 486 When the cache upload mechanism is turned on and the sensor is not identified, the uploaded real-time data is FFFF and the uploaded historical data is F001.
Mengting Qiu 103.2 487
Mengting Qiu 105.1 488
Xiaoling 83.12 489 **Example**:
490
Mengting Qiu 105.1 491 **Real-time data:**
492
Xiaoling 83.12 493 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
494
495 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
496
Xiaoling 95.7 497 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 83.12 498
Mengting Qiu 106.1 499 When no sensor is identified,payload is: FFFFH : (FFFF&8000 == 1),temp = (FFFFH-65536)/10=-409.5 degrees.
500
501 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
502
Mengting Qiu 105.1 503 **Caching data:**
Xiaoling 83.12 504
Mengting Qiu 106.1 505 If payload is: 0109H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.5 degree
506
Mengting Qiu 105.1 507 if payload is: F001H: (F001&8000 == 1),temp = (F001-65536)/10 = -409.5 degrees.
508
509 (F001 & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
510
511
Xiaoling 83.21 512 === (% style="color:blue" %)**Temperature White**(%%) ===
Xiaoling 83.12 513
Xiaoling 83.14 514 (% style="color:red" %)**This point to the Red probe in D22-NB/D23-NB.**
Xiaoling 83.12 515
Mengting Qiu 105.1 516 When the cache upload mechanism is turned on and the sensor is not identified, the uploaded real-time data is FFFF and the uploaded historical data is F001.
Xiaoling 83.12 517
518
519 **Example**:
520
Mengting Qiu 105.1 521 **Real-time data:**
Mengting Qiu 103.2 522
Xiaoling 83.12 523 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
524
525 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
526
Mengting Qiu 106.1 527 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 83.12 528
Mengting Qiu 106.1 529 When no sensor is identified,payload is: FFFFH : (FFFF&8000 == 1),temp = (FFFFH-65536)/10=-409.5 degrees.
530
531 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
532
Mengting Qiu 105.1 533 **Caching data:**
Xiaoling 83.12 534
Mengting Qiu 106.1 535 If payload is: 0109H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.5 degree
536
Mengting Qiu 104.1 537 if payload is: F001H: (F001&8000 == 1),temp = (F001-65536)/10 = -409.5 degrees.
Mengting Qiu 103.2 538
Mengting Qiu 105.1 539 (F001 & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Mengting Qiu 103.2 540
Mengting Qiu 106.1 541
Xiaoling 83.21 542 === (% style="color:blue" %)**Temperature Black**(%%) ===
Xiaoling 83.12 543
Xiaoling 83.14 544 (% style="color:red" %)**This point to the BLACK probe in D23-NB**
Xiaoling 83.12 545
Mengting Qiu 105.1 546 When the cache upload mechanism is turned on and the sensor is not identified, the uploaded real-time data is FFFF and the uploaded historical data is F001.
Xiaoling 83.12 547
548
549 **Example**:
550
Mengting Qiu 105.1 551 **Real-time data:**
552
Xiaoling 83.12 553 If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
554
555 If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
556
Xiaoling 95.8 557 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
Xiaoling 83.12 558
Mengting Qiu 106.1 559 When no sensor is identified,payload is: **FFFF**H : (FFFF & 8000 == 1),temp = (**FFFF**H - 65536)/10=-409.5 degrees.
560
561 (FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
562
Mengting Qiu 105.1 563 **Caching data:**
Xiaoling 83.12 564
Mengting Qiu 106.1 565 If payload is: 0109H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.5 degree
566
Mengting Qiu 105.1 567 if payload is: F001H: (F001&8000 == 1),temp = (F001-65536)/10 = -409.5 degrees.
568
569 (F001 & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
570
571
Xiaoling 83.14 572 == 2.4 Test Uplink and Change Update Interval ==
Edwin Chen 1.1 573
574
Xiaoling 80.4 575 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
Edwin Chen 1.1 576
Xiaoling 80.4 577 User can use below commands to change the (% style="color:blue" %)**uplink interval**.
Edwin Chen 1.1 578
Xiaoling 82.2 579 (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
Edwin Chen 1.1 580
Xiaoling 80.3 581 User can also push the button for more than 1 seconds to activate an uplink.
Edwin Chen 1.1 582
583
Xiaoling 83.14 584 == 2.5 Multi-Samplings and One uplink ==
Xiaoling 39.5 585
Mengting Qiu 103.1 586
Xiaoling 105.2 587 (% style="color:red" %)**Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>||anchor="H2.8Clocklogging28Sincefirmwareversionv1.2.129"]].**
588
Xiaoling 83.18 589 To save battery life, D2x-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
Edwin Chen 1.1 590
Xiaoling 82.6 591 * (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
Edwin Chen 1.1 592
Xiaoling 82.12 593 * (% style="color:#037691" %)**AT+NOUD=8**     (%%)~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
Edwin Chen 1.1 594
Xiaoling 80.3 595 The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
Edwin Chen 1.1 596
Xiaoling 82.2 597 [[image:1692424376354-959.png]]
Edwin Chen 1.1 598
599
Xiaoling 83.14 600 == 2.6 Temperature Alarm Feature ==
Edwin Chen 1.1 601
Xiaoling 80.5 602
Xiaoling 83.14 603 D2x-NB work flow with Alarm feature.
Xiaoling 39.5 604
Xiaoling 83.19 605 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220623090437-1.png?rev=1.1||alt="图片-20220623090437-1.png" height="727" width="1039"]]
Edwin Chen 1.1 606
607
Mengting Qiu 94.5 608 === (% style="color:red" %)**Set Alarm Thredhold**(%%) ===
Edwin Chen 1.1 609
610
Mengting Qiu 94.5 611 (% style="color:blue" %)**Set for Separate Probes:**
Edwin Chen 1.1 612
Mengting Qiu 94.5 613
Mengting Qiu 94.4 614 (% style="color:#037691" %)**AT+TEMPALARM1 index=min,max**
Edwin Chen 1.1 615
Xiaoling 83.14 616 Index:
617
618 * 1: Temperature_Red
619 * 2: Temperature_White
620 * 3: Temperature_Black
621
Mengting Qiu 94.4 622 min,max:
Xiaoling 83.14 623
Mengting Qiu 94.4 624 * When min=0, and max≠0, Alarm trigger when higher than max
625 * When min≠0, and max=0, Alarm trigger when lower than min
626 * When min≠0 and max≠0, Alarm trigger when higher than max or lower than min
Xiaoling 83.14 627
Mengting Qiu 94.4 628 **Example:**
Xiaoling 83.14 629
Mengting Qiu 94.4 630 AT+TEMPALARM1=-10,30  ~/~/ Alarm when < -10 or higher than 30.
Xiaoling 83.14 631
632
633 == 2.7 Trggier an uplink by external interrupt ==
634
635
Xiaoling 83.18 636 D2x-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
Saxer Lin 55.1 637
Xiaoling 80.5 638 (% style="color:blue" %)**AT command:**
Saxer Lin 46.1 639
Xiaoling 82.6 640 * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
Saxer Lin 46.1 641
Xiaoling 82.6 642 * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
Edwin Chen 1.1 643
Xiaoling 82.6 644 * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
Xiaoling 80.5 645
Xiaoling 82.6 646 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
Xiaoling 80.5 647
Xiaoling 82.6 648 * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
Xiaoling 80.5 649
Mengting Qiu 101.1 650 == 2.8 Clock logging (Since firmware version v1.2.1) ==
Mengting Qiu 100.1 651
Xiaoling 101.2 652
Mengting Qiu 100.1 653 Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature.
654
655 We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.
656
657 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)**
658
659 (% style="color:#037691" %)**a: **(%%)**0:** Disable Clock logging.  ** 1: **Enable Clock Logging
660
Xiaoling 101.2 661 (% style="color:#037691" %)**b: **(%%)Specify First sampling start second: range **(0 ~~ 3599, 65535)   ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.
Mengting Qiu 100.1 662
663 (% style="color:#037691" %)**c: **(%%)Specify the sampling interval: range **(0 ~~ 255 minutes)**
664
665 (% style="color:#037691" %)**d: **(%%)How many entries should be uplink on every TDC **(max 32)**
666
667 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1||alt="image-20240315141254-1.png"]]
668
669 **Example:**
670
671 **AT+CLOCKLOG=1,65535,1,5**
672
673 After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp).
674
675 (% class="wikigeneratedid" %)
676 [[image:image-20240316154421-1.png||height="558" width="1165"]]
677
678 (% class="wikigeneratedid" %)
679 (% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.**
680
681
Xiaoling 101.2 682 == 2.9 Example Query saved historical records ==
Mengting Qiu 100.1 683
684
685 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CDP(%%)**
686
687 This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes.
688
689 (% class="wikigeneratedid" %)
690 [[image:image-20240316154510-2.png||height="666" width="872"]]
691
692
Mengting Qiu 102.2 693 == 2.10 Uplink log query ==
694
Mengting Qiu 103.1 695
Mengting Qiu 102.2 696 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+GETLOG(%%)**
697
698 This command can be used to query upstream logs of data packets.
699
700 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20240407191922-2.png?width=903&height=631&rev=1.1||alt="image-20240407191922-2.png"]]
701
702
Xiaoling 103.3 703 == 2.11 Scheduled domain name resolution ==
Mengting Qiu 102.2 704
Xiaoling 105.3 705
706 This command is used to set up scheduled domain name resolution.
707
708 (% style="color:blue" %)**AT command:**
709
710 * (% style="color:#037691" %)**AT+DNSTIMER=XX   **(%%)~/~/ Unit: hour
711
712 After setting this command, domain name resolution will be performed regularly.
713
714
Xiaoling 83.10 715 = 3. Configure D2x-NB =
Edwin Chen 1.1 716
kai 16.4 717 == 3.1 Configure Methods ==
Edwin Chen 1.1 718
719
Xiaoling 83.10 720 D2x-NB supports below configure method:
Edwin Chen 1.1 721
722 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
Xiaoling 80.6 723
Edwin Chen 11.1 724 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
Xiaoling 80.6 725
Xiaoling 82.8 726 == 3.2 AT Commands Set ==
Edwin Chen 1.1 727
728
Xiaoling 82.8 729 AT+<CMD>?        : Help on <CMD>
Edwin Chen 1.1 730
Xiaoling 82.8 731 AT+<CMD>         : Run <CMD>
Edwin Chen 1.1 732
Xiaoling 82.8 733 AT+<CMD>=<value> : Set the value
Edwin Chen 1.1 734
Xiaoling 82.8 735 AT+<CMD>=?       : Get the value
Edwin Chen 1.1 736
737
Xiaoling 82.10 738 (% style="color:blue" %)**General Commands**      
Edwin Chen 1.1 739
Xiaoling 82.8 740 AT                    : Attention       
Edwin Chen 1.1 741
Xiaoling 82.9 742 AT?  : Short Help     
Edwin Chen 1.1 743
Xiaoling 82.9 744 ATZ  : MCU Reset    
Edwin Chen 1.1 745
Mengting Qiu 95.1 746 AT+TDC  : Get or set the application data transmission interval in s
Edwin Chen 1.1 747
Xiaoling 82.9 748 AT+CFG  : Print all configurations
Edwin Chen 1.1 749
Xiaoling 82.8 750 AT+CFGMOD           : Working mode selection
Edwin Chen 1.1 751
Xiaoling 82.9 752 AT+DEUI  : Get or set the Device ID
Edwin Chen 1.1 753
Mengting Qiu 95.1 754 AT+FDR  : Reset Parameters to Factory Default
Edwin Chen 1.1 755
Mengting Qiu 95.1 756 AT+INTMOD            : Get or Set the trigger
Edwin Chen 1.1 757
Mengting Qiu 95.1 758 AT+5VT           : Get or Set extend the time of 5V power  
Edwin Chen 1.1 759
Mengting Qiu 95.1 760 AT+PRO          : Get or Set usage agreement (1:COAP,2:UDP,3:MQTT,4:TCP)
Edwin Chen 1.1 761
Mengting Qiu 95.1 762 AT+APN  : Get or set the APN
Edwin Chen 1.1 763
Mengting Qiu 95.1 764 AT+EXT  : Get or Set Count value
Edwin Chen 1.1 765
Mengting Qiu 95.1 766 AT+TR  : Get or set SHT record time
Edwin Chen 1.1 767
Mengting Qiu 95.1 768 AT+RXDL  : Get or Set the receiving time
Edwin Chen 1.1 769
Mengting Qiu 95.1 770 AT+DNSCFG  : Get or Set DNS Server
Edwin Chen 1.1 771
Mengting Qiu 95.1 772 AT+CSQTIME : Get or Set the time to join the network
Edwin Chen 1.1 773
Mengting Qiu 95.1 774 AT+DNSTIMER : Get or Set the NDS timer
Xiaoling 82.9 775
Mengting Qiu 95.1 776 AT+LDATA  : Get the last upload data
777
778 AT+GETSENSORVALUE  : Returns the current sensor measurement
779
780 AT+NOUD : Get or Set the number of SHT data to be uploaded
781
782 AT+CDP  : Read or Clear cached data
783
784 ATAT+TEMPALARM1  :Get or Set alarm of temp1
785
786 ATAT+TEMPALARM2  :Get or Set alarm of temp2
787
788 ATAT+TEMPALARM3  :Get or Set alarm of temp3
789
790 AT+TLSMOD  : Get or Set the TLS mode
791
792 AT+SERVADDR  :  Server Address
793
794
Xiaoling 82.10 795 (% style="color:blue" %)**MQTT Management**
Edwin Chen 1.1 796
Xiaoling 82.8 797 AT+CLIENT               : Get or Set MQTT client
Edwin Chen 1.1 798
Xiaoling 82.8 799 AT+UNAME              : Get or Set MQTT Username
Edwin Chen 1.1 800
Xiaoling 82.8 801 AT+PWD                  : Get or Set MQTT password
Edwin Chen 1.1 802
Xiaoling 82.9 803 AT+PUBTOPIC  : Get or Set MQTT publish topic
Edwin Chen 1.1 804
Xiaoling 82.9 805 AT+SUBTOPIC  : Get or Set MQTT subscription topic
Edwin Chen 1.1 806
807
Xiaoling 82.10 808 (% style="color:blue" %)**Information**          
Edwin Chen 1.1 809
Xiaoling 82.9 810 AT+FDR  : Factory Data Reset
Edwin Chen 1.1 811
Xiaoling 82.9 812 AT+PWORD  : Serial Access Password
Edwin Chen 1.1 813
Xiaoling 82.9 814 AT+LDATA  : Get the last upload data
Xiaoling 39.6 815
Xiaoling 82.9 816 AT+CDP  : Read or Clear cached data
Edwin Chen 1.1 817
Xiaoling 82.9 818
kai 16.4 819 = 4. Battery & Power Consumption =
Xiaoling 14.45 820
Edwin Chen 1.1 821
Xiaoling 83.10 822 D2x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
Edwin Chen 1.1 823
824 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
825
826
Xiaoling 82.11 827 = 5. Firmware update =
Edwin Chen 1.1 828
829
Xiaoling 82.11 830 User can change device firmware to::
Edwin Chen 1.1 831
Edwin Chen 13.1 832 * Update with new features.
Xiaoling 82.11 833
Edwin Chen 13.1 834 * Fix bugs.
Edwin Chen 1.1 835
Xiaoling 82.37 836 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/rl01j9r0ecspjml/AAACvqfplgTfL_E_Nv-PImMVa?dl=0]]**
Edwin Chen 1.1 837
kai 31.1 838 Methods to Update Firmware:
Edwin Chen 1.1 839
Xiaoling 82.12 840 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
Xiaoling 82.14 841
Mengting Qiu 97.1 842 * Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.
Edwin Chen 1.1 843
kai 31.1 844 = 6. FAQ =
Edwin Chen 1.1 845
Xiaoling 82.15 846 == 6.1 How can I access t BC660K-GL AT Commands? ==
Edwin Chen 1.1 847
848
Xiaoling 82.15 849 User can access to BC660K-GL directly and send AT Commands.
Edwin Chen 1.1 850
Xiaoling 82.15 851 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
Edwin Chen 1.1 852
853
Mengting Qiu 107.1 854
855 == 6.2 How to configure the certificate? ==
856
857
858 User can can refer to this [[description>>url:http://wiki.dragino.com/xwiki/bin/view/How%20to%20configure%20the%20certificate%3F/]] to configure the certificate.
859
860
Xiaoling 82.15 861 = 7. Order Info =
Edwin Chen 1.1 862
863
Xiaoling 83.2 864 Part Number: (% style="color:blue" %)**D20-NB-XX  / D20S-NB**(%%)** (designed for used in Soil or Road)/(% style="color:blue" %)D22-NB-XX / D23-NB-XX(%%)**
Edwin Chen 1.1 865
Xiaoling 82.15 866 (% style="color:red" %)**XX**(%%):
Edwin Chen 1.1 867
Xiaoling 82.15 868 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
Edwin Chen 1.1 869
Xiaoling 82.15 870 * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
Edwin Chen 1.1 871
Xiaoling 82.31 872 (% style="color:#037691" %)**1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
Edwin Chen 1.1 873
874
kai 31.1 875 = 8. ​Packing Info =
Edwin Chen 1.1 876
Xiaoling 39.6 877
Ellie Zhang 39.1 878 (% style="color:#037691" %)**Package Includes**:
Edwin Chen 1.1 879
Xiaoling 82.40 880 * D2x-NB NB-IoT Temperature Sensor x 1
Edwin Chen 1.1 881
Xiaoling 82.16 882 * External antenna x 1
883
Ellie Zhang 39.1 884 (% style="color:#037691" %)**Dimension and weight**:
Edwin Chen 1.1 885
Xiaoling 82.40 886 * Device Size: cm
Edwin Chen 1.1 887
Xiaoling 82.40 888 * Device Weight: g
Edwin Chen 1.1 889
Xiaoling 82.40 890 * Package Size / pcs : cm
Edwin Chen 1.1 891
Xiaoling 82.40 892 * Weight / pcs : g
Edwin Chen 1.1 893
kai 31.1 894 = 9. Support =
Edwin Chen 1.1 895
896
kai 31.1 897 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
Xiaoling 39.6 898
899 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].
Xiaoling 75.2 900
Xiaoling 80.9 901 (% style="display:none" %) (%%)
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0