<
From version < 5.1 >
edited by Xiaoling
on 2022/06/07 13:41
To version < 23.5 >
edited by Xiaoling
on 2022/06/07 14:40
>
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 ==
... ... @@ -51,7 +51,6 @@
51 51  * 8500mAh Battery for long term use
52 52  
53 53  
54 -
55 55  == 1.3 Probe Specification ==
56 56  
57 57  
... ... @@ -80,132 +80,120 @@
80 80  
81 81  == 1.5 Pin mapping and power on ==
82 82  
83 -[[image:1654580428909-307.png]]
87 +[[image:1654580482666-473.png]]
84 84  
85 85  
86 86  
91 += 2. Configure LSPH01 to connect to LoRaWAN network =
87 87  
93 +== 2.1 How it works ==
88 88  
89 -1. Configure LSPH01 to connect to LoRaWAN network
90 -11. How it works
91 -
95 +(((
92 92  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.
97 +)))
93 93  
99 +(((
100 +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.
101 +)))
94 94  
95 -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.
96 96  
104 +== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
97 97  
98 -1.
99 -11. ​Quick guide to connect to LoRaWAN server (OTAA)
100 -
106 +(((
101 101  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.
108 +)))
102 102  
110 +(((
111 +
112 +)))
103 103  
104 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
105 -
106 -
114 +(((
107 107  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.
116 +)))
108 108  
118 +(((
119 +(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LSPH01.
120 +)))
109 109  
110 -**Step 1**: Create a device in TTN with the OTAA keys from LSPH01.
111 -
122 +(((
112 112  Each LSPH01 is shipped with a sticker with the default device EUI as below:
124 +)))
113 113  
114 114  
115 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
127 +[[image:image-20220607135531-1.jpeg]]
116 116  
117 117  
118 -
119 -
120 -
121 121  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
122 122  
123 123  
124 124  **Register the device**
125 125  
126 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
135 +[[image:1654581442672-605.png]]
127 127  
128 128  
138 +
129 129  **Add APP EUI and DEV EUI**
130 130  
141 +[[image:1654581465717-368.png]]
131 131  
132 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
133 133  
134 134  
135 135  **Add APP EUI in the application**
136 136  
147 +[[image:1654581493871-516.png]]
137 137  
138 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
139 139  
140 140  
141 141  **Add APP KEY**
142 142  
143 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
153 +[[image:1654581517630-991.png]]
144 144  
145 145  
146 -**Step 2**: Power on LSPH01
156 +(% style="color:blue" %)**Step 2**(%%): Power on LSPH01
147 147  
148 148  
149 149  Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
150 150  
161 +[[image:image-20220607135918-2.png]]
151 151  
152 152  
153 -|(((
154 -
155 -)))
164 +(% 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.
156 156  
157 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
166 +[[image:1654581590132-631.png]]
158 158  
159 159  
160 160  
170 +== 2.3 ​Uplink Payload ==
161 161  
162 -**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.
163 -
164 -
165 -
166 -
167 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
168 -
169 -
170 -
171 -1.
172 -11. ​Uplink Payload
173 -
174 174  LSPH01 will uplink payload via LoRaWAN with below payload format: 
175 175  
176 -
177 177  Uplink payload includes in total 11 bytes.
178 -
179 179  
180 180  Normal uplink payload:
181 181  
178 +(% 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>>path:#bat]]|(((
188 -[[Temperature>>path:#DS18B20]]
184 +|**Value**|[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(((
185 +[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
189 189  
190 -[[( Optional )>>path:#DS18B20]]
191 -)))|[[Soil pH>>path:#Soil_Nitrogen]]|[[Soil Temperature>>path:#Soil_Phosphorus]]|(((
192 -[[Digital Interrupt>>path:#Int_pin]]
193 -
194 -[[(Optional)>>path:#Int_pin]]
187 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
188 +)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
189 +[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
195 195  )))|Reserve|(((
196 -[[Message>>path:#Message_Type]]
197 -
198 -[[Type>>path:#Message_Type]]
191 +[[Message Type>>||anchor="H2.3.6MessageType"]]
199 199  )))
200 200  
201 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
194 +[[image:1654581735133-458.png]]
202 202  
203 203  
204 204  
205 -1.
206 -11.
207 -111. Battery Info
198 +=== 2.3.1 Battery Info ===
208 208  
200 +
209 209  Check the battery voltage for LSPH01.
210 210  
211 211  Ex1: 0x0B45 = 2885mV
... ... @@ -213,13 +213,12 @@
213 213  Ex2: 0x0B49 = 2889mV
214 214  
215 215  
216 -1.
217 -11.
218 -111. DS18B20 Temperature sensor
219 219  
220 -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.
209 +=== 2.3.2 DS18B20 Temperature sensor ===
221 221  
211 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
222 222  
213 +
223 223  **Example**:
224 224  
225 225  If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
... ... @@ -228,40 +228,35 @@
228 228  
229 229  
230 230  
231 -1.
232 -11.
233 -111. Soil pH
222 +=== 2.3.3 Soil pH ===
234 234  
235 235  Range: 0 ~~ 14 pH
236 236  
237 -Example:
226 +**Example:**
238 238  
239 -**0x02B7(H) = 695(D) = 6.95pH**
228 +(% style="color:#037691" %)** 0x02B7(H) = 695(D) = 6.95pH**
240 240  
241 241  
242 -1.
243 -11.
244 -111. Soil Temperature
245 245  
232 +=== 2.3.4 Soil Temperature ===
233 +
246 246  Get Soil Temperature 
247 247  
248 248  
249 249  **Example**:
250 250  
251 -If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
239 +If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
252 252  
253 -If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
241 +If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
254 254  
255 255  
256 256  
257 -1.
258 -11.
259 -111. Interrupt Pin
245 +=== 2.3.5 Interrupt Pin ===
260 260  
261 -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.
247 +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 262  
263 263  
264 -Example:
250 +**Example:**
265 265  
266 266  0x00: Normal uplink packet.
267 267  
... ... @@ -268,91 +268,91 @@
268 268  0x01: Interrupt Uplink Packet.
269 269  
270 270  
271 -1.
272 -11.
273 -111. Message Type
274 274  
258 +=== 2.3.6 Message Type ===
259 +
275 275  For a normal uplink payload, the message type is always 0x01.
276 276  
277 277  Valid Message Type:
278 278  
279 279  
280 -|Message Type Code|Description|Payload
281 -|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#Normal_Uplink]]
282 -|0x02|Reply configures info|[[Configure Info Payload>>path:#Configure_Info_Payload]]
283 -|0x03|Reply Calibration Info|[[Calibration Payload>>path:#Calibration_Payload]]
265 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
266 +|**Message Type Code**|**Description**|**Payload**
267 +|0x01|Normal Uplink|[[Normal Uplink Payload>>||anchor="H2.3Uplink Payload"]]
268 +|0x02|Reply configures info|[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
269 +|0x03|Reply Calibration Info|[[Calibration Payload>>||anchor="H2.7Calibration"]]
284 284  
285 -1.
286 -11.
287 -111. ​Decode payload in The Things Network
288 288  
272 +=== 2.3.7 Decode payload in The Things Network ===
273 +
289 289  While using TTN network, you can add the payload format to decode the payload.
290 290  
291 291  
292 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
277 +[[image:1654582541848-906.png]]
293 293  
279 +(((
294 294  The payload decoder function for TTN is here:
281 +)))
295 295  
283 +(((
296 296  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/]]
285 +)))
297 297  
298 298  
299 -1.
300 -11. Uplink Interval
301 301  
302 -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:
289 +== 2.4 Uplink Interval ==
303 303  
304 -[[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]]
291 +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 305  
306 306  
307 307  
308 -1.
309 -11. ​Show Data in DataCake IoT Server
295 +== 2.5 ​Show Data in DataCake IoT Server ==
310 310  
311 311  [[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:
312 312  
313 313  
314 -**Step 1**: Be sure that your device is programmed and properly connected to the network at this time.
300 +(% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
315 315  
316 -**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:
302 +(% 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:**
317 317  
318 318  
319 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
305 +[[image:1654583683416-869.png]]
320 320  
321 321  
322 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
308 +[[image:1654583694084-878.png]]
323 323  
324 324  
325 -Step 3: Create an account or log in Datacake.
311 +(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
326 326  
327 -Step 4: Create LSPH01 product.
313 +(% style="color:blue" %)**Step 4**(%%)**: Create LSPH01 product.**
328 328  
329 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
315 +[[image:1654583711590-413.png]]
330 330  
331 331  
332 332  
333 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
319 +[[image:1654583732798-193.png]]
334 334  
335 335  
336 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
322 +[[image:1654583749683-259.png]]
337 337  
338 338  
339 -Step 5: add payload decode
325 +(% style="color:blue" %)**Step 5**(%%)**: add payload decode**
340 340  
341 341  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/]]
342 342  
343 343  
344 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
330 +[[image:1654583770974-935.png]]
345 345  
346 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
332 +[[image:1654583781517-146.png]]
347 347  
348 348  
349 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
335 +[[image:1654583791351-557.png]]
350 350  
351 351  
352 352  After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
353 353  
354 354  
355 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
341 +[[image:1654583805491-713.png]]
356 356  
357 357  
358 358  
... ... @@ -404,7 +404,6 @@
404 404  1111. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
405 405  1111. The probe is IP68 can be put in water.
406 406  
407 -
408 408  1.
409 409  11. Calibration
410 410  
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
image-20220607135531-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +16.5 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