Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual
Last modified by Bei Jinggeng on 2024/05/31 09:53
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.David - Content
-
... ... @@ -16,6 +16,7 @@ 16 16 17 17 = 1. Introduction = 18 18 19 + 19 19 == 1.1 What is NDDS75 Distance Detection Sensor == 20 20 21 21 ((( ... ... @@ -56,6 +56,7 @@ 56 56 57 57 == 1.2 Features == 58 58 60 + 59 59 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 60 60 * Ultra low power consumption 61 61 * Distance Detection by Ultrasonic technology ... ... @@ -69,6 +69,7 @@ 69 69 * Micro SIM card slot for NB-IoT SIM 70 70 * 8500mAh Battery for long term use 71 71 74 + 72 72 == 1.3 Specification == 73 73 74 74 ... ... @@ -99,8 +99,10 @@ 99 99 * STOP Mode: 10uA @ 3.3v 100 100 * Max transmit power: 350mA@3.3v 101 101 105 + 102 102 == 1.4 Applications == 103 103 108 + 104 104 * Smart Buildings & Home Automation 105 105 * Logistics and Supply Chain Management 106 106 * Smart Metering ... ... @@ -112,6 +112,8 @@ 112 112 113 113 114 114 120 + 121 + 115 115 == 1.5 Pin Definitions == 116 116 117 117 ... ... @@ -121,8 +121,10 @@ 121 121 122 122 = 2. Use NDDS75 to communicate with IoT Server = 123 123 131 + 124 124 == 2.1 How it works == 125 125 134 + 126 126 ((( 127 127 The NDDS75 is equipped with a NB-IoT module, the pre-loaded firmware in NDDS75 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 NDDS75. 128 128 ))) ... ... @@ -148,6 +148,7 @@ 148 148 149 149 === 2.2.1 Test Requirement === 150 150 160 + 151 151 ((( 152 152 To use NDDS75 in your city, make sure meet below requirements: 153 153 ))) ... ... @@ -157,7 +157,7 @@ 157 157 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 158 158 159 159 ((( 160 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NDDS75 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server 170 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NDDS75 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server. 161 161 ))) 162 162 163 163 ... ... @@ -167,6 +167,7 @@ 167 167 168 168 === 2.2.2 Insert SIM card === 169 169 180 + 170 170 ((( 171 171 Insert the NB-IoT Card get from your provider. 172 172 ))) ... ... @@ -182,6 +182,7 @@ 182 182 183 183 === 2.2.3 Connect USB – TTL to NDDS75 to configure it === 184 184 196 + 185 185 ((( 186 186 ((( 187 187 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. ... ... @@ -190,6 +190,7 @@ 190 190 191 191 [[image:image-20220709092052-2.png]] 192 192 205 + 193 193 **Connection:** 194 194 195 195 (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND ... ... @@ -213,8 +213,9 @@ 213 213 214 214 [[image:1657329814315-101.png]] 215 215 229 + 216 216 ((( 217 -(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[https:~~/~~/www.dr agino.com/downloads/index.php?dir=NB-IoT/NDDS75/>>url:https://www.dragino.com/downloads/index.php?dir=NB-IoT/NDDS75/]]231 +(% style="color:red" %)**Note: the valid AT Commands can be found at: **(%%)**[[https:~~/~~/www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0>>https://www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0]]** 218 218 ))) 219 219 220 220 ... ... @@ -221,9 +221,10 @@ 221 221 222 222 === 2.2.4 Use CoAP protocol to uplink data === 223 223 224 -(% 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/]] 225 225 239 +(% 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/]]** 226 226 241 + 227 227 ((( 228 228 **Use below commands:** 229 229 ))) ... ... @@ -236,6 +236,9 @@ 236 236 ))) 237 237 * ((( 238 238 (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path 254 + 255 + 256 + 239 239 ))) 240 240 241 241 ((( ... ... @@ -245,6 +245,7 @@ 245 245 [[image:1657330452568-615.png]] 246 246 247 247 266 + 248 248 ((( 249 249 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. 250 250 ))) ... ... @@ -305,22 +305,25 @@ 305 305 306 306 === 2.2.8 Change Update Interval === 307 307 327 + 308 308 User can use below command to change the (% style="color:green" %)**uplink interval**. 309 309 310 310 * (% style="color:blue" %)**AT+TDC=600 ** (%%)~/~/ Set Update Interval to 600s 311 311 312 312 ((( 313 -(% style="color:red" %)**NOTE:** 314 -))) 333 +(% style="color:red" %)**NOTE: By default, the device will send an uplink message every 1 hour.** 315 315 316 -((( 317 -(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour. 335 + 318 318 ))) 319 319 338 +**NOTE:When the firmware version is v1.3.2 and later firmware:** 320 320 340 +**By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).** 321 321 342 + 322 322 == 2.3 Uplink Payload == 323 323 345 + 324 324 In this mode, uplink payload includes in total 14 bytes 325 325 326 326 ... ... @@ -337,6 +337,7 @@ 337 337 338 338 [[image:1657331036973-987.png]] 339 339 362 + 340 340 ((( 341 341 The payload is ASCII string, representative same HEX: 342 342 ))) ... ... @@ -364,16 +364,43 @@ 364 364 * ((( 365 365 Interrupt: 0x00 = 0 366 366 367 - 368 - 369 369 370 370 ))) 371 371 393 +**NOTE:When the firmware version is v1.3.2 and later firmware:** 394 + 395 +In this mode, uplink payload includes 69 bytes in total by default. 396 + 397 +Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded. 398 + 399 +|**Size(bytes)**|**8**|2|2|1|1|1|2|4|2|4 400 +|**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Distance|Timestamp|Distance|Timestamp....... 401 + 402 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NDDS75 uplink data. 403 + 404 +[[image:image-20220908175246-1.png]] 405 + 406 +The payload is ASCII string, representative same HEX: 407 + 408 +0x(% style="color:red" %)f867787050213317(% style="color:blue" %)0084(% style="color:green" %)0cf4(% style="color:red" %)1e(% style="color:blue" %)01(% style="color:green" %)00(% style="color:red" %)**//00396319bb32//**00396319baf0//**00396319ba3c**//00396319b988//**00396319b8d4**//00396319b820//**00396319b76c**//00396319b6b8//**00396319b604**//(%%) where: 409 + 410 +* (% style="color:green" %)Device ID: f867787050213317 = f867787050213317 411 +* (% style="color:red" %)Version: 0x0084=132=1.3.2 412 +* (% style="color:green" %)BAT: 0x0cf4 = 3316 mV = 3.316V 413 +* (% style="color:blue" %)Singal: 0x1e = 30 414 +* (% style="color:red" %)Mod: 0x01 = 1 415 +* Interrupt: 0x00= 0 416 +* Distance: 0x0039= 57 = 57 417 +* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>url:http://www.epochconverter.com/]]) 418 +* Distance,Time stamp : 00396319baf0 419 +* (% style="color:red" %) 8 sets of recorded data: Distance,Time stamp : //**00396319ba3c**//,....... 420 + 372 372 == 2.4 Payload Explanation and Sensor Interface == 373 373 374 374 375 375 === 2.4.1 Device ID === 376 376 426 + 377 377 ((( 378 378 By default, the Device ID equal to the last 6 bytes of IMEI. 379 379 ))) ... ... @@ -380,6 +380,8 @@ 380 380 381 381 ((( 382 382 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID 433 + 434 + 383 383 ))) 384 384 385 385 ((( ... ... @@ -395,9 +395,19 @@ 395 395 ))) 396 396 397 397 450 +**NOTE:When the firmware version is v1.3.2 and later firmware:** 398 398 452 +By default, the Device ID equal to the last 15 bits of IMEI. 453 + 454 +User can use **AT+DEUI** to set Device ID 455 + 456 +**Example:** 457 + 458 +AT+DEUI=868411056754138 459 + 399 399 === 2.4.2 Version Info === 400 400 462 + 401 401 ((( 402 402 Specify the software version: 0x64=100, means firmware version 1.00. 403 403 ))) ... ... @@ -410,6 +410,7 @@ 410 410 411 411 === 2.4.3 Battery Info === 412 412 475 + 413 413 ((( 414 414 Ex1: 0x0B45 = 2885mV 415 415 ))) ... ... @@ -422,6 +422,7 @@ 422 422 423 423 === 2.4.4 Signal Strength === 424 424 488 + 425 425 ((( 426 426 NB-IoT Network signal Strength. 427 427 ))) ... ... @@ -454,6 +454,7 @@ 454 454 455 455 === 2.4.5 Distance === 456 456 521 + 457 457 Get the distance. Flat object range 280mm - 7500mm. 458 458 459 459 ((( ... ... @@ -476,6 +476,7 @@ 476 476 477 477 === 2.4.6 Digital Interrupt === 478 478 544 + 479 479 ((( 480 480 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. 481 481 ))) ... ... @@ -510,6 +510,7 @@ 510 510 511 511 === 2.4.7 +5V Output === 512 512 579 + 513 513 ((( 514 514 NDDS75 will enable +5V output before all sampling and disable the +5v after all sampling. 515 515 ))) ... ... @@ -517,10 +517,14 @@ 517 517 518 518 ((( 519 519 The 5V output time can be controlled by AT Command. 587 + 588 + 520 520 ))) 521 521 522 522 ((( 523 523 (% style="color:blue" %)**AT+5VT=1000** 593 + 594 + 524 524 ))) 525 525 526 526 ((( ... ... @@ -531,6 +531,7 @@ 531 531 532 532 == 2.5 Downlink Payload == 533 533 605 + 534 534 By default, NDDS75 prints the downlink payload to console port. 535 535 536 536 [[image:image-20220709100028-1.png]] ... ... @@ -580,10 +580,44 @@ 580 580 ))) 581 581 582 582 655 +== 2.6 Distance alarm function == 583 583 584 - ==2.6LED Indicator ==657 +➢ AT Command: 585 585 659 +AT+ LDDSALARM=min,max 586 586 661 +² When min=0, and max≠0, Alarm higher than max 662 + 663 +² When min≠0, and max=0, Alarm lower than min 664 + 665 +² When min≠0 and max≠0, Alarm higher than max or lower than min 666 + 667 +Example: 668 + 669 +AT+ LDDSALARM=260,2000 ~/~/ Alarm when distance lower than 260. 670 + 671 + 672 +== 2.7 Set the number of data to be uploaded and the recording time == 673 + 674 +➢ AT Command: 675 + 676 +AT+TR=900 ~/~/The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) 677 + 678 +AT+NOUD=8 ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 679 + 680 +== 2.8 Read or Clear cached data == 681 + 682 +➢ AT Command: 683 + 684 +AT+CDP ~/~/ Read cached data 685 + 686 +[[image:image-20220908175333-2.png]] 687 + 688 +AT+CDP=0 ~/~/ Clear cached data 689 + 690 +== 2.9 LED Indicator == 691 + 692 + 587 587 The NDDS75 has an internal LED which is to show the status of different state. 588 588 589 589 ... ... @@ -598,29 +598,29 @@ 598 598 599 599 600 600 601 -== 2. 7Firmware Change Log ==707 +== 2.10 Firmware Change Log == 602 602 603 603 604 604 ((( 605 -Download URL & Firmware Change log 711 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/3hb94r49iszmstx/AADvSJcXxahEUfxqKWVnZx-La?dl=0>>https://www.dropbox.com/sh/3hb94r49iszmstx/AADvSJcXxahEUfxqKWVnZx-La?dl=0]] 606 606 ))) 607 607 608 608 ((( 609 - [[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/]]715 + 610 610 ))) 611 611 612 - 613 613 ((( 614 -Upgrade Instruction: [[Upgrade _Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]719 +Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 615 615 ))) 616 616 617 617 618 618 619 -== 2. 8Battery Analysis ==724 +== 2.11 Battery Analysis == 620 620 621 -=== 2.8.1 Battery Type === 622 622 727 +=== 2.11.1 Battery Type === 623 623 729 + 624 624 ((( 625 625 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. 626 626 ))) ... ... @@ -643,8 +643,9 @@ 643 643 644 644 645 645 646 -=== 2. 8.2 Power consumption Analyze ===752 +=== 2.11.2 Power consumption Analyze === 647 647 754 + 648 648 ((( 649 649 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. 650 650 ))) ... ... @@ -681,8 +681,9 @@ 681 681 682 682 683 683 684 -=== 2. 8.3 Battery Note ===791 +=== 2.11.3 Battery Note === 685 685 793 + 686 686 ((( 687 687 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. 688 688 ))) ... ... @@ -689,8 +689,9 @@ 689 689 690 690 691 691 692 -=== 2. 8.4 Replace the battery ===800 +=== 2.11.4 Replace the battery === 693 693 802 + 694 694 ((( 695 695 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). 696 696 ))) ... ... @@ -699,6 +699,7 @@ 699 699 700 700 = 3. Access NB-IoT Module = 701 701 811 + 702 702 ((( 703 703 Users can directly access the AT command set of the NB-IoT module. 704 704 ))) ... ... @@ -705,6 +705,8 @@ 705 705 706 706 ((( 707 707 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/]] 818 + 819 + 708 708 ))) 709 709 710 710 [[image:1657333200519-600.png]] ... ... @@ -713,11 +713,13 @@ 713 713 714 714 = 4. Using the AT Commands = 715 715 828 + 716 716 == 4.1 Access AT Commands == 717 717 718 -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/]] 719 719 832 +See this link for detail: [[https:~~/~~/www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0>>https://www.dropbox.com/sh/aaq2xcl0bzfu0yd/AAAEAHRa7Io_465ds4Y7-F3aa?dl=0]] 720 720 834 + 721 721 AT+<CMD>? : Help on <CMD> 722 722 723 723 AT+<CMD> : Run <CMD> ... ... @@ -757,7 +757,23 @@ 757 757 758 758 AT+SERVADDR : Server Address 759 759 874 +AT+TR : Get or Set record time" 760 760 876 +AT+APN : Get or set the APN 877 + 878 +AT+FBAND : Get or Set whether to automatically modify the frequency band 879 + 880 +AT+DNSCFG : Get or Set DNS Server 881 + 882 +AT+GETSENSORVALUE : Returns the current sensor measurement 883 + 884 +AT+NOUD : Get or Set the number of data to be uploaded 885 + 886 +AT+CDP : Read or Clear cached data 887 + 888 +AT+LDDSALARM : Get or Set alarm of distance 889 + 890 + 761 761 (% style="color:#037691" %)**COAP Management** 762 762 763 763 AT+URI : Resource parameters ... ... @@ -791,6 +791,7 @@ 791 791 792 792 = 5. FAQ = 793 793 924 + 794 794 == 5.1 How to Upgrade Firmware == 795 795 796 796 ... ... @@ -803,7 +803,7 @@ 803 803 ))) 804 804 805 805 ((( 806 -(% style="color:red" %)Notice, NDDS75 and LDDS75 share the same mother board. They use the same connection and method to update. 937 +(% style="color:red" %)**Notice, NDDS75 and LDDS75 share the same mother board. They use the same connection and method to update.** 807 807 ))) 808 808 809 809 ... ... @@ -810,6 +810,7 @@ 810 810 811 811 = 6. Trouble Shooting = 812 812 944 + 813 813 == 6.1 Connection problem when uploading firmware == 814 814 815 815 ... ... @@ -825,6 +825,7 @@ 825 825 826 826 == 6.2 AT Command input doesn't work == 827 827 960 + 828 828 ((( 829 829 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. 830 830 ... ... @@ -857,6 +857,7 @@ 857 857 ((( 858 858 859 859 993 + 860 860 (% style="color:#037691" %)**Dimension and weight**: 861 861 862 862 * Device Size: 13.0 x 5 x 4.5 cm ... ... @@ -874,5 +874,6 @@ 874 874 875 875 = 9. Support = 876 876 1011 + 877 877 * 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. 878 878 * 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]]
- image-20220908175246-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.7 KB - Content
- image-20220908175333-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +31.1 KB - Content