Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -60,8 +60,6 @@ 60 60 * ToF FoV: ±9°, Total 18° 61 61 * Light source: VCSEL 62 62 63 - 64 - 65 65 == 1.4 Power Consumption == 66 66 67 67 ... ... @@ -75,8 +75,6 @@ 75 75 * Idle: 21 mA @ 3.3v 76 76 * Max : 360 mA 77 77 78 - 79 - 80 80 = 2. Configure DS20L to connect to LoRaWAN network = 81 81 82 82 == 2.1 How it works == ... ... @@ -128,6 +128,7 @@ 128 128 129 129 (% style="color:blue" %)**Step 2:**(%%) Activate on DS20L 130 130 127 +[[image:image-20231128133704-1.png||height="189" width="441"]] 131 131 132 132 Press the button for 5 seconds to activate the DS20L. 133 133 ... ... @@ -153,9 +153,9 @@ 153 153 154 154 Example parse in TTNv3 155 155 156 -[[image: image-20230805103904-1.png||height="131" width="711"]]153 +[[image:1701149922873-259.png]] 157 157 158 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x2 4155 +(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21 159 159 160 160 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 161 161 ... ... @@ -471,87 +471,15 @@ 471 471 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]] 472 472 473 473 474 -== 2.5 DatalogFeature ==471 +== 2.5 Frequency Plans == 475 475 476 476 477 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS20L will store the reading for future retrieving purposes. 478 - 479 - 480 -=== 2.5.1 Ways to get datalog via LoRaWAN === 481 - 482 - 483 -Set PNACKMD=1, DS20L will wait for ACK for every uplink, when there is no LoRaWAN network, DS20L will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery. 484 - 485 -* ((( 486 -a) DS20L will do an ACK check for data records sending to make sure every data arrive server. 487 -))) 488 -* ((( 489 -b) DS20L will send data in **CONFIRMED Mode** when PNACKMD=1, but DS20L won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DS20L gets a ACK, DS20L will consider there is a network connection and resend all NONE-ACK messages. 490 -))) 491 - 492 -=== 2.5.2 Unix TimeStamp === 493 - 494 - 495 -DS20L uses Unix TimeStamp format based on 496 - 497 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]] 498 - 499 -User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] : 500 - 501 -Below is the converter example 502 - 503 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]] 504 - 505 - 506 -So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 507 - 508 - 509 -=== 2.5.3 Set Device Time === 510 - 511 - 512 -User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 513 - 514 -Once DS20L Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS20L. If DS20L fails to get the time from the server, DS20L will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 515 - 516 -(% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.** 517 - 518 - 519 -=== 2.5.4 Poll sensor value === 520 - 521 - 522 -Users can poll sensor values based on timestamps. Below is the downlink command. 523 - 524 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %) 525 -|(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)** 526 -|(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte** 527 -|(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval 528 - 529 -((( 530 -Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval. 531 -))) 532 - 533 -((( 534 -For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]] 535 -))) 536 - 537 -((( 538 -Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data 539 -))) 540 - 541 -((( 542 -Uplink Internal =5s,means DS20L will send one packet every 5s. range 5~~255s. 543 -))) 544 - 545 - 546 -== 2.6 Frequency Plans == 547 - 548 - 549 549 The DS20L uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets. 550 550 551 551 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 552 552 553 553 554 -3. Configure DS20L 479 += 3. Configure DS20L = 555 555 556 556 == 3.1 Configure Methods == 557 557 ... ... @@ -623,12 +623,10 @@ 623 623 Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 624 624 ))) 625 625 * ((( 626 -Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 627 - 628 - 629 - 551 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 630 630 ))) 631 631 554 + 632 632 === 3.3.2 Set Interrupt Mode === 633 633 634 634 ... ... @@ -646,7 +646,7 @@ 646 646 the mode is 0 =Disable Interrupt 647 647 ))) 648 648 |(% style="width:154px" %)((( 649 -AT+INTMOD= 2572 +AT+INTMOD=3 650 650 651 651 (default) 652 652 )))|(% style="width:196px" %)((( ... ... @@ -667,6 +667,74 @@ 667 667 668 668 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 669 669 593 + 594 + 595 +== 3.3.3 Set work mode == 596 + 597 + 598 +Feature: Switch working mode 599 + 600 +(% style="color:blue" %)**AT Command: AT+MOD** 601 + 602 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:463px" %) 603 +|=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 108px;background-color:#4F81BD;color:white" %)**Response** 604 +|(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK 605 +|(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)((( 606 +OK 607 + 608 +Attention:Take effect after ATZ 609 +))) 610 + 611 +(% style="color:blue" %)**Downlink Command:** 612 + 613 +* **Example: **0x0A00 ~/~/ Same as AT+MOD=0 614 + 615 +* **Example:** 0x0A01 ~/~/ Same as AT+MOD=1 616 + 617 + 618 +=== 3.3.4 Set threshold and threshold mode === 619 + 620 + 621 +Feature, Set threshold and threshold mode 622 + 623 +When **AT+DOL=0,0,0,0,400** is set, No threshold is used, the sampling time is 400ms. 624 + 625 +**AT Command: AT+DOL** 626 + 627 +(% border="1" cellspacing="4" style="width:571.818px" %) 628 +|(% style="width:172px" %)**Command Example**|(% style="width:279px" %)**Function**|(% style="width:118px" %)**Response** 629 +|(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)((( 630 +0,0,0,0,400 631 + 632 +OK 633 +))) 634 +|(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 635 + 636 + 637 +(% border="1" cellspacing="4" style="width:668.818px" %) 638 +|(% rowspan="11" style="width:166px" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:226px" %)The first bit sets the limit mode|(% style="width:251px" %)0:Do not use upper and lower limits 639 +|(% style="width:251px" %)1:Use upper and lower limits 640 +|(% style="width:251px" %)2:Less than the lower limit 641 +|(% style="width:251px" %)3:Greater than the lower limit 642 +|(% style="width:251px" %)4:Less than the upper limit 643 +|(% style="width:251px" %)5: Greater than the upper limit 644 +|(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM 645 +|(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM 646 +|(% rowspan="2" style="width:226px" %)The fourth bit sets the over-limit alarm or person or object count.|(% style="width:251px" %)0 Over-limit alarm, DO output is high 647 +|(% style="width:251px" %)1 Person or object counting statistics 648 +|(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)((( 649 +0~~10000ms 650 + 651 + 652 +))) 653 + 654 +**Downlink Command: 0x07** 655 + 656 +Format: Command Code (0x07) followed by 9bytes. 657 + 658 +* Example 0: Downlink Payload: 070000000000000190 **~-~-->** AT+MOD=0,0,0,0,400 659 +* Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 660 + 670 670 = 4. Battery & Power Consumption = 671 671 672 672