Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual
Last modified by Mengting Qiu on 2025/07/03 15:42
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 32 removed)
- 1675213652444-622.png
- 1675213661769-223.png
- 1675213675852-577.png
- 1675213686734-883.png
- 1675213704414-644.png
- 1675214845056-885.png
- 1675214856590-846.png
- 1675215745275-920.png
- 1675215782925-448.png
- 1675215828102-844.png
- 1675215848113-696.png
- 1675215946738-635.png
- 1675216282284-923.png
- 1675216779406-595.png
- 1675234124233-857.png
- 1675234155374-163.png
- image-20230201090528-5.png
- image-20230201091027-6.png
- image-20230201091027-7.png
- image-20230201091257-8.png
- image-20230201091257-9.png
- image-20230201091630-10.png
- image-20230201091630-11.png
- image-20230201091954-12.png
- image-20230201091954-13.png
- image-20230201092208-14.png
- image-20230201092208-15.png
- image-20230201092355-16.png
- image-20230201092355-17.png
- image-20230201094129-18.png
- image-20230201145019-19.png
- image-20230201152430-20.jpeg
Details
- Page properties
-
- Content
-
... ... @@ -3,7 +3,6 @@ 3 3 4 4 **Table of Contents:** 5 5 6 -{{toc/}} 7 7 8 8 9 9 ... ... @@ -17,42 +17,36 @@ 17 17 18 18 19 19 20 -= 1. Introduction = 19 +1. Introduction 20 +11. What is LoRaWAN Pressure Sensor 21 21 22 - == 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. 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 -))) 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 -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 -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 -))) 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. 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 -))) 44 44 45 -((( 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 -))) 31 +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. 48 48 49 49 50 - [[image:image-20230201084414-1.png||height="464"width="1108"]]34 +**SDI-12-LB** is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years. 51 51 52 52 53 - ==1.2Features==37 +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. 54 54 55 55 40 + 41 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 42 + 43 + 44 + 45 + 46 + 47 +* 48 +*1. Features 56 56 * LoRaWAN 1.0.3 Class A 57 57 * Ultra-low power consumption 58 58 * Controllable 5v and 12v output to power external sensor ... ... @@ -66,22 +66,21 @@ 66 66 * 8500mAh Battery for long term use 67 67 68 68 62 +1. 63 +11. Specification 69 69 70 - == 1.3 Specification==65 +**Micro Controller:** 71 71 72 - 73 -(% style="color:#037691" %)**Micro Controller:** 74 - 75 75 * MCU: 48Mhz ARM 76 76 * Flash: 256KB 77 77 * RAM: 64KB 78 78 79 - (% style="color:#037691" %)**Common DC Characteristics:**71 +**Common DC Characteristics:** 80 80 81 81 * Supply Voltage: 2.5v ~~ 3.6v 82 82 * Operating Temperature: -40 ~~ 85°C 83 83 84 - (% style="color:#037691" %)**LoRa Spec:**76 +**LoRa Spec:** 85 85 86 86 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 87 87 * Max +22 dBm constant RF output vs. ... ... @@ -88,20 +88,23 @@ 88 88 * RX sensitivity: down to -139 dBm. 89 89 * Excellent blocking immunity 90 90 91 -(% style="color:#037691" %)**Current Input Measuring :** 92 92 84 +**Current Input Measuring :** 85 + 93 93 * Range: 0 ~~ 20mA 94 94 * Accuracy: 0.02mA 95 95 * Resolution: 0.001mA 96 96 97 -(% style="color:#037691" %)**Voltage Input Measuring:** 98 98 91 +**Voltage Input Measuring:** 92 + 99 99 * Range: 0 ~~ 30v 100 100 * Accuracy: 0.02v 101 101 * Resolution: 0.001v 102 102 103 -(% style="color:#037691" %)**Battery:** 104 104 98 +**Battery:** 99 + 105 105 * Li/SOCI2 un-chargeable battery 106 106 * Capacity: 8500mAh 107 107 * Self-Discharge: <1% / Year @ 25°C ... ... @@ -108,60 +108,68 @@ 108 108 * Max continuously current: 130mA 109 109 * Max boost current: 2A, 1 second 110 110 111 -(% style="color:#037691" %)**Power Consumption** 112 112 107 +**Power Consumption** 108 + 113 113 * Sleep Mode: 5uA @ 3.3v 114 114 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 115 115 116 116 113 +1. 114 +11. Connect to SDI-12 Sensor 117 117 118 - == 1.4ConnecttoSDI-12 Sensor ==116 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]] 119 119 120 120 121 121 122 -[[image:1675212538524-889.png]] 120 +1. 121 +11. Sleep mode and working mode 123 123 124 124 125 - ==1.5Sleepmode andworkingmode==124 +**Deep Sleep Mode: Sensor doesn’t have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.** 126 126 127 127 128 - (% style="color:blue"%)**DeepSleepMode:**(%%)Sensordoesn'thaveanyLoRaWAN activate.Thismode isusedforstorage andshippingto savebatterylife.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.** 129 129 130 -(% 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. 131 131 132 132 133 -== 1.6 Button & LEDs == 134 134 135 135 136 -[[image:1675212633011-651.png]] 133 +1. 134 +11. Button & LEDs 137 137 136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]] 138 138 139 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 140 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action** 141 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)((( 142 -If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 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 + 143 143 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 144 144 ))) 145 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)((( 146 -(% 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. 147 -(% 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 + 148 148 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. 149 149 ))) 150 -| (% style="width:167px" %)Fast press ACT 5 times.|(% style="width:109px" %)Deactivate Device|(% style="width:231px" %)(% 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. 151 151 152 152 153 153 154 -== 1.7 Pin Mapping == 157 +1. 158 +11. Pin Mapping 155 155 160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] 156 156 157 -[[image:1675213198663-754.png]] 162 +1. 163 +11. BLE connection 158 158 159 - 160 -== 1.8 BLE connection == 161 - 162 - 163 163 SDI-12-LB support BLE remote configure. 164 164 167 + 165 165 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: 166 166 167 167 * Press button to send an uplink ... ... @@ -171,172 +171,175 @@ 171 171 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 172 172 173 173 174 -== 1.9 Mechanical == 175 175 176 176 177 -[[image:image-20230201090139-2.png]] 179 +1. 180 +11. Mechanical 178 178 179 -[[image:image -20230201090139-3.png]]182 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]] 180 180 181 -[[image:image -20230201090139-4.png]]184 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]] 182 182 186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]] 183 183 184 -= 2. Configure SDI-12 to connect to LoRaWAN network = 185 185 186 -== 2.1 How it works == 187 187 188 188 189 -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. 191 +1. Configure SDI-12 to connect to LoRaWAN network 192 +11. How it works 190 190 194 +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. 191 191 192 -== 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 193 193 197 +1. 198 +11. Quick guide to connect to LoRaWAN server (OTAA) 194 194 195 195 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. 196 196 197 197 198 -[[image:image -20230201090528-5.png||height="465" width="1111"]]203 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]] 199 199 200 200 201 201 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. 202 202 203 203 204 - (% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.209 +**Step 1**: Create a device in TTN with the OTAA keys from SDI-12-LB. 205 205 206 206 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 207 207 208 208 209 -[[image:image -20230201152430-20.jpeg]]214 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]] 210 210 211 211 217 + 218 + 219 + 212 212 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 213 213 214 214 215 - (% style="color:blue" %)**Register the device**223 +**Register the device** 216 216 217 -[[image: 1675213652444-622.png]]225 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]] 218 218 219 219 220 - (% style="color:blue" %)**Add APP EUI and DEV EUI**228 +**Add APP EUI and DEV EUI** 221 221 222 222 223 -[[image: 1675213661769-223.png]]231 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]] 224 224 225 225 226 - (% style="color:blue" %)**Add APP EUI in the application**234 +**Add APP EUI in the application** 227 227 228 228 229 -[[image: 1675213675852-577.png]]237 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]] 230 230 231 231 232 - (% style="color:blue" %)**Add APP KEY**240 +**Add APP KEY** 233 233 234 -[[image: 1675213686734-883.png]]242 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] 235 235 236 236 237 - (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB245 +**Step 2**: Activate on SDI-12-LB 238 238 239 239 240 240 Press the button for 5 seconds to activate the SDI-12-LB. 241 241 242 -(% 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. 243 243 251 +**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. 244 244 245 -[[image:1675213704414-644.png]] 246 246 254 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]] 247 247 248 -== 2.3 SDI-12 Related Commands == 249 249 250 250 251 -User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. 252 252 253 253 254 -=== 2.3.1 Basic SDI-12 debug command === 260 +1. 261 +11. SDI-12 Related Commands 255 255 256 256 257 -User canrunsomebasicSDI-12commandtodebug theconnectionto theSDI-12 sensor.Thesecommands can besentviaAT CommandorLoRaWAN downlinkcommand.264 +User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. 258 258 259 -If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server. 260 260 261 -The following is the display information on the serial port and the server. 267 +1. 268 +11. 269 +111. Basic SDI-12 debug command 262 262 271 +User can run some basic SDI-12 command to debug the connection to the SDI-12 sensor. These commands can be sent via AT Command or LoRaWAN downlink command. 263 263 264 -[[image:image-20230201091027-6.png]] 265 265 274 +If SDI-12 sensor return value after get these commands, //SDI-12-LB// will uplink the return on FPORT=100, otherwise, if there is no response from SDI-12 sensor. //SDI-12-LB// will uplink NULL (0x 4E 55 4C 4C) to server. 266 266 267 -[[image:image-20230201091027-7.png||height="261" width="1179"]] 268 268 277 +The following is the display information on the serial port and the server. 269 269 279 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] 270 270 271 - ==== (% style="color:blue" %)**al! ~-~- Get SDI-12sensor Identification**(%%) ====281 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]] 272 272 283 +al! ~-~- Get SDI-12 sensor Identification 273 273 274 274 * AT Command: AT+ADDRI=aa 275 275 * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa 276 276 277 - (% style="color:#037691" %)**Parameter:**(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)288 +Parameter: aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) 278 278 279 - (% style="color:blue" %)**Example :**(%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)290 +Example : AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) 280 280 281 281 293 + 282 282 The following is the display information on the serial port and the server. 283 283 284 284 285 -[[image:image -20230201091257-8.png]]297 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]] 286 286 299 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]] 287 287 288 -[[image:image-20230201091257-9.png||height="225" width="1242"]] 289 289 302 +aM!,aMC!, aM1!- aM9!, aMC1!- aMC9! 290 290 291 - ==== (% style="color:blue" %)**aM!,aMC!,aM1!-aM9!, aMC1!-aMC9!**(%%)====304 +aM!: Start Non-Concurrent Measurement 292 292 306 +aMC!: Start Non-Concurrent Measurement – Request CRC 293 293 294 - (% style="color:red" %)**aM!**(%%):Start Non-ConcurrentMeasurement308 +aM1!- aM9!: Additional Measurements 295 295 296 - (% style="color:red" %)**aMC!**(%%):Start Non-ConcurrentMeasurement – Request CRC310 +aMC1!- aMC9!: Additional Measurements – Request CRC 297 297 298 -(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements 299 299 300 -(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 301 - 302 - 303 303 * AT Command : AT+ADDRM=0,1,0,1 304 - 305 305 * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01 306 306 307 307 Downlink:AA 01 aa bb cc dd 308 308 309 - (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.318 +aa: SDI-12 sensor address. 310 310 311 - (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC320 +bb: 0: no CRC, 1: request CRC 312 312 313 - (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement322 +cc: 1-9: Additional Measurement, 0: no additional measurement 314 314 315 - (% style="color:#037691" %)**dd**(%%): delay (in second) to send(% style="color:#037691" %)__**aD0!**__(%%)to get return.324 +dd: delay (in second) to send **aD0!** to get return. 316 316 317 317 318 318 The following is the display information on the serial port and the server. 319 319 329 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]] 320 320 321 -[[image:image -20230201091630-10.png]]331 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]] 322 322 323 323 324 -[[image:image-20230201091630-11.png||height="247" width="1165"]] 325 325 335 +aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! 326 326 337 +aC!: Start Concurrent Measurement 327 327 328 - ==== (% style="color:blue" %)**aC!, aCC!,aC1!-aC9!,aCC1!-aCC9!**(%%)====339 +aCC!: Start Concurrent Measurement – Request CRC 329 329 341 +aC1!- aC9!: Start Additional Concurrent Measurements 330 330 331 - (% style="color:red" %)**aC!**(%%): Start Concurrent Measurement343 +aCC1!- aCC9!: Start Additional Concurrent Measurements – Request CRC 332 332 333 -(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC 334 334 335 -(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 336 - 337 -(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 338 - 339 - 340 340 * AT Command : AT+ADDRC=0,1,0,1 341 341 342 342 * LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01 ... ... @@ -343,29 +343,24 @@ 343 343 344 344 Downlink: AA 02 aa bb cc dd 345 345 346 - (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.352 +aa: SDI-12 sensor address. 347 347 348 - (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC354 +bb: 0: no CRC, 1: request CRC 349 349 350 - (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement356 +cc: 1-9: Additional Measurement, 0: no additional measurement 351 351 352 - (% style="color:#037691" %)**dd**(%%): delay (in second) to send(% style="color:#037691" %)__**aD0!**__(%%)____to get return.358 +dd: delay (in second) to send **aD0!** to get return. 353 353 354 354 355 355 The following is the display information on the serial port and the server. 356 356 363 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]] 357 357 358 -[[image:image -20230201091954-12.png]]365 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]] 359 359 360 360 361 - [[image:image-20230201091954-13.png||height="203"width="1117"]]368 +aR0!- aR9!, aRC0!- aRC9! 362 362 363 - 364 - 365 - 366 -==== (% style="color:blue" %)**aR0!- aR9!, aRC0!- aRC9!**(%%) ==== 367 - 368 - 369 369 Start Continuous Measurement 370 370 371 371 Start Continuous Measurement – Request CRC ... ... @@ -376,47 +376,46 @@ 376 376 377 377 Downlink: AA 03 aa bb cc dd 378 378 379 - (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.380 +aa: SDI-12 sensor address. 380 380 381 - (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC382 +bb: 0: no CRC, 1: request CRC 382 382 383 - (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement384 +cc: 1-9: Additional Measurement, 0: no additional measurement 384 384 385 - (% style="color:#037691" %)**dd**(%%): delay (in second) to send(% style="color:#037691" %)__**aD0!**__(%%)to get return.386 +dd: delay (in second) to send **aD0!** to get return. 386 386 387 387 388 388 The following is the display information on the serial port and the server. 389 389 391 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]] 390 390 391 -[[image:image -20230201092208-14.png]]393 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]] 392 392 395 +1. 396 +11. 397 +111. Advance SDI-12 Debug command 393 393 394 -[[image:image-20230201092208-15.png||height="214" width="1140"]] 395 - 396 - 397 -=== 2.3.2 Advance SDI-12 Debug command === 398 - 399 - 400 400 This command can be used to debug all SDI-12 command. 401 401 402 402 403 403 LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 404 404 405 -( % style="color:#037691" %)**aa**(%%): total SDI-12 command length404 +(aa: total SDI-12 command length) 406 406 407 -( % style="color:#037691" %)**xx**(%%): SDI-12 command406 +(xx: SDI-12 command) 408 408 409 -( % style="color:#037691" %)**bb**(%%): Delay to wait for return408 +(bb: Delay to wait for return) 410 410 411 -( % style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100410 +(cc: 0: don’t uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100) 412 412 413 413 414 - (% style="color:blue" %)**Example:**(%%)AT+CFGDEV =0RC0!,1413 +Example: AT+CFGDEV =0RC0!,1 415 415 416 - (% style="color:#037691" %)**0RC0!**(%%): SDI-12 Command,415 +0RC0!: SDI-12 Command, 417 417 418 - (% style="color:#037691" %)**1 **(%%): Delay 1 second. ( 0: 810 mini-second)417 +1: Delay 1 second. ( 0: 810 mini-second) 419 419 419 + 420 420 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 421 421 422 422 ... ... @@ -423,171 +423,179 @@ 423 423 The following is the display information on the serial port and the server. 424 424 425 425 426 -[[image:image -20230201092355-16.png]]426 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]] 427 427 428 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]] 428 428 429 -[[image:image-20230201092355-17.png||height="426" width="1135"]] 430 +1. 431 +11. 432 +111. Convert ASCII to String 430 430 431 - 432 -=== 2.3.3 Convert ASCII to String === 433 - 434 - 435 435 This command is used to convert between ASCII and String format. 436 436 436 + 437 437 AT+CONVFORM ( Max length: 80 bytes) 438 438 439 +Example: 439 439 440 - (%style="color:blue"%)**Example:**441 +1)AT+CONVFORM=0,string Convert String from String to ASCII 441 441 442 - 1) AT+CONVFORM=0, stringonvertString fromStringto ASCII443 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]] 443 443 444 -[[image:1675214845056-885.png]] 445 445 446 +2)AT+CONVFORM=1,ASCII Convert ASCII to String. 446 446 447 - 2) AT+CONVFORM=1, ASCII ConvertASCIItoString.448 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]] 448 448 449 -[[image:1675214856590-846.png]] 450 450 451 451 452 -=== 2.3.4 Define periodically SDI-12 commands and uplink. === 452 +1. 453 +11. 454 +111. Define periodically SDI-12 commands and uplink. 453 453 454 - 455 455 AT+COMMANDx & AT+DATACUTx 456 456 457 457 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. 458 458 459 459 460 -* (% style="color:blue" %)**AT Command:**461 +* ** AT Command:** 461 461 462 - (% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.**463 +**AT+COMMANDx=var1,var2,var3,var4.** 463 463 464 - (% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0!465 +var1: SDI-12 command , for example: 0RC0! 465 465 466 - (% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second)467 +var2: Wait timeout for return. (unit: second) 467 467 468 - (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0!469 +var3: Whether to send //addrD0!// to get return after var2 timeout. 0: Don’t Send //addrD0!//; 1: Send //addrD0!//. 469 469 470 - (% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.471 +var4: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 471 471 472 - (% style="color:red" %)**0**(%%)No validation check;473 +0 No validation check; 473 473 474 - (% style="color:red" %)**1**(%%)Check if return chars are printable char(0x20 ~~ 0x7E);475 +1 Check if return chars are printable char(0x20 ~~ 0x7E); 475 475 476 - (% style="color:red" %)**2**(%%)Check if there is return from SDI-12 sensor477 +2 Check if there is return from SDI-12 sensor 477 477 478 - (% style="color:red" %)**3**(%%)Check if return pass CRC check ( SDI-12 command var1 must include CRC request);479 +3 Check if return pass CRC check ( SDI-12 command var1 must include CRC request); 479 479 480 480 481 -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.482 +Each AT+COMMANDx is followed by a **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. 482 482 483 483 484 - (% style="color:blue" %)**AT+DATACUTx**(%%): This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.485 +**AT+DATACUTx** : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes. 485 485 486 -(% border="1" style="background-color:#f7faff; width:436px" %) 487 -|(% style="width:433px" %)((( 488 -**AT+DATACUTx=a,b,c** 487 +|((( 488 +AT+DATACUTx=a,b,c 489 489 490 - **a**:490 +a: length for the return of AT+COMMAND 491 491 492 - **b**:492 +b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 493 493 494 - **c**:494 +c: define the position for valid value. 495 495 ))) 496 496 497 -For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload: 498 498 498 +For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload: 499 499 500 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 501 -|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload** 502 -|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33 503 -|(% 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 504 -|(% 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 505 505 506 -* (% style="color:blue" %)** Downlink Payload:** 501 +|AT+DATACUT1 value|Final Result to combine Payload 502 +|34,1,1+2+3|0D 00 01 30 31 33 503 +|34,2,1~~8+12~~16|0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32 504 +|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 507 507 508 -(% style="color:blue" %)**0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 509 509 510 510 511 - (%style="color:red" %)**Note: if user use AT+COMMANDx toadd a newcommand,healsoneedto send AT+DATACUTx downlink.**508 +* ** Downlink Payload:** 512 512 510 +**0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 513 513 514 -Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)** 515 515 513 +**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.** 514 + 515 + 516 +Format: ** AF MM NN LL XX XX XX XX YY** 517 + 516 516 Where: 517 517 518 -* (% style="color:#037691" %)**MM**(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,519 -* (% style="color:#037691" %)**NN**(%%): 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.520 -* (% style="color:#037691" %)**LL**(%%): The length of AT+COMMAND or AT+DATACUT command521 -* (% style="color:#037691" %)**XX XX XX XX**(%%): AT+COMMAND or AT+DATACUT command522 -* (% 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.520 +* MM: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 521 +* NN: 1: set the AT+DATACUT value ; 2: set the AT+DATACUT value. 522 +* LL: The length of AT+COMMAND or AT+DATACUT command 523 +* XX XX XX XX: AT+COMMAND or AT+DATACUT command 524 +* 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. 523 523 524 - (% style="color:blue" %)**Example:**526 +Example: 525 525 526 - [[image:image-20230201094129-18.png]]528 +**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1** 527 527 530 +**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10** 528 528 532 +**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10** 529 529 530 -(% style="color:blue" %)**Clear SDI12 Command** 531 531 535 +**Clear SDI12 Command** 536 + 532 532 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 533 533 534 534 535 -* (% style="color:#037691" %)**AT Command:**540 +* ** AT Command:** 536 536 537 - (% style="color:#4f81bd" %)**AT+CMDEAR=mm,nn**(%%)mm: start position of erase ,nn: stop position of erase542 +**~ AT+CMDEAR=mm,nn** mm: start position of erase ,nn: stop position of erase 538 538 539 539 540 540 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 541 541 542 542 543 -* (% style="color:#037691" %)** Downlink Payload:**548 +* ** Downlink Payload:** 544 544 545 - (% style="color:#4f81bd" %)**0x09 aa bb**(%%)same as AT+CMDEAR=aa,bb550 +**~ 0x09 aa bb** same as AT+CMDEAR=aa,bb 546 546 547 547 548 548 549 -(% style="color:blue" %)**command combination** 550 550 555 +**command combination** 556 + 551 551 Below shows a screen shot how the results combines together to a uplink payload. 552 552 553 -[[image: 1675215745275-920.png]]559 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]] 554 554 555 555 556 -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.562 +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. 557 557 558 - (% 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.564 +**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. 559 559 560 560 561 - (% 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.567 +For example: as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result. 562 562 563 563 564 -[[image: 1675215782925-448.png]]570 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]] 565 565 566 566 567 -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.573 +If AT+ALLDATAMOD=1, **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. 568 568 569 569 570 570 571 - (% style="color:blue" %)**Compose Uplink**577 +**Compose Uplink** 572 572 573 - (% style="color:#4f81bd" %)**AT+DATAUP=0**579 +**AT+DATAUP=0** 574 574 575 -Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.581 +Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK. 576 576 577 -Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__**583 +Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx 578 578 579 579 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 580 580 581 581 582 -[[image: 1675215828102-844.png]]588 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]] 583 583 584 584 585 - (% style="color:#4f81bd" %)**AT+DATAUP=1**591 +**AT+DATAUP=1** 586 586 587 -Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**.593 +Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs. 588 588 589 -Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__595 +Final Payload is 590 590 597 +**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA** 598 + 591 591 1. Battery Info (2 bytes): Battery voltage 592 592 1. PAYVER (1 byte): Defined by AT+PAYVER 593 593 1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling. ... ... @@ -594,24 +594,27 @@ 594 594 1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT) 595 595 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 596 596 597 -[[image: 1675215848113-696.png]]605 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]] 598 598 599 599 600 - (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**608 +**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:** 601 601 602 -* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 603 -* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 604 -* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 605 -* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 610 + ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 606 606 607 - (%style="color:red"%)**WhenAT+DATAUP=1, the maximumnumberofsegmentsis 15,andthemaximumtotalnumber of bytesis 1500;**612 + * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 608 608 609 - (%style="color:red"%)**When AT+DATAUP=1 andAT+ADR=0,themaximumnumberofbytesof each payloadisdeterminedbytheDRvalue.**614 + * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 610 610 616 + ~* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 611 611 612 - ==2.4UplinkPayload==618 + *** When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;** 613 613 620 +**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.** 614 614 622 +1. 623 +11. Uplink Payload 624 + 625 + 615 615 Uplink payloads have two types: 616 616 617 617 * Distance Value: Use FPORT=2 ... ... @@ -620,29 +620,31 @@ 620 620 The application server should parse the correct value based on FPORT settings. 621 621 622 622 623 -=== 2.4.1 Device Payload, FPORT~=5 === 634 +1. 635 +11. 636 +111. Device Payload, FPORT=5 624 624 625 - 626 626 Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server. 627 627 640 + 628 628 Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink. 629 629 630 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %) 631 -|(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)** 632 -|(% 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** 633 -|(% 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 634 634 635 -Example parse in TTNv3 644 +|(% colspan="6" %)**Device Status (FPORT=5)** 645 +|**Size (bytes)**|**1**|**2**|**1**|**1**|**2** 646 +|**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 636 636 637 -[[image:1675215946738-635.png]] 638 638 649 +Example parse in TTNv3 639 639 640 - (% style="color:#037691" %)**Sensor Model**(%%): ForSDI-12-LB,this valueisx17651 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]] 641 641 642 - (% style="color:#037691" %)**FirmwareVersion**(%%):0x0100,Means:v1.0.0 version653 +**Sensor Model**: For SDI-12-LB, this value is 0x17 643 643 644 - (% style="color:#037691" %)**FrequencyBand**:655 +**Firmware Version**: 0x0100, Means: v1.0.0 version 645 645 657 +**Frequency Band**: 658 + 646 646 *0x01: EU868 647 647 648 648 *0x02: US915 ... ... @@ -672,7 +672,7 @@ 672 672 *0x0e: MA869 673 673 674 674 675 - (% style="color:#037691" %)**Sub-Band**:688 +**Sub-Band**: 676 676 677 677 AU915 and US915:value 0x00 ~~ 0x08 678 678 ... ... @@ -681,7 +681,7 @@ 681 681 Other Bands: Always 0x00 682 682 683 683 684 - (% style="color:#037691" %)**Battery Info**:697 +**Battery Info**: 685 685 686 686 Check the battery voltage. 687 687 ... ... @@ -690,7 +690,9 @@ 690 690 Ex2: 0x0B49 = 2889mV 691 691 692 692 693 -=== 2.4.2 Uplink Payload, FPORT~=2 === 706 +1. 707 +11. 708 +111. Uplink Payload, FPORT=2 694 694 695 695 696 696 There are different cases for uplink. See below ... ... @@ -699,25 +699,33 @@ 699 699 700 700 * Periodically Uplink: FPORT=2 701 701 702 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %) 703 -|=(% style="width: 90px;" %)((( 704 -**Size(bytes)** 705 -)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands** 706 -|(% style="width:93px" %)**Value**|(% style="width:83px" %)((( 717 + 718 +|((( 719 +**Size** 720 + 721 +**(bytes)** 722 +)))|**2**|**1**|**Length depends on the return from the commands** 723 +|**Value**|((( 707 707 Battery(mV) 725 + 708 708 & 727 + 709 709 Interrupt_Flag 710 -)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)((( 711 -If the valid payload is too long and exceed the maximum support. 729 +)))|[[PAYLOAD_VER>>path:#Probe_Model]]|((( 730 +If the valid payload is too long and exceed the maximum support 731 + 712 712 Payload length in server,server will show payload not provided in the LoRaWAN server. 713 713 ))) 714 714 715 -[[image:1675216282284-923.png]] 716 716 736 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]] 717 717 718 -=== 2.4.3 Battery Info === 719 719 720 720 740 +1. 741 +11. 742 +111. Battery Info 743 + 721 721 Check the battery voltage for SDI-12-LB. 722 722 723 723 Ex1: 0x0B45 = 2885mV ... ... @@ -725,12 +725,14 @@ 725 725 Ex2: 0x0B49 = 2889mV 726 726 727 727 728 -=== 2.4.4 Interrupt Pin === 751 +1. 752 +11. 753 +111. Interrupt Pin 729 729 755 +This data field shows if this packet is generated by **Interrupt Pin** or not. [[Click here>>path:#Int_mod]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>path:#pins]]. 730 730 731 -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"]]. 732 732 733 - **Example:**758 +Example: 734 734 735 735 Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet. 736 736 ... ... @@ -737,58 +737,244 @@ 737 737 Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet. 738 738 739 739 740 -=== 2.4.5 Payload version === 765 +1. 766 +11. 767 +111. Payload version 741 741 742 742 743 743 744 -=== 2.4.6 Decode payload in The Things Network === 745 745 746 746 773 + 774 + 775 +1. 776 +11. 777 +111. Decode payload in The Things Network 778 + 747 747 While using TTN network, you can add the payload format to decode the payload. 748 748 749 -[[image: 1675216779406-595.png]]781 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.png]] 750 750 751 751 752 752 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. 753 753 754 -SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]] 755 755 787 +下面的解码生成超链接放进去. 756 756 757 - == 2.5 UplinkInterval==789 +function Decoder(bytes, port) { 758 758 791 + if(port==5) 759 759 793 + { 794 + 795 + var freq_band; 796 + 797 + var sub_band; 798 + 799 + var sensor; 800 + 801 + 802 + if(bytes[0]==0x17) 803 + 804 + sensor= "SDI12-LB"; 805 + 806 + 807 + var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f); 808 + 809 + 810 + if(bytes[3]==0x01) 811 + 812 + freq_band="EU868"; 813 + 814 + else if(bytes[3]==0x02) 815 + 816 + freq_band="US915"; 817 + 818 + else if(bytes[3]==0x03) 819 + 820 + freq_band="IN865"; 821 + 822 + else if(bytes[3]==0x04) 823 + 824 + freq_band="AU915"; 825 + 826 + else if(bytes[3]==0x05) 827 + 828 + freq_band="KZ865"; 829 + 830 + else if(bytes[3]==0x06) 831 + 832 + freq_band="RU864"; 833 + 834 + else if(bytes[3]==0x07) 835 + 836 + freq_band="AS923"; 837 + 838 + else if(bytes[3]==0x08) 839 + 840 + freq_band="AS923_1"; 841 + 842 + else if(bytes[3]==0x09) 843 + 844 + freq_band="AS923_2"; 845 + 846 + else if(bytes[3]==0x0A) 847 + 848 + freq_band="AS923_3"; 849 + 850 + else if(bytes[3]==0x0F) 851 + 852 + freq_band="AS923_4"; 853 + 854 + else if(bytes[3]==0x0B) 855 + 856 + freq_band="CN470"; 857 + 858 + else if(bytes[3]==0x0C) 859 + 860 + freq_band="EU433"; 861 + 862 + else if(bytes[3]==0x0D) 863 + 864 + freq_band="KR920"; 865 + 866 + else if(bytes[3]==0x0E) 867 + 868 + freq_band="MA869"; 869 + 870 + 871 + if(bytes[4]==0xff) 872 + 873 + sub_band="NULL"; 874 + 875 + else 876 + 877 + sub_band=bytes[4]; 878 + 879 + 880 + var bat= (bytes[5]<<8 | bytes[6])/1000; 881 + 882 + 883 + return { 884 + 885 + SENSOR_MODEL:sensor, 886 + 887 + FIRMWARE_VERSION:firm_ver, 888 + 889 + FREQUENCY_BAND:freq_band, 890 + 891 + SUB_BAND:sub_band, 892 + 893 + BAT:bat, 894 + 895 + } 896 + 897 + } 898 + 899 + else if(port==100) 900 + 901 + { 902 + 903 + var datas_sum={}; 904 + 905 + for(var j=0;j<bytes.length;j++) 906 + 907 + { 908 + 909 + var datas= String.fromCharCode(bytes[j]); 910 + 911 + if(j=='0') 912 + 913 + datas_sum.datas_sum=datas; 914 + 915 + else 916 + 917 + datas_sum.datas_sum+=datas; 918 + 919 + } 920 + 921 + 922 + return datas_sum; 923 + 924 + } 925 + 926 + else 927 + 928 + { 929 + 930 + var decode={}; 931 + 932 + decode.EXTI_Trigger= (bytes[0] & 0x80)? "TRUE":"FALSE"; 933 + 934 + decode.BatV= ((bytes[0]<<8 | bytes[1])&0x7FFF)/1000; 935 + 936 + decode.Payver= bytes[2]; 937 + 938 + for(var i=3;i<bytes.length;i++) 939 + 940 + { 941 + 942 + var data= String.fromCharCode(bytes[i]); 943 + 944 + if(i=='3') 945 + 946 + decode.data_sum=data; 947 + 948 + else 949 + 950 + decode.data_sum+=data; 951 + 952 + } 953 + 954 + return decode; 955 + 956 + } 957 + 958 + 959 +} 960 + 961 + 962 +1. 963 +11. Uplink Interval 964 + 760 760 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: 761 761 762 -[[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]]]]967 +[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval]] 763 763 764 764 765 -== 2.6 Frequency Plans == 766 766 971 +1. 972 +11. Frequency Plans 767 767 768 -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.974 +The SDI12-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. 769 769 770 -[[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/]] 771 771 977 +[[https:~~/~~/wiki.dragino.com/index.php?title=End_Device_Frequency_Band>>url:https://wiki.dragino.com/index.php?title=End_Device_Frequency_Band]] 772 772 773 -== 2.7 Firmware Change Log == 774 774 775 775 981 +1. 982 +11. Firmware Change Log 983 + 776 776 **Firmware download link:** 777 777 778 -[[https:~~/~~/www.dropbox.com/sh/ qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]986 +[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]] 779 779 780 780 781 -= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = 782 782 990 +1. Configure SDI-12-LB via AT Command or LoRaWAN Downlink 783 783 784 784 Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink. 785 785 786 -* AT Command Connection: See [[FAQ>> ||anchor="H7.FAQ"]].787 -* LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.994 +* AT Command Connection: See [[FAQ>>path:#AT_COMMAND]]. 995 +* LoRaWAN Downlink instruction for different platforms: 788 788 997 +[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server>>url:http://wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server]] 998 + 999 + 789 789 There are two kinds of commands to configure SDI-12-LB, they are: 790 790 791 -* (% style="color:blue" %)**General Commands**.1002 +* **General Commands**. 792 792 793 793 These commands are to configure: 794 794 ... ... @@ -797,242 +797,270 @@ 797 797 798 798 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 799 799 800 -[[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/]]1011 +[[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]] 801 801 802 802 803 -* (% style="color:blue" %)**Commands special design for SDI-12-LB**1014 +* **Commands special design for SDI-12-LB** 804 804 805 805 These commands only valid for SDI-12-LB, as below: 806 806 807 807 808 -== 3.1 Set Transmit Interval Time == 809 809 1020 +1. 1021 +11. Set Transmit Interval Time 810 810 811 811 Feature: Change LoRaWAN End Node Transmit Interval. 812 812 813 - (% style="color:blue" %)**AT Command: AT+TDC**1025 +**AT Command: AT+TDC** 814 814 815 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 816 -|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response** 817 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 1027 +|**Command Example**|**Function**|**Response** 1028 +|AT+TDC=?|Show current transmit Interval|((( 818 818 30000 1030 + 819 819 OK 1032 + 820 820 the interval is 30000ms = 30s 821 821 ))) 822 -| (% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((1035 +|AT+TDC=60000|Set Transmit Interval|((( 823 823 OK 1037 + 824 824 Set transmit interval to 60000ms = 60 seconds 825 825 ))) 826 826 827 -(% style="color:blue" %)**Downlink Command: 0x01** 828 828 1042 +**Downlink Command: 0x01** 829 829 830 830 Format: Command Code (0x01) followed by 3 bytes time value. 831 831 832 -If the downlink payload=0100003C, it means set the END Node 's Transmit Interval to 0x00003C=60(S), while type code is 01.1046 +If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 833 833 834 -* Example 1: Downlink Payload: 0100001E 835 -* Example 2: Downlink Payload: 0100003C 1048 +* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1049 +* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 836 836 837 837 838 838 839 -== 3.2 Set Interrupt Mode == 1053 +1. 1054 +11. Set Interrupt Mode 840 840 841 - 842 842 Feature, Set Interrupt mode for GPIO_EXIT. 843 843 844 - (% style="color:blue" %)**AT Command: AT+INTMOD**1058 +**AT Command: AT+INTMOD** 845 845 846 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %) 847 -|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 187px;" %)**Function**|=(% style="width: 165px;" %)**Response** 848 -|(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)((( 1060 +|**Command Example**|**Function**|**Response** 1061 +|AT+INTMOD=?|Show current interrupt mode|((( 849 849 0 1063 + 850 850 OK 1065 + 851 851 the mode is 0 = No interruption 852 852 ))) 853 -| (% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((1068 +|AT+INTMOD=2|((( 854 854 Set Transmit Interval 855 -~1. (Disable Interrupt), 856 -2. (Trigger by rising and falling edge) 857 -3. (Trigger by falling edge) 858 -4. (Trigger by rising edge) 859 -)))|(% style="width:165px" %)OK 860 860 861 -(% style="color:blue" %)**Downlink Command: 0x06** 1071 +1. (Disable Interrupt), 1072 +1. (Trigger by rising and falling edge), 1073 +1. (Trigger by falling edge) 1074 +1. (Trigger by rising edge) 1075 +)))|OK 862 862 1077 + 1078 +**Downlink Command: 0x06** 1079 + 863 863 Format: Command Code (0x06) followed by 3 bytes. 864 864 865 865 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 866 866 867 -* Example 1: Downlink Payload: 06000000 868 -* Example 2: Downlink Payload: 06000003 1084 +* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1085 +* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 869 869 870 870 1088 +1. 1089 +11. Set the output time 871 871 872 -== 3.3 Set the output time == 873 - 874 - 875 875 Feature, Control the output 3V3 , 5V or 12V. 876 876 877 - (% style="color:blue" %)**AT Command: AT+3V3T**1093 +**AT Command: AT+3V3T** 878 878 879 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:474px" %) 880 -|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 201px;" %)**Function**|=(% style="width: 116px;" %)**Response** 881 -|(% style="width:154px" %)AT+3V3T=?|(% style="width:201px" %)Show 3V3 open time.|(% style="width:116px" %)((( 1095 +|**Command Example**|**Function**|**Response** 1096 +|AT+3V3T=?|Show 3V3 open time.|((( 882 882 0 1098 + 883 883 OK 884 884 ))) 885 -| (% style="width:154px" %)AT+3V3T=0|(% style="width:201px" %)Normally open 3V3 power supply.|(% style="width:116px" %)(((1101 +|AT+3V3T=0|Normally open 3V3 power supply.|((( 886 886 OK 1103 + 887 887 default setting 888 888 ))) 889 -| (% style="width:154px" %)AT+3V3T=1000|(% style="width:201px" %)Close after a delay of 1000 milliseconds.|(% style="width:116px" %)(((1106 +|AT+3V3T=1000|Close after a delay of 1000 milliseconds.|((( 890 890 OK 1108 + 1109 + 891 891 ))) 892 -| (% style="width:154px" %)AT+3V3T=65535|(% style="width:201px" %)Normally closed 3V3 power supply.|(% style="width:116px" %)(((1111 +|AT+3V3T=65535|Normally closed 3V3 power supply.|((( 893 893 OK 1113 + 1114 + 894 894 ))) 895 895 896 -(% style="color:blue" %)**AT Command: AT+5VT** 897 897 898 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:470px" %) 899 -|=(% style="width: 155px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 114px;" %)**Response** 900 -|(% style="width:155px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:114px" %)((( 1118 +**AT Command: AT+5VT** 1119 + 1120 +|**Command Example**|**Function**|**Response** 1121 +|AT+5VT=?|Show 5V open time.|((( 901 901 0 1123 + 902 902 OK 903 903 ))) 904 -| (% style="width:155px" %)AT+5VT=0|(% style="width:196px" %)Normally closed 5V power supply.|(% style="width:114px" %)(((1126 +|AT+5VT=0|Normally closed 5V power supply.|((( 905 905 OK 1128 + 906 906 default setting 907 907 ))) 908 -| (% style="width:155px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:114px" %)(((1131 +|AT+5VT=1000|Close after a delay of 1000 milliseconds.|((( 909 909 OK 1133 + 1134 + 910 910 ))) 911 -| (% style="width:155px" %)AT+5VT=65535|(% style="width:196px" %)Normally open 5V power supply.|(% style="width:114px" %)(((1136 +|AT+5VT=65535|Normally open 5V power supply.|((( 912 912 OK 1138 + 1139 + 913 913 ))) 914 914 915 -(% style="color:blue" %)**AT Command: AT+12VT** 916 916 917 -(% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:443px" %) 918 -|=(% style="width: 156px;" %)**Command Example**|=(% style="width: 199px;" %)**Function**|=(% style="width: 83px;" %)**Response** 919 -|(% style="width:156px" %)AT+12VT=?|(% style="width:199px" %)Show 12V open time.|(% style="width:83px" %)((( 1143 +**AT Command: AT+12VT** 1144 + 1145 +|**Command Example**|**Function**|**Response** 1146 +|AT+12VT=?|Show 12V open time.|((( 920 920 0 1148 + 921 921 OK 922 922 ))) 923 -| (% style="width:156px" %)AT+12VT=0|(% style="width:199px" %)Normally closed 12V power supply.|(% style="width:83px" %)OK924 -| (% style="width:156px" %)AT+12VT=500|(% style="width:199px" %)Close after a delay of 500 milliseconds.|(% style="width:83px" %)(((1151 +|AT+12VT=0|Normally closed 12V power supply.|OK 1152 +|AT+12VT=500|Close after a delay of 500 milliseconds.|((( 925 925 OK 1154 + 1155 + 926 926 ))) 927 927 928 -(% style="color:blue" %)**Downlink Command: 0x07** 929 929 1159 +**Downlink Command: 0x07** 1160 + 930 930 Format: Command Code (0x07) followed by 3 bytes. 931 931 932 932 The first byte is which power, the second and third bytes are the time to turn on. 933 933 934 -* Example 1: Downlink Payload: 070101F4 **~-~-->**935 -* Example 2: Downlink Payload: 0701FFFF **~-~-->**AT+3V3T=65535936 -* Example 3: Downlink Payload: 070203E8 **~-~-->**AT+5VT=1000937 -* Example 4: Downlink Payload: 07020000 **~-~-->**AT+5VT=0938 -* Example 5: Downlink Payload: 070301F4 **~-~-->**AT+12VT=500939 -* Example 6: Downlink Payload: 07030000 **~-~-->**AT+12VT=01165 +* Example 1: Downlink Payload: 070101F4 -> AT+3V3T=500 1166 +* Example 2: Downlink Payload: 0701FFFF -> AT+3V3T=65535 1167 +* Example 3: Downlink Payload: 070203E8 -> AT+5VT=1000 1168 +* Example 4: Downlink Payload: 07020000 -> AT+5VT=0 1169 +* Example 5: Downlink Payload: 070301F4 -> AT+12VT=500 1170 +* Example 6: Downlink Payload: 07030000 -> AT+12VT=0 940 940 941 941 1173 +1. 1174 +11. Set the all data mode 942 942 943 -== 3.4 Set the all data mode == 944 - 945 - 946 946 Feature, Set the all data mode. 947 947 948 - (% style="color:blue" %)**AT Command: AT+ALLDATAMOD**1178 +**AT Command: AT+ALLDATAMOD** 949 949 950 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %) 951 -|=**Command Example**|=**Function**|=**Response** 1180 +|**Command Example**|**Function**|**Response** 952 952 |AT+ALLDATAMOD=?|Show current all data mode|((( 953 953 0 1183 + 1184 + 954 954 OK 955 955 ))) 956 956 |AT+ALLDATAMOD=1|Set all data mode is 1.|OK 957 957 958 -(% style="color:blue" %)**Downlink Command: 0xAB** 959 959 1190 +**Downlink Command: 0xAB** 1191 + 960 960 Format: Command Code (0xAB) followed by 1 bytes. 961 961 962 -* Example 1: Downlink Payload: AB 00 963 -* Example 2: Downlink Payload: AB 01 1194 +* Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 1195 +* Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 964 964 965 965 1198 +1. 1199 +11. Set the splicing payload for uplink 966 966 967 -== 3.5 Set the splicing payload for uplink == 968 - 969 - 970 970 Feature, splicing payload for uplink. 971 971 972 - (% style="color:blue" %)**AT Command: AT+DATAUP**1203 +**AT Command: AT+DATAUP** 973 973 974 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %) 975 -|=(% style="width: 154px;" %)**Command Example**|=(% style="width: 266px;" %)**Function**|=**Response** 976 -|(% style="width:154px" %)AT+DATAUP =?|(% style="width:266px" %)Show current splicing payload for uplink mode|((( 1205 +|**Command Example**|**Function**|**Response** 1206 +|AT+DATAUP =?|Show current splicing payload for uplink mode|((( 977 977 0 1208 + 1209 + 978 978 OK 979 979 ))) 980 -| (% style="width:154px" %)AT+DATAUP =0|(% style="width:266px" %)(((1212 +|AT+DATAUP =0|((( 981 981 Set splicing payload for uplink mode is 0. 1214 + 1215 + 982 982 )))|((( 983 983 OK 1218 + 1219 + 984 984 ))) 985 -|(% style="width:154px" %)AT+DATAUP =1|(% style="width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK 986 -|(% style="width:154px" %)AT+DATAUP =1,20000|(% style="width:266px" %)((( 987 -Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds. 1221 +|AT+DATAUP =1|Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|OK 1222 +|AT+DATAUP =1,20000|((( 1223 +Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds. 1224 + 1225 + 988 988 )))|OK 989 989 990 -(% style="color:blue" %)**Downlink Command: 0xAD** 991 991 1229 +**Downlink Command: 0xAD** 1230 + 992 992 Format: Command Code (0xAD) followed by 1 bytes or 5 bytes. 993 993 994 -* Example 1: Downlink Payload: AD 00 995 -* Example 2: Downlink Payload: AD 01 996 -* Example 3: Downlink Payload: AD 01 00 00 14 1233 +* Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0 1234 +* Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1 1235 +* Example 3: Downlink Payload: AD 01 00 00 14~/~/ AT+DATAUP =1,20000 997 997 998 998 This means that the interval is set to 0x000014=20S 999 999 1000 1000 1001 -== 3.6 Set the payload version == 1240 +1. 1241 +11. Set the payload version 1002 1002 1003 - 1004 1004 Feature, Set the payload version. 1005 1005 1006 - (% style="color:blue" %)**AT Command: AT+PAYVER**1245 +**AT Command: AT+PAYVER** 1007 1007 1008 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %) 1009 -|=(% style="width: 158px;" %)**Command Example**|=(% style="width: 192px;" %)**Function**|=**Response** 1010 -|(% style="width:158px" %)AT+PAYVER=?|(% style="width:192px" %)Show current payload version|((( 1247 +|**Command Example**|**Function**|**Response** 1248 +|AT+PAYVER=?|Show current payload version|((( 1011 1011 1 1250 + 1251 + 1012 1012 OK 1013 1013 ))) 1014 -| (% style="width:158px" %)AT+PAYVER=5|(% style="width:192px" %)Set payload version is 5.|OK1254 +|AT+PAYVER=5|Set payload version is 5.|OK 1015 1015 1016 -(% style="color:blue" %)**Downlink Command: 0xAE** 1017 1017 1257 +**Downlink Command: 0xAE** 1258 + 1018 1018 Format: Command Code (0xAE) followed by 1 bytes. 1019 1019 1020 -* Example 1: Downlink Payload: AE 01 1021 -* Example 2: Downlink Payload: AE 05 1261 +* Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 1262 +* Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 1022 1022 1023 1023 1024 1024 1025 -= 4. Battery & how to replace = 1266 +1. Battery & how to replace 1267 +11. Battery Type 1026 1026 1027 - == 4.1 Battery Type==1269 +SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter. 1028 1028 1029 1029 1030 -SDI-12-LB is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter. 1031 - 1032 - 1033 1033 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1034 1034 1035 -[[image: 1675234124233-857.png]]1274 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]] 1036 1036 1037 1037 1038 1038 Minimum Working Voltage for the SDI-12-LB: ... ... @@ -1040,25 +1040,32 @@ 1040 1040 SDI-12-LB: 2.45v ~~ 3.6v 1041 1041 1042 1042 1043 -== 4.2 Replace Battery == 1282 +1. 1283 +11. Replace Battery 1044 1044 1045 - 1046 1046 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery. 1047 1047 1048 1048 And make sure the positive and negative pins match. 1049 1049 1050 1050 1051 -== 4.3 Power Consumption Analyze == 1052 1052 1291 +1. 1292 +11. Power Consumption Analyze 1053 1053 1294 + 1054 1054 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. 1055 1055 1297 + 1056 1056 Instruction to use as below: 1057 1057 1058 -(% style="color:blue" %)**Step 1:**(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]] 1059 1059 1060 - (% style="color:blue" %)**Step2:**(%%)Openand choose1301 +Step 1: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: 1061 1061 1303 +[[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]] 1304 + 1305 + 1306 +Step 2: Open it and choose 1307 + 1062 1062 * Product Model 1063 1063 * Uplink Interval 1064 1064 * Working Mode ... ... @@ -1065,106 +1065,85 @@ 1065 1065 1066 1066 And the Life expectation in difference case will be shown on the right. 1067 1067 1314 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image037.png]] 1068 1068 1069 -[[image:1675234155374-163.png]] 1070 1070 1071 - 1072 1072 The battery related documents as below: 1073 1073 1074 -* [[Battery Dimension>>http s://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],1075 -* [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>http s://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]1076 -* [[Lithium-ion Battery-Capacitor datasheet>>http s://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]]1319 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]], 1320 +* [[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]] 1321 +* [[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]] 1077 1077 1078 -[[image:image-20230201145019-19.png]] 1079 1079 1080 1080 1081 -=== 4.3.1 Battery Note === 1325 +|((( 1326 +JST-XH-2P connector 1327 +))) 1082 1082 1329 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image038.png]] 1083 1083 1084 -The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 1085 1085 1086 1086 1087 -=== 4.3.2 Replace the battery === 1333 +1. 1334 +11. 1335 +111. Battery Note 1088 1088 1337 +The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 1089 1089 1090 -You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board. 1091 1091 1092 -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) 1340 +1. 1341 +11. 1342 +111. Replace the battery 1093 1093 1344 +You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won’t be voltage drop between battery and main board. 1094 1094 1095 -= 5. Remote Configure device = 1096 1096 1097 - ==5.1ConnectviaBLE==1347 +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) 1098 1098 1099 1099 1100 -Please see this instruction for how to configure via BLE: [[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/]] 1101 1101 1102 1102 1103 -== 5.2 AT Command Set == 1104 1104 1105 1105 1354 +1. Remote Configure device 1355 +11. Connect via BLE 1106 1106 1107 -= 6. OTA firmware update = 1108 1108 1358 +Please see this instruction for how to configure via BLE: 1109 1109 1110 - Please see this link for howdoOTAfirmware.1360 +[[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/]] 1111 1111 1112 -[[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/]] 1113 1113 1363 +1. 1364 +11. AT Command Set 1114 1114 1115 -= 7. FAQ = 1116 1116 1117 -== 7.1 How to use AT Command to access device? == 1118 1118 1368 +1. OTA firmware update 1119 1119 1120 - 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]]1370 +Please see this link for how to do OTA firmware update. 1121 1121 1372 +[[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/]] 1122 1122 1123 -== 7.2 How to update firmware via UART port? == 1124 1124 1125 1125 1126 -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]] 1127 1127 1128 1128 1129 -== 7.3 How to change the LoRa Frequency Bands/Region? == 1130 1130 1131 1131 1132 -You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. 1133 -When downloading the images, choose the required image file for download. 1134 1134 1135 1135 1136 -= 8. Order Info = 1137 1137 1138 1138 1139 -((( 1140 -(% style="color:blue" %)**Part Number: SDI-12-LB-XXX** 1141 -))) 1384 +1. Order Info 1142 1142 1143 -((( 1144 -XXX: The default frequency band 1145 -))) 1386 +**Package Includes**: 1146 1146 1147 -((( 1148 -(% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 1149 -(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 1150 -(% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 1151 -(% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 1152 -(% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 1153 -(% style="color:red" %)**US915**(%%): LoRaWAN US915 band 1154 -(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1155 -(% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1156 -))) 1388 +* SDI-12-LB SDI-12 to LoRaWAN Converter 1157 1157 1158 1158 1159 - = 9. PackingInfo=1391 +**Dimension and weight**: 1160 1160 1161 - 1162 -(% style="color:#037691" %)**Package Includes**: 1163 - 1164 -* SDI-12-LB SDI-12 to LoRaWAN Converter x 1 1165 - 1166 -(% style="color:#037691" %)**Dimension and weight**: 1167 - 1168 1168 * Device Size: cm 1169 1169 * Device Weight: g 1170 1170 * Package Size / pcs : cm ... ... @@ -1172,11 +1172,13 @@ 1172 1172 1173 1173 1174 1174 1175 -= 10. Support = 1176 1176 1177 1177 1402 +1. Support 1403 + 1178 1178 * 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. 1405 +* 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 1179 1179 1180 - * 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]]1407 +[[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]] 1181 1181 1182 1182
- 1675213652444-622.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -59.6 KB - Content
- 1675213661769-223.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -53.8 KB - Content
- 1675213675852-577.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -83.1 KB - Content
- 1675213686734-883.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -65.2 KB - Content
- 1675213704414-644.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -50.1 KB - Content
- 1675214845056-885.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -20.4 KB - Content
- 1675214856590-846.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -18.6 KB - Content
- 1675215745275-920.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -187.6 KB - Content
- 1675215782925-448.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -142.5 KB - Content
- 1675215828102-844.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -231.3 KB - Content
- 1675215848113-696.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -50.5 KB - Content
- 1675215946738-635.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -38.4 KB - Content
- 1675216282284-923.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -47.0 KB - Content
- 1675216779406-595.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -59.2 KB - Content
- 1675234124233-857.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -75.8 KB - Content
- 1675234155374-163.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -138.2 KB - Content
- image-20230201090528-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -560.9 KB - Content
- image-20230201091027-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -10.4 KB - Content
- image-20230201091027-7.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -43.7 KB - Content
- image-20230201091257-8.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -15.8 KB - Content
- image-20230201091257-9.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.3 KB - Content
- image-20230201091630-10.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -15.1 KB - Content
- image-20230201091630-11.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -53.1 KB - Content
- image-20230201091954-12.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -13.8 KB - Content
- image-20230201091954-13.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.7 KB - Content
- image-20230201092208-14.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -14.3 KB - Content
- image-20230201092208-15.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.6 KB - Content
- image-20230201092355-16.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -21.6 KB - Content
- image-20230201092355-17.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -80.0 KB - Content
- image-20230201094129-18.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -12.8 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