<
From version < 115.2 >
edited by Xiaoling
on 2022/07/09 16:18
To version < 104.2 >
edited by Xiaoling
on 2022/07/09 15:21
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -54,6 +54,7 @@
54 54  * 8500mAh Battery for long term use
55 55  
56 56  
57 +
57 57  == 1.3  Specification ==
58 58  
59 59  
... ... @@ -81,6 +81,7 @@
81 81  * Max boost current: 2A, 1 second
82 82  
83 83  
85 +
84 84  == ​1.4  Applications ==
85 85  
86 86  * Smart Buildings & Home Automation
... ... @@ -130,6 +130,7 @@
130 130  
131 131  
132 132  
135 +
133 133  = 2.  Use N95S31B to communicate with IoT Server =
134 134  
135 135  == 2.1  How it works ==
... ... @@ -173,6 +173,7 @@
173 173  * The local NB-IoT network used the band that N95S31B supports.
174 174  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
175 175  
179 +
176 176  Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.
177 177  
178 178  N95S31B supports different communication protocol such as :
... ... @@ -207,15 +207,15 @@
207 207  
208 208  
209 209  
210 -=== 2.2. Connect USB – TTL to N95S31B to configure it ===
214 +=== 2.2.3 Connect USB – TTL to NDDS75 to configure it ===
211 211  
212 212  (((
213 213  (((
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.
218 +User need to configure NDDS75 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NDDS75 support AT Commands, user can use a USB to TTL adapter to connect to NDDS75 and use AT Commands to configure it, as below.
215 215  )))
216 216  )))
217 217  
218 -[[image:1657351312545-300.png]]
222 +[[image:image-20220709092052-2.png]]
219 219  
220 220  **Connection:**
221 221  
... ... @@ -235,18 +235,18 @@
235 235  * Flow Control: (% style="color:green" %)**None**
236 236  
237 237  (((
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.
242 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NDDS75. NDDS75 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
239 239  )))
240 240  
241 241  [[image:1657329814315-101.png]]
242 242  
243 243  (((
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/]]
248 +(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]]
245 245  )))
246 246  
247 247  
248 248  
249 -=== 2.2. Use CoAP protocol to uplink data ===
253 +=== 2.2.4 Use CoAP protocol to uplink data ===
250 250  
251 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/]]
252 252  
... ... @@ -266,12 +266,10 @@
266 266  )))
267 267  
268 268  (((
269 -
270 -
271 271  For parameter description, please refer to AT command set
272 272  )))
273 273  
274 -[[image:1657352146020-183.png]]
276 +[[image:1657330452568-615.png]]
275 275  
276 276  
277 277  (((
... ... @@ -278,11 +278,11 @@
278 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.
279 279  )))
280 280  
281 -[[image:1657352185396-303.png]]
283 +[[image:1657330472797-498.png]]
282 282  
283 283  
284 284  
285 -=== 2.2. Use UDP protocol to uplink data(Default protocol) ===
287 +=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
286 286  
287 287  
288 288  * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
... ... @@ -289,16 +289,15 @@
289 289  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
290 290  * (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/ If the server does not respond, this command is unnecessary
291 291  
292 -[[image:1657352391268-297.png]]
294 +[[image:1657330501006-241.png]]
293 293  
294 294  
295 -[[image:1657352403317-397.png]]
297 +[[image:1657330533775-472.png]]
296 296  
297 297  
298 298  
299 -=== 2.2. Use MQTT protocol to uplink data ===
301 +=== 2.2.6 Use MQTT protocol to uplink data ===
300 300  
301 -N95S31B supports only plain MQTT now it doesn't support TLS and other related encryption.
302 302  
303 303  * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
304 304  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
... ... @@ -305,40 +305,35 @@
305 305  * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
306 306  * (% style="color:blue" %)**AT+UNAME=UNAME                                **(%%)~/~/Set the username of MQTT
307 307  * (% style="color:blue" %)**AT+PWD=PWD                                         **(%%)~/~/Set the password of MQTT
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
309 +* (% style="color:blue" %)**AT+PUBTOPIC=NDDS75_PUB                 **(%%)~/~/Set the sending topic of MQTT
310 +* (% style="color:blue" %)**AT+SUBTOPIC=NDDS75_SUB          **(%%) ~/~/Set the subscription topic of MQTT
310 310  
311 -[[image:1657352634421-276.png]]
312 +[[image:1657249978444-674.png]]
312 312  
313 313  
314 -[[image:1657352645687-385.png]]
315 +[[image:1657330723006-866.png]]
315 315  
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 -)))
319 319  
320 -
321 321  (((
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.
319 +MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
323 323  )))
324 324  
325 325  
326 326  
327 -=== 2.2. Use TCP protocol to uplink data ===
324 +=== 2.2.7 Use TCP protocol to uplink data ===
328 328  
329 -This feature is supported since firmware version v110
330 330  
331 331  * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
332 332  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
333 333  
334 -[[image:1657352898400-901.png]]
330 +[[image:image-20220709093918-1.png]]
335 335  
336 336  
337 -[[image:1657352914475-252.png]]
333 +[[image:image-20220709093918-2.png]]
338 338  
339 339  
340 340  
341 -=== 2.2. Change Update Interval ===
337 +=== 2.2.8 Change Update Interval ===
342 342  
343 343  User can use below command to change the (% style="color:green" %)**uplink interval**.
344 344  
... ... @@ -345,93 +345,69 @@
345 345  * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
346 346  
347 347  (((
348 -
344 +(% style="color:red" %)**NOTE:**
349 349  )))
350 350  
347 +(((
348 +(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour.
349 +)))
351 351  
352 352  
352 +
353 353  == 2.3  Uplink Payload ==
354 354  
355 +In this mode, uplink payload includes in total 14 bytes
355 355  
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.
357 357  
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 -
385 385  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:440px" %)
386 386  |=(% style="width: 60px;" %)(((
387 387  **Size(bytes)**
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
361 +)))|=(% style="width: 60px;" %)**6**|=(% style="width: 35px;" %)2|=(% style="width: 35px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 100px;" %)**2**|=(% style="width: 60px;" %)**1**
362 +|(% 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:120px" %)[[Distance (unit: mm)>>||anchor="H2.4.5A0Distance"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.6A0DigitalInterrupt"]]
391 391  
392 -No function here.
393 -)))|(% style="width:77px" %)(((
394 -[[Temperature >>||anchor="H2.4.5A0Distance"]]
364 +(((
365 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS751 uplink data.
366 +)))
395 395  
396 -By SHT31
397 -)))|(% style="width:80px" %)(((
398 -[[Humidity>>||anchor="H2.4.6A0DigitalInterrupt"]]
399 399  
400 -By SHT31
369 +[[image:1657331036973-987.png]]
370 +
371 +(((
372 +The payload is ASCII string, representative same HEX:
401 401  )))
402 402  
403 403  (((
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.
376 +0x72403155615900640c6c19029200 where:
406 406  )))
378 +
379 +* (((
380 +Device ID: 0x724031556159 = 724031556159
407 407  )))
382 +* (((
383 +Version: 0x0064=100=1.0.0
384 +)))
408 408  
386 +* (((
387 +BAT: 0x0c6c = 3180 mV = 3.180V
388 +)))
389 +* (((
390 +Signal: 0x19 = 25
391 +)))
392 +* (((
393 +Distance: 0x0292= 658 mm
394 +)))
395 +* (((
396 +Interrupt: 0x00 = 0
409 409  
410 -[[image:1657354294009-643.png]]
411 411  
412 412  
413 -The payload is ASCII string, representative same HEX: 0x724031607457006e0ccd1b0100dc000ccc00e10186 where:
414 -
415 -* Device ID: 0x724031607457 = 724031607457
416 -* Version: 0x006e=110=1.1.0
417 -
418 -* BAT: 0x0ccd = 3277 mV = 3.277V
419 -* Signal: 0x1b = 27
420 -* Model: 0x01 = 1
421 -* 0x00dc000ccc= reserve, ignore in N95S31B
422 -* Temperature by SHT31: 0x00e1 = 225 = 22.5 °C
423 -* Humidity by SHT31: 0x0186 = 390 = 39.0 %rh
424 -
425 -(((
426 426  
427 427  )))
428 428  
429 -(((
430 -
431 -)))
403 +== 2.4  Payload Explanation and Sensor Interface ==
432 432  
433 433  
434 -=== 2.3.2  Device ID ===
406 +=== 2.4.1  Device ID ===
435 435  
436 436  (((
437 437  By default, the Device ID equal to the last 6 bytes of IMEI.
... ... @@ -455,25 +455,20 @@
455 455  
456 456  
457 457  
458 -=== 2.3.3  Version Info ===
430 +=== 2.4.2  Version Info ===
459 459  
432 +(((
433 +Specify the software version: 0x64=100, means firmware version 1.00.
434 +)))
460 460  
461 -These bytes include the hardware and software version.
462 -
463 -Higher byte: Specify hardware version: always 0x00 for N95S31B
464 -
465 -Lower byte: Specify the software version: 0x6E=110, means firmware version 110
466 -
467 -
468 -For example: 0x00 6E: this device is N95S31B with firmware version 110.
469 -
470 470  (((
471 -
437 +For example: 0x00 64 : this device is NDDS75 with firmware version 1.0.0.
472 472  )))
473 473  
474 474  
475 -=== 2.3.4  Battery Info ===
476 476  
442 +=== 2.4.3  Battery Info ===
443 +
477 477  (((
478 478  Ex1: 0x0B45 = 2885mV
479 479  )))
... ... @@ -484,7 +484,7 @@
484 484  
485 485  
486 486  
487 -=== 2.3.5  Signal Strength ===
454 +=== 2.4.4  Signal Strength ===
488 488  
489 489  (((
490 490  NB-IoT Network signal Strength.
... ... @@ -516,24 +516,83 @@
516 516  
517 517  
518 518  
519 -=== 2.3.6  Temperature & Humidity ===
486 +=== 2.4.5  Distance ===
520 520  
521 -The device will be able to get the SHT31 temperature and humidity data now and upload to IoT Server.
488 +Get the distance. Flat object range 280mm - 7500mm.
522 522  
523 -[[image:image-20220709161741-3.png]]
490 +(((
491 +For example, if the data you get from the register is **__0x0B 0x05__**, the distance between the sensor and the measured object is
492 +)))
524 524  
494 +(((
495 +(((
496 +(% style="color:blue" %)** 0B05(H) = 2821(D) = 2821mm.**
497 +)))
498 +)))
525 525  
526 -Convert the read byte to decimal and divide it by ten.
500 +(((
501 +
502 +)))
527 527  
504 +(((
505 +
506 +)))
528 528  
529 -**Example:**
508 +=== 2.4.6  Digital Interrupt ===
530 530  
531 -Temperature:  Read:00ec (H) = 236(D)  Value:  236 /10=23.6℃
510 +(((
511 +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.
512 +)))
532 532  
533 -Humidity:    Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
514 +(((
515 +The command is:
516 +)))
534 534  
518 +(((
519 +(% 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]])**.**
520 +)))
535 535  
536 536  
523 +(((
524 +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.
525 +)))
526 +
527 +
528 +(((
529 +Example:
530 +)))
531 +
532 +(((
533 +0x(00): Normal uplink packet.
534 +)))
535 +
536 +(((
537 +0x(01): Interrupt Uplink Packet.
538 +)))
539 +
540 +
541 +
542 +=== 2.4.7  ​+5V Output ===
543 +
544 +(((
545 +NDDS75 will enable +5V output before all sampling and disable the +5v after all sampling. 
546 +)))
547 +
548 +
549 +(((
550 +The 5V output time can be controlled by AT Command.
551 +)))
552 +
553 +(((
554 +(% style="color:blue" %)**AT+5VT=1000**
555 +)))
556 +
557 +(((
558 +Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
559 +)))
560 +
561 +
562 +
537 537  == 2.5  Downlink Payload ==
538 538  
539 539  By default, NDDS75 prints the downlink payload to console port.
1657351312545-300.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -675.8 KB
Content
1657352146020-183.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -264.0 KB
Content
1657352185396-303.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -98.3 KB
Content
1657352391268-297.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -238.0 KB
Content
1657352403317-397.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -547.7 KB
Content
1657352634421-276.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -163.6 KB
Content
1657352645687-385.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -214.7 KB
Content
1657352898400-901.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -144.8 KB
Content
1657352914475-252.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -157.0 KB
Content
1657354294009-643.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -214.7 KB
Content
image-20220709161741-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -111.2 KB
Content
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0