Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
From 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}
To version 171.2
edited by Mengting Qiu
on 2023/12/12 11:46
on 2023/12/12 11:46
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -49,7 +49,6 @@ 49 49 50 50 == 1.3 Specification == 51 51 52 - 53 53 (% style="color:#037691" %)**LiDAR Sensor:** 54 54 55 55 * Operation Temperature: -40 ~~ 80 °C ... ... @@ -65,7 +65,7 @@ 65 65 66 66 (% style="color:#037691" %)**Battery Power Mode:** 67 67 68 -* Idle: 0.003mA @ 3.3v67 +* Idle: 3uA @ 3.3v 69 69 * Max : 360 mA 70 70 71 71 (% style="color:#037691" %)**Continuously mode**: ... ... @@ -73,6 +73,21 @@ 73 73 * Idle: 21 mA @ 3.3v 74 74 * Max : 360 mA 75 75 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 + 76 76 = 2. Configure DS20L to connect to LoRaWAN network = 77 77 78 78 == 2.1 How it works == ... ... @@ -112,12 +112,16 @@ 112 112 113 113 114 114 115 -=== Step 2: Activate onDS20L ===129 +=== Step 2: Activate DS20L === 116 116 117 117 [[image:image-20231128133704-1.png||height="189" width="441"]] 118 118 119 119 Press the button for 5 seconds to activate the DS20L. 120 120 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 + 121 121 (% 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. 122 122 123 123 After join success, it will start to upload messages to TTN and you can see the messages in the panel. ... ... @@ -197,16 +197,31 @@ 197 197 === 2.3.2 Uplink Payload, FPORT~=2 === 198 198 199 199 200 -==== (% style="color:red" %)**MOD~=1**(%%) ==== 218 +==== (% style="color:red" %)**AT+MOD~=1**(%%) ==== 201 201 202 202 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. 203 203 204 -Uplink Payload totals 10 bytes. 222 +**Uplink Payload totals 10 bytes.** 205 205 206 206 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 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 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+ Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count 209 209 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 + 210 210 [[image:image-20231209152917-1.png||height="300" width="1172"]] 211 211 212 212 (% style="color:blue" %)**Battery Info:** ... ... @@ -243,27 +243,174 @@ 243 243 244 244 (% style="color:blue" %)**Sensor State:** 245 245 246 -Ex1: 0x00: Normalcollectiondistance279 +Ex1: 0x00: Distance Reading is valid 247 247 248 -Ex2 0x0x: Distance collection iswrong281 +Ex2: 0x0x: Distance Reading is invalid 249 249 250 250 251 -(% style="color:blue" %)**Interr ipt Count:**284 +(% style="color:blue" %)**Interrupt Count:** 252 252 253 253 If payload is:000007D0H: count = 07D0H =2000 254 254 255 255 256 256 257 -==== (% style="color:red" %)**MOD~=2**(%%)** ** ==== 290 +==== (% style="color:red" %)**AT+MOD~=2**(%%)** ** ==== 258 258 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. 260 260 261 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 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 +Uninterrupted measurement. 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 +Continuous measurement, 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" %) 262 262 |(% 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** 263 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:1 76px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)DistanceLimitAlarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit412 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:176px" %)Distance limit alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 264 264 265 - [[image:image-20231209155616-2.png||height="271"width="1262"]]414 +**MOD+DO+ Alarm+ Do flag+ Limit flag:** 266 266 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 + 267 267 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 268 268 269 269 (% style="color:red" %)**MOD:** ... ... @@ -279,9 +279,9 @@ 279 279 280 280 (% style="color:red" %)**Do:** 281 281 282 - Whenthedistance exceeds the set threshold,pull theDo pinhigh.462 +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. 283 283 284 -(% style="color:red" %)** Limitflag:**464 +(% style="color:red" %)**Threshold Flag for Alarm:** 285 285 286 286 Mode for setting threshold: **0~~3** 287 287 ... ... @@ -294,16 +294,35 @@ 294 294 **3: **Greater than the lower limit 295 295 296 296 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 + 297 297 (% style="color:blue" %)**Upper limit:** 298 298 299 - The upper limitofthethreshold cannotexceed 2000mm.494 +Show the pre-set upper limit in Hex, Unit: mm. 300 300 496 +Ex: 01F4(H)=500mm 301 301 498 + 302 302 (% style="color:blue" %)**Lower limit:** 303 303 304 - The lower limitofthethreshold cannotbe less than 3mm.501 +Show the pre-set lower limit in Hex, Unit: mm. 305 305 503 +Ex: 0xF4(H)=244mm 306 306 505 + 307 307 == 2.4 Decode payload in The Things Network == 308 308 309 309 ... ... @@ -325,7 +325,7 @@ 325 325 326 326 327 327 ((( 328 -[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, on ce wehavetain TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:527 +[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, onhuman-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: 329 329 ))) 330 330 331 331 ... ... @@ -398,7 +398,7 @@ 398 398 == 3.3 Commands special design for DS20L == 399 399 400 400 401 - Thesecommands only valid for DS20L, as below:600 +Below commands only valid for DS20L, as below: 402 402 403 403 404 404 === 3.3.1 Set Transmit Interval Time === ... ... @@ -522,7 +522,8 @@ 522 522 ))) 523 523 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 524 524 525 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 724 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 725 +|=(% 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 526 526 |(% rowspan="11" style="color:blue; width:120px" %)((( 527 527 528 528 ... ... @@ -535,14 +535,12 @@ 535 535 536 536 537 537 538 -**AT+DOL= 5,1800,0,0,400**738 +**AT+DOL=1,1800,3,0,400** 539 539 )))|(% rowspan="4" style="width:240px" %)((( 540 540 541 541 542 542 543 543 544 - 545 - 546 546 The first bit sets the limit mode 547 547 )))|(% style="width:150px" %)0: Do not use upper and lower limits 548 548 |(% style="width:251px" %)1: Use upper and lower limits ... ... @@ -568,10 +568,34 @@ 568 568 569 569 * Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 570 570 571 -* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,1800100,0,400 769 +* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,1800,100,0,400 572 572 573 573 * Example 3: Downlink Payload: 070300000064000190 **~-~-->** AT+MOD=3,0,100,0,400 574 574 773 +(% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.** 774 + 775 +**For example:** 776 + 777 +* **AT+MOD=1** 778 + 779 + **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 780 + 781 +Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1: 782 + 783 +[[image:image-20231211113204-2.png||height="292" width="1093"]] 784 + 785 +* **AT+MOD=2 ** 786 + 787 + **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 788 + 789 +If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1: 790 + 791 +[[image:image-20231211114932-3.png||height="277" width="1248"]] 792 + 793 + 794 + 795 + 796 + 575 575 = 4. Battery & Power Consumption = 576 576 577 577
- image-20231209173457-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +66.3 KB - Content
- image-20231211113113-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +64.5 KB - Content
- image-20231211113204-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +59.7 KB - Content
- image-20231211114932-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +57.3 KB - Content
- image-20231211220922-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +411.2 KB - Content
- image-20231211221253-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +90.8 KB - Content
- image-20231211221436-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +64.9 KB - Content