Last modified by Mengting Qiu on 2025/07/03 15:42

From version 39.1
edited by Xiaoling
on 2023/02/01 14:49
Change comment: Uploaded new attachment "1675234155374-163.png", version {1}
To version 47.1
edited by Bei Jinggeng
on 2023/03/20 10:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Bei
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:image-20230131183542-1.jpeg||height="694" width="694"]]
2 +[[image:image-20230131183542-1.jpeg||_mstalt="470678" height="694" width="694"]]
3 3  
4 4  **Table of Contents:**
5 5  
... ... @@ -17,36 +17,45 @@
17 17  
18 18  
19 19  
20 -
21 21  = 1. Introduction =
22 22  
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.
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 +)))
27 27  
29 +(((
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.
31 +)))
29 29  
33 +(((
30 30  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 +)))
31 31  
37 +(((
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.
39 +)))
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.
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 +)))
35 35  
45 +(((
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.
47 +)))
37 37  
38 38  
39 -[[image:image-20230201084414-1.png||height="464" width="1108"]]
50 +[[image:image-20230201084414-1.png||_mstalt="427765" height="464" width="1108"]]
40 40  
41 41  
42 -
43 -
44 44  == ​1.2 Features ==
45 45  
46 46  
47 47  * LoRaWAN 1.0.3 Class A
48 48  * Ultra-low power consumption
49 -* Controllable 5v and 12v output to power external sensor
58 +* Controllable 3.3v, 5v and 12v output to power external sensor
50 50  * SDI-12 Protocol to connect to SDI-12 Sensor
51 51  * Monitor Battery Level
52 52  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
... ... @@ -56,22 +56,23 @@
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:**
71 +(% 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:**
77 +(% style="color:#037691" %)**Common DC Characteristics:**
70 70  
71 71  * Supply Voltage: 2.5v ~~ 3.6v
80 +* Support current: 5V 300mA
81 + 12V 100mA
72 72  * Operating Temperature: -40 ~~ 85°C
73 73  
74 -**(% style="color:#037691" %)LoRa Spec:**
84 +(% 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 :**
91 +(% 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:**
97 +(% 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:**
103 +(% style="color:#037691" %)**Battery:**
94 94  
95 95  * Li/SOCI2 un-chargeable battery
96 96  * Capacity: 8500mAh
... ... @@ -98,52 +98,49 @@
98 98  * Max continuously current: 130mA
99 99  * Max boost current: 2A, 1 second
100 100  
101 -**(% style="color:#037691" %)Power Consumption**
111 +(% 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  
110 110  
111 -[[image:1675212538524-889.png]]
120 +[[image:1675212538524-889.png||_mstalt="298272"]]
112 112  
113 113  
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.
126 +(% 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.
128 +(% 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 ==
123 123  
124 124  
125 -[[image:1675212633011-651.png]]
134 +[[image:1675212633011-651.png||_mstalt="291538"]]
126 126  
127 127  
128 -
129 129  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
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" %)(((
138 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
139 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)(((
132 132  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
133 133  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
134 134  )))
135 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
143 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)(((
136 136  (% 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.
137 137  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
138 138  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.
139 139  )))
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 +|(% 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 SDI-12-LB is in Deep Sleep Mode.
141 141  
142 -
143 143  == 1.7 Pin Mapping ==
144 144  
145 145  
146 -[[image:1675213198663-754.png]]
153 +[[image:1675213198663-754.png||_mstalt="297167"]]
147 147  
148 148  
149 149  == 1.8 BLE connection ==
... ... @@ -163,11 +163,11 @@
163 163  == 1.9 Mechanical ==
164 164  
165 165  
166 -[[image:image-20230201090139-2.png]]
173 +[[image:image-20230201090139-2.png||_mstalt="428623"]]
167 167  
168 -[[image:image-20230201090139-3.png]]
175 +[[image:image-20230201090139-3.png||_mstalt="428987"]]
169 169  
170 -[[image:image-20230201090139-4.png]]
177 +[[image:image-20230201090139-4.png||_mstalt="429351"]]
171 171  
172 172  
173 173  = 2. Configure SDI-12 to connect to LoRaWAN network =
... ... @@ -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.
185 +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) ==
... ... @@ -184,60 +184,56 @@
184 184  Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
185 185  
186 186  
187 -[[image:image-20230201090528-5.png||height="465" width="1111"]]
194 +[[image:image-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]]
188 188  
189 189  
190 190  The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
191 191  
192 192  
193 -**(% style="color:blue" %)Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
200 +(% 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  
197 197  
198 -[[image:image-20230131134744-2.jpeg]]
205 +[[image:image-20230201152430-20.jpeg||_mstalt="492245"]]
199 199  
200 200  
201 -
202 -
203 -
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**
211 +(% style="color:blue" %)**Register the device**
208 208  
209 -[[image:1675213652444-622.png]]
213 +[[image:1675213652444-622.png||_mstalt="293657"]]
210 210  
211 211  
212 -**(% style="color:blue" %)Add APP EUI and DEV EUI**
216 +(% style="color:blue" %)**Add APP EUI and DEV EUI**
213 213  
214 214  
215 -[[image:1675213661769-223.png]]
219 +[[image:1675213661769-223.png||_mstalt="295217"]]
216 216  
217 217  
218 -**(% style="color:blue" %)Add APP EUI in the application**
222 +(% style="color:blue" %)**Add APP EUI in the application**
219 219  
220 220  
221 -[[image:1675213675852-577.png]]
225 +[[image:1675213675852-577.png||_mstalt="297947"]]
222 222  
223 223  
224 -**(% style="color:blue" %)Add APP KEY**
228 +(% style="color:blue" %)**Add APP KEY**
225 225  
226 -[[image:1675213686734-883.png]]
230 +[[image:1675213686734-883.png||_mstalt="298064"]]
227 227  
228 228  
229 -**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB
233 +(% 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  
238 +(% 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.
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.
236 236  
241 +[[image:1675213704414-644.png||_mstalt="293748"]]
237 237  
238 -[[image:1675213704414-644.png]]
239 239  
240 -
241 241  == ​2.3 SDI-12 Related Commands ==
242 242  
243 243  
... ... @@ -254,43 +254,43 @@
254 254  The following is the display information on the serial port and the server.
255 255  
256 256  
260 +[[image:image-20230201091027-6.png||_mstalt="429065"]]
257 257  
258 -[[image:image-20230201091027-6.png]]
259 259  
263 +[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
260 260  
261 -[[image:image-20230201091027-7.png||height="261" width="1179"]]
262 262  
263 263  
264 -==== **(% style="color:blue" %)al!  ~-~- Get SDI-12 sensor Identification** ====
267 +==== (% 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)
273 +(% 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)
275 +(% 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.
276 276  
277 277  
278 -[[image:image-20230201091257-8.png]]
281 +[[image:image-20230201091257-8.png||_mstalt="431392"]]
279 279  
280 280  
281 -[[image:image-20230201091257-9.png||height="225" width="1242"]]
284 +[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
282 282  
283 283  
284 -==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
287 +==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
285 285  
286 286  
287 -**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement
290 +(% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement
288 288  
289 -**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
292 +(% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
290 290  
291 -**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements
294 +(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements
292 292  
293 -**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
296 +(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
294 294  
295 295  
296 296  * AT Command : AT+ADDRM=0,1,0,1
... ... @@ -299,35 +299,35 @@
299 299  
300 300  Downlink:AA 01 aa bb cc dd
301 301  
302 -**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
305 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
303 303  
304 -**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
307 +(% 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
309 +(% 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.
311 +(% 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.
312 312  
313 313  
314 -[[image:image-20230201091630-10.png]]
317 +[[image:image-20230201091630-10.png||_mstalt="449995"]]
315 315  
316 316  
317 -[[image:image-20230201091630-11.png||height="247" width="1165"]]
320 +[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
318 318  
319 319  
320 320  
321 -==== **(% style="color:blue" %)aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
324 +==== (% style="color:blue" %)**aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! **(%%) ====
322 322  
323 323  
324 -**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement
327 +(% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement
325 325  
326 -**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC
329 +(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC
327 327  
328 -**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
331 +(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
329 329  
330 -**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
333 +(% 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,27 +336,27 @@
336 336  
337 337  Downlink: AA 02 aa bb cc dd
338 338  
339 -**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
342 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
340 340  
341 -**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
344 +(% 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
346 +(% 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.
348 +(% 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.
349 349  
350 350  
351 -[[image:image-20230201091954-12.png]]
354 +[[image:image-20230201091954-12.png||_mstalt="453687"]]
352 352  
353 353  
354 -[[image:image-20230201091954-13.png||height="203" width="1117"]]
357 +[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
355 355  
356 356  
357 357  
358 358  
359 -==== **(% style="color:blue" %)aR0!- aR9!,  aRC0!- aRC9!** ====
362 +==== (% style="color:blue" %)**aR0!- aR9!,  aRC0!- aRC9!**(%%) ====
360 360  
361 361  
362 362  Start Continuous Measurement
... ... @@ -369,25 +369,24 @@
369 369  
370 370  Downlink: AA 03 aa bb cc dd
371 371  
372 -**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
375 +(% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.
373 373  
374 -**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
377 +(% 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
379 +(% 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.
381 +(% 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.
382 382  
383 383  
387 +[[image:image-20230201092208-14.png||_mstalt="452283"]]
384 384  
385 -[[image:image-20230201092208-14.png]]
386 386  
390 +[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
387 387  
388 -[[image:image-20230201092208-15.png||height="214" width="1140"]]
389 389  
390 -
391 391  === 2.3.2 Advance SDI-12 Debug command ===
392 392  
393 393  
... ... @@ -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
401 +(% style="color:#037691" %)**aa **(%%): total SDI-12 command length
400 400  
401 -**(% style="color:#037691" %)xx **(%%): SDI-12 command
403 +(% style="color:#037691" %)**xx **(%%): SDI-12 command
402 402  
403 -**(% style="color:#037691" %)bb **(%%): Delay to wait for return
405 +(% 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
407 +(% 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
410 +(% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1
409 409  
410 -**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command,
412 +(% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command,
411 411  
412 -**(% style="color:#037691" %)1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
414 +(% 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  
... ... @@ -417,10 +417,10 @@
417 417  The following is the display information on the serial port and the server.
418 418  
419 419  
420 -[[image:image-20230201092355-16.png]]
422 +[[image:image-20230201092355-16.png||_mstalt="453960"]]
421 421  
422 422  
423 -[[image:image-20230201092355-17.png||height="426" width="1135"]]
425 +[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
424 424  
425 425  
426 426  === 2.3.3 Convert ASCII to String ===
... ... @@ -431,16 +431,16 @@
431 431  AT+CONVFORM ( Max length: 80 bytes)
432 432  
433 433  
434 -**(% style="color:blue" %)Example:**
436 +(% style="color:blue" %)**Example:**
435 435  
436 436  1) AT+CONVFORM=0, string Convert String from String to ASCII
437 437  
438 -[[image:1675214845056-885.png]]
440 +[[image:1675214845056-885.png||_mstalt="297622"]]
439 439  
440 440  
441 441  2) AT+CONVFORM=1, ASCII Convert ASCII to String.
442 442  
443 -[[image:1675214856590-846.png]]
445 +[[image:1675214856590-846.png||_mstalt="297739"]]
444 444  
445 445  
446 446  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
... ... @@ -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:**
456 +* (% style="color:blue" %)**AT Command:**
455 455  
456 -**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.**
458 +(% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.**
457 457  
458 -**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0!
460 +(% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0!
459 459  
460 -**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second)
462 +(% 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!//.
464 +(% 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.
466 +(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
465 465  
466 -**(% style="color:red" %)0 **(%%) No validation check;
468 +(% style="color:red" %)**0 **(%%) No validation check;
467 467  
468 -**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
470 +(% 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
472 +(% 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);
474 +(% 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.
477 +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.
480 +(% 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" %)(((
... ... @@ -488,102 +488,100 @@
488 488  **c**:  define the position for valid value. 
489 489  )))
490 490  
491 -For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
493 +For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
492 492  
493 493  
494 494  (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
495 -|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
496 -|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
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 -|(% 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
497 +|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
498 +|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
499 +|(% style="width:164px" %)34,2,1~~8+12~~16|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
500 +|(% style="width:164px" %)34,2,1~~34|(% style="width:344px" %)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:**
502 +* (% style="color:blue" %)** Downlink Payload:**
501 501  
502 -**(% style="color:blue" %)0xAF**(%%)  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
504 +(% 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.**
507 +(% 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**
510 +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. 
514 +* (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
515 +* (% style="color:#037691" %)**NN **(%%):  1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
516 +* (% style="color:#037691" %)**LL **(%%):  The length of AT+COMMAND or AT+DATACUT command
517 +* (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
518 +* (% style="color:#037691" %)**YY **(%%):  If YY=0, SDI-12-LB will execute the downlink command without uplink; if YY=1, SDI-12-LB will execute an uplink after got this command. 
517 517  
518 -**(% style="color:blue" %)Example:**
520 +(% style="color:blue" %)**Example:**
519 519  
520 -[[image:image-20230201094129-18.png]]
522 +[[image:image-20230201094129-18.png||_mstalt="455065"]]
521 521  
522 522  
523 -**(% style="color:blue" %)Clear SDI12 Command**
524 524  
526 +(% style="color:blue" %)**Clear SDI12 Command**
527 +
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:**
531 +* (% 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
533 +(% 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:**
539 +* (% style="color:#037691" %)** Downlink Payload:**
537 537  
538 -**(% style="color:#4F81BD" %)0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
541 +(% style="color:#4f81bd" %)**0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
539 539  
540 540  
541 541  
542 -**(% style="color:blue" %)command combination**
545 +(% 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  
546 -[[image:1675215745275-920.png]]
549 +[[image:1675215745275-920.png||_mstalt="295334"]]
547 547  
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.
554 +(% 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.
557 +(% 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 -[[image:1675215782925-448.png]]
560 +[[image:1675215782925-448.png||_mstalt="297466"]]
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.
563 +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**
567 +(% style="color:blue" %)**Compose Uplink**
565 565  
569 +(% style="color:#4f81bd" %)**AT+DATAUP=0**
566 566  
567 -**(% style="color:#4F81BD" %)AT+DATAUP=0**
571 +Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
568 568  
569 -Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
573 +Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__**
570 570  
571 -Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
572 -
573 573  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
574 574  
575 575  
576 -[[image:1675215828102-844.png]]
578 +[[image:1675215828102-844.png||_mstalt="294645"]]
577 577  
578 578  
579 -**(% style="color:#4F81BD" %)AT+DATAUP=1**
581 +(% style="color:#4f81bd" %)**AT+DATAUP=1**
580 580  
581 -Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs.
583 +Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**.
582 582  
583 -Final Payload is
585 +Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
584 584  
585 -__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
586 -
587 587  1. Battery Info (2 bytes): Battery voltage
588 588  1. PAYVER (1 byte): Defined by AT+PAYVER
589 589  1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
... ... @@ -590,10 +590,10 @@
590 590  1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
591 591  1. DATA: Valid value: max 6 bytes(US915 version here, Notice*!) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes
592 592  
593 -[[image:1675215848113-696.png]]
593 +[[image:1675215848113-696.png||_mstalt="296998"]]
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:**
596 +(% 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,22 +600,13 @@
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;**
603 +(% 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.**
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.**
606 606  
607 607  
608 -== ​​​​​​​2.4 Uplink Payload ==
608 +== 2.4 Uplink Payload ==
609 609  
610 -
611 -Uplink payloads have two types:
612 -
613 -* Distance Value: Use FPORT=2
614 -* Other control commands: Use other FPORT fields.
615 -
616 -The application server should parse the correct value based on FPORT settings.
617 -
618 -
619 619  === 2.4.1 Device Payload, FPORT~=5 ===
620 620  
621 621  
... ... @@ -623,21 +623,21 @@
623 623  
624 624  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
625 625  
626 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
617 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
627 627  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
628 -|(% style="width:102px" %)**Size (bytes)**|(% style="width:67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2**
629 -|(% style="width:102px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT
619 +|(% style="width:114px" %)**Size(bytes)**|(% style="width:39px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:59px" %)**1**|(% style="width:37px" %)**2**
620 +|(% style="width:114px" %)**Value**|(% style="width:39px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:59px" %)Sub-band|(% style="width:37px" %)BAT
630 630  
631 631  Example parse in TTNv3
632 632  
633 -[[image:1675215946738-635.png]]
624 +[[image:1675215946738-635.png||_mstalt="297778"]]
634 634  
635 635  
636 -**(% style="color:#037691" %)Sensor Model**(%%): For SDI-12-LB, this value is 0x17
627 +(% 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
629 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
639 639  
640 -**(% style="color:#037691" %)Frequency Band**:
631 +(% 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**:
662 +(% 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**:
671 +(% style="color:#037691" %)**Battery Info**:
681 681  
682 682  Check the battery voltage.
683 683  
... ... @@ -695,20 +695,20 @@
695 695  
696 696  * Periodically Uplink: FPORT=2
697 697  
698 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
699 -|(% style="width:93px" %)(((
689 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
690 +|=(% style="width: 90px;" %)(((
700 700  **Size(bytes)**
701 -)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
692 +)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
702 702  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
703 703  Battery(mV)
704 704  &
705 705  Interrupt_Flag
706 -)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)(((
697 +)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((
707 707  If the valid payload is too long and exceed the maximum support.
708 708  Payload length in server,server will show payload not provided in the LoRaWAN server.
709 709  )))
710 710  
711 -[[image:1675216282284-923.png]]
702 +[[image:1675216282284-923.png||_mstalt="295633"]]
712 712  
713 713  
714 714  === 2.4.3 Battery Info ===
... ... @@ -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"]].
718 +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  
... ... @@ -735,6 +735,7 @@
735 735  
736 736  === 2.4.5 Payload version ===
737 737  
729 +The version number of the payload, mainly used for decoding. The default is 01.
738 738  
739 739  
740 740  === 2.4.6 ​Decode payload in The Things Network ===
... ... @@ -742,7 +742,7 @@
742 742  
743 743  While using TTN network, you can add the payload format to decode the payload.
744 744  
745 -[[image:1675216779406-595.png]]
737 +[[image:1675216779406-595.png||_mstalt="298376"]]
746 746  
747 747  
748 748  There is no fix payload decoder in LoRaWAN server because the SDI-12 sensors returns are different. User need to write the decoder themselves for their case.
... ... @@ -755,26 +755,91 @@
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]]
750 +[[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  
753 +== 2.6 Examples To Set SDI commands. ==
761 761  
755 +=== 2.6.1 Examples 1 ===
762 762  
763 -== 2.6 Frequency Plans ==
764 764  
758 +COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
765 765  
760 +[[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]]
761 +
762 +
763 +(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:**
764 +
765 +a. Send the first command and get the first reply:
766 +
767 +(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
768 +
769 +b. Send the second command and get the second reply:
770 +
771 +(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
772 +
773 +c. Send the third command and get the third reply:
774 +
775 +(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
776 +
777 +d. Send the fourth command and get the fourth reply:
778 +
779 +(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
780 +
781 +e. Send the fifth command plus the sixth command, get the sixth reply:
782 +
783 +(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
784 +
785 +f. Send the seventh command plus the eighth command, get the eighth reply:
786 +
787 +(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
788 +
789 +g. Send the ninth command plus the tenth command, get the tenth reply:
790 +
791 +(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
792 +
793 +h. Send the eleventh command plus the twelfth command, get the twelfth reply:
794 +
795 +(% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1**
796 +
797 +
798 +(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor:**
799 +
800 +a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
801 +
802 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %);
803 +
804 +b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
805 +
806 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
807 +
808 +c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
809 +
810 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
811 +
812 +d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>”
813 +
814 +Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
815 +
816 +e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>”
817 +
818 +Partial cut, the cut sensor address and the first two parameters:(% style="color:#037691" %)**AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”**.
819 +
820 +
821 +== 2.7 Frequency Plans ==
822 +
823 +
766 766  The SDI-12-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
767 767  
768 768  [[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/]]
769 769  
770 770  
829 +== 2.8 Firmware Change Log ==
771 771  
772 -== 2.7 Firmware Change Log ==
773 773  
774 -
775 775  **Firmware download link:**
776 776  
777 -[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
834 +[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
778 778  
779 779  
780 780  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
... ... @@ -782,12 +782,12 @@
782 782  
783 783  Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink.
784 784  
785 -* AT Command Connection: See [[FAQ>>path:#AT_COMMAND]].
842 +* AT Command Connection: See [[FAQ>>||anchor="H7.FAQ"]].
786 786  * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
787 787  
788 788  There are two kinds of commands to configure SDI-12-LB, they are:
789 789  
790 -* **General Commands**.
847 +* (% style="color:blue" %)**General Commands**.
791 791  
792 792  These commands are to configure:
793 793  
... ... @@ -796,15 +796,15 @@
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]]
856 +[[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 -* **Commands special design for SDI-12-LB**
859 +* (% style="color:blue" %)**Commands special design for SDI-12-LB**
803 803  
804 804  These commands only valid for SDI-12-LB, as below:
805 805  
806 806  
807 -== ​​​​​​​3.1 Set Transmit Interval Time ==
864 +== 3.1 Set Transmit Interval Time ==
808 808  
809 809  
810 810  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -845,14 +845,14 @@
845 845  |(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
846 846  0
847 847  OK
848 -the mode is 0 = No interruption
905 +the mode is 0 = Disable Interrupt
849 849  )))
850 850  |(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
851 851  Set Transmit Interval
852 -~1. (Disable Interrupt),
853 -2. (Trigger by rising and falling edge)
854 -3. (Trigger by falling edge)
855 -4. (Trigger by rising edge)
909 +0. (Disable Interrupt),
910 +~1. (Trigger by rising and falling edge)
911 +2. (Trigger by falling edge)
912 +3. (Trigger by rising edge)
856 856  )))|(% style="width:165px" %)OK
857 857  
858 858  (% style="color:blue" %)**Downlink Command: 0x06**
... ... @@ -991,6 +991,7 @@
991 991  
992 992  == 3.6 Set the payload version ==
993 993  
1051 +
994 994  Feature, Set the payload version.
995 995  
996 996  (% style="color:blue" %)**AT Command: AT+PAYVER**
... ... @@ -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]]
1081 +[[image:1675234124233-857.png||_mstalt="295035"]]
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  
1115 +[[image:1675234155374-163.png||_mstalt="294411"]]
1058 1058  
1117 +
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,7 +1062,7 @@
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]]
1124 +[[image:image-20230201145019-19.png||_mstalt="453947"]]
1066 1066  
1067 1067  
1068 1068  === 4.3.1 ​Battery Note ===
... ... @@ -1079,7 +1079,6 @@
1079 1079  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)
1080 1080  
1081 1081  
1082 -
1083 1083  = 5. Remote Configure device =
1084 1084  
1085 1085  == 5.1 Connect via BLE ==
... ... @@ -1100,36 +1100,58 @@
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  
1161 += 7. FAQ =
1103 1103  
1104 -= 7. ​Order Info =
1163 +== 7.1 How to use AT Command to access device? ==
1105 1105  
1106 1106  
1107 -Part Number: SDI-12-LB-XXX
1108 -XXX: The default frequency band
1166 +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]]
1109 1109  
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
1118 1118  
1169 +== 7.2 How to update firmware via UART port? ==
1119 1119  
1120 1120  
1172 +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]]
1121 1121  
1122 1122  
1175 +== 7.3 How to change the LoRa Frequency Bands/Region? ==
1123 1123  
1124 1124  
1125 -= 8. Packing Info =
1178 +You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]].
1179 +When downloading the images, choose the required image file for download. ​
1126 1126  
1127 1127  
1128 -**Package Includes**:
1182 += 8. ​Order Info =
1129 1129  
1184 +
1185 +(((
1186 +(% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
1187 +)))
1188 +
1189 +(((
1190 +XXX: The default frequency band
1191 +)))
1192 +
1193 +(((
1194 +(% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1195 +(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1196 +(% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
1197 +(% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
1198 +(% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
1199 +(% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1200 +(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1201 +(% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1202 +)))
1203 +
1204 +
1205 += 9. Packing Info =
1206 +
1207 +
1208 +(% style="color:#037691" %)**Package Includes**:
1209 +
1130 1130  * SDI-12-LB SDI-12 to LoRaWAN Converter x 1
1131 1131  
1132 -**Dimension and weight**:
1212 +(% style="color:#037691" %)**Dimension and weight**:
1133 1133  
1134 1134  * Device Size: cm
1135 1135  * Device Weight: g
... ... @@ -1136,7 +1136,7 @@
1136 1136  * Package Size / pcs : cm
1137 1137  * Weight / pcs : g
1138 1138  
1139 -= 9. ​Support =
1219 += 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.
image-20230201145019-19.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +82.2 KB
Content
image-20230201152430-20.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +16.5 KB
Content
image-20230222143809-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +322.1 KB
Content