Skip to Content
Last modified by Mengting Qiu on 2025/07/03 15:42
From version 41.14
edited by Xiaoling
on 2023/02/01 16:38
Change comment: There is no comment for this version
To version 38.1
edited by Xiaoling
on 2023/02/01 14:48
Change comment: Uploaded new attachment "1675234124233-857.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -17,39 +17,30 @@
17 17  
18 18  
19 19  
20 +
20 20  = 1. Introduction =
21 21  
22 22  == 1.1 ​What is SDI-12 to LoRaWAN Converter ==
23 23  
24 24  
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.
27 -)))
26 +The Dragino **(% style="color:blue" %)SDI-12-LB**(%%) is a **(% style="color:blue" %)SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
28 28  
29 -(((
30 30  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.
31 -)))
32 32  
33 -(((
34 34  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.
35 -)))
36 36  
37 -(((
38 38  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.
39 -)))
40 40  
41 -(((
42 -SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
43 -)))
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.
44 44  
45 -(((
46 46  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.
47 -)))
48 48  
49 49  
50 50  [[image:image-20230201084414-1.png||height="464" width="1108"]]
51 51  
52 52  
42 +
43 +
53 53  == ​1.2 Features ==
54 54  
55 55  
... ... @@ -65,21 +65,22 @@
65 65  * Downlink to change configure
66 66  * 8500mAh Battery for long term use
67 67  
59 +
68 68  == 1.3 Specification ==
69 69  
70 70  
71 -(% style="color:#037691" %)**Micro Controller:**
63 +**(% style="color:#037691" %)Micro Controller:**
72 72  
73 73  * MCU: 48Mhz ARM
74 74  * Flash: 256KB
75 75  * RAM: 64KB
76 76  
77 -(% style="color:#037691" %)**Common DC Characteristics:**
69 +**(% style="color:#037691" %)Common DC Characteristics:**
78 78  
79 79  * Supply Voltage: 2.5v ~~ 3.6v
80 80  * Operating Temperature: -40 ~~ 85°C
81 81  
82 -(% style="color:#037691" %)**LoRa Spec:**
74 +**(% style="color:#037691" %)LoRa Spec:**
83 83  
84 84  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
85 85  * Max +22 dBm constant RF output vs.
... ... @@ -86,19 +86,19 @@
86 86  * RX sensitivity: down to -139 dBm.
87 87  * Excellent blocking immunity
88 88  
89 -(% style="color:#037691" %)**Current Input Measuring :**
81 +**(% style="color:#037691" %)Current Input Measuring :**
90 90  
91 91  * Range: 0 ~~ 20mA
92 92  * Accuracy: 0.02mA
93 93  * Resolution: 0.001mA
94 94  
95 -(% style="color:#037691" %)**Voltage Input Measuring:**
87 +**(% style="color:#037691" %)Voltage Input Measuring:**
96 96  
97 97  * Range: 0 ~~ 30v
98 98  * Accuracy: 0.02v
99 99  * Resolution: 0.001v
100 100  
101 -(% style="color:#037691" %)**Battery:**
93 +**(% style="color:#037691" %)Battery:**
102 102  
103 103  * Li/SOCI2 un-chargeable battery
104 104  * Capacity: 8500mAh
... ... @@ -106,11 +106,12 @@
106 106  * Max continuously current: 130mA
107 107  * Max boost current: 2A, 1 second
108 108  
109 -(% style="color:#037691" %)**Power Consumption**
101 +**(% style="color:#037691" %)Power Consumption**
110 110  
111 111  * Sleep Mode: 5uA @ 3.3v
112 112  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
113 113  
106 +
114 114  == 1.4 Connect to SDI-12 Sensor ==
115 115  
116 116  
... ... @@ -121,9 +121,9 @@
121 121  == 1.5 Sleep mode and working mode ==
122 122  
123 123  
124 -(% 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.
125 125  
126 -(% 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.
127 127  
128 128  
129 129  == 1.6 Button & LEDs ==
... ... @@ -134,18 +134,19 @@
134 134  
135 135  
136 136  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
137 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
138 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)(((
130 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
131 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
139 139  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
140 140  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
141 141  )))
142 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)(((
135 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
143 143  (% 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.
144 144  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
145 145  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.
146 146  )))
147 -|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:109px" %)Deactivate Device|(% style="width:231px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
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.
148 148  
142 +
149 149  == 1.7 Pin Mapping ==
150 150  
151 151  
... ... @@ -181,7 +181,7 @@
181 181  == 2.1 How it works ==
182 182  
183 183  
184 -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.
185 185  
186 186  
187 187  == 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -196,47 +196,51 @@
196 196  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.
197 197  
198 198  
199 -(% 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.
200 200  
201 201  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
202 202  
203 203  
204 -[[image:image-20230201152430-20.jpeg]]
198 +[[image:image-20230131134744-2.jpeg]]
205 205  
206 206  
201 +
202 +
203 +
207 207  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
208 208  
209 209  
210 -(% style="color:blue" %)**Register the device**
207 +**(% style="color:blue" %)Register the device**
211 211  
212 212  [[image:1675213652444-622.png]]
213 213  
214 214  
215 -(% style="color:blue" %)**Add APP EUI and DEV EUI**
212 +**(% style="color:blue" %)Add APP EUI and DEV EUI**
216 216  
217 217  
218 218  [[image:1675213661769-223.png]]
219 219  
220 220  
221 -(% style="color:blue" %)**Add APP EUI in the application**
218 +**(% style="color:blue" %)Add APP EUI in the application**
222 222  
223 223  
224 224  [[image:1675213675852-577.png]]
225 225  
226 226  
227 -(% style="color:blue" %)**Add APP KEY**
224 +**(% style="color:blue" %)Add APP KEY**
228 228  
229 229  [[image:1675213686734-883.png]]
230 230  
231 231  
232 -(% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
229 +**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB
233 233  
234 234  
235 235  Press the button for 5 seconds to activate the SDI-12-LB.
236 236  
237 -(% 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.
238 238  
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.
239 239  
237 +
240 240  [[image:1675213704414-644.png]]
241 241  
242 242  
... ... @@ -256,6 +256,7 @@
256 256  The following is the display information on the serial port and the server.
257 257  
258 258  
257 +
259 259  [[image:image-20230201091027-6.png]]
260 260  
261 261  
... ... @@ -262,16 +262,15 @@
262 262  [[image:image-20230201091027-7.png||height="261" width="1179"]]
263 263  
264 264  
264 +==== **(% style="color:blue" %)al!  ~-~- Get SDI-12 sensor Identification** ====
265 265  
266 -==== (% style="color:blue" %)**al!  ~-~- Get SDI-12 sensor Identification**(%%) ====
267 267  
268 -
269 269  * AT Command: AT+ADDRI=aa
270 270  * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa
271 271  
272 -(% 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)
273 273  
274 -(% 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)
275 275  
276 276  
277 277  The following is the display information on the serial port and the server.
... ... @@ -283,16 +283,16 @@
283 283  [[image:image-20230201091257-9.png||height="225" width="1242"]]
284 284  
285 285  
286 -==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
284 +==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
287 287  
288 288  
289 -(% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement
287 +**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement
290 290  
291 -(% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
289 +**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
292 292  
293 -(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements
291 +**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements
294 294  
295 -(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
293 +**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
296 296  
297 297  
298 298  * AT Command : AT+ADDRM=0,1,0,1
... ... @@ -301,13 +301,13 @@
301 301  
302 302  Downlink：AA 01 aa bb cc dd
303 303  
304 -(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
302 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
305 305  
306 -(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
304 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
307 307  
308 -(% 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
309 309  
310 -(% 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.
311 311  
312 312  
313 313  The following is the display information on the serial port and the server.
... ... @@ -320,16 +320,16 @@
320 320  
321 321  
322 322  
323 -==== (% style="color:blue" %)**aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! **(%%) ====
321 +==== **(% style="color:blue" %)aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
324 324  
325 325  
326 -(% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement
324 +**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement
327 327  
328 -(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC
326 +**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC
329 329  
330 -(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
328 +**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
331 331  
332 -(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
330 +**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
333 333  
334 334  
335 335  * AT Command : AT+ADDRC=0,1,0,1 
... ... @@ -338,13 +338,13 @@
338 338  
339 339  Downlink: AA 02 aa bb cc dd
340 340  
341 -(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
339 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
342 342  
343 -(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
341 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
344 344  
345 -(% 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
346 346  
347 -(% 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.
348 348  
349 349  
350 350  The following is the display information on the serial port and the server.
... ... @@ -358,7 +358,7 @@
358 358  
359 359  
360 360  
361 -==== (% style="color:blue" %)**aR0!- aR9!,  aRC0!- aRC9!**(%%) ====
359 +==== **(% style="color:blue" %)aR0!- aR9!,  aRC0!- aRC9!** ====
362 362  
363 363  
364 364  Start Continuous Measurement
... ... @@ -371,18 +371,19 @@
371 371  
372 372  Downlink: AA 03 aa bb cc dd
373 373  
374 -(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
372 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
375 375  
376 -(% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC
374 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
377 377  
378 -(% 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
379 379  
380 -(% 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.
381 381  
382 382  
383 383  The following is the display information on the serial port and the server.
384 384  
385 385  
384 +
386 386  [[image:image-20230201092208-14.png]]
387 387  
388 388  
... ... @@ -397,20 +397,20 @@
397 397  
398 398  LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
399 399  
400 -(% style="color:#037691" %)**aa **(%%): total SDI-12 command length
399 +**(% style="color:#037691" %)aa **(%%): total SDI-12 command length
401 401  
402 -(% style="color:#037691" %)**xx **(%%): SDI-12 command
401 +**(% style="color:#037691" %)xx **(%%): SDI-12 command
403 403  
404 -(% style="color:#037691" %)**bb **(%%): Delay to wait for return
403 +**(% style="color:#037691" %)bb **(%%): Delay to wait for return
405 405  
406 -(% 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
407 407  
408 408  
409 -(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1
408 +**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1
410 410  
411 -(% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command,
410 +**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command,
412 412  
413 -(% style="color:#037691" %)**1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
412 +**(% style="color:#037691" %)1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
414 414  
415 415  Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
416 416  
... ... @@ -432,7 +432,7 @@
432 432  AT+CONVFORM ( Max length: 80 bytes)
433 433  
434 434  
435 -(% style="color:blue" %)**Example:**
434 +**(% style="color:blue" %)Example:**
436 436  
437 437  1) AT+CONVFORM=0, string Convert String from String to ASCII
438 438  
... ... @@ -452,31 +452,31 @@
452 452  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.
453 453  
454 454  
455 -* (% style="color:blue" %)**AT Command:**
454 +* ** (% style="color:blue" %)AT Command:**
456 456  
457 -(% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.**
456 +**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.**
458 458  
459 -(% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0!
458 +**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0!
460 460  
461 -(% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second)
460 +**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second)
462 462  
463 -(% 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!//.
464 464  
465 -(% 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.
466 466  
467 -(% style="color:red" %)**0 **(%%) No validation check;
466 +**(% style="color:red" %)0 **(%%) No validation check;
468 468  
469 -(% 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);
470 470  
471 -(% 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
472 472  
473 -(% 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);
474 474  
475 475  
476 -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.
477 477  
478 478  
479 -(% 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.
480 480  
481 481  (% border="1" style="background-color:#f7faff; width:436px" %)
482 482  |(% style="width:433px" %)(((
... ... @@ -498,49 +498,49 @@
498 498  |(% 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
499 499  |(% 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
500 500  
501 -* (% style="color:blue" %)** Downlink Payload:**
500 +* **(% style="color:blue" %) Downlink Payload:**
502 502  
503 -(% 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.
504 504  
505 505  
506 -(% 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.**
507 507  
508 508  
509 -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**
510 510  
511 511  Where:
512 512  
513 -* (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
514 -* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
515 -* (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
516 -* (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
517 -* (% 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. 
518 518  
519 -(% style="color:blue" %)**Example:**
518 +**(% style="color:blue" %)Example:**
520 520  
521 521  [[image:image-20230201094129-18.png]]
522 522  
523 523  
524 -(% style="color:blue" %)**Clear SDI12 Command**
523 +**(% style="color:blue" %)Clear SDI12 Command**
525 525  
526 526  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
527 527  
528 528  
529 -* (% style="color:#037691" %)**AT Command:**
528 +* ** (% style="color:#037691" %)AT Command:**
530 530  
531 -(% 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
532 532  
533 533  
534 534  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
535 535  
536 536  
537 -* (% style="color:#037691" %)** Downlink Payload:**
536 +* **(% style="color:#037691" %) Downlink Payload:**
538 538  
539 -(% 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
540 540  
541 541  
542 542  
543 -(% style="color:blue" %)**command combination**
542 +**(% style="color:blue" %)command combination**
544 544  
545 545  Below shows a screen shot how the results combines together to a uplink payload.
546 546  
... ... @@ -549,27 +549,27 @@
549 549  
550 550  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.
551 551  
552 -(% 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.
553 553  
554 554  
555 -(% 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.
556 556  
557 557  
558 558  [[image:1675215782925-448.png]]
559 559  
560 560  
561 -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.
562 562  
563 563  
564 564  
565 -(% style="color:blue" %)**Compose Uplink**
564 +**(% style="color:blue" %)Compose Uplink**
566 566  
567 567  
568 -(% style="color:#4f81bd" %)**AT+DATAUP=0**
567 +**(% style="color:#4F81BD" %)AT+DATAUP=0**
569 569  
570 -Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
569 +Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
571 571  
572 -Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__**
571 +Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
573 573  
574 574  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
575 575  
... ... @@ -577,12 +577,14 @@
577 577  [[image:1675215828102-844.png]]
578 578  
579 579  
580 -(% style="color:#4f81bd" %)**AT+DATAUP=1**
579 +**(% style="color:#4F81BD" %)AT+DATAUP=1**
581 581  
582 -Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**.
581 +Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs.
583 583  
584 -Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
583 +Final Payload is
585 585  
585 +__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
586 +
586 586  1. Battery Info (2 bytes): Battery voltage
587 587  1. PAYVER (1 byte): Defined by AT+PAYVER
588 588  1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
... ... @@ -592,7 +592,7 @@
592 592  [[image:1675215848113-696.png]]
593 593  
594 594  
595 -(% 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:**
596 596  
597 597  * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
598 598  * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
... ... @@ -599,12 +599,12 @@
599 599  * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
600 600  * For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
601 601  
602 -(% 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;**
603 603  
604 -(% 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.**
605 605  
606 606  
607 -== 2.4 Uplink Payload ==
608 +== ​​​​​​​2.4 Uplink Payload ==
608 608  
609 609  
610 610  Uplink payloads have two types:
... ... @@ -632,11 +632,11 @@
632 632  [[image:1675215946738-635.png]]
633 633  
634 634  
635 -(% 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
636 636  
637 -(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
638 +**(% style="color:#037691" %)Firmware Version**(%%): 0x0100, Means: v1.0.0 version
638 638  
639 -(% style="color:#037691" %)**Frequency Band**:
640 +**(% style="color:#037691" %)Frequency Band**:
640 640  
641 641  *0x01: EU868
642 642  
... ... @@ -667,7 +667,7 @@
667 667  *0x0e: MA869
668 668  
669 669  
670 -(% style="color:#037691" %)**Sub-Band**:
671 +**(% style="color:#037691" %)Sub-Band**:
671 671  
672 672  AU915 and US915:value 0x00 ~~ 0x08
673 673  
... ... @@ -676,7 +676,7 @@
676 676  Other Bands: Always 0x00
677 677  
678 678  
679 -(% style="color:#037691" %)**Battery Info**:
680 +**(% style="color:#037691" %)Battery Info**:
680 680  
681 681  Check the battery voltage.
682 682  
... ... @@ -723,7 +723,7 @@
723 723  === 2.4.4 Interrupt Pin ===
724 724  
725 725  
726 -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"]].
727 727  
728 728  **Example:**
729 729  
... ... @@ -754,9 +754,11 @@
754 754  
755 755  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:
756 756  
757 -[[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]]
758 758  
759 759  
761 +
762 +
760 760  == 2.6 Frequency Plans ==
761 761  
762 762  
... ... @@ -765,14 +765,14 @@
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  
771 771  **Firmware download link:**
772 772  
773 -[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
777 +[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
774 774  
775 -
776 776  
777 777  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
778 778  
... ... @@ -779,12 +779,12 @@
779 779  
780 780  Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
781 781  
782 -* AT Command Connection: See [[FAQ>>||anchor="H7.FAQ"]].
785 +* AT Command Connection: See [[FAQ>>path:#AT_COMMAND]].
783 783  * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
784 784  
785 785  There are two kinds of commands to configure SDI-12-LB, they are:
786 786  
787 -* (% style="color:blue" %)**General Commands**.
790 +* **General Commands**.
788 788  
789 789  These commands are to configure:
790 790  
... ... @@ -793,10 +793,10 @@
793 793  
794 794  They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
795 795  
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/]]
799 +[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]]
797 797  
798 798  
799 -* (% style="color:blue" %)**Commands special design for SDI-12-LB**
802 +* **Commands special design for SDI-12-LB**
800 800  
801 801  These commands only valid for SDI-12-LB, as below:
802 802  
... ... @@ -1017,7 +1017,7 @@
1017 1017  
1018 1018  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1019 1019  
1020 -[[image:1675234124233-857.png]]
1023 +[[image:1675146710956-626.png]]
1021 1021  
1022 1022  
1023 1023  Minimum Working Voltage for the SDI-12-LB:
... ... @@ -1050,10 +1050,9 @@
1050 1050  
1051 1051  And the Life expectation in difference case will be shown on the right.
1052 1052  
1056 +[[image:1675146895108-304.png]]
1053 1053  
1054 -[[image:1675234155374-163.png]]
1055 1055  
1056 -
1057 1057  The battery related documents as below:
1058 1058  
1059 1059  * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
... ... @@ -1060,7 +1060,7 @@
1060 1060  * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
1061 1061  * [[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]]
1062 1062  
1063 -[[image:image-20230201145019-19.png]]
1065 +[[image:image-20230131145708-3.png]]
1064 1064  
1065 1065  
1066 1066  === 4.3.1 ​Battery Note ===
... ... @@ -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,52 +1097,36 @@
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]]
1107 +Part Number: SDI-12-LB-XXX
1108 +XXX: The default frequency band
1106 1106  
1110 +AS923: LoRaWAN AS923 band
1111 +AU915: LoRaWAN AU915 band
1112 +EU433: LoRaWAN EU433 band
1113 +EU868: LoRaWAN EU868 band
1114 +KR920: LoRaWAN KR920 band
1115 +US915: LoRaWAN US915 band
1116 +IN865: LoRaWAN IN865 band
1117 +CN470: LoRaWAN CN470 band
1107 1107  
1108 -== 7.2 How to update firmware via UART port? ==
1109 1109  
1110 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 1112  
1113 1113  
1114 -== 7.3 How to change the LoRa Frequency Bands/Region? ==
1115 1115  
1116 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. ​
1125 += 8. Packing Info =
1119 1119  
1120 1120  
1121 -= 8. ​Order Info =
1128 +**Package Includes**:
1122 1122  
1123 -
1124 -(% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
1125 -
1126 -XXX: The default frequency band
1127 -
1128 -(% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1129 -(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1130 -(% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
1131 -(% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
1132 -(% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
1133 -(% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1134 -(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1135 -(% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1136 -
1137 -
1138 -= 9. Packing Info =
1139 -
1140 -
1141 -(% style="color:#037691" %)**Package Includes**:
1142 -
1143 1143  * SDI-12-LB SDI-12 to LoRaWAN Converter x 1
1144 1144  
1145 -(% style="color:#037691" %)**Dimension and weight**:
1132 +**Dimension and weight**:
1146 1146  
1147 1147  * Device Size: cm
1148 1148  * Device Weight: g
... ... @@ -1149,7 +1149,7 @@
1149 1149  * Package Size / pcs : cm
1150 1150  * Weight / pcs : g
1151 1151  
1152 -= 10. ​Support =
1139 += 9. ​Support =
1153 1153  
1154 1154  
1155 1155  * 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.
1675234155374-163.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -138.2 KB
Content
image-20230201145019-19.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -82.2 KB
Content
image-20230201152430-20.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -16.5 KB
Content