Changes for page SE01-LB/LS -- LoRaWAN Soil Moisture & EC Sensor User Manual
Last modified by Edwin Chen on 2024/02/07 10:40
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -136,7 +136,7 @@ 136 136 == 1.7 BLE connection == 137 137 138 138 139 - CPL03-LB support BLE remote configure.139 +SE01-LB support BLE remote configure. 140 140 141 141 142 142 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case: ... ... @@ -169,7 +169,7 @@ 169 169 170 170 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/image-20221008135912-1.png?rev=1.1||alt="image-20221008135912-1.png"]] 171 171 172 -= 2. Configure CPL03-LB to connect to LoRaWAN network =172 += 2. Configure SE01-LB to connect to LoRaWAN network = 173 173 174 174 == 2.1 How it works == 175 175 ... ... @@ -234,7 +234,7 @@ 234 234 === 2.3.1 MOD~=0(Default Mode)(% style="display:none" %) (%%) === 235 235 236 236 237 - LSE01 will uplink payload via LoRaWAN with below payload format:237 +SE01-LB will uplink payload via LoRaWAN with below payload format: 238 238 239 239 ((( 240 240 Uplink payload includes in total 11 bytes. ... ... @@ -267,7 +267,7 @@ 267 267 268 268 269 269 ((( 270 -Check the battery voltage for LSE01.270 +Check the battery voltage for SE01-LB. 271 271 ))) 272 272 273 273 ((( ... ... @@ -420,7 +420,7 @@ 420 420 ))) 421 421 422 422 ((( 423 -If payload = 0x04FF, it will reset the LSE01423 +If payload = 0x04FF, it will reset the SE01-LB 424 424 ))) 425 425 426 426 ... ... @@ -429,30 +429,23 @@ 429 429 Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0 430 430 431 431 432 -== 2.4 Payload Decoder file == 433 433 433 +== 2.6 Datalog Feature == 434 434 435 -In TTN, use can add a custom payload so it shows friendly reading 436 436 437 - Inthe page(%style="color:#037691"%)**Applications~-~->PayloadFormats~-~-> Custom~-~-> decoder**(%%)toaddthedecoderfrom: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]436 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, SE01-LB will store the reading for future retrieving purposes. 438 438 439 439 440 -== 2. 5DatalogFeature==439 +=== 2.6.1 Ways to get datalog via LoRaWAN === 441 441 442 442 443 - DatalogFeatureistoensureIoT Servercan get all samplingdata from SensoreveniftheLoRaWAN network isdown.For eachsampling,CPL03-LBwillstore thereadingfor futureretrievingpurposes.442 +Set PNACKMD=1, SE01-LB will wait for ACK for every uplink, when there is no LoRaWAN network,SE01-LB 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. 444 444 445 - 446 -=== 2.5.1 Ways to get datalog via LoRaWAN === 447 - 448 - 449 -Set PNACKMD=1, CPL03-LB will wait for ACK for every uplink, when there is no LoRaWAN network,CPL03-LB 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. 450 - 451 451 * ((( 452 -a) CPL03-LB will do an ACK check for data records sending to make sure every data arrive server.445 +a) SE01-LB will do an ACK check for data records sending to make sure every data arrive server. 453 453 ))) 454 454 * ((( 455 -b) CPL03-LB will send data in **CONFIRMED Mode** when PNACKMD=1, butCPL03-LB 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 ifCPL03-LB gets a ACK,CPL03-LB will consider there is a network connection and resend all NONE-ACK messages.448 +b) SE01-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but SE01-LB 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 SE01-LB gets a ACK, SE01-LB will consider there is a network connection and resend all NONE-ACK messages. 456 456 ))) 457 457 458 458 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) ... ... @@ -460,10 +460,10 @@ 460 460 [[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-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]] 461 461 462 462 463 -=== 2. 5.2 Unix TimeStamp ===456 +=== 2.6.2 Unix TimeStamp === 464 464 465 465 466 - CPL03-LB uses Unix TimeStamp format based on459 +SE01-LB uses Unix TimeStamp format based on 467 467 468 468 [[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"]] 469 469 ... ... @@ -477,17 +477,17 @@ 477 477 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 478 478 479 479 480 -=== 2. 5.3 Set Device Time ===473 +=== 2.6.3 Set Device Time === 481 481 482 482 483 483 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 484 484 485 -Once CPL03-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time toCPL03-LB. IfCPL03-LB fails to get the time from the server,CPL03-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).478 +Once SE01-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to SE01-LB. If SE01-LB fails to get the time from the server, SE01-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 486 486 487 487 (% 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.** 488 488 489 489 490 -=== 2. 5.4 Poll sensor value ===483 +=== 2.6.4 Poll sensor value === 491 491 492 492 493 493 Users can poll sensor values based on timestamps. Below is the downlink command. ... ... @@ -510,24 +510,50 @@ 510 510 ))) 511 511 512 512 ((( 513 -Uplink Internal =5s,means CPL03-LB will send one packet every 5s. range 5~~255s.506 +Uplink Internal =5s,means SE01-LB will send one packet every 5s. range 5~~255s. 514 514 ))) 515 515 516 516 517 -== 2. 6Frequency Plans ==510 +== 2.7 Frequency Plans == 518 518 519 519 520 -The CPL03-LB 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.513 +The SE01-LB 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. 521 521 522 522 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 523 523 524 524 525 -= 3.ConfigureCPL03-LB=518 +== 2.8 Installation in Soil == 526 526 520 + 521 +(% style="color:blue" %)**Measurement the soil surface** 522 + 523 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506634463-199.png?rev=1.1||alt="1654506634463-199.png"]] 524 + 525 +((( 526 +((( 527 +Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting. 528 +))) 529 +))) 530 + 531 + 532 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506665940-119.png?rev=1.1||alt="1654506665940-119.png"]] 533 + 534 +((( 535 +Dig a hole with diameter > 20CM. 536 +))) 537 + 538 +((( 539 +Horizontal insert the probe to the soil and fill the hole for long term measurement. 540 + 541 + 542 +))) 543 + 544 += 3. Configure SE01-LB = 545 + 527 527 == 3.1 Configure Methods == 528 528 529 529 530 - CPL03-LB supports below configure method:549 +SE01-LB supports below configure method: 531 531 532 532 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 533 533 ... ... @@ -549,10 +549,10 @@ 549 549 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]] 550 550 551 551 552 -== 3.3 Commands special design for CPL03-LB ==571 +== 3.3 Commands special design for SE01-LB == 553 553 554 554 555 -These commands only valid for CPL03-LB, as below:574 +These commands only valid for SE01-LB, as below: 556 556 557 557 558 558 === 3.3.1 Set Transmit Interval Time === ... ... @@ -617,204 +617,9 @@ 617 617 No downlink command for this feature. 618 618 619 619 620 -=== 3.3.3 GetDevice Status===639 +=== 3.3.3 Set Interrupt Mode === 621 621 622 622 623 -Send a LoRaWAN downlink to ask device send Alarm settings. 624 - 625 -(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 626 - 627 -Sensor will upload Device Status via FPORT=5. See payload section for detail. 628 - 629 - 630 -=== 3.3.4 Enable / Disable Alarm === 631 - 632 - 633 -Feature: Enable/Disable Alarm for open/close event. Default value 0. 634 - 635 -(% style="color:blue" %)**AT Command:** 636 - 637 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 638 -|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response** 639 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 640 -|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 641 - 642 -(% style="color:blue" %)**Downlink Command:** 643 - 644 -**0xA7 01** ~/~/ Same As AT+DISALARM=1 645 - 646 -**0xA7 00 ** ~/~/ Same As AT+DISALARM=0 647 - 648 - 649 -=== 3.3.5 Alarm Base on Timeout === 650 - 651 - 652 -((( 653 -CPL03-LB can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are: 654 -))) 655 - 656 - 657 -((( 658 -(% style="color:#4f81bd" %)**1. Keep Status: Status to be monitor** 659 -))) 660 - 661 -((( 662 -**Keep Status = 1**: Monitor Close to Open event 663 -))) 664 - 665 -((( 666 -**Keep Status = 0**: Monitor Open to Close event 667 -))) 668 - 669 - 670 -((( 671 -(% style="color:#4f81bd" %)**2. Keep Time: Timeout to send an Alarm** 672 -))) 673 - 674 -((( 675 -Range 0 ~~ 65535(0xFFFF) seconds. 676 -))) 677 - 678 -((( 679 -If** keep time = 0**, Disable Alarm Base on Timeout feature. 680 -))) 681 - 682 -((( 683 -If **keep time > 0**, device will monitor the keep status event and send an alarm when status doesn’t change after timeout. 684 -))) 685 - 686 - 687 -((( 688 -(% style="color:#4f81bd" %)**AT Command**(%%) to configure: 689 -))) 690 - 691 -((( 692 -(% style="color:blue" %)**AT+TTRIG=1,30**(%%) ~-~-> When the **Keep Status** change from connect to disconnect, and device remains in disconnect status for more than 30 seconds. CPL03-LB will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 693 -))) 694 - 695 -((( 696 -(% style="color:blue" %)**AT+TTIG=0,0 **(%%) ~-~-> Default Value, disable timeout Alarm. 697 -))) 698 - 699 - 700 -((( 701 -(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure: 702 -))) 703 - 704 -((( 705 -**Command: 0xA9 aa bb cc** 706 -))) 707 - 708 -((( 709 -**A9: **Command Type Code 710 -))) 711 - 712 -((( 713 -**aa: **status to be monitored 714 -))) 715 - 716 -((( 717 -**bb cc: **timeout. 718 -))) 719 - 720 - 721 -((( 722 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 723 -))) 724 - 725 -((( 726 -Or 727 -))) 728 - 729 -((( 730 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 731 -))) 732 - 733 - 734 -=== 3.3.6 Clear Flash Record === 735 - 736 - 737 -Feature: Clear flash storage for data log feature. 738 - 739 -(% style="color:blue" %)**AT Command: AT+CLRDTA** 740 - 741 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) 742 -|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 169px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 174px;background-color:#D9E2F3;color:#0070C0" %)**Response** 743 -|(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK 744 - 745 -((( 746 -(% style="color:blue" %)**Downlink Command:** 747 -))) 748 - 749 -((( 750 -* **Example**: 0xA301 ~/~/ Same as AT+CLRDTA 751 -))) 752 - 753 - 754 - 755 -=== 3.3.7 Set trigger mode === 756 - 757 - 758 -Feature: Set the trigger interrupt mode. 759 - 760 -(% style="color:blue" %)**AT Command: AT+TTRMOD** 761 - 762 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:495px" %) 763 -|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 246px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 92px;background-color:#D9E2F3;color:#0070C0" %)**Response** 764 -|(% style="width:157px" %)((( 765 -AT+TTRMOD=1 766 -)))|(% style="width:156px" %)Count and trigger from open to close (rising edge)|(% style="width:89px" %)((( 767 -((( 768 -OK 769 -))) 770 -))) 771 -|(% style="width:157px" %)((( 772 -AT+TTRMOD=0 773 -)))|(% style="width:156px" %)Count and trigger from close to open (falling edge)|(% style="width:89px" %)((( 774 -OK 775 -))) 776 - 777 -(% style="color:blue" %)**Downlink Command:** 778 - 779 -* **Example**: 0xA401 ~/~/ Same as AT+ TTRMOD =1 780 - 781 -=== 3.3.8 Set the calculate flag === 782 - 783 - 784 -Feature: Set the calculate flag 785 - 786 -(% style="color:blue" %)**AT Command: AT+CALCFLAG** 787 - 788 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %) 789 -|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 193px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 110px;background-color:#D9E2F3;color:#0070C0" %)**Response** 790 -|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK 791 -|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK 792 - 793 -(% style="color:blue" %)**Downlink Command:** 794 - 795 -* **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 796 - 797 -=== 3.3.9 Set count number === 798 - 799 - 800 -Feature: Manually set the count number 801 - 802 -(% style="color:blue" %)**AT Command: AT+SETCNT** 803 - 804 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %) 805 -|=(% style="width: 160px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 223px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 96px;background-color:#D9E2F3;color:#0070C0" %)**Response** 806 -|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK 807 -|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK 808 - 809 -(% style="color:blue" %)**Downlink Command:** 810 - 811 -* **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1 812 - 813 -* **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 814 - 815 -=== 3.3.10 Set Interrupt Mode === 816 - 817 - 818 818 Feature, Set Interrupt mode for PA8 of pin. 819 819 820 820 When AT+INTMOD=0 is set, PA8 is used as a digital input port. ... ... @@ -846,7 +846,7 @@ 846 846 847 847 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 848 848 849 -=== 3.3. 11Set Power Output Duration ===673 +=== 3.3.4 Set Power Output Duration === 850 850 851 851 852 852 Control the output duration 5V . Before each sampling, device will ... ... @@ -878,7 +878,7 @@ 878 878 = 4. Battery & Power Consumption = 879 879 880 880 881 - CPL03-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.705 +SE01-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 882 882 883 883 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 884 884 ... ... @@ -887,7 +887,7 @@ 887 887 888 888 889 889 (% class="wikigeneratedid" %) 890 -User can change firmware CPL03-LB to:714 +User can change firmware SE01-LB to: 891 891 892 892 * Change Frequency band/ region. 893 893 ... ... @@ -911,10 +911,24 @@ 911 911 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. 912 912 913 913 738 +== 6.2 Can I calibrate SE01-LB to different soil types? == 739 + 740 + 741 +((( 742 +SE01-LB is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20230522.pdf]]. 743 +))) 744 + 745 + 746 +== 6.3 Why I can't join TTN in US915 / AU915 bands? == 747 + 748 + 749 +It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H7.19EightChannelMode"]] section above for details. 750 + 751 + 914 914 = 7. Order Info = 915 915 916 916 917 -Part Number: (% style="color:blue" %)** CPL03-LB-XXX**755 +Part Number: (% style="color:blue" %)**SE01-LB-XXX** 918 918 919 919 (% style="color:red" %)**XXX**(%%): The default frequency band 920 920 ... ... @@ -934,12 +934,15 @@ 934 934 935 935 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 936 936 775 + 776 + 777 + 937 937 = 8. Packing Info = 938 938 939 939 940 940 (% style="color:#037691" %)**Package Includes**: 941 941 942 -* CPL03-LB LoRaWANPulse/ContactSensor783 +* SE01-LB LoRaWAN Soil Moisture & EC Sensor 943 943 944 944 (% style="color:#037691" %)**Dimension and weight**: 945 945