Last modified by Mengting Qiu on 2025/02/26 15:04
<
From version < 15.1 >
edited by Xiaoling
on 2022/06/07 14:34
To version < 5.3 >
edited by Xiaoling
on 2022/06/07 13:44
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,9 +5,7 @@
5 5  
6 6  
7 7  
8 -**Contents:**
9 9  
10 -{{toc/}}
11 11  
12 12  
13 13  
... ... @@ -17,9 +17,6 @@
17 17  
18 18  
19 19  
20 -
21 -
22 -
23 23  = 1. Introduction =
24 24  
25 25  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
... ... @@ -78,22 +78,20 @@
78 78  * Length: 3.5 meters
79 79  
80 80  
81 -
82 82  == 1.4 ​Applications ==
83 83  
84 84  * Smart Agriculture
85 85  
86 86  
87 -
88 88  == 1.5 Pin mapping and power on ==
89 89  
90 -[[image:1654580482666-473.png]]
83 +[[image:1654580482666-473.png]][[image:1654580428909-307.png]]
91 91  
92 92  
93 93  
94 94  = 2. Configure LSPH01 to connect to LoRaWAN network =
95 95  
96 -== 2.1 How it works ==
89 +== 2.1 How it works ==
97 97  
98 98  (((
99 99  The LSPH01 is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and power on the LSPH01. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
... ... @@ -100,60 +100,55 @@
100 100  )))
101 101  
102 102  (((
103 -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.200BUseATCommand"]]to set the keys in the LSPH01.
96 +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:#_​Using_the_AT]]to set the keys in the LSPH01.
104 104  )))
105 105  
106 106  
107 107  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
108 108  
109 -(((
110 110  Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LG308>>url:http://www.dragino.com/products/lora/item/140-lg308.html]] as a LoRaWAN gateway in this example.
111 -)))
112 112  
113 -(((
114 -
115 -)))
116 116  
117 -(((
105 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
106 +
107 +
118 118  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.
119 -)))
120 120  
121 -(((
110 +
122 122  **Step 1**: Create a device in TTN with the OTAA keys from LSPH01.
123 -)))
124 124  
125 -(((
126 126  Each LSPH01 is shipped with a sticker with the default device EUI as below:
127 -)))
128 128  
129 129  
130 -[[image:image-20220607135531-1.jpeg]]
116 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
131 131  
132 132  
119 +
120 +
121 +
133 133  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
134 134  
135 135  
136 136  **Register the device**
137 137  
138 -[[image:1654581442672-605.png]]
127 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
139 139  
140 140  
141 -
142 142  **Add APP EUI and DEV EUI**
143 143  
144 -[[image:1654581465717-368.png]]
145 145  
133 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
146 146  
147 147  
148 148  **Add APP EUI in the application**
149 149  
150 -[[image:1654581493871-516.png]]
151 151  
139 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
152 152  
153 153  
154 154  **Add APP KEY**
155 155  
156 -[[image:1654581517630-991.png]]
144 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
157 157  
158 158  
159 159  **Step 2**: Power on LSPH01
... ... @@ -161,46 +161,64 @@
161 161  
162 162  Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
163 163  
164 -[[image:image-20220607135918-2.png]]
165 165  
166 166  
154 +|(((
155 +
156 +)))
157 +
158 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
159 +
160 +
161 +
162 +
167 167  **Step 3:** The LSPH01 will auto join to the TTN network. After join success, it will start to upload messages to TTN and you can see the messages in the panel.
168 168  
169 -[[image:1654581590132-631.png]]
170 170  
171 171  
172 172  
173 -== 2.3 ​Uplink Payload ==
168 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
174 174  
170 +
171 +
172 +1.
173 +11. ​Uplink Payload
174 +
175 175  LSPH01 will uplink payload via LoRaWAN with below payload format: 
176 176  
177 +
177 177  Uplink payload includes in total 11 bytes.
179 +
178 178  
179 179  Normal uplink payload:
180 180  
181 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
182 182  |(((
183 183  **Size**
184 184  
185 185  **(bytes)**
186 186  )))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
187 -|**Value**|[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(((
188 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
188 +|**Value**|[[BAT>>path:#bat]]|(((
189 +[[Temperature>>path:#DS18B20]]
189 189  
190 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
191 -)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
192 -[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
191 +[[( Optional )>>path:#DS18B20]]
192 +)))|[[Soil pH>>path:#Soil_Nitrogen]]|[[Soil Temperature>>path:#Soil_Phosphorus]]|(((
193 +[[Digital Interrupt>>path:#Int_pin]]
194 +
195 +[[(Optional)>>path:#Int_pin]]
193 193  )))|Reserve|(((
194 -[[Message Type>>||anchor="H2.3.6MessageType"]]
197 +[[Message>>path:#Message_Type]]
198 +
199 +[[Type>>path:#Message_Type]]
195 195  )))
196 196  
197 -[[image:1654581735133-458.png]]
202 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
198 198  
199 199  
200 200  
201 -=== 2.3.1 Battery Info ===
206 +1.
207 +11.
208 +111. Battery Info
202 202  
203 -
204 204  Check the battery voltage for LSPH01.
205 205  
206 206  Ex1: 0x0B45 = 2885mV
... ... @@ -208,12 +208,13 @@
208 208  Ex2: 0x0B49 = 2889mV
209 209  
210 210  
217 +1.
218 +11.
219 +111. DS18B20 Temperature sensor
211 211  
212 -=== 2.3.2 DS18B20 Temperature sensor ===
221 +This is optional, user can connect external DS18B20 sensor to the [[+3.3v, 1-wire and GND pin>>path:#DS18B20]] . and this field will report temperature.
213 213  
214 -This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
215 215  
216 -
217 217  **Example**:
218 218  
219 219  If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
... ... @@ -222,35 +222,40 @@
222 222  
223 223  
224 224  
225 -=== 2.3.3 Soil pH ===
232 +1.
233 +11.
234 +111. Soil pH
226 226  
227 227  Range: 0 ~~ 14 pH
228 228  
229 -**Example:**
238 +Example:
230 230  
231 -(% style="color:#037691" %)** 0x02B7(H) = 695(D) = 6.95pH**
240 +**0x02B7(H) = 695(D) = 6.95pH**
232 232  
233 233  
243 +1.
244 +11.
245 +111. Soil Temperature
234 234  
235 -=== 2.3.4 Soil Temperature ===
236 -
237 237  Get Soil Temperature 
238 238  
239 239  
240 240  **Example**:
241 241  
242 -If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
252 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
243 243  
244 -If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
254 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
245 245  
246 246  
247 247  
248 -=== 2.3.5 Interrupt Pin ===
258 +1.
259 +11.
260 +111. Interrupt Pin
249 249  
250 -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.
262 +This data field shows if this packet is generated by interrupt or not. [[Click here>>path:#Int_mod]] for the hardware and software set up.
251 251  
252 252  
253 -**Example:**
265 +Example:
254 254  
255 255  0x00: Normal uplink packet.
256 256  
... ... @@ -257,47 +257,44 @@
257 257  0x01: Interrupt Uplink Packet.
258 258  
259 259  
272 +1.
273 +11.
274 +111. Message Type
260 260  
261 -=== 2.3.6 Message Type ===
262 -
263 263  For a normal uplink payload, the message type is always 0x01.
264 264  
265 265  Valid Message Type:
266 266  
267 267  
268 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
269 -|**Message Type Code**|**Description**|**Payload**
270 -|0x01|Normal Uplink|[[Normal Uplink Payload>>||anchor="H2.3Uplink Payload"]]
271 -|0x02|Reply configures info|[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
272 -|0x03|Reply Calibration Info|[[Calibration Payload>>||anchor="H2.7Calibration"]]
281 +|Message Type Code|Description|Payload
282 +|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#Normal_Uplink]]
283 +|0x02|Reply configures info|[[Configure Info Payload>>path:#Configure_Info_Payload]]
284 +|0x03|Reply Calibration Info|[[Calibration Payload>>path:#Calibration_Payload]]
273 273  
286 +1.
287 +11.
288 +111. ​Decode payload in The Things Network
274 274  
275 -
276 -=== 2.3.7 Decode payload in The Things Network ===
277 -
278 278  While using TTN network, you can add the payload format to decode the payload.
279 279  
280 280  
281 -[[image:1654582541848-906.png]]
293 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
282 282  
283 -(((
284 284  The payload decoder function for TTN is here:
285 -)))
286 286  
287 -(((
288 288  LSPH01 TTN Payload Decoder: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSNPK01/Decoder/]]
289 -)))
290 290  
291 291  
300 +1.
301 +11. Uplink Interval
292 292  
293 -== 2.4 Uplink Interval ==
303 +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:
294 294  
295 -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"]]
305 +[[http:~~/~~/wiki.dragino.com/index.pHp?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval]]
296 296  
297 297  
298 298  
299 -
300 -1.
309 +1.
301 301  11. ​Show Data in DataCake IoT Server
302 302  
303 303  [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
... ... @@ -357,8 +357,8 @@
357 357  If the LSPH01 has more than 7 days not use or just clean the pH probe. User should put the probe inside pure water for more than 24 hours for activation. If no put in water, user need to put inside soil for more than 24 hours to ensure the measurement accuracy. 
358 358  
359 359  
360 -1.
361 -11.
369 +1.
370 +11.
362 362  111. Measurement
363 363  
364 364  **Measurement the soil surface**
... ... @@ -386,8 +386,8 @@
386 386  Insert the probe inside, method like measure the surface.
387 387  
388 388  
389 -1.
390 -11.
398 +1.
399 +11.
391 391  111. Maintain Probe
392 392  1111. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
393 393  1111. After long time use (3~~ 6  months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it.
... ... @@ -396,7 +396,8 @@
396 396  1111. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
397 397  1111. The probe is IP68 can be put in water.
398 398  
399 -1.
408 +
409 +1.
400 400  11. Calibration
401 401  
402 402  User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable).
... ... @@ -467,13 +467,13 @@
467 467  * Reply to the confirmation package: 14 01
468 468  * Reply to non-confirmed packet: 14 00
469 469  
470 -1.
480 +1.
471 471  11. Frequency Plans
472 472  
473 473  The LSPH01 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.
474 474  
475 -1.
476 -11.
485 +1.
486 +11.
477 477  111. EU863-870 (EU868)
478 478  
479 479  Uplink:
... ... @@ -504,8 +504,8 @@
504 504  869.525 - SF9BW125 (RX2 downlink only)
505 505  
506 506  
507 -1.
508 -11.
517 +1.
518 +11.
509 509  111. US902-928(US915)
510 510  
511 511  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
... ... @@ -519,8 +519,8 @@
519 519  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
520 520  * 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)
521 521  
522 -1.
523 -11.
532 +1.
533 +11.
524 524  111. CN470-510 (CN470)
525 525  
526 526  Used in China, Default use CHE=1
... ... @@ -565,8 +565,8 @@
565 565  505.3 - SF12BW125 (RX2 downlink only)
566 566  
567 567  
568 -1.
569 -11.
578 +1.
579 +11.
570 570  111. AU915-928(AU915)
571 571  
572 572  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
... ... @@ -580,8 +580,8 @@
580 580  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
581 581  * 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)
582 582  
583 -1.
584 -11.
593 +1.
594 +11.
585 585  111. AS920-923 & AS923-925 (AS923)
586 586  
587 587  **Default Uplink channel:**
... ... @@ -633,8 +633,8 @@
633 633  923.2 - SF10BW125 (RX2)
634 634  
635 635  
636 -1.
637 -11.
646 +1.
647 +11.
638 638  111. KR920-923 (KR920)
639 639  
640 640  Default channel:
... ... @@ -670,8 +670,8 @@
670 670  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
671 671  
672 672  
673 -1.
674 -11.
683 +1.
684 +11.
675 675  111. IN865-867 (IN865)
676 676  
677 677  Uplink:
... ... @@ -690,7 +690,7 @@
690 690  866.550 - SF10BW125 (RX2)
691 691  
692 692  
693 -1.
703 +1.
694 694  11. LED Indicator
695 695  
696 696  The LSPH01 has an internal LED which is to show the status of different state.
... ... @@ -699,7 +699,7 @@
699 699  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
700 700  * Blink once when device transmit a packet.
701 701  
702 -1.
712 +1.
703 703  11. ​Firmware Change Log
704 704  
705 705  **Firmware download link:**
... ... @@ -745,7 +745,7 @@
745 745  These commands only valid for LSPH01, as below:
746 746  
747 747  
748 -1.
758 +1.
749 749  11. Set Transmit Interval Time
750 750  
751 751  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -775,7 +775,7 @@
775 775  * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
776 776  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
777 777  
778 -1.
788 +1.
779 779  11. Set Interrupt Mode
780 780  
781 781  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -808,7 +808,7 @@
808 808  * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
809 809  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
810 810  
811 -1.
821 +1.
812 812  11. Calibrate Sensor
813 813  
814 814  Detail See [[Calibration Guide>>path:#Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -815,7 +815,7 @@
815 815  
816 816  
817 817  
818 -1.
828 +1.
819 819  11. Get Firmware Version Info
820 820  
821 821  Feature: use downlink to get firmware version.
... ... @@ -924,7 +924,7 @@
924 924  LSPH01:  2.45v ~~ 3.6v
925 925  
926 926  
927 -1.
937 +1.
928 928  11. Replace Battery
929 929  
930 930  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
... ... @@ -933,7 +933,7 @@
933 933  
934 934  
935 935  
936 -1.
946 +1.
937 937  11. Power Consumption Analyze
938 938  
939 939  Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
... ... @@ -973,14 +973,14 @@
973 973  
974 974  
975 975  1.
976 -11.
986 +11.
977 977  111. ​Battery Note
978 978  
979 979  The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
980 980  
981 981  
982 -1.
983 -11.
992 +1.
993 +11.
984 984  111. ​Replace the battery
985 985  
986 986  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.
1654581442672-605.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -59.6 KB
Content
1654581465717-368.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -62.1 KB
Content
1654581493871-516.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -83.1 KB
Content
1654581517630-991.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -65.2 KB
Content
1654581590132-631.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -42.6 KB
Content
1654581735133-458.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -42.6 KB
Content
1654582541848-906.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -59.2 KB
Content
1654583683416-869.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -62.2 KB
Content
image-20220607135531-1.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -16.5 KB
Content
image-20220607135918-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -99.6 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0