Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 30.1
edited by Xiaoling
on 2023/02/01 09:41
Change comment: Uploaded new attachment "image-20230201094129-18.png", version {1}
To version 8.1
edited by Xiaoling
on 2023/02/01 09:01
Change comment: Uploaded new attachment "image-20230201090139-3.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -16,34 +16,36 @@
16 16  
17 17  
18 18  
19 -= 1. Introduction =
19 +1. Introduction
20 +11. ​What is LoRaWAN Pressure Sensor
20 20  
21 -== 1.1 ​What is SDI-12 to LoRaWAN Converter ==
22 +The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Convert **designed for Smart Agriculture solution.
22 22  
23 23  
24 -The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution.
25 -
26 26  SDI-12 (Serial Digital Interface at 1200 baud) is an asynchronous [[serial communications>>url:https://en.wikipedia.org/wiki/Serial_communication]] protocol for intelligent sensors that monitor environment data. SDI-12 protocol is widely used in Agriculture sensor and Weather Station sensors.
27 27  
27 +
28 28  **SDI-12-LB** has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol.
29 29  
30 +
30 30  The LoRa wireless technology used in **SDI-12-LB** allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
31 31  
33 +
32 32  **SDI-12-LB** is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.
33 33  
36 +
34 34  Each **SDI-12-LB** is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
35 35  
36 36  
37 -[[image:image-20230201084414-1.png||height="464" width="1108"]]
38 38  
41 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
39 39  
40 40  
41 41  
42 42  
43 43  
44 -== ​1.2 Features ==
45 -
46 -
47 +*
48 +*1. ​ Features
47 47  * LoRaWAN 1.0.3 Class A
48 48  * Ultra-low power consumption
49 49  * Controllable 5v and 12v output to power external sensor
... ... @@ -56,8 +56,9 @@
56 56  * Downlink to change configure
57 57  * 8500mAh Battery for long term use
58 58  
59 -== 1.3 Specification ==
60 60  
62 +1.
63 +11. Specification
61 61  
62 62  **Micro Controller:**
63 63  
... ... @@ -77,6 +77,7 @@
77 77  * RX sensitivity: down to -139 dBm.
78 78  * Excellent blocking immunity
79 79  
83 +
80 80  **Current Input Measuring :**
81 81  
82 82  * Range: 0 ~~ 20mA
... ... @@ -83,6 +83,7 @@
83 83  * Accuracy: 0.02mA
84 84  * Resolution: 0.001mA
85 85  
90 +
86 86  **Voltage Input Measuring:**
87 87  
88 88  * Range: 0 ~~ 30v
... ... @@ -89,6 +89,7 @@
89 89  * Accuracy: 0.02v
90 90  * Resolution: 0.001v
91 91  
97 +
92 92  **Battery:**
93 93  
94 94  * Li/SOCI2 un-chargeable battery
... ... @@ -97,57 +97,68 @@
97 97  * Max continuously current: 130mA
98 98  * Max boost current: 2A, 1 second
99 99  
106 +
100 100  **Power Consumption**
101 101  
102 102  * Sleep Mode: 5uA @ 3.3v
103 103  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
104 104  
105 -== 1.4 Connect to SDI-12 Sensor ==
106 106  
113 +1.
114 +11. Connect to SDI-12 Sensor
107 107  
116 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
108 108  
109 -[[image:1675212538524-889.png]]
110 110  
111 111  
112 -== 1.5 Sleep mode and working mode ==
120 +1.
121 +11. Sleep mode and working mode
113 113  
114 114  
115 -**Deep Sleep Mode: **Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
124 +**Deep Sleep Mode: Sensor doesn’t have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.**
116 116  
117 -**Working Mode: **In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
118 118  
127 +**Working Mode: In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.**
119 119  
120 -== 1.6 Button & LEDs ==
121 121  
122 122  
123 -[[image:1675212633011-651.png]]
124 124  
125 125  
133 +1.
134 +11. Button & LEDs
126 126  
127 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
128 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
129 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
130 -If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
137 +
138 +
139 +
140 +|**Behavior on ACT**|**Function**|**Action**
141 +|Pressing ACT between 1s < time < 3s|Send an uplink|(((
142 +If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, **blue led** will blink once.
143 +
131 131  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
132 132  )))
133 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
134 -(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
135 -(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
146 +|Pressing ACT for more than 3s|Active Device|(((
147 +**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network.
148 +
149 +**Green led** will solidly turn on for 5 seconds after joined in network.
150 +
136 136  Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
137 137  )))
138 -|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
153 +|Fast press ACT 5 times.|Deactivate Device|red led will solid on for 5 seconds. Means SDI-12-LB are in Deep Sleep Mode.
139 139  
140 -== 1.7 Pin Mapping ==
141 141  
142 142  
143 -[[image:1675213198663-754.png]]
157 +1.
158 +11. Pin Mapping
144 144  
160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
145 145  
146 -== 1.8 BLE connection ==
162 +1.
163 +11. BLE connection
147 147  
148 -
149 149  SDI-12-LB support BLE remote configure.
150 150  
167 +
151 151  BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
152 152  
153 153  * Press button to send an uplink
... ... @@ -157,34 +157,33 @@
157 157  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
158 158  
159 159  
160 -== 1.9 Mechanical ==
161 161  
162 162  
179 +1.
180 +11. Mechanical
163 163  
182 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
164 164  
184 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
165 165  
166 -[[image:image-20230201090139-2.png]]
186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
167 167  
168 -[[image:image-20230201090139-3.png]]
169 169  
170 -[[image:image-20230201090139-4.png]]
171 171  
172 172  
173 -= 2. Configure SDI-12 to connect to LoRaWAN network =
191 +1. Configure SDI-12 to connect to LoRaWAN network
192 +11. How it works
174 174  
175 -== 2.1 How it works ==
176 -
177 -
178 178  The SDI-12-LB 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 activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
179 179  
180 180  
181 -== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
197 +1.
198 +11. ​Quick guide to connect to LoRaWAN server (OTAA)
182 182  
183 -
184 184  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 [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
185 185  
186 186  
187 -[[image:image-20230201090528-5.png||height="465" width="1111"]]
203 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
188 188  
189 189  
190 190  The LPS8V2 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.
... ... @@ -195,7 +195,7 @@
195 195  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
196 196  
197 197  
198 -[[image:image-20230131134744-2.jpeg]]
214 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
199 199  
200 200  
201 201  
... ... @@ -206,24 +206,24 @@
206 206  
207 207  **Register the device**
208 208  
209 -[[image:1675213652444-622.png]]
225 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
210 210  
211 211  
212 212  **Add APP EUI and DEV EUI**
213 213  
214 214  
215 -[[image:1675213661769-223.png]]
231 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
216 216  
217 217  
218 218  **Add APP EUI in the application**
219 219  
220 220  
221 -[[image:1675213675852-577.png]]
237 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
222 222  
223 223  
224 224  **Add APP KEY**
225 225  
226 -[[image:1675213686734-883.png]]
242 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
227 227  
228 228  
229 229  **Step 2**: Activate on SDI-12-LB
... ... @@ -235,100 +235,98 @@
235 235  **Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. **Green led** will solidly turn on for 5 seconds after joined in network.
236 236  
237 237  
238 -[[image:1675213704414-644.png]]
254 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
239 239  
240 240  
241 -== ​2.3 SDI-12 Related Commands ==
242 242  
243 243  
244 -User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes.
245 245  
260 +1.
261 +11. ​SDI-12 Related Commands
246 246  
247 -=== 2.3.1 Basic SDI-12 debug command ===
248 248  
264 +User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes.
249 249  
250 -User can run some basic SDI-12 command to debug the connection to the SDI-12 sensor. These commands can be sent via AT Command or LoRaWAN downlink command.
251 251  
252 -If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server.
267 +1.
268 +11.
269 +111. Basic SDI-12 debug command
253 253  
254 -The following is the display information on the serial port and the server.
271 +User can run some basic SDI-12 command to debug the connection to the SDI-12 sensor. These commands can be sent via AT Command or LoRaWAN downlink command.
255 255  
256 256  
274 +If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server.
257 257  
258 -[[image:image-20230201091027-6.png]]
259 259  
277 +The following is the display information on the serial port and the server.
260 260  
261 -[[image:image-20230201091027-7.png||height="261" width="1179"]]
279 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
262 262  
281 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
263 263  
264 -==== **al!  ~-~- Get SDI-12 sensor Identification** ====
283 +al!  ~-~- Get SDI-12 sensor Identification
265 265  
266 -
267 267  * AT Command: AT+ADDRI=aa
268 268  * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
269 269  
270 -**Parameter:  **aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
288 +Parameter: aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
271 271  
272 -**Example :  **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
290 +Example : AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
273 273  
274 274  
293 +
275 275  The following is the display information on the serial port and the server.
276 276  
277 277  
278 -[[image:image-20230201091257-8.png]]
297 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
279 279  
299 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
280 280  
281 -[[image:image-20230201091257-9.png||height="225" width="1242"]]
282 282  
302 +aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!
283 283  
284 -==== **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
304 +aM!: Start Non-Concurrent Measurement
285 285  
306 +aMC!: Start Non-Concurrent Measurement – Request CRC
286 286  
287 -**aM! **: Start Non-Concurrent Measurement
308 +aM1!- aM9!: Additional Measurements
288 288  
289 -**aMC! **: Start Non-Concurrent Measurement – Request CRC
310 +aMC1!- aMC9!: Additional Measurements – Request CRC
290 290  
291 -**aM1!- aM9! **: Additional Measurements
292 292  
293 -**aMC1!- aMC9!** : Additional Measurements – Request CRC
294 -
295 -
296 296  * AT Command : AT+ADDRM=0,1,0,1
297 297  * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01
298 298  
299 299  Downlink：AA 01 aa bb cc dd
300 300  
301 -**aa**: SDI-12 sensor address.
318 +aa: SDI-12 sensor address.
302 302  
303 -**bb**: 0: no CRC, 1: request CRC
320 +bb: 0: no CRC, 1: request CRC
304 304  
305 -**cc**: 1-9: Additional Measurement, 0: no additional measurement
322 +cc: 1-9: Additional Measurement, 0: no additional measurement
306 306  
307 -**dd**: delay (in second) to send **aD0!** to get return.
324 +dd: delay (in second) to send **aD0!** to get return.
308 308  
309 309  
310 310  The following is the display information on the serial port and the server.
311 311  
329 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
312 312  
313 -[[image:image-20230201091630-10.png]]
331 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
314 314  
315 315  
316 -[[image:image-20230201091630-11.png||height="247" width="1165"]]
317 317  
335 +aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9!
318 318  
337 +aC!: Start Concurrent Measurement
319 319  
320 -==== **aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
339 +aCC!: Start Concurrent Measurement – Request CRC
321 321  
341 +aC1!- aC9!: Start Additional Concurrent Measurements
322 322  
323 -**aC!** : Start Concurrent Measurement
343 +aCC1!- aCC9!: Start Additional Concurrent Measurements – Request CRC
324 324  
325 -**aCC!** : Start Concurrent Measurement – Request CRC
326 326  
327 -**aC1!- aC9!** : Start Additional Concurrent Measurements
328 -
329 -**aCC1!- aCC9!** : Start Additional Concurrent Measurements – Request CRC
330 -
331 -
332 332  * AT Command : AT+ADDRC=0,1,0,1 
333 333  
334 334  * LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01
... ... @@ -335,29 +335,24 @@
335 335  
336 336  Downlink: AA 02 aa bb cc dd
337 337  
338 -**aa**: SDI-12 sensor address.
352 +aa: SDI-12 sensor address.
339 339  
340 -**bb**: 0: no CRC, 1: request CRC
354 +bb: 0: no CRC, 1: request CRC
341 341  
342 -**cc**: 1-9: Additional Measurement, 0: no additional measurement
356 +cc: 1-9: Additional Measurement, 0: no additional measurement
343 343  
344 -**dd**: delay (in second) to send **aD0!** to get return.
358 +dd: delay (in second) to send **aD0!** to get return.
345 345  
346 346  
347 347  The following is the display information on the serial port and the server.
348 348  
363 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]]
349 349  
350 -[[image:image-20230201091954-12.png]]
365 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]
351 351  
352 352  
353 -[[image:image-20230201091954-13.png||height="203" width="1117"]]
368 +aR0!- aR9!,  aRC0!- aRC9!
354 354  
355 -
356 -(% style="display:none" %) (%%)
357 -
358 -==== **aR0!- aR9!,  aRC0!- aRC9!** ====
359 -
360 -
361 361  Start Continuous Measurement
362 362  
363 363  Start Continuous Measurement – Request CRC
... ... @@ -368,48 +368,46 @@
368 368  
369 369  Downlink: AA 03 aa bb cc dd
370 370  
371 -**aa**: SDI-12 sensor address.
380 +aa: SDI-12 sensor address.
372 372  
373 -**bb**: 0: no CRC, 1: request CRC
382 +bb: 0: no CRC, 1: request CRC
374 374  
375 -**cc**: 1-9: Additional Measurement, 0: no additional measurement
384 +cc: 1-9: Additional Measurement, 0: no additional measurement
376 376  
377 -**dd**: delay (in second) to send **aD0!** to get return.
386 +dd: delay (in second) to send **aD0!** to get return.
378 378  
379 379  
380 380  The following is the display information on the serial port and the server.
381 381  
391 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
382 382  
393 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
383 383  
384 -[[image:image-20230201092208-14.png]]
395 +1.
396 +11.
397 +111. Advance SDI-12 Debug command
385 385  
386 -
387 -[[image:image-20230201092208-15.png||height="214" width="1140"]]
388 -
389 -
390 -=== ​​​​​​​2.3.2 Advance SDI-12 Debug command ===
391 -
392 -
393 393  This command can be used to debug all SDI-12 command.
394 394  
395 395  
396 396  LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
397 397  
398 -**aa **: total SDI-12 command length
404 +(aa: total SDI-12 command length)
399 399  
400 -**xx **: SDI-12 command
406 +(xx: SDI-12 command)
401 401  
402 -**bb **: Delay to wait for return
408 +(bb: Delay to wait for return)
403 403  
404 -**cc **: 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
410 +(cc: 0: don’t uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100)
405 405  
406 406  
407 -**Example: **AT+CFGDEV =0RC0!,1
413 +Example: AT+CFGDEV =0RC0!,1
408 408  
409 -**0RC0! **: SDI-12 Command,
415 +0RC0!: SDI-12 Command,
410 410  
411 -**1 **: Delay 1 second.  ( 0: 810 mini-second)
417 +1: Delay 1 second.  ( 0: 810 mini-second)
412 412  
419 +
413 413  Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
414 414  
415 415  
... ... @@ -416,41 +416,36 @@
416 416  The following is the display information on the serial port and the server.
417 417  
418 418  
419 -[[image:image-20230201092355-16.png]]
426 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
420 420  
428 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
421 421  
422 -​​​​​​​[[image:image-20230201092355-17.png||height="426" width="1135"]]
430 +1.
431 +11.
432 +111. Convert ASCII to String
423 423  
424 -
425 -​​​​​​​
426 -
427 -=== 2.3.3 Convert ASCII to String ===
428 -
429 -
430 430  This command is used to convert between ASCII and String format.
431 431  
436 +
432 432  AT+CONVFORM ( Max length: 80 bytes)
433 433  
439 +Example:
434 434  
435 -**Example:**
441 +1)AT+CONVFORM=0,string   Convert String from String to ASCII
436 436  
437 -1) AT+CONVFORM=0, string Convert String from String to ASCII
443 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]]
438 438  
439 -[[image:1675214845056-885.png]]
440 440  
446 +2)AT+CONVFORM=1,ASCII   Convert ASCII to String.
441 441  
442 -2) AT+CONVFORM=1, ASCII Convert ASCII to String.
448 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
443 443  
444 -[[image:1675214856590-846.png]]
445 445  
446 446  
452 +1.
453 +11.
454 +111. Define periodically SDI-12 commands and uplink.
447 447  
448 -
449 -​​​​​​​
450 -
451 -=== 2.3.4 Define periodically SDI-12 commands and uplink. ===
452 -
453 -
454 454  AT+COMMANDx & AT+DATACUTx
455 455  
456 456  User can define max 15 SDI-12 Commands (AT+COMMAND1 ~~ AT+COMMANDF). On each uplink period (TDC time, default 20 minutes), SDI-12-LB will send these SDI-12 commands and wait for return from SDI-12 sensors. SDI-12-LB will then combine these returns and uplink via LoRaWAN.
... ... @@ -460,21 +460,21 @@
460 460  
461 461  **AT+COMMANDx=var1,var2,var3,var4.**
462 462  
463 -**var1**: SDI-12 command , for example: 0RC0!
465 +var1: SDI-12 command , for example: 0RC0!
464 464  
465 -**var2**: Wait timeout for return. (unit: second)
467 +var2: Wait timeout for return. (unit: second)
466 466  
467 -**var3**: Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
469 +var3: Whether to send //addrD0!// to get return after var2 timeout. 0: Don’t Send //addrD0!//; 1: Send //addrD0!//.
468 468  
469 -**var4**: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
471 +var4: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
470 470  
471 -**0 ** No validation check;
473 +0  No validation check;
472 472  
473 -**1**  Check if return chars are printable char(0x20 ~~ 0x7E);
475 +1  Check if return chars are printable char(0x20 ~~ 0x7E);
474 474  
475 -**2**  Check if there is return from SDI-12 sensor
477 +2  Check if there is return from SDI-12 sensor
476 476  
477 -**3**  Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
479 +3  Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
478 478  
479 479  
480 480  Each AT+COMMANDx is followed by a **AT+DATACUT** command. AT+DATACUT command is used to take the useful string from the SDI-12 sensor so the final payload will have the minimum length to uplink.
... ... @@ -482,17 +482,17 @@
482 482  
483 483  **AT+DATACUTx** : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
484 484  
485 -(% border="1" style="background-color:#f7faff; width:436px" %)
486 -|(% style="width:433px" %)(((
487 +|(((
487 487  AT+DATACUTx=a,b,c
488 488  
489 -**a**:  length for the return of AT+COMMAND
490 +a: length for the return of AT+COMMAND
490 490  
491 -**b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
492 +b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
492 492  
493 -**c**:  define the position for valid value. 
494 +c: define the position for valid value. 
494 494  )))
495 495  
497 +
496 496  For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload:
497 497  
498 498  
... ... @@ -501,6 +501,8 @@
501 501  |34,2,1~~8+12~~16|0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
502 502  |34,2,1~~34|0D 00 01 30 31 33 4D 45 54 45 52 20 20 20 54 45 52 31 32 20 31 31 32 54 31 32 2D 30 30 30 32 34 38 39 35 0D 0A
503 503  
506 +
507 +
504 504  * ** Downlink Payload:**
505 505  
506 506  **0xAF**  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
... ... @@ -521,7 +521,7 @@
521 521  
522 522  Example:
523 523  
524 -**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1**
528 +**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1**
525 525  
526 526  **AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
527 527  
... ... @@ -618,6 +618,7 @@
618 618  1.
619 619  11. Uplink Payload
620 620  
625 +
621 621  Uplink payloads have two types:
622 622  
623 623  * Distance Value: Use FPORT=2
... ... @@ -640,6 +640,7 @@
640 640  |**Size (bytes)**|**1**|**2**|**1**|**1**|**2**
641 641  |**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT
642 642  
648 +
643 643  Example parse in TTNv3
644 644  
645 645  [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]]
... ... @@ -701,6 +701,7 @@
701 701  11.
702 702  111. Uplink Payload, FPORT=2
703 703  
710 +
704 704  There are different cases for uplink. See below
705 705  
706 706  * SDI-12 Debug Command return: FPORT=100
... ... @@ -707,6 +707,7 @@
707 707  
708 708  * Periodically Uplink: FPORT=2
709 709  
717 +
710 710  |(((
711 711  **Size**
712 712  
... ... @@ -724,11 +724,12 @@
724 724  Payload length in server,server will show payload not provided in the LoRaWAN server.
725 725  )))
726 726  
735 +
727 727  [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]]
728 728  
729 729  
730 730  
731 -1.
740 +1.
732 732  11.
733 733  111. Battery Info
734 734  
... ... @@ -761,6 +761,8 @@
761 761  
762 762  
763 763  
773 +
774 +
764 764  1.
765 765  11.
766 766  111. ​Decode payload in The Things Network
... ... @@ -1027,6 +1027,7 @@
1027 1027  Set transmit interval to 60000ms = 60 seconds
1028 1028  )))
1029 1029  
1041 +
1030 1030  **Downlink Command: 0x01**
1031 1031  
1032 1032  Format: Command Code (0x01) followed by 3 bytes time value.
... ... @@ -1036,6 +1036,8 @@
1036 1036  * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1037 1037  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1038 1038  
1051 +
1052 +
1039 1039  1.
1040 1040  11. Set Interrupt Mode
1041 1041  
... ... @@ -1060,6 +1060,7 @@
1060 1060  1. (Trigger by rising edge)
1061 1061  )))|OK
1062 1062  
1077 +
1063 1063  **Downlink Command: 0x06**
1064 1064  
1065 1065  Format: Command Code (0x06) followed by 3 bytes.
... ... @@ -1069,6 +1069,7 @@
1069 1069  * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1070 1070  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1071 1071  
1087 +
1072 1072  1.
1073 1073  11. Set the output time
1074 1074  
... ... @@ -1098,6 +1098,7 @@
1098 1098  
1099 1099  )))
1100 1100  
1117 +
1101 1101  **AT Command: AT+5VT**
1102 1102  
1103 1103  |**Command Example**|**Function**|**Response**
... ... @@ -1122,6 +1122,7 @@
1122 1122  
1123 1123  )))
1124 1124  
1142 +
1125 1125  **AT Command: AT+12VT**
1126 1126  
1127 1127  |**Command Example**|**Function**|**Response**
... ... @@ -1137,6 +1137,7 @@
1137 1137  
1138 1138  )))
1139 1139  
1158 +
1140 1140  **Downlink Command: 0x07**
1141 1141  
1142 1142  Format: Command Code (0x07) followed by 3 bytes.
... ... @@ -1150,6 +1150,7 @@
1150 1150  * Example 5: Downlink Payload: 070301F4  -> AT+12VT=500
1151 1151  * Example 6: Downlink Payload: 07030000  -> AT+12VT=0
1152 1152  
1172 +
1153 1153  1.
1154 1154  11. Set the all data mode
1155 1155  
... ... @@ -1166,6 +1166,7 @@
1166 1166  )))
1167 1167  |AT+ALLDATAMOD=1|Set all data mode is 1.|OK
1168 1168  
1189 +
1169 1169  **Downlink Command: 0xAB**
1170 1170  
1171 1171  Format: Command Code (0xAB) followed by 1 bytes.
... ... @@ -1173,6 +1173,7 @@
1173 1173  * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
1174 1174  * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
1175 1175  
1197 +
1176 1176  1.
1177 1177  11. Set the splicing payload for uplink
1178 1178  
... ... @@ -1203,6 +1203,7 @@
1203 1203  
1204 1204  )))|OK
1205 1205  
1228 +
1206 1206  **Downlink Command: 0xAD**
1207 1207  
1208 1208  Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
... ... @@ -1230,6 +1230,7 @@
1230 1230  )))
1231 1231  |AT+PAYVER=5|Set payload version is 5.|OK
1232 1232  
1256 +
1233 1233  **Downlink Command: 0xAE**
1234 1234  
1235 1235  Format: Command Code (0xAE) followed by 1 bytes.
... ... @@ -1237,6 +1237,8 @@
1237 1237  * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
1238 1238  * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
1239 1239  
1264 +
1265 +
1240 1240  1. Battery & how to replace
1241 1241  11. Battery Type
1242 1242  
... ... @@ -1265,6 +1265,7 @@
1265 1265  1.
1266 1266  11. Power Consumption Analyze
1267 1267  
1294 +
1268 1268  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.
1269 1269  
1270 1270  
... ... @@ -1293,6 +1293,8 @@
1293 1293  * [[Lithium-Thionyl Chloride Battery>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet-EN.pdf]] datasheet, [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet_PM-ER18505-S-02-LF_EN.pdf]]
1294 1294  * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]]
1295 1295  
1323 +
1324 +
1296 1296  |(((
1297 1297  JST-XH-2P connector
1298 1298  )))
... ... @@ -1301,7 +1301,7 @@
1301 1301  
1302 1302  
1303 1303  
1304 -1.
1333 +1.
1305 1305  11.
1306 1306  111. ​Battery Note
1307 1307  
... ... @@ -1325,6 +1325,7 @@
1325 1325  1. Remote Configure device
1326 1326  11. Connect via BLE
1327 1327  
1357 +
1328 1328  Please see this instruction for how to configure via BLE:
1329 1329  
1330 1330  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]
... ... @@ -1333,6 +1333,8 @@
1333 1333  1.
1334 1334  11. AT Command Set
1335 1335  
1366 +
1367 +
1336 1336  1. OTA firmware update
1337 1337  
1338 1338  Please see this link for how to do OTA firmware update.
... ... @@ -1355,6 +1355,7 @@
1355 1355  
1356 1356  * SDI-12-LB SDI-12 to LoRaWAN Converter
1357 1357  
1390 +
1358 1358  **Dimension and weight**:
1359 1359  
1360 1360  * Device Size: cm
... ... @@ -1364,6 +1364,8 @@
1364 1364  
1365 1365  
1366 1366  
1400 +
1401 +
1367 1367  1. ​Support
1368 1368  
1369 1369  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1675213652444-622.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -59.6 KB
Content
1675213661769-223.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -53.8 KB
Content
1675213675852-577.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -83.1 KB
Content
1675213686734-883.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -65.2 KB
Content
1675213704414-644.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -50.1 KB
Content
1675214845056-885.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -20.4 KB
Content
1675214856590-846.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -18.6 KB
Content
image-20230201090139-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -7.2 KB
Content
image-20230201090528-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -560.9 KB
Content
image-20230201091027-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -10.4 KB
Content
image-20230201091027-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -43.7 KB
Content
image-20230201091257-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -15.8 KB
Content
image-20230201091257-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -46.3 KB
Content
image-20230201091630-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -15.1 KB
Content
image-20230201091630-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -53.1 KB
Content
image-20230201091954-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -13.8 KB
Content
image-20230201091954-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -46.7 KB
Content
image-20230201092208-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -14.3 KB
Content
image-20230201092208-15.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -46.6 KB
Content
image-20230201092355-16.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -21.6 KB
Content
image-20230201092355-17.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -80.0 KB
Content
image-20230201094129-18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -12.8 KB
Content