Version 115.1 by Xiaoling on 2022/07/09 16:17

Hide last authors
Xiaoling 74.2 1 (% style="text-align:center" %)
Xiaoling 99.2 2 [[image:1657348034241-728.png||height="470" width="470"]]
Xiaoling 1.1 3
4
5
Xiaoling 35.25 6
7
Xiaoling 99.2 8
9
Xiaoling 35.4 10 **Table of Contents:**
Xiaoling 1.1 11
12
13
14
15
Xiaoling 31.17 16
Xiaoling 44.2 17 = 1.  Introduction =
Xiaoling 1.1 18
Xiaoling 99.2 19 == 1.1 ​ What is N95S31B NB-IoT Sensor Node ==
Xiaoling 1.1 20
Xiaoling 12.2 21 (((
Xiaoling 35.4 22
23
Xiaoling 99.2 24 The Dragino N95S31B is a (% style="color:blue" %)**NB-IoT Temperature and Humidity Sensor**(%%) for Internet of Things solution. It is used to measure the (% style="color:blue" %)**surrounding environment temperature and relative air humidity precisely**(%%), and then upload to IoT server via NB-IoT network*.
Xiaoling 97.13 25
Xiaoling 99.2 26 The temperature & humidity sensor used in N95S31B is SHT31, which is fully calibrated, linearized, and temperature compensated digital output from Sensirion, it provides a strong reliability and long-term stability. The SHT31 is fixed in a (% style="color:blue" %)**waterproof anti-condensation casing **(%%)for long term use.
Xiaoling 97.13 27
Xiaoling 99.2 28 N95S31B supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP and CoAP**(%%) for different application requirement.
Xiaoling 97.13 29
Xiaoling 99.2 30 N95S31B is powered by(% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to several years. (Real-world battery life depends on the use environment, update period. Please check related Power Analyze report).
Xiaoling 97.13 31
32
Xiaoling 99.2 33 ~* make sure you have NB-IoT coverage locally.
Xiaoling 4.2 34
Xiaoling 42.2 35
Xiaoling 12.2 36 )))
Xiaoling 4.2 37
Xiaoling 99.2 38 [[image:1657348284168-431.png]]
Xiaoling 4.2 39
40
41
Xiaoling 65.3 42 == 1.2 ​ Features ==
Xiaoling 13.3 43
Xiaoling 100.2 44
Xiaoling 44.2 45 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
Xiaoling 100.2 46 * Monitor Temperature & Humidity via SHT31
Xiaoling 4.2 47 * AT Commands to change parameters
48 * Uplink on periodically
49 * Downlink to change configure
50 * IP66 Waterproof Enclosure
Xiaoling 100.2 51 * Ultra-Low Power consumption
52 * AT Commands to change parameters
Xiaoling 44.2 53 * Micro SIM card slot for NB-IoT SIM
54 * 8500mAh Battery for long term use
Xiaoling 4.2 55
Xiaoling 100.2 56
Xiaoling 44.2 57 == 1.3  Specification ==
58
59
60 (% style="color:#037691" %)**Common DC Characteristics:**
61
62 * Supply Voltage: 2.1v ~~ 3.6v
63 * Operating Temperature: -40 ~~ 85°C
64
65 (% style="color:#037691" %)**NB-IoT Spec:**
66
67 * - B1 @H-FDD: 2100MHz
68 * - B3 @H-FDD: 1800MHz
69 * - B8 @H-FDD: 900MHz
70 * - B5 @H-FDD: 850MHz
71 * - B20 @H-FDD: 800MHz
72 * - B28 @H-FDD: 700MHz
73
Xiaoling 75.3 74 (% style="color:#037691" %)**Battery:**
Xiaoling 4.2 75
Xiaoling 100.2 76
Xiaoling 75.3 77 * Li/SOCI2 un-chargeable battery
78 * Capacity: 8500mAh
79 * Self Discharge: <1% / Year @ 25°C
80 * Max continuously current: 130mA
81 * Max boost current: 2A, 1 second
Xiaoling 14.2 82
Xiaoling 4.2 83
Xiaoling 44.2 84 == ​1.4  Applications ==
Xiaoling 4.2 85
Xiaoling 75.4 86 * Smart Buildings & Home Automation
87 * Logistics and Supply Chain Management
88 * Smart Metering
Xiaoling 4.2 89 * Smart Agriculture
Xiaoling 75.4 90 * Smart Cities
91 * Smart Factory
Xiaoling 4.2 92
Xiaoling 15.6 93 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %)
94
Xiaoling 4.2 95
Xiaoling 75.4 96
Xiaoling 44.2 97 == 1.5  Pin Definitions ==
Xiaoling 15.6 98
Xiaoling 100.2 99 N95S31B use the mother board from NBSN95 which as below.
Xiaoling 15.6 100
Xiaoling 100.2 101 [[image:image-20220709144723-1.png]]
Xiaoling 4.2 102
Xiaoling 14.3 103
Xiaoling 100.2 104 === 1.5.1 Jumper JP2 ===
Xiaoling 14.3 105
Xiaoling 100.2 106 Power on Device when put this jumper.
Xiaoling 14.3 107
Xiaoling 100.2 108
109
110 === 1.5.2 BOOT MODE / SW1 ===
111
112 1) 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.
113
114 2) Flash: work mode, device starts to work and send out console output for further debug
115
116
117
118 === 1.5.3 Reset Button ===
119
120 Press to reboot the device.
121
122
123
124 === 1.5.4 LED ===
125
126 It will flash:
127
128 1. When boot the device in flash mode
129 1. Send an uplink packet
130
131
132
133 = 2.  Use N95S31B to communicate with IoT Server =
134
Xiaoling 45.2 135 == 2.1  How it works ==
Xiaoling 14.3 136
Xiaoling 100.3 137
Xiaoling 15.3 138 (((
Xiaoling 100.3 139 The N95S31B is equipped with a NB-IoT module, the pre-loaded firmware in N95S31B 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 N95S31B.
Xiaoling 15.3 140 )))
Xiaoling 4.2 141
Xiaoling 45.2 142
Xiaoling 15.3 143 (((
Xiaoling 100.3 144 The diagram below shows the working flow in default firmware of N95S31B:
Xiaoling 15.3 145 )))
Xiaoling 4.2 146
Xiaoling 77.2 147 (((
148
149 )))
Xiaoling 4.2 150
Xiaoling 102.2 151 [[image:1657350248151-650.png]]
Xiaoling 77.2 152
Xiaoling 45.2 153 (((
154
155 )))
Xiaoling 4.2 156
Xiaoling 45.2 157
Xiaoling 102.2 158 == 2.2 ​ Configure the N95S31B ==
Xiaoling 4.2 159
Xiaoling 48.2 160
Xiaoling 102.2 161 === 2.2.1  Power On N95S31B ===
162
163
164 [[image:image-20220709150546-2.png]]
165
Xiaoling 102.3 166
Xiaoling 45.4 167 === 2.2.1 Test Requirement ===
Xiaoling 4.2 168
169
Xiaoling 102.3 170 To use N95S31B in your city, make sure meet below requirements:
171
Xiaoling 45.4 172 * Your local operator has already distributed a NB-IoT Network there.
Xiaoling 102.3 173 * The local NB-IoT network used the band that N95S31B supports.
Xiaoling 45.4 174 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
Xiaoling 4.2 175
Xiaoling 102.3 176 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.
177
178 N95S31B supports different communication protocol such as :
179
Xiaoling 48.2 180 (((
Xiaoling 102.3 181 * CoAP  ((% style="color:red" %)120.24.4.116:5683(%%))
182 * raw UDP  ((% style="color:red" %)120.24.4.116:5601(%%))
183 * MQTT  ((% style="color:red" %)120.24.4.116:1883(%%))
184 * TCP  ((% style="color:red" %)120.24.4.116:5600(%%))
185
186 We will show how to use with each protocol. The IP addresses above are our test server. User need to change to point their corresponding server.
187
188
189 )))
190
Xiaoling 103.2 191 [[image:1657350625843-586.png]]
Xiaoling 4.2 192
193
194
Xiaoling 104.2 195 === 2.2.3  Insert SIM card ===
Xiaoling 4.2 196
Xiaoling 65.11 197 (((
Xiaoling 45.4 198 Insert the NB-IoT Card get from your provider.
Xiaoling 65.11 199 )))
Xiaoling 4.2 200
Xiaoling 65.11 201 (((
Xiaoling 45.4 202 User need to take out the NB-IoT module and insert the SIM card like below:
Xiaoling 65.11 203 )))
Xiaoling 4.2 204
205
Xiaoling 104.2 206 [[image:1657351240556-536.png]]
Xiaoling 4.2 207
208
Xiaoling 48.2 209
Xiaoling 107.2 210 === 2.2.4  Connect USB – TTL to N95S31B to configure it ===
Xiaoling 4.2 211
Xiaoling 48.2 212 (((
213 (((
Xiaoling 105.2 214 User need to configure N95S31B via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. N95S31B support AT Commands, user can use a USB to TTL adapter to connect to N95S31B and use AT Commands to configure it, as below.
Xiaoling 48.2 215 )))
216 )))
Xiaoling 19.2 217
Xiaoling 105.2 218 [[image:1657351312545-300.png]]
Xiaoling 4.2 219
Xiaoling 48.2 220 **Connection:**
Xiaoling 4.2 221
Xiaoling 45.6 222 (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
Xiaoling 4.2 223
Xiaoling 45.6 224 (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
Xiaoling 4.2 225
Xiaoling 45.6 226 (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
Xiaoling 4.2 227
228
Xiaoling 45.4 229 In the PC, use below serial tool settings:
230
Xiaoling 57.4 231 * Baud:  (% style="color:green" %)**9600**
Xiaoling 48.2 232 * Data bits:** (% style="color:green" %)8(%%)**
233 * Stop bits: (% style="color:green" %)**1**
Xiaoling 57.4 234 * Parity:  (% style="color:green" %)**None**
Xiaoling 48.2 235 * Flow Control: (% style="color:green" %)**None**
Xiaoling 45.4 236
Xiaoling 48.2 237 (((
Xiaoling 105.2 238 Make sure the switch is in FLASH position, then power on device by connecting the jumper on N95S31B. N95S31B will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
Xiaoling 48.2 239 )))
Xiaoling 45.4 240
Xiaoling 81.2 241 [[image:1657329814315-101.png]]
Xiaoling 45.4 242
Xiaoling 65.12 243 (((
Xiaoling 105.2 244 (% style="color:red" %)Note: the valid AT Commands can be found at:  (%%)[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/N95S31B/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/N95S31B/]]
Xiaoling 65.12 245 )))
Xiaoling 45.4 246
247
248
Xiaoling 107.2 249 === 2.2.5  Use CoAP protocol to uplink data ===
Xiaoling 45.4 250
Xiaoling 56.2 251 (% style="color:red" %)Note: if you don't have CoAP server, you can refer this link to set up one: (%%)[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
Xiaoling 45.4 252
253
Xiaoling 97.9 254 (((
Xiaoling 50.2 255 **Use below commands:**
Xiaoling 97.9 256 )))
Xiaoling 45.4 257
Xiaoling 97.9 258 * (((
259 (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
260 )))
261 * (((
262 (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
263 )))
264 * (((
265 (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
266 )))
Xiaoling 45.4 267
Xiaoling 97.9 268 (((
Xiaoling 107.2 269
270
Xiaoling 45.4 271 For parameter description, please refer to AT command set
Xiaoling 97.9 272 )))
Xiaoling 45.4 273
Xiaoling 107.2 274 [[image:1657352146020-183.png]]
Xiaoling 45.4 275
276
Xiaoling 97.10 277 (((
Xiaoling 86.2 278 After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NDDS75 will start to uplink sensor values to CoAP server.
Xiaoling 97.10 279 )))
Xiaoling 45.4 280
Xiaoling 107.2 281 [[image:1657352185396-303.png]]
Xiaoling 45.4 282
283
Xiaoling 50.2 284
Xiaoling 107.2 285 === 2.2.6  Use UDP protocol to uplink data(Default protocol) ===
Xiaoling 45.4 286
287
Xiaoling 97.5 288 * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
Xiaoling 48.2 289 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
Xiaoling 97.5 290 * (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/ If the server does not respond, this command is unnecessary
Xiaoling 45.4 291
Xiaoling 111.2 292 [[image:1657352391268-297.png]]
Xiaoling 45.4 293
294
Xiaoling 111.2 295 [[image:1657352403317-397.png]]
Xiaoling 45.4 296
Xiaoling 52.3 297
Xiaoling 86.2 298
Xiaoling 111.2 299 === 2.2.7  Use MQTT protocol to uplink data ===
Xiaoling 45.4 300
Xiaoling 113.2 301 N95S31B supports only plain MQTT now it doesn't support TLS and other related encryption.
Xiaoling 45.4 302
Xiaoling 97.11 303 * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
304 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
305 * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
Xiaoling 97.13 306 * (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/Set the username of MQTT
307 * (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/Set the password of MQTT
Xiaoling 114.2 308 * (% style="color:blue" %)**AT+PUBTOPIC=f9527                               **(%%)~/~/Set the sending topic of MQTT
309 * (% style="color:blue" %)**AT+SUBTOPIC=Ns9527          **(%%) ~/~/Set the subscription topic of MQTT
Xiaoling 45.4 310
Xiaoling 111.2 311 [[image:1657352634421-276.png]]
Xiaoling 45.4 312
Xiaoling 54.2 313
Xiaoling 111.2 314 [[image:1657352645687-385.png]]
Xiaoling 54.2 315
Xiaoling 111.2 316 (((
317 To save battery life, N95S31B will establish a subscription before each uplink and close the subscription 3 seconds after uplink successful. Any downlink commands from server will only arrive during the subscription period.
318 )))
Xiaoling 45.4 319
Xiaoling 111.2 320
Xiaoling 54.3 321 (((
Xiaoling 111.2 322 MQTT protocol has a much high-power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
Xiaoling 54.3 323 )))
Xiaoling 45.4 324
325
Xiaoling 54.3 326
Xiaoling 113.2 327 === 2.2.8  Use TCP protocol to uplink data ===
Xiaoling 45.4 328
Xiaoling 113.2 329 This feature is supported since firmware version v110
Xiaoling 45.4 330
Xiaoling 56.2 331 * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
Xiaoling 48.2 332 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
Xiaoling 45.4 333
Xiaoling 113.2 334 [[image:1657352898400-901.png]]
Xiaoling 45.4 335
336
Xiaoling 113.2 337 [[image:1657352914475-252.png]]
Xiaoling 45.4 338
Xiaoling 57.6 339
Xiaoling 89.2 340
Xiaoling 113.2 341 === 2.2.9  Change Update Interval ===
Xiaoling 45.4 342
Xiaoling 48.2 343 User can use below command to change the (% style="color:green" %)**uplink interval**.
Xiaoling 45.4 344
Xiaoling 56.3 345 * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
Xiaoling 45.4 346
Xiaoling 56.3 347 (((
Xiaoling 113.2 348
Xiaoling 56.3 349 )))
Xiaoling 45.4 350
351
352
Xiaoling 57.2 353 == 2.3  Uplink Payload ==
Xiaoling 4.2 354
Xiaoling 32.9 355
Xiaoling 114.2 356 NBSN95 has different working mode for the connections of different type of sensors. This section describes these modes. User can use the AT Command (% style="color:blue" %)**AT+MOD**(%%) to set NBSN95 to different working modes.
Xiaoling 90.2 357
Xiaoling 114.2 358
359 For example:
360
361 (% style="color:blue" %)**AT+CFGMOD=2 ** (%%)~/~/will set the NBSN95 to work in MOD=2 distance mode which target to measure distance via Ultrasonic Sensor.
362
363
364 The uplink payloads are composed in  ASCII String. For example:
365
366 0a cd 00 ed 0a cc 00 00 ef 02 d2 1d (total 24 ASCII Chars) . Representative the actually payload:
367
368 0x 0a cd 00 ed 0a cc 00 00 ef 02 d2 1d Total 12 bytes
369
370
371 (% style="color:red" %)**NOTE:**
372
373 (% style="color:red" %)
374 1. All modes share the same Payload Explanation from [[HERE>>path:#Payload_Explain]].
375 1. By default, the device will send an uplink message every 1 hour.
376
377
378
379
380 === 2.3.1  Payload Analyze ===
381
382 N95S31B uplink payload includes in total 21 bytes
383
384
Xiaoling 97.16 385 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:440px" %)
Xiaoling 97.12 386 |=(% style="width: 60px;" %)(((
Xiaoling 57.2 387 **Size(bytes)**
Xiaoling 114.2 388 )))|=(% style="width: 60px;" %)**6**|=(% style="width: 35px;" %)2|=(% style="width: 35px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 80px;" %) |=(% style="width: 99px;" %) |=(% style="width: 77px;" %)**2**|=(% style="width: 60px;" %)**1**
389 |(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:123px" %)MOD 0X01|(% style="width:99px" %)(((
390 Reserve/ Same as NBSN95 CFGMOD=1
Xiaoling 57.2 391
Xiaoling 114.2 392 No function here.
393 )))|(% style="width:77px" %)(((
394 [[Temperature >>||anchor="H2.4.5A0Distance"]]
395
396 By SHT31
397 )))|(% style="width:80px" %)(((
398 [[Humidity>>||anchor="H2.4.6A0DigitalInterrupt"]]
399
400 By SHT31
401 )))
402
Xiaoling 65.13 403 (((
Xiaoling 114.2 404 (((
405 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
Xiaoling 65.13 406 )))
Xiaoling 114.2 407 )))
Xiaoling 57.2 408
409
Xiaoling 114.2 410 [[image:1657354294009-643.png]]
Xiaoling 57.2 411
Xiaoling 90.2 412 (((
Xiaoling 57.2 413 The payload is ASCII string, representative same HEX:
Xiaoling 90.2 414 )))
Xiaoling 57.2 415
Xiaoling 90.2 416 (((
417 0x72403155615900640c6c19029200 where:
418 )))
Xiaoling 57.2 419
Xiaoling 90.2 420 * (((
421 Device ID: 0x724031556159 = 724031556159
422 )))
423 * (((
424 Version: 0x0064=100=1.0.0
425 )))
Xiaoling 57.2 426
Xiaoling 90.2 427 * (((
428 BAT: 0x0c6c = 3180 mV = 3.180V
429 )))
430 * (((
431 Signal: 0x19 = 25
432 )))
433 * (((
434 Distance: 0x0292= 658 mm
435 )))
436 * (((
437 Interrupt: 0x00 = 0
Xiaoling 95.5 438
439
440
441
Xiaoling 90.2 442 )))
Xiaoling 57.2 443
Xiaoling 57.3 444 == 2.4  Payload Explanation and Sensor Interface ==
Xiaoling 4.2 445
Xiaoling 57.7 446
Xiaoling 57.5 447 === 2.4.1  Device ID ===
Xiaoling 4.2 448
Xiaoling 65.13 449 (((
Xiaoling 57.3 450 By default, the Device ID equal to the last 6 bytes of IMEI.
Xiaoling 65.13 451 )))
Xiaoling 4.2 452
Xiaoling 65.13 453 (((
Xiaoling 57.4 454 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
Xiaoling 65.13 455 )))
Xiaoling 4.2 456
Xiaoling 65.13 457 (((
Xiaoling 57.3 458 **Example:**
Xiaoling 65.13 459 )))
Xiaoling 4.2 460
Xiaoling 65.13 461 (((
Xiaoling 57.3 462 AT+DEUI=A84041F15612
Xiaoling 65.13 463 )))
Xiaoling 4.2 464
Xiaoling 65.13 465 (((
Xiaoling 91.1 466 The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
Xiaoling 65.13 467 )))
Xiaoling 22.2 468
Xiaoling 4.2 469
470
Xiaoling 57.5 471 === 2.4.2  Version Info ===
472
Xiaoling 65.13 473 (((
Xiaoling 57.3 474 Specify the software version: 0x64=100, means firmware version 1.00.
Xiaoling 65.13 475 )))
Xiaoling 4.2 476
Xiaoling 65.13 477 (((
Xiaoling 91.1 478 For example: 0x00 64 : this device is NDDS75 with firmware version 1.0.0.
Xiaoling 65.13 479 )))
Xiaoling 4.2 480
481
Xiaoling 57.3 482
Xiaoling 57.5 483 === 2.4.3  Battery Info ===
Xiaoling 22.2 484
Xiaoling 32.10 485 (((
Xiaoling 4.2 486 Ex1: 0x0B45 = 2885mV
Xiaoling 32.10 487 )))
Xiaoling 4.2 488
Xiaoling 32.10 489 (((
Xiaoling 4.2 490 Ex2: 0x0B49 = 2889mV
Xiaoling 32.10 491 )))
Xiaoling 4.2 492
493
494
Xiaoling 57.6 495 === 2.4.4  Signal Strength ===
Xiaoling 4.2 496
Xiaoling 65.13 497 (((
Xiaoling 57.6 498 NB-IoT Network signal Strength.
Xiaoling 65.13 499 )))
Xiaoling 57.6 500
Xiaoling 65.13 501 (((
Xiaoling 57.6 502 **Ex1: 0x1d = 29**
Xiaoling 65.13 503 )))
Xiaoling 57.6 504
Xiaoling 65.13 505 (((
Xiaoling 57.6 506 (% style="color:blue" %)**0**(%%)  -113dBm or less
Xiaoling 65.13 507 )))
Xiaoling 57.6 508
Xiaoling 65.13 509 (((
Xiaoling 57.6 510 (% style="color:blue" %)**1**(%%)  -111dBm
Xiaoling 65.13 511 )))
Xiaoling 57.6 512
Xiaoling 65.13 513 (((
Xiaoling 57.6 514 (% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm
Xiaoling 65.13 515 )))
Xiaoling 57.6 516
Xiaoling 65.13 517 (((
Xiaoling 57.6 518 (% style="color:blue" %)**31**  (%%) -51dBm or greater
Xiaoling 65.13 519 )))
Xiaoling 57.6 520
Xiaoling 65.13 521 (((
Xiaoling 57.6 522 (% style="color:blue" %)**99**   (%%) Not known or not detectable
Xiaoling 65.13 523 )))
Xiaoling 57.6 524
525
526
Xiaoling 95.4 527 === 2.4.5  Distance ===
Xiaoling 57.6 528
Xiaoling 91.1 529 Get the distance. Flat object range 280mm - 7500mm.
Xiaoling 4.2 530
Xiaoling 97.17 531 (((
Xiaoling 91.1 532 For example, if the data you get from the register is **__0x0B 0x05__**, the distance between the sensor and the measured object is
Xiaoling 97.17 533 )))
Xiaoling 4.2 534
Xiaoling 32.10 535 (((
536 (((
Xiaoling 91.4 537 (% style="color:blue" %)** 0B05(H) = 2821(D) = 2821mm.**
Xiaoling 32.10 538 )))
Xiaoling 32.11 539 )))
Xiaoling 4.2 540
Xiaoling 32.11 541 (((
Xiaoling 23.2 542
543 )))
Xiaoling 4.2 544
Xiaoling 23.2 545 (((
546
547 )))
548
Xiaoling 91.1 549 === 2.4.6  Digital Interrupt ===
Xiaoling 23.2 550
Xiaoling 65.15 551 (((
Xiaoling 91.1 552 Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NDDS75 will send a packet to the server.
Xiaoling 65.15 553 )))
Xiaoling 4.2 554
Xiaoling 65.15 555 (((
Xiaoling 57.6 556 The command is:
Xiaoling 65.15 557 )))
Xiaoling 4.2 558
Xiaoling 65.15 559 (((
Xiaoling 57.8 560 (% style="color:blue" %)**AT+INTMOD=3 **(%%) ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**
Xiaoling 65.15 561 )))
Xiaoling 4.2 562
563
Xiaoling 65.15 564 (((
Xiaoling 65.6 565 The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up.
Xiaoling 65.15 566 )))
Xiaoling 4.2 567
568
Xiaoling 65.15 569 (((
Xiaoling 57.6 570 Example:
Xiaoling 65.15 571 )))
Xiaoling 4.2 572
Xiaoling 65.15 573 (((
Xiaoling 57.6 574 0x(00): Normal uplink packet.
Xiaoling 65.15 575 )))
Xiaoling 4.2 576
Xiaoling 65.15 577 (((
Xiaoling 57.6 578 0x(01): Interrupt Uplink Packet.
Xiaoling 65.15 579 )))
Xiaoling 23.2 580
Xiaoling 4.2 581
582
Xiaoling 91.1 583 === 2.4.7  ​+5V Output ===
Xiaoling 4.2 584
Xiaoling 65.16 585 (((
Xiaoling 91.1 586 NDDS75 will enable +5V output before all sampling and disable the +5v after all sampling. 
Xiaoling 65.16 587 )))
Xiaoling 4.2 588
Xiaoling 57.6 589
Xiaoling 65.16 590 (((
Xiaoling 57.6 591 The 5V output time can be controlled by AT Command.
Xiaoling 65.16 592 )))
Xiaoling 57.6 593
Xiaoling 65.16 594 (((
Xiaoling 57.7 595 (% style="color:blue" %)**AT+5VT=1000**
Xiaoling 65.16 596 )))
Xiaoling 57.6 597
Xiaoling 65.16 598 (((
Xiaoling 57.6 599 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
Xiaoling 65.16 600 )))
Xiaoling 57.6 601
602
603
Xiaoling 58.2 604 == 2.5  Downlink Payload ==
Xiaoling 4.2 605
Xiaoling 92.2 606 By default, NDDS75 prints the downlink payload to console port.
Xiaoling 4.2 607
Xiaoling 92.2 608 [[image:image-20220709100028-1.png]]
Xiaoling 4.2 609
610
Xiaoling 32.14 611 (((
Xiaoling 40.4 612 (% style="color:blue" %)**Examples:**
Xiaoling 32.14 613 )))
Xiaoling 4.2 614
Xiaoling 32.14 615 (((
616
617 )))
Xiaoling 4.2 618
Xiaoling 32.14 619 * (((
Xiaoling 40.4 620 (% style="color:blue" %)**Set TDC**
Xiaoling 32.14 621 )))
Xiaoling 4.2 622
Xiaoling 32.14 623 (((
Xiaoling 60.2 624 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
Xiaoling 32.14 625 )))
Xiaoling 4.2 626
Xiaoling 32.14 627 (((
Xiaoling 4.2 628 Payload:    01 00 00 1E    TDC=30S
Xiaoling 32.14 629 )))
Xiaoling 4.2 630
Xiaoling 32.14 631 (((
Xiaoling 4.2 632 Payload:    01 00 00 3C    TDC=60S
Xiaoling 32.14 633 )))
Xiaoling 4.2 634
Xiaoling 32.14 635 (((
636
637 )))
Xiaoling 4.2 638
Xiaoling 32.14 639 * (((
Xiaoling 40.4 640 (% style="color:blue" %)**Reset**
Xiaoling 32.14 641 )))
Xiaoling 4.2 642
Xiaoling 32.14 643 (((
Xiaoling 92.2 644 If payload = 0x04FF, it will reset the NDDS75
Xiaoling 32.14 645 )))
Xiaoling 4.2 646
647
Xiaoling 60.2 648 * (% style="color:blue" %)**INTMOD**
Xiaoling 4.2 649
Xiaoling 65.17 650 (((
Xiaoling 60.2 651 Downlink Payload: 06000003, Set AT+INTMOD=3
Xiaoling 65.17 652 )))
Xiaoling 4.2 653
654
Xiaoling 26.2 655
Xiaoling 60.2 656 == 2.6  ​LED Indicator ==
Xiaoling 26.2 657
Xiaoling 4.2 658
Xiaoling 92.2 659 The NDDS75 has an internal LED which is to show the status of different state.
Xiaoling 4.2 660
Xiaoling 92.2 661
662 * When power on, NDDS75 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
Xiaoling 60.2 663 * Then the LED will be on for 1 second means device is boot normally.
Xiaoling 92.2 664 * After NDDS75 join NB-IoT network. The LED will be ON for 3 seconds.
Xiaoling 60.2 665 * For each uplink probe, LED will be on for 500ms.
Xiaoling 92.2 666
667 (((
668
Xiaoling 32.15 669 )))
Xiaoling 4.2 670
671
672
Xiaoling 92.3 673 == 2.7  ​Firmware Change Log ==
Xiaoling 4.2 674
675
Xiaoling 97.18 676 (((
Xiaoling 92.3 677 Download URL & Firmware Change log
Xiaoling 97.18 678 )))
Xiaoling 4.2 679
Xiaoling 60.2 680 (((
Xiaoling 92.3 681 [[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/Firmware/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/Firmware/]]
Xiaoling 60.2 682 )))
Xiaoling 4.2 683
684
Xiaoling 97.18 685 (((
Xiaoling 65.6 686 Upgrade Instruction: [[Upgrade_Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
Xiaoling 97.18 687 )))
Xiaoling 28.5 688
Xiaoling 4.2 689
690
Xiaoling 95.2 691 == 2.8  ​Battery Analysis ==
Xiaoling 4.2 692
Xiaoling 95.2 693 === 2.8.1  ​Battery Type ===
Xiaoling 4.2 694
695
Xiaoling 65.18 696 (((
Xiaoling 95.2 697 The NDDS75 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
Xiaoling 65.18 698 )))
Xiaoling 4.2 699
Xiaoling 65.18 700 (((
Xiaoling 62.3 701 The battery is designed to last for several years depends on the actually use environment and update interval. 
Xiaoling 65.18 702 )))
Xiaoling 4.2 703
Xiaoling 65.18 704 (((
Xiaoling 60.2 705 The battery related documents as below:
Xiaoling 65.18 706 )))
Xiaoling 4.2 707
Xiaoling 60.2 708 * [[Battery Dimension>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
Xiaoling 65.7 709 * [[Lithium-Thionyl Chloride Battery datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
Xiaoling 60.2 710 * [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
Xiaoling 4.2 711
Xiaoling 29.2 712 (((
Xiaoling 95.2 713 [[image:image-20220709101450-2.png]]
Xiaoling 29.2 714 )))
Xiaoling 4.2 715
716
Xiaoling 35.18 717
Xiaoling 95.2 718 === 2.8.2  Power consumption Analyze ===
Xiaoling 4.2 719
Xiaoling 62.3 720 (((
Xiaoling 60.2 721 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
Xiaoling 62.3 722 )))
Xiaoling 4.2 723
724
Xiaoling 62.3 725 (((
Xiaoling 60.2 726 Instruction to use as below:
Xiaoling 62.3 727 )))
Xiaoling 4.2 728
Xiaoling 62.3 729 (((
730 (% style="color:blue" %)**Step 1:  **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
731 )))
Xiaoling 4.2 732
733
Xiaoling 62.3 734 (((
735 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
736 )))
Xiaoling 4.2 737
Xiaoling 62.3 738 * (((
739 Product Model
740 )))
741 * (((
742 Uplink Interval
743 )))
744 * (((
745 Working Mode
746 )))
Xiaoling 4.2 747
Xiaoling 62.3 748 (((
Xiaoling 60.2 749 And the Life expectation in difference case will be shown on the right.
Xiaoling 62.3 750 )))
Xiaoling 4.2 751
Xiaoling 96.2 752 [[image:image-20220709110451-3.png]]
Xiaoling 4.2 753
754
Xiaoling 62.2 755
Xiaoling 95.2 756 === 2.8.3  ​Battery Note ===
Xiaoling 4.2 757
Xiaoling 31.6 758 (((
Xiaoling 4.2 759 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
Xiaoling 31.3 760 )))
Xiaoling 4.2 761
762
763
Xiaoling 95.2 764 === 2.8.4  Replace the battery ===
Xiaoling 31.2 765
Xiaoling 62.2 766 (((
Xiaoling 95.2 767 The default battery pack of NDDS75 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
Xiaoling 62.2 768 )))
Xiaoling 4.2 769
770
771
Xiaoling 63.2 772 = 3. ​ Access NB-IoT Module =
Xiaoling 4.2 773
Xiaoling 63.2 774 (((
775 Users can directly access the AT command set of the NB-IoT module.
776 )))
777
778 (((
Xiaoling 64.2 779 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 
Xiaoling 63.2 780 )))
781
Xiaoling 95.2 782 [[image:1657333200519-600.png]]
Xiaoling 63.2 783
784
785
Xiaoling 64.2 786 = 4.  Using the AT Commands =
Xiaoling 63.2 787
Xiaoling 64.2 788 == 4.1  Access AT Commands ==
Xiaoling 9.2 789
Xiaoling 95.2 790 See this link for detail: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
Xiaoling 11.4 791
Xiaoling 4.2 792
Xiaoling 64.2 793 AT+<CMD>?  : Help on <CMD>
Xiaoling 4.2 794
Xiaoling 64.2 795 AT+<CMD>         : Run <CMD>
Xiaoling 4.2 796
Xiaoling 64.2 797 AT+<CMD>=<value> : Set the value
Xiaoling 4.2 798
Xiaoling 64.2 799 AT+<CMD>=?  : Get the value
Xiaoling 4.2 800
801
Xiaoling 11.6 802 (% style="color:#037691" %)**General Commands**(%%)      
Xiaoling 4.2 803
Xiaoling 64.2 804 AT  : Attention       
Xiaoling 4.2 805
Xiaoling 64.2 806 AT?  : Short Help     
Xiaoling 4.2 807
Xiaoling 64.2 808 ATZ  : MCU Reset    
Xiaoling 4.2 809
Xiaoling 64.2 810 AT+TDC  : Application Data Transmission Interval
Xiaoling 4.2 811
Xiaoling 64.2 812 AT+CFG  : Print all configurations
Xiaoling 4.2 813
Xiaoling 64.2 814 AT+CFGMOD           : Working mode selection
Xiaoling 4.2 815
Xiaoling 64.2 816 AT+INTMOD            : Set the trigger interrupt mode
Xiaoling 4.2 817
Xiaoling 64.2 818 AT+5VT  : Set extend the time of 5V power  
Xiaoling 4.2 819
Xiaoling 64.2 820 AT+PRO  : Choose agreement
Xiaoling 4.2 821
Xiaoling 64.2 822 AT+WEIGRE  : Get weight or set weight to 0
Xiaoling 4.2 823
Xiaoling 64.2 824 AT+WEIGAP  : Get or Set the GapValue of weight
Xiaoling 4.2 825
Xiaoling 64.2 826 AT+RXDL  : Extend the sending and receiving time
Xiaoling 4.2 827
Xiaoling 64.2 828 AT+CNTFAC  : Get or set counting parameters
Xiaoling 4.2 829
Xiaoling 64.2 830 AT+SERVADDR  : Server Address
Xiaoling 4.2 831
832
Xiaoling 64.2 833 (% style="color:#037691" %)**COAP Management**      
Xiaoling 4.2 834
Xiaoling 64.2 835 AT+URI            : Resource parameters
Xiaoling 4.2 836
837
Xiaoling 64.2 838 (% style="color:#037691" %)**UDP Management**
Xiaoling 4.2 839
Xiaoling 64.2 840 AT+CFM          : Upload confirmation mode (only valid for UDP)
Xiaoling 4.2 841
842
Xiaoling 64.2 843 (% style="color:#037691" %)**MQTT Management**
Xiaoling 4.2 844
Xiaoling 64.2 845 AT+CLIENT               : Get or Set MQTT client
Xiaoling 4.2 846
Xiaoling 64.2 847 AT+UNAME  : Get or Set MQTT Username
Xiaoling 4.2 848
Xiaoling 64.2 849 AT+PWD                  : Get or Set MQTT password
Xiaoling 4.2 850
Xiaoling 64.2 851 AT+PUBTOPIC  : Get or Set MQTT publish topic
Xiaoling 4.2 852
Xiaoling 64.2 853 AT+SUBTOPIC  : Get or Set MQTT subscription topic
Xiaoling 4.2 854
855
Xiaoling 64.2 856 (% style="color:#037691" %)**Information**          
Xiaoling 4.2 857
Xiaoling 64.2 858 AT+FDR  : Factory Data Reset
Xiaoling 4.2 859
Xiaoling 64.2 860 AT+PWORD  : Serial Access Password
Xiaoling 4.2 861
862
863
Xiaoling 64.4 864 = ​5.  FAQ =
Xiaoling 4.2 865
Xiaoling 64.4 866 == 5.1 ​ How to Upgrade Firmware ==
Xiaoling 6.3 867
Xiaoling 4.2 868
Xiaoling 31.35 869 (((
Xiaoling 64.4 870 User can upgrade the firmware for 1) bug fix, 2) new feature release.
Xiaoling 31.35 871 )))
Xiaoling 4.2 872
Xiaoling 31.35 873 (((
Xiaoling 64.4 874 Please see this link for how to upgrade:  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
Xiaoling 31.35 875 )))
Xiaoling 4.2 876
Xiaoling 31.35 877 (((
Xiaoling 95.2 878 (% style="color:red" %)Notice, NDDS75 and LDDS75 share the same mother board. They use the same connection and method to update.
Xiaoling 31.35 879 )))
Xiaoling 4.2 880
881
882
Xiaoling 64.5 883 = 6.  Trouble Shooting =
Xiaoling 4.2 884
Xiaoling 64.5 885 == 6.1  ​Connection problem when uploading firmware ==
Xiaoling 4.9 886
Xiaoling 4.2 887
Xiaoling 65.20 888 (((
889 **Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
890 )))
891
Xiaoling 64.5 892 (% class="wikigeneratedid" %)
Xiaoling 31.29 893 (((
Xiaoling 65.20 894
Xiaoling 31.29 895 )))
Xiaoling 4.2 896
897
Xiaoling 64.5 898 == 6.2  AT Command input doesn't work ==
Xiaoling 4.2 899
Xiaoling 31.30 900 (((
Xiaoling 64.5 901 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
Xiaoling 65.22 902
Xiaoling 65.23 903
Xiaoling 31.30 904 )))
Xiaoling 4.2 905
906
Xiaoling 64.5 907 = 7. ​ Order Info =
Xiaoling 4.2 908
909
Xiaoling 95.3 910 Part Number**:** (% style="color:#4f81bd" %)**NSDDS75**
Xiaoling 4.7 911
Xiaoling 4.2 912
Xiaoling 31.10 913 (% class="wikigeneratedid" %)
914 (((
915
916 )))
917
Xiaoling 65.2 918 = 8.  Packing Info =
Xiaoling 4.2 919
Xiaoling 4.3 920 (((
Xiaoling 31.39 921
922
Xiaoling 31.40 923 (% style="color:#037691" %)**Package Includes**:
Xiaoling 64.5 924
Xiaoling 95.3 925 * NSE01 NB-IoT Distance Detect Sensor Node x 1
Xiaoling 64.5 926 * External antenna x 1
Xiaoling 4.3 927 )))
Xiaoling 4.2 928
Xiaoling 4.3 929 (((
Xiaoling 31.40 930
931
932 (% style="color:#037691" %)**Dimension and weight**:
Xiaoling 4.2 933
Xiaoling 95.3 934
935 * Device Size: 13.0 x 5 x 4.5 cm
936 * Device Weight: 150g
937 * Package Size / pcs : 15 x 12x 5.5 cm
938 * Weight / pcs : 220g
Xiaoling 4.3 939 )))
Xiaoling 31.11 940
Xiaoling 64.5 941 (((
Xiaoling 31.11 942
Xiaoling 64.5 943
944
945
Xiaoling 4.3 946 )))
Xiaoling 4.2 947
Xiaoling 64.5 948 = 9.  Support =
Xiaoling 4.2 949
950 * 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.
951 * 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.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]