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

From version 74.13
edited by Xiaoling
on 2022/06/07 17:52
Change comment: There is no comment for this version
To version 86.13
edited by Xiaoling
on 2022/06/14 14:36
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 -**Contents:**
7 +**Table of Contents:**
8 8  
9 9  * [[1. Introduction>>path:#H1.Introduction]]
10 10  ** [[1.1 ​What is LoRaWAN Soil pH Sensor>>path:#H1.1200BWhatisLoRaWANSoilpHSensor]]
... ... @@ -64,14 +64,13 @@
64 64  
65 65  
66 66  
67 -
68 -
69 -
70 70  = 1. Introduction =
71 71  
72 72  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
73 73  
74 74  (((
72 +
73 +
75 75  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.
76 76  )))
77 77  
... ... @@ -96,6 +96,7 @@
96 96  
97 97  
98 98  
98 +
99 99  == ​1.2 Features ==
100 100  
101 101  * LoRaWAN 1.0.3 Class A
... ... @@ -113,6 +113,8 @@
113 113  * 8500mAh Battery for long term use
114 114  
115 115  
116 +
117 +
116 116  == 1.3 Probe Specification ==
117 117  
118 118  
... ... @@ -125,6 +125,7 @@
125 125  * IP68 Protection
126 126  * Length: 3.5 meters
127 127  
130 +
128 128  (% style="color:#4f81bd" %)**Soil Temperature:**
129 129  
130 130  * Range -40℃~85℃
... ... @@ -134,11 +134,15 @@
134 134  * Length: 3.5 meters
135 135  
136 136  
140 +
141 +
137 137  == 1.4 ​Applications ==
138 138  
139 139  * Smart Agriculture
140 140  
141 141  
147 +
148 +
142 142  == 1.5 Pin mapping and power on ==
143 143  
144 144  [[image:1654592472094-134.png]]
... ... @@ -154,7 +154,7 @@
154 154  )))
155 155  
156 156  (((
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.
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.
158 158  )))
159 159  
160 160  
... ... @@ -166,10 +166,14 @@
166 166  
167 167  (((
168 168  [[image:1654592492399-921.png]]
176 +
177 +
169 169  )))
170 170  
171 171  (((
172 172  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 +
173 173  )))
174 174  
175 175  (((
... ... @@ -193,11 +193,13 @@
193 193  [[image:1654592600093-601.png]]
194 194  
195 195  
207 +
196 196  **Add APP EUI and DEV EUI**
197 197  
198 198  [[image:1654592619856-881.png]]
199 199  
200 200  
213 +
201 201  **Add APP EUI in the application**
202 202  
203 203  [[image:1654592632656-512.png]]
... ... @@ -240,19 +240,17 @@
240 240  )))
241 241  
242 242  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
243 -|(((
244 -**Size**
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"]]
245 245  
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]]
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"]]
254 254  )))|Reserve|(((
255 -[[Message Type>>path:#H2.3.6MessageType]]
266 +[[Message Type>>||anchor="H2.3.6MessageType"]]
256 256  )))
257 257  
258 258  [[image:1654592721645-318.png]]
... ... @@ -308,7 +308,7 @@
308 308  
309 309  === 2.3.5 Interrupt Pin ===
310 310  
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.
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.
312 312  
313 313  
314 314  **Example:**
... ... @@ -330,14 +330,15 @@
330 330  )))
331 331  
332 332  
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]]
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"]]
338 338  
339 339  
340 340  
352 +
341 341  === 2.3.7 Decode payload in The Things Network ===
342 342  
343 343  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -357,7 +357,7 @@
357 357  
358 358  == 2.4 Uplink Interval ==
359 359  
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]]
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"]]
361 361  
362 362  
363 363  
... ... @@ -521,11 +521,9 @@
521 521  (% style="color:#037691" %)**Calibration Payload**
522 522  
523 523  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
524 -|(((
525 -**Size**
526 -
527 -**(bytes)**
528 -)))|**1**|**1**|**1**|**7**|**1**
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**
529 529  |**Value**|(((
530 530  PH4
531 531  
... ... @@ -535,7 +535,7 @@
535 535  
536 536  Calibrate value
537 537  )))|Reserve|(((
538 -[[Message Type>>path:#H2.3.6MessageType]]
548 +[[Message Type>>||anchor="H2.3.6MessageType"]]
539 539  
540 540  Always 0x03
541 541  )))
... ... @@ -636,7 +636,6 @@
636 636  
637 637  
638 638  
639 -
640 640  === 2.8.3 CN470-510 (CN470) ===
641 641  
642 642  (((
... ... @@ -747,6 +747,8 @@
747 747  * 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)
748 748  
749 749  
759 +
760 +
750 750  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
751 751  
752 752  (((
... ... @@ -970,7 +970,6 @@
970 970  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
971 971  * Blink once when device transmit a packet.
972 972  
973 -
974 974  == 2.10 ​Firmware Change Log ==
975 975  
976 976  
... ... @@ -985,26 +985,51 @@
985 985  
986 986  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
987 987  
998 +(((
988 988  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
1000 +)))
989 989  
990 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
991 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
1002 +* (((
1003 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
1004 +)))
1005 +* (((
1006 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
1007 +)))
992 992  
1009 +(((
993 993  There are two kinds of commands to configure LSPH01, they are:
1011 +)))
994 994  
995 -* (% style="color:#4f81bd" %)** General Commands**.
1013 +* (((
1014 +(% style="color:#4f81bd" %)** General Commands**.
1015 +)))
996 996  
1017 +(((
997 997  These commands are to configure:
1019 +)))
998 998  
999 -* General system settings like: uplink interval.
1000 -* LoRaWAN protocol & radio related command.
1021 +* (((
1022 +General system settings like: uplink interval.
1023 +)))
1024 +* (((
1025 +LoRaWAN protocol & radio related command.
1026 +)))
1001 1001  
1028 +(((
1002 1002  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/]]
1030 +)))
1003 1003  
1032 +(((
1033 +
1034 +)))
1004 1004  
1005 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1036 +* (((
1037 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1038 +)))
1006 1006  
1040 +(((
1007 1007  These commands only valid for LSPH01, as below:
1042 +)))
1008 1008  
1009 1009  
1010 1010  
... ... @@ -1018,16 +1018,27 @@
1018 1018  
1019 1019  
1020 1020  
1056 +(((
1021 1021  (% style="color:#037691" %)**Downlink Command: 0x01**
1058 +)))
1022 1022  
1060 +(((
1023 1023  Format: Command Code (0x01) followed by 3 bytes time value.
1062 +)))
1024 1024  
1064 +(((
1025 1025  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1066 +)))
1026 1026  
1027 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1028 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1068 +* (((
1069 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1070 +)))
1071 +* (((
1072 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1029 1029  
1030 1030  
1075 +
1076 +)))
1031 1031  
1032 1032  == 3.2 Set Interrupt Mode ==
1033 1033  
... ... @@ -1035,21 +1035,37 @@
1035 1035  
1036 1036  (% style="color:#037691" %)**AT Command: AT+INTMOD**
1037 1037  
1038 -[[image:image-20220607171716-9.png]]
1084 +[[image:image-20220610105907-1.png]]
1039 1039  
1040 1040  
1087 +(((
1041 1041  (% style="color:#037691" %)**Downlink Command: 0x06**
1089 +)))
1042 1042  
1091 +(((
1043 1043  Format: Command Code (0x06) followed by 3 bytes.
1093 +)))
1044 1044  
1095 +(((
1045 1045  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1097 +)))
1046 1046  
1047 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1048 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1099 +* (((
1100 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1101 +)))
1102 +* (((
1103 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1104 +)))
1049 1049  
1106 +(((
1107 +
1108 +)))
1109 +
1110 +
1111 +
1050 1050  == 3.3 Calibrate Sensor ==
1051 1051  
1052 -Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
1114 +Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1053 1053  
1054 1054  
1055 1055  
... ... @@ -1081,7 +1081,7 @@
1081 1081  
1082 1082  Version
1083 1083  )))|Sensor Type|Reserve|(((
1084 -[[Message Type>>path:#H2.3.6MessageType]]
1146 +[[Message Type>>||anchor="H2.3.6MessageType"]]
1085 1085  Always 0x02
1086 1086  )))
1087 1087  
... ... @@ -1221,9 +1221,13 @@
1221 1221  
1222 1222  === ​4.3.2 Replace the battery ===
1223 1223  
1286 +(((
1224 1224  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.
1288 +)))
1225 1225  
1290 +(((
1226 1226  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)
1292 +)))
1227 1227  
1228 1228  
1229 1229  
... ... @@ -1244,24 +1244,24 @@
1244 1244  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1245 1245  
1246 1246  
1313 +(((
1247 1247  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:
1315 +)))
1248 1248  
1249 1249  
1250 1250   [[image:1654593712276-618.png]]
1251 1251  
1252 -Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].
1320 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1253 1253  
1254 1254  
1255 -
1256 1256  = 6. FAQ =
1257 1257  
1258 1258  == 6.1 How to change the LoRa Frequency Bands/Region ==
1259 1259  
1260 -You can follow the instructions for [[how to upgrade image>>path:#H2.10200BFirmwareChangeLog]].
1327 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1261 1261  When downloading the images, choose the required image file for download. ​
1262 1262  
1263 1263  
1264 -
1265 1265  = 7. Trouble Shooting =
1266 1266  
1267 1267  == 7.1 AT Commands input doesn’t work ==
image-20220610105907-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +15.5 KB
Content