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

From version 37.5
edited by Xiaoling
on 2023/02/01 10:38
Change comment: There is no comment for this version
To version 37.10
edited by Xiaoling
on 2023/02/01 13:53
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -3,6 +3,7 @@
3 3  
4 4  **Table of Contents:**
5 5  
6 +{{toc/}}
6 6  
7 7  
8 8  
... ... @@ -16,22 +16,23 @@
16 16  
17 17  
18 18  
20 +
19 19  = 1. Introduction =
20 20  
21 21  == 1.1 ​What is SDI-12 to LoRaWAN Converter ==
22 22  
23 23  
24 -The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution.
26 +The Dragino **(% style="color:blue" %)SDI-12-LB**(%%) is a **(% style="color:blue" %)SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
25 25  
26 26  SDI-12 (Serial Digital Interface at 1200 baud) is an asynchronous [[serial communications>>url:https://en.wikipedia.org/wiki/Serial_communication]] protocol for intelligent sensors that monitor environment data. SDI-12 protocol is widely used in Agriculture sensor and Weather Station sensors.
27 27  
28 -**SDI-12-LB** has SDI-12 interface and support 12v output to power external SDI-12 sensor. It can get the environment data from SDI-12 sensor and sends out the data via LoRaWAN wireless protocol.
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.
29 29  
30 -The LoRa wireless technology used in **SDI-12-LB** allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
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.
31 31  
32 -**SDI-12-LB** is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.
34 +SDI-12-LB is powered by **(% style="color:blue" %)8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
33 33  
34 -Each **SDI-12-LB** is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
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.
35 35  
36 36  
37 37  [[image:image-20230201084414-1.png||height="464" width="1108"]]
... ... @@ -39,8 +39,6 @@
39 39  
40 40  
41 41  
42 -
43 -
44 44  == ​1.2 Features ==
45 45  
46 46  
... ... @@ -56,21 +56,22 @@
56 56  * Downlink to change configure
57 57  * 8500mAh Battery for long term use
58 58  
59 +
59 59  == 1.3 Specification ==
60 60  
61 61  
62 -**Micro Controller:**
63 +**(% style="color:#037691" %)Micro Controller:**
63 63  
64 64  * MCU: 48Mhz ARM
65 65  * Flash: 256KB
66 66  * RAM: 64KB
67 67  
68 -**Common DC Characteristics:**
69 +**(% style="color:#037691" %)Common DC Characteristics:**
69 69  
70 70  * Supply Voltage: 2.5v ~~ 3.6v
71 71  * Operating Temperature: -40 ~~ 85°C
72 72  
73 -**LoRa Spec:**
74 +**(% style="color:#037691" %)LoRa Spec:**
74 74  
75 75  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
76 76  * Max +22 dBm constant RF output vs.
... ... @@ -77,19 +77,19 @@
77 77  * RX sensitivity: down to -139 dBm.
78 78  * Excellent blocking immunity
79 79  
80 -**Current Input Measuring :**
81 +**(% style="color:#037691" %)Current Input Measuring :**
81 81  
82 82  * Range: 0 ~~ 20mA
83 83  * Accuracy: 0.02mA
84 84  * Resolution: 0.001mA
85 85  
86 -**Voltage Input Measuring:**
87 +**(% style="color:#037691" %)Voltage Input Measuring:**
87 87  
88 88  * Range: 0 ~~ 30v
89 89  * Accuracy: 0.02v
90 90  * Resolution: 0.001v
91 91  
92 -**Battery:**
93 +**(% style="color:#037691" %)Battery:**
93 93  
94 94  * Li/SOCI2 un-chargeable battery
95 95  * Capacity: 8500mAh
... ... @@ -97,11 +97,12 @@
97 97  * Max continuously current: 130mA
98 98  * Max boost current: 2A, 1 second
99 99  
100 -**Power Consumption**
101 +**(% style="color:#037691" %)Power Consumption**
101 101  
102 102  * Sleep Mode: 5uA @ 3.3v
103 103  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
104 104  
106 +
105 105  == 1.4 Connect to SDI-12 Sensor ==
106 106  
107 107  
... ... @@ -112,9 +112,9 @@
112 112  == 1.5 Sleep mode and working mode ==
113 113  
114 114  
115 -**Deep Sleep Mode: **Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
117 +**(% style="color:blue" %)Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
116 116  
117 -**Working Mode: **In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
119 +**(% style="color:blue" %)Working Mode: **(%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
118 118  
119 119  
120 120  == 1.6 Button & LEDs ==
... ... @@ -137,6 +137,7 @@
137 137  )))
138 138  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
139 139  
142 +
140 140  == 1.7 Pin Mapping ==
141 141  
142 142  
... ... @@ -160,9 +160,6 @@
160 160  == 1.9 Mechanical ==
161 161  
162 162  
163 -
164 -
165 -
166 166  [[image:image-20230201090139-2.png]]
167 167  
168 168  [[image:image-20230201090139-3.png]]
... ... @@ -175,7 +175,7 @@
175 175  == 2.1 How it works ==
176 176  
177 177  
178 -The SDI-12-LB is configured as **LoRaWAN OTAA Class A** mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
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.
179 179  
180 180  
181 181  == 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -190,7 +190,7 @@
190 190  The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
191 191  
192 192  
193 -**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.
194 194  
195 195  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
196 196  
... ... @@ -204,35 +204,35 @@
204 204  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
205 205  
206 206  
207 -**Register the device**
207 +**(% style="color:blue" %)Register the device**
208 208  
209 209  [[image:1675213652444-622.png]]
210 210  
211 211  
212 -**Add APP EUI and DEV EUI**
212 +**(% style="color:blue" %)Add APP EUI and DEV EUI**
213 213  
214 214  
215 215  [[image:1675213661769-223.png]]
216 216  
217 217  
218 -**Add APP EUI in the application**
218 +**(% style="color:blue" %)Add APP EUI in the application**
219 219  
220 220  
221 221  [[image:1675213675852-577.png]]
222 222  
223 223  
224 -**Add APP KEY**
224 +**(% style="color:blue" %)Add APP KEY**
225 225  
226 226  [[image:1675213686734-883.png]]
227 227  
228 228  
229 -**Step 2**: Activate on SDI-12-LB
229 +**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB
230 230  
231 231  
232 232  Press the button for 5 seconds to activate the SDI-12-LB.
233 233  
234 234  
235 -**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. **Green led** will solidly turn on for 5 seconds after joined in network.
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  
237 237  
238 238  [[image:1675213704414-644.png]]
... ... @@ -261,15 +261,15 @@
261 261  [[image:image-20230201091027-7.png||height="261" width="1179"]]
262 262  
263 263  
264 -==== **al!  ~-~- Get SDI-12 sensor Identification** ====
264 +==== **(% 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 -**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)
271 271  
272 -**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)
273 273  
274 274  
275 275  The following is the display information on the serial port and the server.
... ... @@ -281,30 +281,31 @@
281 281  [[image:image-20230201091257-9.png||height="225" width="1242"]]
282 282  
283 283  
284 -==== **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
284 +==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
285 285  
286 286  
287 -**aM! **: Start Non-Concurrent Measurement
287 +**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement
288 288  
289 -**aMC! **: Start Non-Concurrent Measurement – Request CRC
289 +**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
290 290  
291 -**aM1!- aM9! **: Additional Measurements
291 +**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements
292 292  
293 -**aMC1!- aMC9!** : Additional Measurements – Request CRC
293 +**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
294 294  
295 295  
296 296  * AT Command : AT+ADDRM=0,1,0,1
297 +
297 297  * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01
298 298  
299 299  Downlink:AA 01 aa bb cc dd
300 300  
301 -**aa**: SDI-12 sensor address.
302 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
302 302  
303 -**bb**: 0: no CRC, 1: request CRC
304 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
304 304  
305 -**cc**: 1-9: Additional Measurement, 0: no additional measurement
306 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
306 306  
307 -**dd**: delay (in second) to send **aD0!** to get return.
308 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
308 308  
309 309  
310 310  The following is the display information on the serial port and the server.
... ... @@ -317,16 +317,16 @@
317 317  
318 318  
319 319  
320 -==== **aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
321 +==== **(% style="color:blue" %)aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
321 321  
322 322  
323 -**aC!** : Start Concurrent Measurement
324 +**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement
324 324  
325 -**aCC!** : Start Concurrent Measurement – Request CRC
326 +**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC
326 326  
327 -**aC1!- aC9!** : Start Additional Concurrent Measurements
328 +**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
328 328  
329 -**aCC1!- aCC9!** : Start Additional Concurrent Measurements – Request CRC
330 +**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
330 330  
331 331  
332 332  * AT Command : AT+ADDRC=0,1,0,1 
... ... @@ -335,13 +335,13 @@
335 335  
336 336  Downlink: AA 02 aa bb cc dd
337 337  
338 -**aa**: SDI-12 sensor address.
339 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
339 339  
340 -**bb**: 0: no CRC, 1: request CRC
341 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
341 341  
342 -**cc**: 1-9: Additional Measurement, 0: no additional measurement
343 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
343 343  
344 -**dd**: delay (in second) to send **aD0!** to get return.
345 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
345 345  
346 346  
347 347  The following is the display information on the serial port and the server.
... ... @@ -353,11 +353,11 @@
353 353  [[image:image-20230201091954-13.png||height="203" width="1117"]]
354 354  
355 355  
356 -(% style="display:none" %) (%%)
357 357  
358 -==== **aR0!- aR9!,  aRC0!- aRC9!** ====
359 359  
359 +==== **(% style="color:blue" %)aR0!- aR9!,  aRC0!- aRC9!** ====
360 360  
361 +
361 361  Start Continuous Measurement
362 362  
363 363  Start Continuous Measurement – Request CRC
... ... @@ -368,13 +368,13 @@
368 368  
369 369  Downlink: AA 03 aa bb cc dd
370 370  
371 -**aa**: SDI-12 sensor address.
372 +**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
372 372  
373 -**bb**: 0: no CRC, 1: request CRC
374 +**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
374 374  
375 -**cc**: 1-9: Additional Measurement, 0: no additional measurement
376 +**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
376 376  
377 -**dd**: delay (in second) to send **aD0!** to get return.
378 +**(% style="color:#037691" %)dd**(%%): delay (in second) to send **(% style="color:#037691" %)aD0!**(%%) to get return.
378 378  
379 379  
380 380  The following is the display information on the serial port and the server.
... ... @@ -827,31 +827,32 @@
827 827  
828 828  Format: Command Code (0x01) followed by 3 bytes time value.
829 829  
830 -If the downlink payload=0100003C, it means set the END Nodes Transmit Interval to 0x00003C=60(S), while type code is 01.
831 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
831 831  
832 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
833 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
833 +* Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
834 +* Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
834 834  
835 835  == 3.2 Set Interrupt Mode ==
836 836  
838 +
837 837  Feature, Set Interrupt mode for GPIO_EXIT.
838 838  
839 839  (% style="color:blue" %)**AT Command: AT+INTMOD**
840 840  
841 841  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
842 -|=**Command Example**|=**Function**|=**Response**
843 -|AT+INTMOD=?|Show current interrupt mode|(((
844 +|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 187px;" %)**Function**|=(% style="width: 165px;" %)**Response**
845 +|(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
844 844  0
845 845  OK
846 846  the mode is 0 = No interruption
847 847  )))
848 -|AT+INTMOD=2|(((
850 +|(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
849 849  Set Transmit Interval
850 850  ~1. (Disable Interrupt),
851 851  2. (Trigger by rising and falling edge)
852 852  3. (Trigger by falling edge)
853 853  4. (Trigger by rising edge)
854 -)))|OK
856 +)))|(% style="width:165px" %)OK
855 855  
856 856  (% style="color:blue" %)**Downlink Command: 0x06**
857 857  
... ... @@ -859,8 +859,8 @@
859 859  
860 860  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
861 861  
862 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
863 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
864 +* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
865 +* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
864 864  
865 865  == 3.3 Set the output time ==
866 866  
... ... @@ -980,9 +980,9 @@
980 980  
981 981  Format: Command Code (0xAD) followed by 1 bytes or 5 bytes.
982 982  
983 -* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0
984 -* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1
985 -* Example 3: Downlink Payload: AD 01 00 00 14~/~/ AT+DATAUP =1,20000
985 +* Example 1: Downlink Payload: AD 00  ~/~/  AT+DATAUP=0
986 +* Example 2: Downlink Payload: AD 01  ~/~/  AT+DATAUP =1
987 +* Example 3: Downlink Payload: AD 01 00 00 14  ~/~/  AT+DATAUP =1,20000
986 986  
987 987  This means that the interval is set to 0x000014=20S
988 988  
... ... @@ -993,19 +993,20 @@
993 993  
994 994  (% style="color:blue" %)**AT Command: AT+PAYVER**
995 995  
996 -|**Command Example**|**Function**|**Response**
997 -|AT+PAYVER=?|Show current payload version|(((
998 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
999 +|=(% style="width: 158px;" %)**Command Example**|=(% style="width: 192px;" %)**Function**|=**Response**
1000 +|(% style="width:158px" %)AT+PAYVER=?|(% style="width:192px" %)Show current payload version|(((
998 998  1
999 999  OK
1000 1000  )))
1001 -|AT+PAYVER=5|Set payload version is 5.|OK
1004 +|(% style="width:158px" %)AT+PAYVER=5|(% style="width:192px" %)Set payload version is 5.|OK
1002 1002  
1003 1003  (% style="color:blue" %)**Downlink Command: 0xAE**
1004 1004  
1005 1005  Format: Command Code (0xAE) followed by 1 bytes.
1006 1006  
1007 -* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1
1008 -* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5
1010 +* Example 1: Downlink Payload: AE 01  ~/~/  AT+PAYVER=1
1011 +* Example 2: Downlink Payload: AE 05  ~/~/  AT+PAYVER=5
1009 1009  
1010 1010  = 4. Battery & how to replace =
1011 1011  
... ... @@ -1140,3 +1140,4 @@
1140 1140  
1141 1141  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
1142 1142  
1146 +