Last modified by Xiaoling on 2025/04/25 08:58
<
From version < 40.3 >
edited by Xiaoling
on 2023/02/01 14:52
To version < 40.1 >
edited by Xiaoling
on 2023/02/01 14:50
>
Change comment: Uploaded new attachment "image-20230201145019-19.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -23,7 +23,7 @@
23 23  == 1.1 ​What is SDI-12 to LoRaWAN Converter ==
24 24  
25 25  
26 -The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
26 +The Dragino **(% style="color:blue" %)SDI-12-LB**(%%) is a **(% style="color:blue" %)SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
27 27  
28 28  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.
29 29  
... ... @@ -31,7 +31,7 @@
31 31  
32 32  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.
33 33  
34 -SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
34 +SDI-12-LB is powered by **(% style="color:blue" %)8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
35 35  
36 36  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.
37 37  
... ... @@ -56,21 +56,22 @@
56 56  * Downlink to change configure
57 57  * 8500mAh Battery for long term use
58 58  
59 +
59 59  == 1.3 Specification ==
60 60  
61 61  
62 -(% style="color:#037691" %)**Micro Controller:**
63 +**(% style="color:#037691" %)Micro Controller:**
63 63  
64 64  * MCU: 48Mhz ARM
65 65  * Flash: 256KB
66 66  * RAM: 64KB
67 67  
68 -(% style="color:#037691" %)**Common DC Characteristics:**
69 +**(% style="color:#037691" %)Common DC Characteristics:**
69 69  
70 70  * Supply Voltage: 2.5v ~~ 3.6v
71 71  * Operating Temperature: -40 ~~ 85°C
72 72  
73 -(% style="color:#037691" %)**LoRa Spec:**
74 +**(% style="color:#037691" %)LoRa Spec:**
74 74  
75 75  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
76 76  * Max +22 dBm constant RF output vs.
... ... @@ -77,19 +77,19 @@
77 77  * RX sensitivity: down to -139 dBm.
78 78  * Excellent blocking immunity
79 79  
80 -(% style="color:#037691" %)**Current Input Measuring :**
81 +**(% style="color:#037691" %)Current Input Measuring :**
81 81  
82 82  * Range: 0 ~~ 20mA
83 83  * Accuracy: 0.02mA
84 84  * Resolution: 0.001mA
85 85  
86 -(% style="color:#037691" %)**Voltage Input Measuring:**
87 +**(% style="color:#037691" %)Voltage Input Measuring:**
87 87  
88 88  * Range: 0 ~~ 30v
89 89  * Accuracy: 0.02v
90 90  * Resolution: 0.001v
91 91  
92 -(% style="color:#037691" %)**Battery:**
93 +**(% style="color:#037691" %)Battery:**
93 93  
94 94  * Li/SOCI2 un-chargeable battery
95 95  * Capacity: 8500mAh
... ... @@ -97,11 +97,12 @@
97 97  * Max continuously current: 130mA
98 98  * Max boost current: 2A, 1 second
99 99  
100 -(% style="color:#037691" %)**Power Consumption**
101 +**(% style="color:#037691" %)Power Consumption**
101 101  
102 102  * Sleep Mode: 5uA @ 3.3v
103 103  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
104 104  
106 +
105 105  == 1.4 Connect to SDI-12 Sensor ==
106 106  
107 107  
... ... @@ -112,9 +112,9 @@
112 112  == 1.5 Sleep mode and working mode ==
113 113  
114 114  
115 -(% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
117 +**(% style="color:blue" %)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 -(% style="color:blue" %)**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 +**(% style="color:blue" %)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  
119 119  
120 120  == 1.6 Button & LEDs ==
... ... @@ -137,6 +137,7 @@
137 137  )))
138 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.
139 139  
142 +
140 140  == 1.7 Pin Mapping ==
141 141  
142 142  
... ... @@ -172,7 +172,7 @@
172 172  == 2.1 How it works ==
173 173  
174 174  
175 -The SDI-12-LB is configured as (% style="color:#037691" %)**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.
178 +The SDI-12-LB is configured as **(% style="color:#037691" %)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.
176 176  
177 177  
178 178  == 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -187,7 +187,7 @@
187 187  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.
188 188  
189 189  
190 -(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
193 +**(% style="color:blue" %)Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
191 191  
192 192  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
193 193  
... ... @@ -201,35 +201,35 @@
201 201  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
202 202  
203 203  
204 -(% style="color:blue" %)**Register the device**
207 +**(% style="color:blue" %)Register the device**
205 205  
206 206  [[image:1675213652444-622.png]]
207 207  
208 208  
209 -(% style="color:blue" %)**Add APP EUI and DEV EUI**
212 +**(% style="color:blue" %)Add APP EUI and DEV EUI**
210 210  
211 211  
212 212  [[image:1675213661769-223.png]]
213 213  
214 214  
215 -(% style="color:blue" %)**Add APP EUI in the application**
218 +**(% style="color:blue" %)Add APP EUI in the application**
216 216  
217 217  
218 218  [[image:1675213675852-577.png]]
219 219  
220 220  
221 -(% style="color:blue" %)**Add APP KEY**
224 +**(% style="color:blue" %)Add APP KEY**
222 222  
223 223  [[image:1675213686734-883.png]]
224 224  
225 225  
226 -(% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
229 +**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB
227 227  
228 228  
229 229  Press the button for 5 seconds to activate the SDI-12-LB.
230 230  
231 231  
232 -(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode** (%%)for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
235 +**(% style="color:green" %)Green led**(%%) will fast blink 5 times, device will enter **(% style="color:blue" %)OTA mode** (%%)for 3 seconds. And then start to JOIN LoRaWAN network. **(% style="color:green" %)Green led**(%%) will solidly turn on for 5 seconds after joined in network.
233 233  
234 234  
235 235  [[image:1675213704414-644.png]]
... ... @@ -258,15 +258,15 @@
258 258  [[image:image-20230201091027-7.png||height="261" width="1179"]]
259 259  
260 260  
261 -==== (% style="color:blue" %)**al!  ~-~- Get SDI-12 sensor Identification**(%%) ====
264 +==== **(% style="color:blue" %)al!  ~-~- Get SDI-12 sensor Identification** ====
262 262  
263 263  
264 264  * AT Command: AT+ADDRI=aa
265 265  * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
266 266  
267 -(% style="color:#037691" %)**Parameter:  **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
270 +**(% style="color:#037691" %)Parameter:  **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
268 268  
269 -(% style="color:blue" %)**Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
272 +**(% style="color:blue" %)Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
270 270  
271 271  
272 272  The following is the display information on the serial port and the server.
... ... @@ -278,16 +278,16 @@
278 278  [[image:image-20230201091257-9.png||height="225" width="1242"]]
279 279  
280 280  
281 -==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
284 +==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
282 282  
283 283  
284 -(% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement
287 +**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement
285 285  
286 -(% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
289 +**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
287 287  
288 -(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements
291 +**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements
289 289  
290 -(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
293 +**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
291 291  
292 292  
293 293  * AT Command : AT+ADDRM=0,1,0,1
... ... @@ -296,13 +296,13 @@
296 296  
297 297  Downlink：AA 01 aa bb cc dd
298 298  
299 -(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
302 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
300 300  
301 -(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
304 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
302 302  
303 -(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
306 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
304 304  
305 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
308 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
306 306  
307 307  
308 308  The following is the display information on the serial port and the server.
... ... @@ -315,16 +315,16 @@
315 315  
316 316  
317 317  
318 -==== (% style="color:blue" %)**aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! **(%%) ====
321 +==== **(% style="color:blue" %)aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
319 319  
320 320  
321 -(% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement
324 +**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement
322 322  
323 -(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC
326 +**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC
324 324  
325 -(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
328 +**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
326 326  
327 -(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
330 +**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
328 328  
329 329  
330 330  * AT Command : AT+ADDRC=0,1,0,1 
... ... @@ -333,13 +333,13 @@
333 333  
334 334  Downlink: AA 02 aa bb cc dd
335 335  
336 -(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
339 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
337 337  
338 -(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
341 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
339 339  
340 -(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
343 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
341 341  
342 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
345 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
343 343  
344 344  
345 345  The following is the display information on the serial port and the server.
... ... @@ -353,7 +353,7 @@
353 353  
354 354  
355 355  
356 -==== (% style="color:blue" %)**aR0!- aR9!,  aRC0!- aRC9!**(%%) ====
359 +==== **(% style="color:blue" %)aR0!- aR9!,  aRC0!- aRC9!** ====
357 357  
358 358  
359 359  Start Continuous Measurement
... ... @@ -366,13 +366,13 @@
366 366  
367 367  Downlink: AA 03 aa bb cc dd
368 368  
369 -(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
372 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
370 370  
371 -(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
374 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
372 372  
373 -(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
376 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
374 374  
375 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
378 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
376 376  
377 377  
378 378  The following is the display information on the serial port and the server.
... ... @@ -393,20 +393,20 @@
393 393  
394 394  LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
395 395  
396 -(% style="color:#037691" %)**aa **(%%): total SDI-12 command length
399 +**(% style="color:#037691" %)aa **(%%): total SDI-12 command length
397 397  
398 -(% style="color:#037691" %)**xx **(%%): SDI-12 command
401 +**(% style="color:#037691" %)xx **(%%): SDI-12 command
399 399  
400 -(% style="color:#037691" %)**bb **(%%): Delay to wait for return
403 +**(% style="color:#037691" %)bb **(%%): Delay to wait for return
401 401  
402 -(% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
405 +**(% style="color:#037691" %)cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
403 403  
404 404  
405 -(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1
408 +**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1
406 406  
407 -(% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command,
410 +**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command,
408 408  
409 -(% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
412 +**(% style="color:#037691" %)1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
410 410  
411 411  Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
412 412  
... ... @@ -428,7 +428,7 @@
428 428  AT+CONVFORM ( Max length: 80 bytes)
429 429  
430 430  
431 -(% style="color:blue" %)**Example:**
434 +**(% style="color:blue" %)Example:**
432 432  
433 433  1) AT+CONVFORM=0, string Convert String from String to ASCII
434 434  
... ... @@ -448,31 +448,31 @@
448 448  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.
449 449  
450 450  
451 -* (% style="color:blue" %)**AT Command:**
454 +* ** (% style="color:blue" %)AT Command:**
452 452  
453 -(% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.**
456 +**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.**
454 454  
455 -(% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0!
458 +**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0!
456 456  
457 -(% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second)
460 +**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second)
458 458  
459 -(% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
462 +**(% style="color:red" %)var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
460 460  
461 -(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
464 +**(% style="color:red" %)var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
462 462  
463 -(% style="color:red" %)**0 **(%%) No validation check;
466 +**(% style="color:red" %)0 **(%%) No validation check;
464 464  
465 -(% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
468 +**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
466 466  
467 -(% style="color:#red" %)**2**(%%)  Check if there is return from SDI-12 sensor
470 +**(% style="color:#red" %)2**(%%)  Check if there is return from SDI-12 sensor
468 468  
469 -(% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
472 +**(% style="color:red" %)3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
470 470  
471 471  
472 -Each AT+COMMANDx is followed by a (% style="color:blue" %)**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.
475 +Each AT+COMMANDx is followed by a **(% style="color:blue" %)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.
473 473  
474 474  
475 -(% style="color:blue" %)**AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
478 +**(% style="color:blue" %)AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
476 476  
477 477  (% border="1" style="background-color:#f7faff; width:436px" %)
478 478  |(% style="width:433px" %)(((
... ... @@ -494,49 +494,49 @@
494 494  |(% style="width:170px" %)34,2,1~~8+12~~16|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
495 495  |(% style="width:170px" %)34,2,1~~34|(% style="width:338px" %)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
496 496  
497 -* (% style="color:blue" %)** Downlink Payload:**
500 +* **(% style="color:blue" %) Downlink Payload:**
498 498  
499 -(% style="color:blue" %)**0xAF**(%%)  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
502 +**(% style="color:blue" %)0xAF**(%%)  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
500 500  
501 501  
502 -(% style="color:red" %)**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
505 +**(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
503 503  
504 504  
505 -Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)**
508 +Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY**
506 506  
507 507  Where:
508 508  
509 -* (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
510 -* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
511 -* (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
512 -* (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
513 -* (% style="color:#037691" %)**YY **(%%):  If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command. 
512 +* **(% style="color:#037691" %)MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
513 +* **(% style="color:#037691" %)NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
514 +* **(% style="color:#037691" %)LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
515 +* **(% style="color:#037691" %)XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
516 +* **(% style="color:#037691" %)YY **(%%):  If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command. 
514 514  
515 -(% style="color:blue" %)**Example:**
518 +**(% style="color:blue" %)Example:**
516 516  
517 517  [[image:image-20230201094129-18.png]]
518 518  
519 519  
520 -(% style="color:blue" %)**Clear SDI12 Command**
523 +**(% style="color:blue" %)Clear SDI12 Command**
521 521  
522 522  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
523 523  
524 524  
525 -* (% style="color:#037691" %)**AT Command:**
528 +* ** (% style="color:#037691" %)AT Command:**
526 526  
527 -(% style="color:#4f81bd" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase
530 +**(% style="color:#4F81BD" %)AT+CMDEAR=mm,nn** (%%)  mm: start position of erase ,nn: stop position of erase
528 528  
529 529  
530 530  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
531 531  
532 532  
533 -* (% style="color:#037691" %)** Downlink Payload:**
536 +* **(% style="color:#037691" %) Downlink Payload:**
534 534  
535 -(% style="color:#4f81bd" %)**0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
538 +**(% style="color:#4F81BD" %)0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
536 536  
537 537  
538 538  
539 -(% style="color:blue" %)**command combination**
542 +**(% style="color:blue" %)command combination**
540 540  
541 541  Below shows a screen shot how the results combines together to a uplink payload.
542 542  
... ... @@ -545,23 +545,23 @@
545 545  
546 546  If user don't want to use DATACUT for some command, he simply want to uplink all returns. AT+ALLDATAMOD can be set to 1.
547 547  
548 -(% style="color:blue" %)**AT+ALLDATAMOD**(%%) will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
551 +**(% style="color:blue" %)AT+ALLDATAMOD**(%%) will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
549 549  
550 550  
551 -(% style="color:#4f81bd" %)**For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
554 +**(% style="color:#4F81BD" %)For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
552 552  
553 553  
554 554  [[image:1675215782925-448.png]]
555 555  
556 556  
557 -If AT+ALLDATAMOD=1, (% style="color:#4f81bd" %)**FX,X**(%%) will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes.
560 +If AT+ALLDATAMOD=1, **(% style="color:#4F81BD" %)FX,X**(%%) will be added in the payload, FX specify which command is used and X specify the length of return. for example in above screen, F1 05 means the return is from AT+COMMAND1 and the return is 5 bytes.
558 558  
559 559  
560 560  
561 -(% style="color:blue" %)**Compose Uplink**
564 +**(% style="color:blue" %)Compose Uplink**
562 562  
563 563  
564 -(% style="color:#4f81bd" %)**AT+DATAUP=0**
567 +**(% style="color:#4F81BD" %)AT+DATAUP=0**
565 565  
566 566  Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
567 567  
... ... @@ -573,7 +573,7 @@
573 573  [[image:1675215828102-844.png]]
574 574  
575 575  
576 -(% style="color:#4f81bd" %)**AT+DATAUP=1**
579 +**(% style="color:#4F81BD" %)AT+DATAUP=1**
577 577  
578 578  Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs.
579 579  
... ... @@ -590,7 +590,7 @@
590 590  [[image:1675215848113-696.png]]
591 591  
592 592  
593 -(% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
596 +**(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
594 594  
595 595  * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
596 596  * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
... ... @@ -597,9 +597,9 @@
597 597  * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
598 598  * For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
599 599  
600 -(% style="color:red" %)**When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
603 +**(% style="color:red" %)When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
601 601  
602 -(% style="color:red" %)**When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
605 +**(% style="color:red" %)When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
603 603  
604 604  
605 605  == ​​​​​​​2.4 Uplink Payload ==
... ... @@ -630,11 +630,11 @@
630 630  [[image:1675215946738-635.png]]
631 631  
632 632  
633 -(% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
636 +**(% style="color:#037691" %)Sensor Model**(%%): For SDI-12-LB, this value is 0x17
634 634  
635 -(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
638 +**(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version
636 636  
637 -(% style="color:#037691" %)**Frequency Band**:
640 +**(% style="color:#037691" %)Frequency Band**:
638 638  
639 639  *0x01: EU868
640 640  
... ... @@ -665,7 +665,7 @@
665 665  *0x0e: MA869
666 666  
667 667  
668 -(% style="color:#037691" %)**Sub-Band**:
671 +**(% style="color:#037691" %)Sub-Band**:
669 669  
670 670  AU915 and US915:value 0x00 ~~ 0x08
671 671  
... ... @@ -674,7 +674,7 @@
674 674  Other Bands: Always 0x00
675 675  
676 676  
677 -(% style="color:#037691" %)**Battery Info**:
680 +**(% style="color:#037691" %)Battery Info**:
678 678  
679 679  Check the battery voltage.
680 680  
... ... @@ -721,7 +721,7 @@
721 721  === 2.4.4 Interrupt Pin ===
722 722  
723 723  
724 -This data field shows if this packet is generated by (% style="color:#037691" %)**Interrupt Pin**(%%) or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.7PinMapping"]].
727 +This data field shows if this packet is generated by **(% style="color:#037691" %)Interrupt Pin**(%%) or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.7PinMapping"]].
725 725  
726 726  **Example:**
727 727  
... ... @@ -752,7 +752,7 @@
752 752  
753 753  The SDI-12-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link:
754 754  
755 -[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]]]
758 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]
756 756  
757 757  
758 758  
... ... @@ -765,6 +765,7 @@
765 765  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
766 766  
767 767  
771 +
768 768  == 2.7 Firmware Change Log ==
769 769  
770 770  
... ... @@ -792,7 +792,7 @@
792 792  
793 793  They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
794 794  
795 -[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
799 +[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]]
796 796  
797 797  
798 798  * **Commands special design for SDI-12-LB**
... ... @@ -1016,7 +1016,7 @@
1016 1016  
1017 1017  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1018 1018  
1019 -[[image:1675234124233-857.png]]
1023 +[[image:1675146710956-626.png]]
1020 1020  
1021 1021  
1022 1022  Minimum Working Voltage for the SDI-12-LB:
... ... @@ -1049,10 +1049,9 @@
1049 1049  
1050 1050  And the Life expectation in difference case will be shown on the right.
1051 1051  
1056 +[[image:1675146895108-304.png]]
1052 1052  
1053 -[[image:1675234155374-163.png]]
1054 1054  
1055 -
1056 1056  The battery related documents as below:
1057 1057  
1058 1058  * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
... ... @@ -1059,10 +1059,9 @@
1059 1059  * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1060 1060  * [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]]
1061 1061  
1065 +[[image:image-20230131145708-3.png]]
1062 1062  
1063 -[[image:image-20230201145019-19.png]]
1064 1064  
1065 -
1066 1066  === 4.3.1 ​Battery Note ===
1067 1067  
1068 1068  
... ... @@ -1077,6 +1077,7 @@
1077 1077  The default battery pack of SDI-12-LB 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)
1078 1078  
1079 1079  
1082 +
1080 1080  = 5. Remote Configure device =
1081 1081  
1082 1082  == 5.1 Connect via BLE ==
... ... @@ -1097,30 +1097,10 @@
1097 1097  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
1098 1098  
1099 1099  
1100 -= 7. FAQ =
1101 1101  
1102 -== 7.1 How to use AT Command to access device? ==
1104 += 7. ​Order Info =
1103 1103  
1104 1104  
1105 -See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]
1106 -
1107 -
1108 -== 7.2 How to update firmware via UART port? ==
1109 -
1110 -
1111 -See: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]
1112 -
1113 -
1114 -== 7.3 How to change the LoRa Frequency Bands/Region? ==
1115 -
1116 -
1117 -You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
1118 -When downloading the images, choose the required image file for download. ​
1119 -
1120 -
1121 -= 8. ​Order Info =
1122 -
1123 -
1124 1124  Part Number: SDI-12-LB-XXX
1125 1125  XXX: The default frequency band
1126 1126  
... ... @@ -1139,7 +1139,7 @@
1139 1139  
1140 1140  
1141 1141  
1142 -= 9. Packing Info =
1125 += 8. Packing Info =
1143 1143  
1144 1144  
1145 1145  **Package Includes**:
... ... @@ -1153,7 +1153,7 @@
1153 1153  * Package Size / pcs : cm
1154 1154  * Weight / pcs : g
1155 1155  
1156 -= 10. ​Support =
1139 += 9. ​Support =
1157 1157  
1158 1158  
1159 1159  * 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.

Applications

Navigation

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