<
From version < 40.1 >
edited by Xiaoling
on 2023/02/01 14:50
To version < 40.2 >
edited by Xiaoling
on 2023/02/01 14:50
>
Change comment: There is no comment for this version

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,22 +56,21 @@
56 56  * Downlink to change configure
57 57  * 8500mAh Battery for long term use
58 58  
59 -
60 60  == 1.3 Specification ==
61 61  
62 62  
63 -**(% style="color:#037691" %)Micro Controller:**
62 +(% style="color:#037691" %)**Micro Controller:**
64 64  
65 65  * MCU: 48Mhz ARM
66 66  * Flash: 256KB
67 67  * RAM: 64KB
68 68  
69 -**(% style="color:#037691" %)Common DC Characteristics:**
68 +(% style="color:#037691" %)**Common DC Characteristics:**
70 70  
71 71  * Supply Voltage: 2.5v ~~ 3.6v
72 72  * Operating Temperature: -40 ~~ 85°C
73 73  
74 -**(% style="color:#037691" %)LoRa Spec:**
73 +(% style="color:#037691" %)**LoRa Spec:**
75 75  
76 76  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
77 77  * Max +22 dBm constant RF output vs.
... ... @@ -78,19 +78,19 @@
78 78  * RX sensitivity: down to -139 dBm.
79 79  * Excellent blocking immunity
80 80  
81 -**(% style="color:#037691" %)Current Input Measuring :**
80 +(% style="color:#037691" %)**Current Input Measuring :**
82 82  
83 83  * Range: 0 ~~ 20mA
84 84  * Accuracy: 0.02mA
85 85  * Resolution: 0.001mA
86 86  
87 -**(% style="color:#037691" %)Voltage Input Measuring:**
86 +(% style="color:#037691" %)**Voltage Input Measuring:**
88 88  
89 89  * Range: 0 ~~ 30v
90 90  * Accuracy: 0.02v
91 91  * Resolution: 0.001v
92 92  
93 -**(% style="color:#037691" %)Battery:**
92 +(% style="color:#037691" %)**Battery:**
94 94  
95 95  * Li/SOCI2 un-chargeable battery
96 96  * Capacity: 8500mAh
... ... @@ -98,12 +98,11 @@
98 98  * Max continuously current: 130mA
99 99  * Max boost current: 2A, 1 second
100 100  
101 -**(% style="color:#037691" %)Power Consumption**
100 +(% style="color:#037691" %)**Power Consumption**
102 102  
103 103  * Sleep Mode: 5uA @ 3.3v
104 104  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
105 105  
106 -
107 107  == 1.4 Connect to SDI-12 Sensor ==
108 108  
109 109  
... ... @@ -114,9 +114,9 @@
114 114  == 1.5 Sleep mode and working mode ==
115 115  
116 116  
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.
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.
118 118  
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.
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.
120 120  
121 121  
122 122  == 1.6 Button & LEDs ==
... ... @@ -139,7 +139,6 @@
139 139  )))
140 140  |(% 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.
141 141  
142 -
143 143  == 1.7 Pin Mapping ==
144 144  
145 145  
... ... @@ -175,7 +175,7 @@
175 175  == 2.1 How it works ==
176 176  
177 177  
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.
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.
179 179  
180 180  
181 181  == 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -190,7 +190,7 @@
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.
191 191  
192 192  
193 -**(% style="color:blue" %)Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
190 +(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
194 194  
195 195  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
196 196  
... ... @@ -204,35 +204,35 @@
204 204  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
205 205  
206 206  
207 -**(% style="color:blue" %)Register the device**
204 +(% style="color:blue" %)**Register the device**
208 208  
209 209  [[image:1675213652444-622.png]]
210 210  
211 211  
212 -**(% style="color:blue" %)Add APP EUI and DEV EUI**
209 +(% style="color:blue" %)**Add APP EUI and DEV EUI**
213 213  
214 214  
215 215  [[image:1675213661769-223.png]]
216 216  
217 217  
218 -**(% style="color:blue" %)Add APP EUI in the application**
215 +(% style="color:blue" %)**Add APP EUI in the application**
219 219  
220 220  
221 221  [[image:1675213675852-577.png]]
222 222  
223 223  
224 -**(% style="color:blue" %)Add APP KEY**
221 +(% style="color:blue" %)**Add APP KEY**
225 225  
226 226  [[image:1675213686734-883.png]]
227 227  
228 228  
229 -**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB
226 +(% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
230 230  
231 231  
232 232  Press the button for 5 seconds to activate the SDI-12-LB.
233 233  
234 234  
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.
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.
236 236  
237 237  
238 238  [[image:1675213704414-644.png]]
... ... @@ -261,15 +261,15 @@
261 261  [[image:image-20230201091027-7.png||height="261" width="1179"]]
262 262  
263 263  
264 -==== **(% style="color:blue" %)al!  ~-~- Get SDI-12 sensor Identification** ====
261 +==== (% style="color:blue" %)**al!  ~-~- Get SDI-12 sensor Identification**(%%) ====
265 265  
266 266  
267 267  * AT Command: AT+ADDRI=aa
268 268  * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
269 269  
270 -**(% style="color:#037691" %)Parameter:  **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
267 +(% style="color:#037691" %)**Parameter:  **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
271 271  
272 -**(% style="color:blue" %)Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
269 +(% style="color:blue" %)**Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
273 273  
274 274  
275 275  The following is the display information on the serial port and the server.
... ... @@ -281,16 +281,16 @@
281 281  [[image:image-20230201091257-9.png||height="225" width="1242"]]
282 282  
283 283  
284 -==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
281 +==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
285 285  
286 286  
287 -**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement
284 +(% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement
288 288  
289 -**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
286 +(% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
290 290  
291 -**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements
288 +(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements
292 292  
293 -**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
290 +(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
294 294  
295 295  
296 296  * AT Command : AT+ADDRM=0,1,0,1
... ... @@ -299,13 +299,13 @@
299 299  
300 300  Downlink:AA 01 aa bb cc dd
301 301  
302 -**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
299 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
303 303  
304 -**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
301 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
305 305  
306 -**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
303 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
307 307  
308 -**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
305 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
309 309  
310 310  
311 311  The following is the display information on the serial port and the server.
... ... @@ -318,16 +318,16 @@
318 318  
319 319  
320 320  
321 -==== **(% style="color:blue" %)aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
318 +==== (% style="color:blue" %)**aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! **(%%) ====
322 322  
323 323  
324 -**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement
321 +(% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement
325 325  
326 -**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC
323 +(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC
327 327  
328 -**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
325 +(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
329 329  
330 -**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
327 +(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
331 331  
332 332  
333 333  * AT Command : AT+ADDRC=0,1,0,1 
... ... @@ -336,13 +336,13 @@
336 336  
337 337  Downlink: AA 02 aa bb cc dd
338 338  
339 -**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
336 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
340 340  
341 -**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
338 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
342 342  
343 -**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
340 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
344 344  
345 -**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
342 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
346 346  
347 347  
348 348  The following is the display information on the serial port and the server.
... ... @@ -356,7 +356,7 @@
356 356  
357 357  
358 358  
359 -==== **(% style="color:blue" %)aR0!- aR9!,  aRC0!- aRC9!** ====
356 +==== (% style="color:blue" %)**aR0!- aR9!,  aRC0!- aRC9!**(%%) ====
360 360  
361 361  
362 362  Start Continuous Measurement
... ... @@ -369,13 +369,13 @@
369 369  
370 370  Downlink: AA 03 aa bb cc dd
371 371  
372 -**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
369 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
373 373  
374 -**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
371 +(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
375 375  
376 -**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
373 +(% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
377 377  
378 -**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
375 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
379 379  
380 380  
381 381  The following is the display information on the serial port and the server.
... ... @@ -396,20 +396,20 @@
396 396  
397 397  LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
398 398  
399 -**(% style="color:#037691" %)aa **(%%): total SDI-12 command length
396 +(% style="color:#037691" %)**aa **(%%): total SDI-12 command length
400 400  
401 -**(% style="color:#037691" %)xx **(%%): SDI-12 command
398 +(% style="color:#037691" %)**xx **(%%): SDI-12 command
402 402  
403 -**(% style="color:#037691" %)bb **(%%): Delay to wait for return
400 +(% style="color:#037691" %)**bb **(%%): Delay to wait for return
404 404  
405 -**(% style="color:#037691" %)cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
402 +(% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
406 406  
407 407  
408 -**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1
405 +(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1
409 409  
410 -**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command,
407 +(% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command,
411 411  
412 -**(% style="color:#037691" %)1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
409 +(% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
413 413  
414 414  Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
415 415  
... ... @@ -431,7 +431,7 @@
431 431  AT+CONVFORM ( Max length: 80 bytes)
432 432  
433 433  
434 -**(% style="color:blue" %)Example:**
431 +(% style="color:blue" %)**Example:**
435 435  
436 436  1) AT+CONVFORM=0, string Convert String from String to ASCII
437 437  
... ... @@ -451,31 +451,31 @@
451 451  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.
452 452  
453 453  
454 -* ** (% style="color:blue" %)AT Command:**
451 +* (% style="color:blue" %)**AT Command:**
455 455  
456 -**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.**
453 +(% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.**
457 457  
458 -**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0!
455 +(% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0!
459 459  
460 -**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second)
457 +(% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second)
461 461  
462 -**(% style="color:red" %)var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
459 +(% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
463 463  
464 -**(% style="color:red" %)var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
461 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
465 465  
466 -**(% style="color:red" %)0 **(%%) No validation check;
463 +(% style="color:red" %)**0 **(%%) No validation check;
467 467  
468 -**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
465 +(% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
469 469  
470 -**(% style="color:#red" %)2**(%%)  Check if there is return from SDI-12 sensor
467 +(% style="color:#red" %)**2**(%%)  Check if there is return from SDI-12 sensor
471 471  
472 -**(% style="color:red" %)3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
469 +(% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
473 473  
474 474  
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.
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.
476 476  
477 477  
478 -**(% style="color:blue" %)AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
475 +(% style="color:blue" %)**AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
479 479  
480 480  (% border="1" style="background-color:#f7faff; width:436px" %)
481 481  |(% style="width:433px" %)(((
... ... @@ -497,49 +497,49 @@
497 497  |(% 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
498 498  |(% 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
499 499  
500 -* **(% style="color:blue" %) Downlink Payload:**
497 +* (% style="color:blue" %)** Downlink Payload:**
501 501  
502 -**(% style="color:blue" %)0xAF**(%%)  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
499 +(% style="color:blue" %)**0xAF**(%%)  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
503 503  
504 504  
505 -**(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
502 +(% style="color:red" %)**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
506 506  
507 507  
508 -Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY**
505 +Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)**
509 509  
510 510  Where:
511 511  
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. 
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. 
517 517  
518 -**(% style="color:blue" %)Example:**
515 +(% style="color:blue" %)**Example:**
519 519  
520 520  [[image:image-20230201094129-18.png]]
521 521  
522 522  
523 -**(% style="color:blue" %)Clear SDI12 Command**
520 +(% style="color:blue" %)**Clear SDI12 Command**
524 524  
525 525  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
526 526  
527 527  
528 -* ** (% style="color:#037691" %)AT Command:**
525 +* (% style="color:#037691" %)**AT Command:**
529 529  
530 -**(% style="color:#4F81BD" %)AT+CMDEAR=mm,nn** (%%)  mm: start position of erase ,nn: stop position of erase
527 +(% style="color:#4f81bd" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase
531 531  
532 532  
533 533  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
534 534  
535 535  
536 -* **(% style="color:#037691" %) Downlink Payload:**
533 +* (% style="color:#037691" %)** Downlink Payload:**
537 537  
538 -**(% style="color:#4F81BD" %)0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
535 +(% style="color:#4f81bd" %)**0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
539 539  
540 540  
541 541  
542 -**(% style="color:blue" %)command combination**
539 +(% style="color:blue" %)**command combination**
543 543  
544 544  Below shows a screen shot how the results combines together to a uplink payload.
545 545  
... ... @@ -548,23 +548,23 @@
548 548  
549 549  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.
550 550  
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.
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.
552 552  
553 553  
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.
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.
555 555  
556 556  
557 557  [[image:1675215782925-448.png]]
558 558  
559 559  
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.
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.
561 561  
562 562  
563 563  
564 -**(% style="color:blue" %)Compose Uplink**
561 +(% style="color:blue" %)**Compose Uplink**
565 565  
566 566  
567 -**(% style="color:#4F81BD" %)AT+DATAUP=0**
564 +(% style="color:#4f81bd" %)**AT+DATAUP=0**
568 568  
569 569  Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
570 570  
... ... @@ -576,7 +576,7 @@
576 576  [[image:1675215828102-844.png]]
577 577  
578 578  
579 -**(% style="color:#4F81BD" %)AT+DATAUP=1**
576 +(% style="color:#4f81bd" %)**AT+DATAUP=1**
580 580  
581 581  Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs.
582 582  
... ... @@ -593,7 +593,7 @@
593 593  [[image:1675215848113-696.png]]
594 594  
595 595  
596 -**(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
593 +(% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
597 597  
598 598  * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
599 599  * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
... ... @@ -600,9 +600,9 @@
600 600  * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
601 601  * For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
602 602  
603 -**(% style="color:red" %)When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
600 +(% style="color:red" %)**When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
604 604  
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.**
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.**
606 606  
607 607  
608 608  == ​​​​​​​2.4 Uplink Payload ==
... ... @@ -633,11 +633,11 @@
633 633  [[image:1675215946738-635.png]]
634 634  
635 635  
636 -**(% style="color:#037691" %)Sensor Model**(%%): For SDI-12-LB, this value is 0x17
633 +(% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
637 637  
638 -**(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version
635 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
639 639  
640 -**(% style="color:#037691" %)Frequency Band**:
637 +(% style="color:#037691" %)**Frequency Band**:
641 641  
642 642  *0x01: EU868
643 643  
... ... @@ -668,7 +668,7 @@
668 668  *0x0e: MA869
669 669  
670 670  
671 -**(% style="color:#037691" %)Sub-Band**:
668 +(% style="color:#037691" %)**Sub-Band**:
672 672  
673 673  AU915 and US915:value 0x00 ~~ 0x08
674 674  
... ... @@ -677,7 +677,7 @@
677 677  Other Bands: Always 0x00
678 678  
679 679  
680 -**(% style="color:#037691" %)Battery Info**:
677 +(% style="color:#037691" %)**Battery Info**:
681 681  
682 682  Check the battery voltage.
683 683  
... ... @@ -724,7 +724,7 @@
724 724  === 2.4.4 Interrupt Pin ===
725 725  
726 726  
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"]].
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"]].
728 728  
729 729  **Example:**
730 730  
... ... @@ -755,7 +755,7 @@
755 755  
756 756  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:
757 757  
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]]
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]]]]
759 759  
760 760  
761 761  
... ... @@ -796,7 +796,7 @@
796 796  
797 797  They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
798 798  
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 +[[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/]]
800 800  
801 801  
802 802  * **Commands special design for SDI-12-LB**
... ... @@ -1020,7 +1020,7 @@
1020 1020  
1021 1021  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1022 1022  
1023 -[[image:1675146710956-626.png]]
1020 +[[image:1675234124233-857.png]]
1024 1024  
1025 1025  
1026 1026  Minimum Working Voltage for the SDI-12-LB:
... ... @@ -1053,9 +1053,10 @@
1053 1053  
1054 1054  And the Life expectation in difference case will be shown on the right.
1055 1055  
1056 -[[image:1675146895108-304.png]]
1057 1057  
1054 +[[image:1675234155374-163.png]]
1058 1058  
1056 +
1059 1059  The battery related documents as below:
1060 1060  
1061 1061  * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
... ... @@ -1062,9 +1062,10 @@
1062 1062  * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1063 1063  * [[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]]
1064 1064  
1065 -[[image:image-20230131145708-3.png]]
1066 1066  
1064 +[[image:image-20230201145019-19.png]]
1067 1067  
1066 +
1068 1068  === 4.3.1 ​Battery Note ===
1069 1069  
1070 1070  
... ... @@ -1100,10 +1100,30 @@
1100 1100  [[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/]]
1101 1101  
1102 1102  
1102 += 7. FAQ =
1103 1103  
1104 -= 7. ​Order Info =
1104 +== 7.1 How to use AT Command to access device? ==
1105 1105  
1106 1106  
1107 +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]]
1108 +
1109 +
1110 +== 7.2 How to update firmware via UART port? ==
1111 +
1112 +
1113 +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]]
1114 +
1115 +
1116 +== 7.3 How to change the LoRa Frequency Bands/Region? ==
1117 +
1118 +
1119 +You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
1120 +When downloading the images, choose the required image file for download. ​
1121 +
1122 +
1123 += 8. ​Order Info =
1124 +
1125 +
1107 1107  Part Number: SDI-12-LB-XXX
1108 1108  XXX: The default frequency band
1109 1109  
... ... @@ -1122,7 +1122,7 @@
1122 1122  
1123 1123  
1124 1124  
1125 -= 8. Packing Info =
1144 += 9. Packing Info =
1126 1126  
1127 1127  
1128 1128  **Package Includes**:
... ... @@ -1136,7 +1136,7 @@
1136 1136  * Package Size / pcs : cm
1137 1137  * Weight / pcs : g
1138 1138  
1139 -= 9. ​Support =
1158 += 10. ​Support =
1140 1140  
1141 1141  
1142 1142  * 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.
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0