Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Xiaoling on 2025/04/25 08:58
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -16,34 +16,36 @@ 16 16 17 17 18 18 19 -= 1. Introduction = 19 +1. Introduction 20 +11. What is LoRaWAN Pressure Sensor 20 20 21 - == 1.1 Whatis SDI-12 to LoRaWAN Converter==22 +The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Convert **designed for Smart Agriculture solution. 22 22 23 23 24 -The Dragino **SDI-12-LB** is a **SDI-12 to LoRaWAN Converter **designed for Smart Agriculture solution. 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 27 + 28 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. 29 29 30 + 30 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. 31 31 33 + 32 32 **SDI-12-LB** is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years. 33 33 36 + 34 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. 35 35 36 36 37 -[[image:image-20230201084414-1.png||height="464" width="1108"]] 38 38 41 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 39 39 40 40 41 41 42 42 43 43 44 -== 1.2 Features == 45 - 46 - 47 +* 48 +*1. Features 47 47 * LoRaWAN 1.0.3 Class A 48 48 * Ultra-low power consumption 49 49 * Controllable 5v and 12v output to power external sensor ... ... @@ -56,8 +56,9 @@ 56 56 * Downlink to change configure 57 57 * 8500mAh Battery for long term use 58 58 59 -== 1.3 Specification == 60 60 62 +1. 63 +11. Specification 61 61 62 62 **Micro Controller:** 63 63 ... ... @@ -77,6 +77,7 @@ 77 77 * RX sensitivity: down to -139 dBm. 78 78 * Excellent blocking immunity 79 79 83 + 80 80 **Current Input Measuring :** 81 81 82 82 * Range: 0 ~~ 20mA ... ... @@ -83,6 +83,7 @@ 83 83 * Accuracy: 0.02mA 84 84 * Resolution: 0.001mA 85 85 90 + 86 86 **Voltage Input Measuring:** 87 87 88 88 * Range: 0 ~~ 30v ... ... @@ -89,6 +89,7 @@ 89 89 * Accuracy: 0.02v 90 90 * Resolution: 0.001v 91 91 97 + 92 92 **Battery:** 93 93 94 94 * Li/SOCI2 un-chargeable battery ... ... @@ -97,57 +97,68 @@ 97 97 * Max continuously current: 130mA 98 98 * Max boost current: 2A, 1 second 99 99 106 + 100 100 **Power Consumption** 101 101 102 102 * Sleep Mode: 5uA @ 3.3v 103 103 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 104 104 105 -== 1.4 Connect to SDI-12 Sensor == 106 106 113 +1. 114 +11. Connect to SDI-12 Sensor 107 107 116 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]] 108 108 109 -[[image:1675212538524-889.png]] 110 110 111 111 112 -== 1.5 Sleep mode and working mode == 120 +1. 121 +11. 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.124 +**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. 118 118 127 +**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 119 120 -== 1.6 Button & LEDs == 121 121 122 122 123 -[[image:1675212633011-651.png]] 124 124 125 125 133 +1. 134 +11. Button & LEDs 126 126 127 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 128 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action** 129 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 130 -If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]] 137 + 138 + 139 + 140 +|**Behavior on ACT**|**Function**|**Action** 141 +|Pressing ACT between 1s < time < 3s|Send an uplink|((( 142 +If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, **blue led** will blink once. 143 + 131 131 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 132 132 ))) 133 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 134 -(% 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. 135 -(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 146 +|Pressing ACT for more than 3s|Active Device|((( 147 +**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. 148 + 149 +**Green led** will solidly turn on for 5 seconds after joined in network. 150 + 136 136 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. 137 137 ))) 138 -| (% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red"%)**Redled**(%%)will solid on for 5 seconds. MeansPS-LBisin Deep Sleep Mode.153 +|Fast press ACT 5 times.|Deactivate Device|red led will solid on for 5 seconds. Means SDI-12-LB are in Deep Sleep Mode. 139 139 140 -== 1.7 Pin Mapping == 141 141 142 142 143 -[[image:1675213198663-754.png]] 157 +1. 158 +11. Pin Mapping 144 144 160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] 145 145 146 -== 1.8 BLE connection == 162 +1. 163 +11. BLE connection 147 147 148 - 149 149 SDI-12-LB support BLE remote configure. 150 150 167 + 151 151 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case: 152 152 153 153 * Press button to send an uplink ... ... @@ -157,23 +157,20 @@ 157 157 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 158 158 159 159 160 -== 1.9 Mechanical == 161 161 162 162 179 +1. 180 +11. Mechanical 163 163 182 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]] 164 164 184 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]] 165 165 166 -[[image:image -20230201090139-2.png]]186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]] 167 167 168 -[[image:image-20230201090139-3.png]] 169 169 170 -[[image:image-20230201090139-4.png]] 171 171 172 172 173 - 174 - 175 - 176 - 177 177 1. Configure SDI-12 to connect to LoRaWAN network 178 178 11. How it works 179 179 ... ... @@ -243,9 +243,10 @@ 243 243 244 244 245 245 246 -1. 260 +1. 247 247 11. SDI-12 Related Commands 248 248 263 + 249 249 User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. 250 250 251 251 ... ... @@ -377,7 +377,7 @@ 377 377 378 378 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]] 379 379 380 -1. 395 +1. 381 381 11. 382 382 111. Advance SDI-12 Debug command 383 383 ... ... @@ -412,7 +412,7 @@ 412 412 413 413 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]] 414 414 415 -1. 430 +1. 416 416 11. 417 417 111. Convert ASCII to String 418 418 ... ... @@ -434,7 +434,7 @@ 434 434 435 435 436 436 437 -1. 452 +1. 438 438 11. 439 439 111. Define periodically SDI-12 commands and uplink. 440 440 ... ... @@ -479,6 +479,7 @@ 479 479 c: define the position for valid value. 480 480 ))) 481 481 497 + 482 482 For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload: 483 483 484 484 ... ... @@ -487,6 +487,8 @@ 487 487 |34,2,1~~8+12~~16|0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32 488 488 |34,2,1~~34|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 489 489 506 + 507 + 490 490 * ** Downlink Payload:** 491 491 492 492 **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. ... ... @@ -507,7 +507,7 @@ 507 507 508 508 Example: 509 509 510 -**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 528 +**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1** 511 511 512 512 **AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10** 513 513 ... ... @@ -604,6 +604,7 @@ 604 604 1. 605 605 11. Uplink Payload 606 606 625 + 607 607 Uplink payloads have two types: 608 608 609 609 * Distance Value: Use FPORT=2 ... ... @@ -626,6 +626,7 @@ 626 626 |**Size (bytes)**|**1**|**2**|**1**|**1**|**2** 627 627 |**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 628 628 648 + 629 629 Example parse in TTNv3 630 630 631 631 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]] ... ... @@ -687,6 +687,7 @@ 687 687 11. 688 688 111. Uplink Payload, FPORT=2 689 689 710 + 690 690 There are different cases for uplink. See below 691 691 692 692 * SDI-12 Debug Command return: FPORT=100 ... ... @@ -693,6 +693,7 @@ 693 693 694 694 * Periodically Uplink: FPORT=2 695 695 717 + 696 696 |((( 697 697 **Size** 698 698 ... ... @@ -710,11 +710,12 @@ 710 710 Payload length in server,server will show payload not provided in the LoRaWAN server. 711 711 ))) 712 712 735 + 713 713 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]] 714 714 715 715 716 716 717 -1. 740 +1. 718 718 11. 719 719 111. Battery Info 720 720 ... ... @@ -747,6 +747,8 @@ 747 747 748 748 749 749 773 + 774 + 750 750 1. 751 751 11. 752 752 111. Decode payload in The Things Network ... ... @@ -1013,6 +1013,7 @@ 1013 1013 Set transmit interval to 60000ms = 60 seconds 1014 1014 ))) 1015 1015 1041 + 1016 1016 **Downlink Command: 0x01** 1017 1017 1018 1018 Format: Command Code (0x01) followed by 3 bytes time value. ... ... @@ -1022,6 +1022,8 @@ 1022 1022 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1023 1023 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1024 1024 1051 + 1052 + 1025 1025 1. 1026 1026 11. Set Interrupt Mode 1027 1027 ... ... @@ -1046,6 +1046,7 @@ 1046 1046 1. (Trigger by rising edge) 1047 1047 )))|OK 1048 1048 1077 + 1049 1049 **Downlink Command: 0x06** 1050 1050 1051 1051 Format: Command Code (0x06) followed by 3 bytes. ... ... @@ -1055,6 +1055,7 @@ 1055 1055 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1056 1056 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1057 1057 1087 + 1058 1058 1. 1059 1059 11. Set the output time 1060 1060 ... ... @@ -1084,6 +1084,7 @@ 1084 1084 1085 1085 ))) 1086 1086 1117 + 1087 1087 **AT Command: AT+5VT** 1088 1088 1089 1089 |**Command Example**|**Function**|**Response** ... ... @@ -1108,6 +1108,7 @@ 1108 1108 1109 1109 ))) 1110 1110 1142 + 1111 1111 **AT Command: AT+12VT** 1112 1112 1113 1113 |**Command Example**|**Function**|**Response** ... ... @@ -1123,6 +1123,7 @@ 1123 1123 1124 1124 ))) 1125 1125 1158 + 1126 1126 **Downlink Command: 0x07** 1127 1127 1128 1128 Format: Command Code (0x07) followed by 3 bytes. ... ... @@ -1136,6 +1136,7 @@ 1136 1136 * Example 5: Downlink Payload: 070301F4 -> AT+12VT=500 1137 1137 * Example 6: Downlink Payload: 07030000 -> AT+12VT=0 1138 1138 1172 + 1139 1139 1. 1140 1140 11. Set the all data mode 1141 1141 ... ... @@ -1152,6 +1152,7 @@ 1152 1152 ))) 1153 1153 |AT+ALLDATAMOD=1|Set all data mode is 1.|OK 1154 1154 1189 + 1155 1155 **Downlink Command: 0xAB** 1156 1156 1157 1157 Format: Command Code (0xAB) followed by 1 bytes. ... ... @@ -1159,6 +1159,7 @@ 1159 1159 * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 1160 1160 * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 1161 1161 1197 + 1162 1162 1. 1163 1163 11. Set the splicing payload for uplink 1164 1164 ... ... @@ -1189,6 +1189,7 @@ 1189 1189 1190 1190 )))|OK 1191 1191 1228 + 1192 1192 **Downlink Command: 0xAD** 1193 1193 1194 1194 Format: Command Code (0xAD) followed by 1 bytes or 5 bytes. ... ... @@ -1216,6 +1216,7 @@ 1216 1216 ))) 1217 1217 |AT+PAYVER=5|Set payload version is 5.|OK 1218 1218 1256 + 1219 1219 **Downlink Command: 0xAE** 1220 1220 1221 1221 Format: Command Code (0xAE) followed by 1 bytes. ... ... @@ -1223,6 +1223,8 @@ 1223 1223 * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1224 1224 * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1225 1225 1264 + 1265 + 1226 1226 1. Battery & how to replace 1227 1227 11. Battery Type 1228 1228 ... ... @@ -1251,6 +1251,7 @@ 1251 1251 1. 1252 1252 11. Power Consumption Analyze 1253 1253 1294 + 1254 1254 Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval. 1255 1255 1256 1256 ... ... @@ -1279,6 +1279,8 @@ 1279 1279 * [[Lithium-Thionyl Chloride Battery>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet-EN.pdf]] datasheet, [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/ER18505_datasheet_PM-ER18505-S-02-LF_EN.pdf]] 1280 1280 * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]] 1281 1281 1323 + 1324 + 1282 1282 |((( 1283 1283 JST-XH-2P connector 1284 1284 ))) ... ... @@ -1287,7 +1287,7 @@ 1287 1287 1288 1288 1289 1289 1290 -1. 1333 +1. 1291 1291 11. 1292 1292 111. Battery Note 1293 1293 ... ... @@ -1311,6 +1311,7 @@ 1311 1311 1. Remote Configure device 1312 1312 11. Connect via BLE 1313 1313 1357 + 1314 1314 Please see this instruction for how to configure via BLE: 1315 1315 1316 1316 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]] ... ... @@ -1319,6 +1319,8 @@ 1319 1319 1. 1320 1320 11. AT Command Set 1321 1321 1366 + 1367 + 1322 1322 1. OTA firmware update 1323 1323 1324 1324 Please see this link for how to do OTA firmware update. ... ... @@ -1341,6 +1341,7 @@ 1341 1341 1342 1342 * SDI-12-LB SDI-12 to LoRaWAN Converter 1343 1343 1390 + 1344 1344 **Dimension and weight**: 1345 1345 1346 1346 * Device Size: cm ... ... @@ -1350,6 +1350,8 @@ 1350 1350 1351 1351 1352 1352 1400 + 1401 + 1353 1353 1. Support 1354 1354 1355 1355 * 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.