Last modified by Xiaoling on 2025/04/25 14:08

From version 86.14
edited by Xiaoling
on 2022/06/14 14:37
Change comment: There is no comment for this version
To version 74.10
edited by Xiaoling
on 2022/06/07 17:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,7 +4,7 @@
4 4  
5 5  
6 6  
7 -**Table of Contents:**
7 +**Contents:**
8 8  
9 9  * [[1. Introduction>>path:#H1.Introduction]]
10 10  ** [[1.1 ​What is LoRaWAN Soil pH Sensor>>path:#H1.1200BWhatisLoRaWANSoilpHSensor]]
... ... @@ -64,13 +64,14 @@
64 64  
65 65  
66 66  
67 +
68 +
69 +
67 67  = 1. Introduction =
68 68  
69 69  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
70 70  
71 71  (((
72 -
73 -
74 74  The Dragino LSPH01 is a (% style="color:#4f81bd" %)**LoRaWAN Soil pH Sensor**(%%) for IoT of Agriculture. It is designed to measure the soil PH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof.
75 75  )))
76 76  
... ... @@ -95,7 +95,6 @@
95 95  
96 96  
97 97  
98 -
99 99  == ​1.2 Features ==
100 100  
101 101  * LoRaWAN 1.0.3 Class A
... ... @@ -113,8 +113,6 @@
113 113  * 8500mAh Battery for long term use
114 114  
115 115  
116 -
117 -
118 118  == 1.3 Probe Specification ==
119 119  
120 120  
... ... @@ -127,7 +127,6 @@
127 127  * IP68 Protection
128 128  * Length: 3.5 meters
129 129  
130 -
131 131  (% style="color:#4f81bd" %)**Soil Temperature:**
132 132  
133 133  * Range -40℃~85℃
... ... @@ -137,15 +137,11 @@
137 137  * Length: 3.5 meters
138 138  
139 139  
140 -
141 -
142 142  == 1.4 ​Applications ==
143 143  
144 144  * Smart Agriculture
145 145  
146 146  
147 -
148 -
149 149  == 1.5 Pin mapping and power on ==
150 150  
151 151  [[image:1654592472094-134.png]]
... ... @@ -161,7 +161,7 @@
161 161  )))
162 162  
163 163  (((
164 -In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H5.UseATCommand"]]to set the keys in the LSPH01.
157 +In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>path:#H5.UseATCommand]]to set the keys in the LSPH01.
165 165  )))
166 166  
167 167  
... ... @@ -173,14 +173,10 @@
173 173  
174 174  (((
175 175  [[image:1654592492399-921.png]]
176 -
177 -
178 178  )))
179 179  
180 180  (((
181 181  The LG308 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
182 -
183 -
184 184  )))
185 185  
186 186  (((
... ... @@ -204,13 +204,11 @@
204 204  [[image:1654592600093-601.png]]
205 205  
206 206  
207 -
208 208  **Add APP EUI and DEV EUI**
209 209  
210 210  [[image:1654592619856-881.png]]
211 211  
212 212  
213 -
214 214  **Add APP EUI in the application**
215 215  
216 216  [[image:1654592632656-512.png]]
... ... @@ -253,17 +253,19 @@
253 253  )))
254 254  
255 255  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
256 -|=(% style="width: 62.5px;" %)(((
257 -**Size (bytes)**
258 -)))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1**
259 -|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
260 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
243 +|(((
244 +**Size**
261 261  
262 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
263 -)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
264 -[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
246 +**(bytes)**
247 +)))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
248 +|**Value**|[[BAT>>path:#H2.3.1BatteryInfo]]|(((
249 +[[Temperature>>path:#H2.3.2DS18B20Temperaturesensor]]
250 +
251 +[[(Optional)>>path:#H2.3.2DS18B20Temperaturesensor]]
252 +)))|[[Soil pH>>path:#H2.3.3SoilpH]]|[[Soil Temperature>>path:#H2.3.4SoilTemperature]]|(((
253 +[[Digital Interrupt (Optional)>>path:#H2.3.5InterruptPin]]
265 265  )))|Reserve|(((
266 -[[Message Type>>||anchor="H2.3.6MessageType"]]
255 +[[Message Type>>path:#H2.3.6MessageType]]
267 267  )))
268 268  
269 269  [[image:1654592721645-318.png]]
... ... @@ -319,7 +319,7 @@
319 319  
320 320  === 2.3.5 Interrupt Pin ===
321 321  
322 -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.
311 +This data field shows if this packet is generated by interrupt or not. [[Click here>>path:#H3.2SetInterruptMode]] for the hardware and software set up.
323 323  
324 324  
325 325  **Example:**
... ... @@ -341,15 +341,14 @@
341 341  )))
342 342  
343 343  
344 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %)
345 -|=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload**
346 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
347 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
348 -|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
333 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
334 +|=**Message Type Code**|=**Description**|=**Payload**
335 +|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
336 +|0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
337 +|0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
349 349  
350 350  
351 351  
352 -
353 353  === 2.3.7 Decode payload in The Things Network ===
354 354  
355 355  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -369,7 +369,7 @@
369 369  
370 370  == 2.4 Uplink Interval ==
371 371  
372 -The LSPH01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
360 +The LSPH01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]
373 373  
374 374  
375 375  
... ... @@ -533,9 +533,11 @@
533 533  (% style="color:#037691" %)**Calibration Payload**
534 534  
535 535  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
536 -|=(% style="width: 62.5px;" %)(((
537 -**Size (bytes)**
538 -)))|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**7**|=(% style="width: 89px;" %)**1**
524 +|(((
525 +**Size**
526 +
527 +**(bytes)**
528 +)))|**1**|**1**|**1**|**7**|**1**
539 539  |**Value**|(((
540 540  PH4
541 541  
... ... @@ -545,7 +545,7 @@
545 545  
546 546  Calibrate value
547 547  )))|Reserve|(((
548 -[[Message Type>>||anchor="H2.3.6MessageType"]]
538 +[[Message Type>>path:#H2.3.6MessageType]]
549 549  
550 550  Always 0x03
551 551  )))
... ... @@ -646,91 +646,49 @@
646 646  
647 647  
648 648  
639 +
649 649  === 2.8.3 CN470-510 (CN470) ===
650 650  
651 -(((
652 652  Used in China, Default use CHE=1
653 -)))
654 654  
655 -(((
656 656  (% style="color:blue" %)**Uplink:**
657 -)))
658 658  
659 -(((
660 660  486.3 - SF7BW125 to SF12BW125
661 -)))
662 662  
663 -(((
664 664  486.5 - SF7BW125 to SF12BW125
665 -)))
666 666  
667 -(((
668 668  486.7 - SF7BW125 to SF12BW125
669 -)))
670 670  
671 -(((
672 672  486.9 - SF7BW125 to SF12BW125
673 -)))
674 674  
675 -(((
676 676  487.1 - SF7BW125 to SF12BW125
677 -)))
678 678  
679 -(((
680 680  487.3 - SF7BW125 to SF12BW125
681 -)))
682 682  
683 -(((
684 684  487.5 - SF7BW125 to SF12BW125
685 -)))
686 686  
687 -(((
688 688  487.7 - SF7BW125 to SF12BW125
689 -)))
690 690  
691 -(((
692 -
693 -)))
694 694  
695 -(((
696 696  (% style="color:blue" %)**Downlink:**
697 -)))
698 698  
699 -(((
700 700  506.7 - SF7BW125 to SF12BW125
701 -)))
702 702  
703 -(((
704 704  506.9 - SF7BW125 to SF12BW125
705 -)))
706 706  
707 -(((
708 708  507.1 - SF7BW125 to SF12BW125
709 -)))
710 710  
711 -(((
712 712  507.3 - SF7BW125 to SF12BW125
713 -)))
714 714  
715 -(((
716 716  507.5 - SF7BW125 to SF12BW125
717 -)))
718 718  
719 -(((
720 720  507.7 - SF7BW125 to SF12BW125
721 -)))
722 722  
723 -(((
724 724  507.9 - SF7BW125 to SF12BW125
725 -)))
726 726  
727 -(((
728 728  508.1 - SF7BW125 to SF12BW125
729 -)))
730 730  
731 -(((
732 732  505.3 - SF12BW125 (RX2 downlink only)
733 -)))
734 734  
735 735  
736 736  
... ... @@ -756,8 +756,6 @@
756 756  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
757 757  
758 758  
759 -
760 -
761 761  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
762 762  
763 763  (((
... ... @@ -868,109 +868,56 @@
868 868  
869 869  === 2.8.6 KR920-923 (KR920) ===
870 870  
871 -(((
872 872  (% style="color:blue" %)**Default channel:**
873 -)))
874 874  
875 -(((
876 876  922.1 - SF7BW125 to SF12BW125
877 -)))
878 878  
879 -(((
880 880  922.3 - SF7BW125 to SF12BW125
881 -)))
882 882  
883 -(((
884 884  922.5 - SF7BW125 to SF12BW125
885 -)))
886 886  
887 -(((
888 -
889 -)))
890 890  
891 -(((
892 892  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
893 -)))
894 894  
895 -(((
896 896  922.1 - SF7BW125 to SF12BW125
897 -)))
898 898  
899 -(((
900 900  922.3 - SF7BW125 to SF12BW125
901 -)))
902 902  
903 -(((
904 904  922.5 - SF7BW125 to SF12BW125
905 -)))
906 906  
907 -(((
908 908  922.7 - SF7BW125 to SF12BW125
909 -)))
910 910  
911 -(((
912 912  922.9 - SF7BW125 to SF12BW125
913 -)))
914 914  
915 -(((
916 916  923.1 - SF7BW125 to SF12BW125
917 -)))
918 918  
919 -(((
920 920  923.3 - SF7BW125 to SF12BW125
921 -)))
922 922  
923 -(((
924 -
925 -)))
926 926  
927 -(((
928 928  (% style="color:blue" %)**Downlink:**
929 -)))
930 930  
931 -(((
932 932  Uplink channels 1-7(RX1)
933 -)))
934 934  
935 -(((
936 936  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
937 -)))
938 938  
939 939  
940 940  
941 941  === 2.8.7 IN865-867 (IN865) ===
942 942  
943 -(((
944 944  (% style="color:blue" %)**Uplink:**
945 -)))
946 946  
947 -(((
948 948  865.0625 - SF7BW125 to SF12BW125
949 -)))
950 950  
951 -(((
952 952  865.4025 - SF7BW125 to SF12BW125
953 -)))
954 954  
955 -(((
956 956  865.9850 - SF7BW125 to SF12BW125
957 -)))
958 958  
959 -(((
960 -
961 -)))
962 962  
963 -(((
964 964  (% style="color:blue" %)**Downlink:**
965 -)))
966 966  
967 -(((
968 968  Uplink channels 1-3 (RX1)
969 -)))
970 970  
971 -(((
972 972  866.550 - SF10BW125 (RX2)
973 -)))
974 974  
975 975  
976 976  
... ... @@ -982,8 +982,6 @@
982 982  * Blink once when device transmit a packet.
983 983  
984 984  
985 -
986 -
987 987  == 2.10 ​Firmware Change Log ==
988 988  
989 989  
... ... @@ -998,51 +998,26 @@
998 998  
999 999  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
1000 1000  
1001 -(((
1002 1002  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
1003 -)))
1004 1004  
1005 -* (((
1006 -AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
1007 -)))
1008 -* (((
1009 -LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
1010 -)))
894 +* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
895 +* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
1011 1011  
1012 -(((
1013 1013  There are two kinds of commands to configure LSPH01, they are:
1014 -)))
1015 1015  
1016 -* (((
1017 -(% style="color:#4f81bd" %)** General Commands**.
1018 -)))
899 +* (% style="color:#4f81bd" %)** General Commands**.
1019 1019  
1020 -(((
1021 1021  These commands are to configure:
1022 -)))
1023 1023  
1024 -* (((
1025 -General system settings like: uplink interval.
1026 -)))
1027 -* (((
1028 -LoRaWAN protocol & radio related command.
1029 -)))
903 +* General system settings like: uplink interval.
904 +* LoRaWAN protocol & radio related command.
1030 1030  
1031 -(((
1032 1032  They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:[[End Device AT Commands and Downlink Command>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
1033 -)))
1034 1034  
1035 -(((
1036 -
1037 -)))
1038 1038  
1039 -* (((
1040 -(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1041 -)))
909 +* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1042 1042  
1043 -(((
1044 1044  These commands only valid for LSPH01, as below:
1045 -)))
1046 1046  
1047 1047  
1048 1048  
... ... @@ -1056,27 +1056,16 @@
1056 1056  
1057 1057  
1058 1058  
1059 -(((
1060 1060  (% style="color:#037691" %)**Downlink Command: 0x01**
1061 -)))
1062 1062  
1063 -(((
1064 1064  Format: Command Code (0x01) followed by 3 bytes time value.
1065 -)))
1066 1066  
1067 -(((
1068 1068  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1069 -)))
1070 1070  
1071 -* (((
1072 -Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1073 -)))
1074 -* (((
1075 -Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
931 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
932 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1076 1076  
1077 1077  
1078 -
1079 -)))
1080 1080  
1081 1081  == 3.2 Set Interrupt Mode ==
1082 1082  
... ... @@ -1084,37 +1084,21 @@
1084 1084  
1085 1085  (% style="color:#037691" %)**AT Command: AT+INTMOD**
1086 1086  
1087 -[[image:image-20220610105907-1.png]]
942 +[[image:image-20220607171716-9.png]]
1088 1088  
1089 1089  
1090 -(((
1091 1091  (% style="color:#037691" %)**Downlink Command: 0x06**
1092 -)))
1093 1093  
1094 -(((
1095 1095  Format: Command Code (0x06) followed by 3 bytes.
1096 -)))
1097 1097  
1098 -(((
1099 1099  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1100 -)))
1101 1101  
1102 -* (((
1103 -Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1104 -)))
1105 -* (((
1106 -Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1107 -)))
951 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
952 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1108 1108  
1109 -(((
1110 -
1111 -)))
1112 -
1113 -
1114 -
1115 1115  == 3.3 Calibrate Sensor ==
1116 1116  
1117 -Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
956 +Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
1118 1118  
1119 1119  
1120 1120  
... ... @@ -1146,7 +1146,7 @@
1146 1146  
1147 1147  Version
1148 1148  )))|Sensor Type|Reserve|(((
1149 -[[Message Type>>||anchor="H2.3.6MessageType"]]
988 +[[Message Type>>path:#H2.3.6MessageType]]
1150 1150  Always 0x02
1151 1151  )))
1152 1152  
... ... @@ -1286,13 +1286,9 @@
1286 1286  
1287 1287  === ​4.3.2 Replace the battery ===
1288 1288  
1289 -(((
1290 1290  You can change the battery in the LSPH01.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won’t be voltage drop between battery and main board.
1291 -)))
1292 1292  
1293 -(((
1294 1294  The default battery pack of LSPH01 includes a ER26500 plus super capacitor. If user can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes)
1295 -)))
1296 1296  
1297 1297  
1298 1298  
... ... @@ -1313,24 +1313,24 @@
1313 1313  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1314 1314  
1315 1315  
1316 -(((
1317 1317  In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
1318 -)))
1319 1319  
1320 1320  
1321 1321   [[image:1654593712276-618.png]]
1322 1322  
1323 -Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1156 +Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].
1324 1324  
1325 1325  
1159 +
1326 1326  = 6. FAQ =
1327 1327  
1328 1328  == 6.1 How to change the LoRa Frequency Bands/Region ==
1329 1329  
1330 -You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1164 +You can follow the instructions for [[how to upgrade image>>path:#H2.10200BFirmwareChangeLog]].
1331 1331  When downloading the images, choose the required image file for download. ​
1332 1332  
1333 1333  
1168 +
1334 1334  = 7. Trouble Shooting =
1335 1335  
1336 1336  == 7.1 AT Commands input doesn’t work ==
image-20220610105907-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -15.5 KB
Content