Changes for page SPH01-LB -- LoRaWAN Soil pH Sensor User Manual
Last modified by Xiaoling on 2024/01/15 09:36
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -163,7 +163,7 @@ 163 163 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 164 164 165 165 166 -= 2. Configure SPH01-LB to connect to LoRaWAN network =166 += 2. Configure CPL03-LB to connect to LoRaWAN network = 167 167 168 168 == 2.1 How it works == 169 169 ... ... @@ -304,7 +304,7 @@ 304 304 === 2.3.5 Interrupt Pin === 305 305 306 306 307 -This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3. 3.2SetInterruptMode"]] for the hardware and software set up.307 +This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up. 308 308 309 309 310 310 **Example:** ... ... @@ -364,7 +364,7 @@ 364 364 === 2.5.1 Ways to get datalog via LoRaWAN === 365 365 366 366 367 -Set PNACKMD=1, SPH01-LB will wait for ACK for every uplink, when there is no LoRaWAN network, SPH01-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.367 +Set PNACKMD=1, SPH01-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. 368 368 369 369 * ((( 370 370 a) SPH01-LB will do an ACK check for data records sending to make sure every data arrive server. ... ... @@ -400,7 +400,7 @@ 400 400 401 401 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 402 402 403 -Once SPH01-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time toSPH01-LB. IfSPH01-LB fails to get the time from the server,SPH01-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).403 +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 to CPL03-LB. If CPL03-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). 404 404 405 405 (% 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.** 406 406 ... ... @@ -428,7 +428,7 @@ 428 428 ))) 429 429 430 430 ((( 431 -Uplink Internal =5s,means SPH01-LB will send one packet every 5s. range 5~~255s.431 +Uplink Internal =5s,means CPL03-LB will send one packet every 5s. range 5~~255s. 432 432 ))) 433 433 434 434 ... ... @@ -581,7 +581,14 @@ 581 581 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 582 582 583 583 584 +== 2.9 Firmware Change Log == 584 584 586 + 587 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]] 588 + 589 +**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]] 590 + 591 + 585 585 = 3. Configure SPH01-LB = 586 586 587 587 == 3.1 Configure Methods == ... ... @@ -609,10 +609,10 @@ 609 609 [[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/]] 610 610 611 611 612 -== 3.3 Commands special design for SPH01-LB ==619 +== 3.3 Commands special design for CPL03-LB == 613 613 614 614 615 -These commands only valid for SPH01-LB, as below:622 +These commands only valid for CPL03-LB, as below: 616 616 617 617 618 618 === 3.3.1 Set Transmit Interval Time === ... ... @@ -656,135 +656,289 @@ 656 656 657 657 * ((( 658 658 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 666 + 667 + 668 + 659 659 ))) 660 660 671 +=== 3.3.2 Quit AT Command === 661 661 662 662 663 - ===3.3.2SetInterruptMode ===674 +Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands. 664 664 676 +(% style="color:blue" %)**AT Command: AT+DISAT** 665 665 666 -Feature, Set Interrupt mode for PA8 of pin. 678 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:452px" %) 679 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 198px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 99px;background-color:#D9E2F3;color:#0070C0" %)**Response** 680 +|(% style="width:155px" %)AT+DISAT|(% style="width:198px" %)Quit AT Commands mode|(% style="width:96px" %)OK 667 667 668 - WhenAT+INTMOD=0 isset, PA8 isusedas a digitalputport.682 +(% style="color:blue" %)**Downlink Command:** 669 669 670 - (%style="color:blue"%)**AT Command:AT+INTMOD**684 +No downlink command for this feature. 671 671 672 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 673 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response** 674 -|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 675 -0 676 -OK 677 -the mode is 0 =Disable Interrupt 686 + 687 +=== 3.3.3 Get Device Status === 688 + 689 + 690 +Send a LoRaWAN downlink to ask device send Alarm settings. 691 + 692 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 693 + 694 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 695 + 696 + 697 +=== 3.3.4 Enable / Disable Alarm === 698 + 699 + 700 +Feature: Enable/Disable Alarm for open/close event. Default value 0. 701 + 702 +(% style="color:blue" %)**AT Command:** 703 + 704 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 705 +|(% 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** 706 +|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 707 +|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 708 + 709 +(% style="color:blue" %)**Downlink Command:** 710 + 711 +**0xA7 01** ~/~/ Same As AT+DISALARM=1 712 + 713 +**0xA7 00 ** ~/~/ Same As AT+DISALARM=0 714 + 715 + 716 +=== 3.3.5 Alarm Base on Timeout === 717 + 718 + 719 +((( 720 +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: 678 678 ))) 679 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 680 -Set Transmit Interval 681 -0. (Disable Interrupt), 682 -~1. (Trigger by rising and falling edge) 683 -2. (Trigger by falling edge) 684 -3. (Trigger by rising edge) 685 -)))|(% style="width:157px" %)OK 686 686 687 -(% style="color:blue" %)**Downlink Command: 0x06** 688 688 689 -Format: Command Code (0x06) followed by 3 bytes. 724 +((( 725 +(% style="color:#4f81bd" %)**1. Keep Status: Status to be monitor** 726 +))) 690 690 691 -This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 728 +((( 729 +**Keep Status = 1**: Monitor Close to Open event 730 +))) 692 692 693 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 732 +((( 733 +**Keep Status = 0**: Monitor Open to Close event 734 +))) 694 694 695 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 696 696 737 +((( 738 +(% style="color:#4f81bd" %)**2. Keep Time: Timeout to send an Alarm** 739 +))) 697 697 741 +((( 742 +Range 0 ~~ 65535(0xFFFF) seconds. 743 +))) 698 698 745 +((( 746 +If** keep time = 0**, Disable Alarm Base on Timeout feature. 747 +))) 699 699 700 -=== 3.3.3 Calibrate Sensor === 749 +((( 750 +If **keep time > 0**, device will monitor the keep status event and send an alarm when status doesn’t change after timeout. 751 +))) 701 701 702 702 703 -Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands 754 +((( 755 +(% style="color:#4f81bd" %)**AT Command**(%%) to configure: 756 +))) 704 704 758 +((( 759 +(% 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. 760 +))) 705 705 706 -=== 3.3.4 Get Firmware Version Info === 762 +((( 763 +(% style="color:blue" %)**AT+TTIG=0,0 **(%%) ~-~-> Default Value, disable timeout Alarm. 764 +))) 707 707 708 708 709 -Feature: use downlink to get firmware version. 767 +((( 768 +(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure: 769 +))) 710 710 711 -(% style="color:#037691" %)**Downlink Command: 0x26** 771 +((( 772 +**Command: 0xA9 aa bb cc** 773 +))) 712 712 775 +((( 776 +**A9: **Command Type Code 777 +))) 778 + 779 +((( 780 +**aa: **status to be monitored 781 +))) 782 + 783 +((( 784 +**bb cc: **timeout. 785 +))) 786 + 787 + 788 +((( 789 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 790 +))) 791 + 792 +((( 793 +Or 794 +))) 795 + 796 +((( 797 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 798 +))) 799 + 800 + 801 +=== 3.3.6 Clear Flash Record === 802 + 803 + 804 +Feature: Clear flash storage for data log feature. 805 + 806 +(% style="color:blue" %)**AT Command: AT+CLRDTA** 807 + 713 713 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) 714 -|(% style="background-color:# d9e2f3;c0; width:193px" %)**DownlinkControlType**|(% style="background-color:#d9e2f3;c0; width:57px" %)**FPort**|(% style="background-color:#d9e2f3; color:#0070c0;width:91px" %)**Type Code**|(% style="background-color:#d9e2f3;c0; width:159px" %)**Downlinkpayloadsize(bytes)**715 -|(% style="width:1 93px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(%style="width:91px"%)26|(%style="width:149px"%)2809 +|=(% 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** 810 +|(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK 716 716 717 -* Reply to the confirmation package: 26 01 718 -* Reply to non-confirmed packet: 26 00 812 +((( 813 +(% style="color:blue" %)**Downlink Command:** 814 +))) 719 719 720 -Device will send an uplink after got this downlink command. With below payload: 816 +((( 817 +* **Example**: 0xA301 ~/~/ Same as AT+CLRDTA 818 +))) 721 721 722 -Configures info payload: 723 723 724 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 725 -|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**5**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**1** 726 -|Value|Software Type|((( 727 -Frequency 728 -Band 729 -)))|Sub-band|((( 730 -Firmware 731 -Version 732 -)))|Sensor Type|Reserve|((( 733 -[[Message Type>>||anchor="H2.3.6MessageType"]] 734 -Always 0x02 821 + 822 +=== 3.3.7 Set trigger mode === 823 + 824 + 825 +Feature: Set the trigger interrupt mode. 826 + 827 +(% style="color:blue" %)**AT Command: AT+TTRMOD** 828 + 829 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:495px" %) 830 +|=(% 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** 831 +|(% style="width:157px" %)((( 832 +AT+TTRMOD=1 833 +)))|(% style="width:156px" %)Count and trigger from open to close (rising edge)|(% style="width:89px" %)((( 834 +((( 835 +OK 735 735 ))) 837 +))) 838 +|(% style="width:157px" %)((( 839 +AT+TTRMOD=0 840 +)))|(% style="width:156px" %)Count and trigger from close to open (falling edge)|(% style="width:89px" %)((( 841 +OK 842 +))) 736 736 737 -(% style="color: #037691" %)**Software Type**(%%): Always0x03 for LSPH01844 +(% style="color:blue" %)**Downlink Command:** 738 738 739 - (%style="color:#037691"%)**FrequencyBand**:846 +* **Example**: 0xA401 ~/~/ Same as AT+ TTRMOD =1 740 740 741 - *0x01:EU868848 +=== 3.3.8 Set the calculate flag === 742 742 743 -*0x02: US915 744 744 745 - *0x03:IN865851 +Feature: Set the calculate flag 746 746 747 -* 0x04: AU915853 +(% style="color:blue" %)**AT Command: AT+CALCFLAG** 748 748 749 -*0x05: KZ865 855 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %) 856 +|=(% 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** 857 +|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK 858 +|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK 750 750 751 - *0x06:RU864860 +(% style="color:blue" %)**Downlink Command:** 752 752 753 -* 0x07: AS923862 +* **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 754 754 755 - *0x08:AS923-1864 +=== 3.3.9 Set count number === 756 756 757 -*0x09: AS923-2 758 758 759 - *0xa0:AS923-3867 +Feature: Manually set the count number 760 760 869 +(% style="color:blue" %)**AT Command: AT+SETCNT** 761 761 762 -(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08 871 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %) 872 +|=(% 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** 873 +|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK 874 +|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK 763 763 764 -(% style="color: #037691" %)**Firmware Version**(%%):0x0100, Means:v1.0.0 version876 +(% style="color:blue" %)**Downlink Command:** 765 765 766 - (%style="color:#037691"%)**SensorType**:878 +* **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1 767 767 768 -0x0 1:LSE01880 +* **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 769 769 770 -0 x02:LDDS75882 +=== 3.3.10 Set Interrupt Mode === 771 771 772 -0x03: LDDS20 773 773 774 - 0x04:LLMS01885 +Feature, Set Interrupt mode for PA8 of pin. 775 775 776 -0 x05:LSPH01887 +When AT+INTMOD=0 is set, PA8 is used as a digital input port. 777 777 778 - 0x06:LSNPK01889 +(% style="color:blue" %)**AT Command: AT+INTMOD** 779 779 780 -0x07: LDDS12 891 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 892 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response** 893 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 894 +0 895 +OK 896 +the mode is 0 =Disable Interrupt 897 +))) 898 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 899 +Set Transmit Interval 900 +0. (Disable Interrupt), 901 +~1. (Trigger by rising and falling edge) 902 +2. (Trigger by falling edge) 903 +3. (Trigger by rising edge) 904 +)))|(% style="width:157px" %)OK 781 781 906 +(% style="color:blue" %)**Downlink Command: 0x06** 782 782 908 +Format: Command Code (0x06) followed by 3 bytes. 783 783 910 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 911 + 912 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 913 + 914 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 915 + 916 +=== 3.3.11 Set Power Output Duration === 917 + 918 + 919 +Control the output duration 5V . Before each sampling, device will 920 + 921 +~1. first enable the power output to external sensor, 922 + 923 +2. keep it on as per duration, read sensor value and construct uplink payload 924 + 925 +3. final, close the power output. 926 + 927 +(% style="color:blue" %)**AT Command: AT+5VT** 928 + 929 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 930 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response** 931 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 932 +OK 933 +|(% style="width:154px" %)AT+5VT=500|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 934 + 935 +(% style="color:blue" %)**Downlink Command: 0x07** 936 + 937 +Format: Command Code (0x07) followed by 2 bytes. 938 + 939 +The first and second bytes are the time to turn on. 940 + 941 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 942 + 943 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 944 + 784 784 = 4. Battery & Power Consumption = 785 785 786 786 787 - SPH01-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.948 +CPL03-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 788 788 789 789 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 790 790 ... ... @@ -793,7 +793,7 @@ 793 793 794 794 795 795 (% class="wikigeneratedid" %) 796 -User can change firmware SPH01-LB to:957 +User can change firmware CPL03-LB to: 797 797 798 798 * Change Frequency band/ region. 799 799 ... ... @@ -820,7 +820,7 @@ 820 820 = 7. Order Info = 821 821 822 822 823 -Part Number: (% style="color:blue" %)** SPH01-LB-XXX**984 +Part Number: (% style="color:blue" %)**CPL03-LB-XXX** 824 824 825 825 (% style="color:red" %)**XXX**(%%): The default frequency band 826 826 ... ... @@ -845,7 +845,7 @@ 845 845 846 846 (% style="color:#037691" %)**Package Includes**: 847 847 848 -* SPH01-LB LoRaWANSoilPhSensorx 11009 +* CPL03-LB LoRaWAN Pulse/Contact Sensor 849 849 850 850 (% style="color:#037691" %)**Dimension and weight**: 851 851