<
From version < 6.2 >
edited by Xiaoling
on 2022/06/07 13:55
To version < 24.2 >
edited by Xiaoling
on 2022/06/07 14:46
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,7 +5,9 @@
5 5  
6 6  
7 7  
8 +**Contents:**
8 8  
10 +{{toc/}}
9 9  
10 10  
11 11  
... ... @@ -15,6 +15,9 @@
15 15  
16 16  
17 17  
20 +
21 +
22 +
18 18  = 1. Introduction =
19 19  
20 20  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
... ... @@ -50,7 +50,6 @@
50 50  * IP68 rate for the Sensor Probe
51 51  * 8500mAh Battery for long term use
52 52  
53 -
54 54  == 1.3 Probe Specification ==
55 55  
56 56  
... ... @@ -71,13 +71,10 @@
71 71  * IP68 Protection
72 72  * Length: 3.5 meters
73 73  
74 -
75 -
76 76  == 1.4 ​Applications ==
77 77  
78 78  * Smart Agriculture
79 79  
80 -
81 81  == 1.5 Pin mapping and power on ==
82 82  
83 83  [[image:1654580482666-473.png]]
... ... @@ -99,114 +99,101 @@
99 99  
100 100  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
101 101  
103 +(((
102 102  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.
105 +)))
103 103  
107 +(((
108 +
109 +)))
104 104  
105 -[[image:image-20220607135531-1.jpeg]]
106 -
107 -
111 +(((
108 108  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.
113 +)))
109 109  
115 +(((
116 +(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LSPH01.
117 +)))
110 110  
111 -**Step 1**: Create a device in TTN with the OTAA keys from LSPH01.
112 -
119 +(((
113 113  Each LSPH01 is shipped with a sticker with the default device EUI as below:
121 +)))
114 114  
115 115  
116 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
124 +[[image:image-20220607135531-1.jpeg]]
117 117  
118 118  
119 -
120 -
121 -
122 122  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
123 123  
124 124  
125 125  **Register the device**
126 126  
127 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
132 +[[image:1654581442672-605.png]]
128 128  
129 129  
135 +
130 130  **Add APP EUI and DEV EUI**
131 131  
138 +[[image:1654581465717-368.png]]
132 132  
133 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
134 134  
135 135  
136 136  **Add APP EUI in the application**
137 137  
144 +[[image:1654581493871-516.png]]
138 138  
139 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
140 140  
141 141  
142 142  **Add APP KEY**
143 143  
144 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
150 +[[image:1654581517630-991.png]]
145 145  
146 146  
147 -**Step 2**: Power on LSPH01
153 +(% style="color:blue" %)**Step 2**(%%): Power on LSPH01
148 148  
149 149  
150 150  Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
151 151  
158 +[[image:image-20220607135918-2.png]]
152 152  
153 153  
154 -|(((
155 -
156 -)))
161 +(% style="color:blue" %)**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.
157 157  
158 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
163 +[[image:1654581590132-631.png]]
159 159  
160 160  
161 161  
167 +== 2.3 ​Uplink Payload ==
162 162  
163 -**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.
164 -
165 -
166 -
167 -
168 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
169 -
170 -
171 -
172 -1.
173 -11. ​Uplink Payload
174 -
175 175  LSPH01 will uplink payload via LoRaWAN with below payload format: 
176 176  
177 -
178 178  Uplink payload includes in total 11 bytes.
179 -
180 180  
181 181  Normal uplink payload:
182 182  
175 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
183 183  |(((
184 184  **Size**
185 185  
186 186  **(bytes)**
187 187  )))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
188 -|**Value**|[[BAT>>path:#bat]]|(((
189 -[[Temperature>>path:#DS18B20]]
181 +|**Value**|[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(((
182 +[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
190 190  
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]]
184 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
185 +)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
186 +[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
196 196  )))|Reserve|(((
197 -[[Message>>path:#Message_Type]]
198 -
199 -[[Type>>path:#Message_Type]]
188 +[[Message Type>>||anchor="H2.3.6MessageType"]]
200 200  )))
201 201  
202 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
191 +[[image:1654581735133-458.png]]
203 203  
204 204  
205 205  
206 -1.
207 -11.
208 -111. Battery Info
195 +=== 2.3.1 Battery Info ===
209 209  
197 +
210 210  Check the battery voltage for LSPH01.
211 211  
212 212  Ex1: 0x0B45 = 2885mV
... ... @@ -214,13 +214,12 @@
214 214  Ex2: 0x0B49 = 2889mV
215 215  
216 216  
217 -1.
218 -11.
219 -111. DS18B20 Temperature sensor
220 220  
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.
206 +=== 2.3.2 DS18B20 Temperature sensor ===
222 222  
208 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
223 223  
210 +
224 224  **Example**:
225 225  
226 226  If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
... ... @@ -229,40 +229,35 @@
229 229  
230 230  
231 231  
232 -1.
233 -11.
234 -111. Soil pH
219 +=== 2.3.3 Soil pH ===
235 235  
236 236  Range: 0 ~~ 14 pH
237 237  
238 -Example:
223 +**Example:**
239 239  
240 -**0x02B7(H) = 695(D) = 6.95pH**
225 +(% style="color:#037691" %)** 0x02B7(H) = 695(D) = 6.95pH**
241 241  
242 242  
243 -1.
244 -11.
245 -111. Soil Temperature
246 246  
229 +=== 2.3.4 Soil Temperature ===
230 +
247 247  Get Soil Temperature 
248 248  
249 249  
250 250  **Example**:
251 251  
252 -If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
236 +If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
253 253  
254 -If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
238 +If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
255 255  
256 256  
257 257  
258 -1.
259 -11.
260 -111. Interrupt Pin
242 +=== 2.3.5 Interrupt Pin ===
261 261  
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.
244 +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.
263 263  
264 264  
265 -Example:
247 +**Example:**
266 266  
267 267  0x00: Normal uplink packet.
268 268  
... ... @@ -269,145 +269,154 @@
269 269  0x01: Interrupt Uplink Packet.
270 270  
271 271  
272 -1.
273 -11.
274 -111. Message Type
275 275  
255 +=== 2.3.6 Message Type ===
256 +
276 276  For a normal uplink payload, the message type is always 0x01.
277 277  
278 278  Valid Message Type:
279 279  
280 280  
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]]
262 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
263 +|**Message Type Code**|**Description**|**Payload**
264 +|0x01|Normal Uplink|[[Normal Uplink Payload>>||anchor="H2.3Uplink Payload"]]
265 +|0x02|Reply configures info|[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
266 +|0x03|Reply Calibration Info|[[Calibration Payload>>||anchor="H2.7Calibration"]]
285 285  
286 -1.
287 -11.
288 -111. ​Decode payload in The Things Network
268 +=== 2.3.7 Decode payload in The Things Network ===
289 289  
290 290  While using TTN network, you can add the payload format to decode the payload.
291 291  
292 292  
293 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
273 +[[image:1654582541848-906.png]]
294 294  
275 +(((
295 295  The payload decoder function for TTN is here:
277 +)))
296 296  
279 +(((
297 297  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/]]
281 +)))
298 298  
299 299  
300 -1.
301 -11. Uplink Interval
302 302  
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:
285 +== 2.4 Uplink Interval ==
304 304  
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]]
287 +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"]]
306 306  
307 307  
308 308  
309 -1.
310 -11. ​Show Data in DataCake IoT Server
291 +== 2.5 ​Show Data in DataCake IoT Server ==
311 311  
312 312  [[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:
313 313  
314 314  
315 -**Step 1**: Be sure that your device is programmed and properly connected to the network at this time.
296 +(% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
316 316  
317 -**Step 2**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:
298 +(% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**
318 318  
319 319  
320 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
301 +[[image:1654583683416-869.png]]
321 321  
322 322  
323 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
304 +[[image:1654583694084-878.png]]
324 324  
325 325  
326 -Step 3: Create an account or log in Datacake.
307 +(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
327 327  
328 -Step 4: Create LSPH01 product.
309 +(% style="color:blue" %)**Step 4**(%%)**: Create LSPH01 product.**
329 329  
330 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
311 +[[image:1654583711590-413.png]]
331 331  
332 332  
333 333  
334 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
315 +[[image:1654583732798-193.png]]
335 335  
336 336  
337 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
318 +[[image:1654583749683-259.png]]
338 338  
339 339  
340 -Step 5: add payload decode
321 +(% style="color:blue" %)**Step 5**(%%)**: add payload decode**
341 341  
342 342  Download Datacake decoder from: [[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/]]
343 343  
344 344  
345 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
326 +[[image:1654583770974-935.png]]
346 346  
347 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
328 +[[image:1654583781517-146.png]]
348 348  
349 349  
350 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
331 +[[image:1654583791351-557.png]]
351 351  
352 352  
353 353  After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
354 354  
355 355  
356 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
337 +[[image:1654583805491-713.png]]
357 357  
358 358  
359 359  
360 360  
361 361  
362 -1.
363 -11. Installation and Maintain
364 -111. Before measurement
343 +== 2.6 Installation and Maintain ==
365 365  
345 +=== 2.6.1 Before measurement ===
346 +
347 +(((
366 366  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. 
349 +)))
367 367  
368 368  
369 -1.
370 -11.
371 -111. Measurement
372 372  
373 -**Measurement the soil surface**
353 +=== 2.6.2 Measurement ===
374 374  
375 375  
376 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]] Choose the proper measuring position. Split the surface soil according to the measured deep.
356 +(% style="color:#4f81bd" %)**Measurement the soil surface:**
377 377  
358 +[[image:1654584128046-287.png]]
378 378  
360 +Choose the proper measuring position. Split the surface soil according to the measured deep.
361 +
379 379  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
380 380  
381 -
382 382  Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
383 383  
384 -
385 385  Put soil over the probe after insert. And start to measure.
386 386  
387 387  
388 -**Measurement inside soil**
369 +(% style="color:#4f81bd" %)**Measurement inside soil:**
389 389  
371 +Dig a hole with diameter > 20CM.
390 390  
373 +Insert the probe inside, method like measure the surface.
391 391  
392 -Dig a hole with diameter > 20CM.
393 393  
394 394  
395 -Insert the probe inside, method like measure the surface.
377 +=== 2.6.3 Maintain Probe ===
396 396  
379 +1. (((
380 +pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
381 +)))
382 +1. (((
383 +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.
384 +)))
385 +1. (((
386 +Probe reference electrode is also no strong, need to avoid strong force or hitting.
387 +)))
388 +1. (((
389 +User should keep reference electrode wet while not use.
390 +)))
391 +1. (((
392 +Avoid the probes to touch oily matter. Which will cause issue in accuracy.
393 +)))
394 +1. (((
395 +The probe is IP68 can be put in water.
396 +)))
397 397  
398 -1.
399 -11.
400 -111. Maintain Probe
401 -1111. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
402 -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.
403 -1111. Probe reference electrode is also no strong, need to avoid strong force or hitting.
404 -1111. User should keep reference electrode wet while not use.
405 -1111. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
406 -1111. The probe is IP68 can be put in water.
407 407  
408 -1.
409 -11. Calibration
410 410  
400 +2.7 Calibration
401 +
411 411  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).
412 412  
413 413  
1654581442672-605.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +59.6 KB
Content
1654581465717-368.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +62.1 KB
Content
1654581493871-516.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +83.1 KB
Content
1654581517630-991.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +65.2 KB
Content
1654581590132-631.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +42.6 KB
Content
1654581735133-458.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +42.6 KB
Content
1654582541848-906.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +59.2 KB
Content
1654583683416-869.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +62.2 KB
Content
1654583694084-878.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +66.6 KB
Content
1654583711590-413.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +246.2 KB
Content
1654583732798-193.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +199.6 KB
Content
1654583749683-259.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +129.1 KB
Content
1654583770974-935.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +37.7 KB
Content
1654583781517-146.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +64.0 KB
Content
1654583791351-557.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +11.3 KB
Content
1654583805491-713.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +127.1 KB
Content
1654584128046-287.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +345.3 KB
Content
image-20220607135918-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +99.6 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0