Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 173.1
edited by Mengting Qiu
on 2023/12/12 14:47
on 2023/12/12 14:47
Change comment:
There is no comment for this version
To version 157.1
edited by Mengting Qiu
on 2023/12/09 17:15
on 2023/12/09 17:15
Change comment:
Uploaded new attachment "image-20231209171549-4.png", version {1}
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 7 removed)
Details
- Page properties
-
- Content
-
... ... @@ -49,6 +49,7 @@ 49 49 50 50 == 1.3 Specification == 51 51 52 + 52 52 (% style="color:#037691" %)**LiDAR Sensor:** 53 53 54 54 * Operation Temperature: -40 ~~ 80 °C ... ... @@ -64,7 +64,7 @@ 64 64 65 65 (% style="color:#037691" %)**Battery Power Mode:** 66 66 67 -* Idle: 3 uA @ 3.3v68 +* Idle: 0.003 mA @ 3.3v 68 68 * Max : 360 mA 69 69 70 70 (% style="color:#037691" %)**Continuously mode**: ... ... @@ -72,21 +72,6 @@ 72 72 * Idle: 21 mA @ 3.3v 73 73 * Max : 360 mA 74 74 75 -== 1.5 Use Case == 76 - 77 -(% class="mark" %)**Regular Distance Detect** 78 - 79 -[[image:image-20231211220922-1.png||height="352" width="605"]] 80 - 81 - 82 -(% class="mark" %)**Counting / Alarm** 83 - 84 -[[image:image-20231211221253-2.png]] 85 - 86 - 87 -[[image:image-20231211221436-3.png]] 88 - 89 - 90 90 = 2. Configure DS20L to connect to LoRaWAN network = 91 91 92 92 == 2.1 How it works == ... ... @@ -126,16 +126,12 @@ 126 126 127 127 128 128 129 -=== Step 2: Activate DS20L === 115 +=== Step 2: Activate on DS20L === 130 130 131 131 [[image:image-20231128133704-1.png||height="189" width="441"]] 132 132 133 133 Press the button for 5 seconds to activate the DS20L. 134 134 135 -The switch is switched to (% style="color:blue" %)**E** (%%)and the external power supply is used. 136 - 137 -The switch is switched to (% style="color:blue" %)**I** (%%)and DS20L will be power by the built-in battery. 138 - 139 139 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 140 140 141 141 After join success, it will start to upload messages to TTN and you can see the messages in the panel. ... ... @@ -215,31 +215,16 @@ 215 215 === 2.3.2 Uplink Payload, FPORT~=2 === 216 216 217 217 218 -==== (% style="color:red" %)** AT+MOD~=1**(%%) ====200 +==== (% style="color:red" %)**MOD~=1**(%%) ==== 219 219 220 220 Regularly detect distance and report. When the distance exceeds the limit, the alarm flag is set to 1, and the report can be triggered by external interrupts. 221 221 222 - **Uplink Payload totals 10 bytes.**204 +Uplink Payload totals 10 bytes. 223 223 224 224 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 225 -|(% style="background-color:#4f81bd; color: White; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:White; width:30px" %)**2**|(% style="background-color:#4f81bd; color:White; width:130px" %)**1**|(% style="background-color:#4f81bd; color:White; width:70px" %)**2**|(% style="background-color:#4f81bd; color:White; width:100px" %)**1**|(% style="background-color:#4f81bd; color:White; width:120px" %)**4**226 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+ 207 +|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:120px" %)**4** 208 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count 227 227 228 -**MOD+ Alarm+ Interrupt:** 229 - 230 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:400px" %) 231 -|(% style="background-color:#4f81bd; color:White; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:White; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:White; width:70px" %)**bit5**|(% style="background-color:#4f81bd; color:White; width:120px" %)**bit4** 232 -|(% style="width:80px" %)Value|(% style="width:80px" %)MOD|(% style="width:89px" %)Digital Interrupt 233 - |(% style="width:167px" %)((( 234 -Distance Alarm 235 - 236 -0: No Alarm; 237 - 238 -1: Alarm 239 -))) 240 - 241 -Example parse in TTNv3 242 - 243 243 [[image:image-20231209152917-1.png||height="300" width="1172"]] 244 244 245 245 (% style="color:blue" %)**Battery Info:** ... ... @@ -276,174 +276,27 @@ 276 276 277 277 (% style="color:blue" %)**Sensor State:** 278 278 279 -Ex1: 0x00: DistanceReadingisvalid246 +Ex1: 0x00: Normal collection distance 280 280 281 -Ex2 :0x0x: DistanceReadingisinvalid248 +Ex2 0x0x: Distance collection is wrong 282 282 283 283 284 -(% style="color:blue" %)**Interr upt Count:**251 +(% style="color:blue" %)**Interript Count:** 285 285 286 286 If payload is:000007D0H: count = 07D0H =2000 287 287 288 288 289 289 290 -==== (% style="color:red" %)** AT+MOD~=2**(%%)** ** ====257 +==== (% style="color:red" %)**MOD~=2**(%%)** ** ==== 291 291 259 +Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes. 292 292 293 -The power consumption of uninterrupted measurement is high, and the device needs to use external power supply.(The switch is switched to E and the external power supply is used.) 294 - 295 -[[image:image-20231128133704-1.png||height="189" width="441"]] 296 - 297 - 298 -* **Set over-limit alarm mode: AT+DOL=3,500,244,**(% style="color:red" %)0(%%)**,120** 299 - 300 -(% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %) 301 -Continuously measurement with Alarm. When the distance exceeds the limit, the output IO high, instant alarm. 302 - 303 -(% class="wikigeneratedid" %) 304 -**Uplink Payload totals 9 bytes.** 305 - 306 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 307 -|(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2** 308 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:74px" %)Distance |(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 309 - 310 -**MOD+DO+ Alarm+ Do flag+ Limit flag:** 311 - 312 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 313 -|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]** 314 -|(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)((( 315 -((( 316 -DO 317 -))) 318 - 319 -((( 320 -0:Within limit 321 - 322 -1:Out of limit 323 -))) 324 -)))|(% style="width:73px" %)((( 325 -Alarm 326 - 327 -0: No Alarm; 328 - 329 -1: Alarm 330 -)))|(% style="width:150px" %)((( 331 -DO flag 332 - 333 -0:the over-limit alarm mode 334 - 335 -1:the person or object count mode 336 -)))|(% style="width:103px" %)Limit flag 337 -(0~~3) 338 - 339 -Example parse in TTNv3 340 - 341 -[[image:image-20231209171127-3.png||height="374" width="1209"]] 342 - 343 -(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 344 - 345 -(% style="color:red" %)**MOD:** 346 - 347 -**Example: ** (0x60>>6) & 0x3f =1 348 - 349 -**0x01:** Regularly detect distance and report. 350 -**0x02: ** Uninterrupted measurement (external power supply). 351 - 352 -(% style="color:red" %)**Alarm:** 353 - 354 -When the detection distance exceeds the limit, the alarm flag is set to 1. 355 - 356 -(% style="color:red" %)**DO:** 357 - 358 -Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm. 359 - 360 -(% style="color:red" %)**Threshold Flag for Alarm:** 361 - 362 -Mode for setting threshold: **0~~3** 363 - 364 -**0:** Distance limit range is not enabled, alarm:0. 365 - 366 -**1:** Trigger Alarm if distance exceed the range between lower and upper. 367 - 368 -**2:** Trigger Alarm if distance smaller than the upper limit. 369 - 370 -**3: **Trigger Alarm if distance bigger than the lower limit . 371 - 372 - 373 -(% style="color:blue" %)**Distance:** 374 - 375 - Actual sampling distance values. 376 - 377 -**Example:** 378 - 379 -**AT+DOL=1,500,244,**(% style="color:red" %)0(%%)**,120 ** 380 - 381 -The distance is detected every 120ms. 382 - 383 -When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time. 384 - 385 -When the actual detection value is outside the range of [244mm,500mm], the uplink data will be immediately alerted. 386 - 387 -If payload is: 0708H: distance = 0708H = 1800 mm 388 - 389 - 390 -(% style="color:blue" %)**Upper limit:** 391 - 392 -Show the pre-set upper limit in Hex, Unit: mm. 393 - 394 -Ex: 01F4(H)=500mm 395 - 396 - 397 -(% style="color:blue" %)**Lower limit:** 398 - 399 -Show the pre-set lower limit in Hex, Unit: mm. 400 - 401 -Ex: 0xF4(H)=244mm 402 - 403 - 404 -* **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120** 405 - 406 -Continuously measurement with Alarm, detect and count people or things passing by in distance limit mode. 407 - 408 -**Uplink Payload totals 11 bytes.** 409 - 410 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 261 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 411 411 |(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2** 412 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width: 210px" %)MOD+DO+Alarm+O flag+176px" %)Distancelimitalarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit263 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 413 413 414 - **MOD+DO+ Alarm+ Do flag+ Limitflag:**265 +[[image:image-20231209155616-2.png||height="271" width="1262"]] 415 415 416 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 417 -|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]** 418 -|(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)((( 419 -((( 420 -DO 421 -))) 422 - 423 -((( 424 -0:Within limit 425 - 426 -1:Out of limit 427 -))) 428 -)))|(% style="width:73px" %)((( 429 -Alarm 430 - 431 -0: No Alarm; 432 - 433 -1: Alarm 434 -)))|(% style="width:150px" %)((( 435 -DO flag 436 - 437 -0:the over-limit alarm mode 438 - 439 -1:the person or object count mode 440 -)))|(% style="width:103px" %)Limit flag 441 -(0~~3) 442 - 443 -Example parse in TTNv3 444 - 445 -[[image:image-20231209173457-5.png||height="277" width="1098"]] 446 - 447 447 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 448 448 449 449 (% style="color:red" %)**MOD:** ... ... @@ -459,9 +459,9 @@ 459 459 460 460 (% style="color:red" %)**Do:** 461 461 462 - ShowstheDO pinstatus, whilethereisalarmtrigger, TheDO pin will beset tohigh (3.3v), It will beet to0lowlevelwhenthereisnoalarm.282 +When the distance exceeds the set threshold, pull the Do pin high. 463 463 464 -(% style="color:red" %)** ThresholdFlagfor Alarm:**284 +(% style="color:red" %)**Limit flag:** 465 465 466 466 Mode for setting threshold: **0~~3** 467 467 ... ... @@ -474,35 +474,16 @@ 474 474 **3: **Greater than the lower limit 475 475 476 476 477 -(% style="color:blue" %)**Distance limit alarm count:** 478 - 479 -People or objects are collected and counted within a limited distance. 480 - 481 -The detection of a stationary person or object at each sampling time will be repeated three times, and the fourth sampling count will be added by 1. 482 - 483 -**Example:** 484 - 485 -**AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120 ** 486 - 487 -People or objects passing within the distance range of [244mm,500mm] are detected and counted every 120ms. 488 - 489 -If payload is: 0x56H, interrupt count =0x56H =86 490 - 491 - 492 492 (% style="color:blue" %)**Upper limit:** 493 493 494 - Show thepre-setupper limitinHex,Unit:mm.299 +The upper limit of the threshold cannot exceed 2000mm. 495 495 496 -Ex: 01F4(H)=500mm 497 497 498 - 499 499 (% style="color:blue" %)**Lower limit:** 500 500 501 - Show thepre-setlower limitinHex,Unit:mm.304 +The lower limit of the threshold cannot be less than 3mm. 502 502 503 -Ex: 0xF4(H)=244mm 504 504 505 - 506 506 == 2.4 Decode payload in The Things Network == 507 507 508 508 ... ... @@ -524,7 +524,7 @@ 524 524 525 525 526 526 ((( 527 -[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, onh uman-friendlya in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:328 +[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps: 528 528 ))) 529 529 530 530 ... ... @@ -574,6 +574,8 @@ 574 574 575 575 DS20L supports below configure method: 576 576 378 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 379 + 577 577 * 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]]. 578 578 579 579 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. ... ... @@ -595,7 +595,7 @@ 595 595 == 3.3 Commands special design for DS20L == 596 596 597 597 598 - Belowcommands only valid for DS20L, as below:401 +These commands only valid for DS20L, as below: 599 599 600 600 601 601 === 3.3.1 Set Transmit Interval Time === ... ... @@ -719,8 +719,7 @@ 719 719 ))) 720 720 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 721 721 722 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 723 -|=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 155px;background-color:#4F81BD;color:white" %) Parameter 525 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 724 724 |(% rowspan="11" style="color:blue; width:120px" %)((( 725 725 726 726 ... ... @@ -733,12 +733,14 @@ 733 733 734 734 735 735 736 -**AT+DOL= 1,1800,3,0,400**538 +**AT+DOL=5,1800,0,0,400** 737 737 )))|(% rowspan="4" style="width:240px" %)((( 738 738 739 739 740 740 741 741 544 + 545 + 742 742 The first bit sets the limit mode 743 743 )))|(% style="width:150px" %)0: Do not use upper and lower limits 744 744 |(% style="width:251px" %)1: Use upper and lower limits ... ... @@ -764,34 +764,10 @@ 764 764 765 765 * Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 766 766 767 -* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,1800 ,100,0,400571 +* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,1800100,0,400 768 768 769 769 * Example 3: Downlink Payload: 070300000064000190 **~-~-->** AT+MOD=3,0,100,0,400 770 770 771 -(% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.** 772 - 773 -**For example:** 774 - 775 -* **AT+MOD=1** 776 - 777 - **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 778 - 779 -Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1: 780 - 781 -[[image:image-20231211113204-2.png||height="292" width="1093"]] 782 - 783 -* **AT+MOD=2 ** 784 - 785 - **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 786 - 787 -If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1: 788 - 789 -[[image:image-20231211114932-3.png||height="277" width="1248"]] 790 - 791 - 792 - 793 - 794 - 795 795 = 4. Battery & Power Consumption = 796 796 797 797
- image-20231209173457-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -66.3 KB - Content
- image-20231211113113-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.5 KB - Content
- image-20231211113204-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -59.7 KB - Content
- image-20231211114932-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -57.3 KB - Content
- image-20231211220922-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -411.2 KB - Content
- image-20231211221253-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -90.8 KB - Content
- image-20231211221436-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.9 KB - Content