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
From version 81.1
edited by Bei Jinggeng
on 2023/06/27 18:03
on 2023/06/27 18:03
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 61 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
- image-20230222143809-1.png
- image-20230426084456-1.png
- image-20230603120127-1.png
- image-20230603120209-2.png
- image-20230603120515-3.png
- image-20230603120648-4.png
- image-20230603120726-5.png
- image-20230603120859-6.png
- image-20230603121606-7.png
- image-20230603121643-8.png
- image-20230603121721-9.png
- image-20230603121752-10.png
- image-20230603121826-11.png
- image-20230603122040-12.png
- image-20230603122109-13.png
- image-20230603122139-14.png
- image-20230603122212-15.png
- image-20230603122248-16.png
- image-20230603122508-17.png
- image-20230603122549-18.png
- image-20230603122623-19.png
- image-20230603122719-20.png
- image-20230627164957-1.png
- image-20230627165744-2.png
- image-20230627174446-2.png
- image-20230627174559-3.png
- image-20230627175513-4.png
- image-20230627175736-5.png
- image-20230627180303-6.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Bei1 +XWiki.Xiaoling - Content
-
... ... @@ -1,9 +1,8 @@ 1 1 (% style="text-align:center" %) 2 -[[image:image-20230131183542-1.jpeg|| _mstalt="470678"height="694" width="694"]]2 +[[image:image-20230131183542-1.jpeg||height="694" width="694"]] 3 3 4 4 **Table of Contents:** 5 5 6 -{{toc/}} 7 7 8 8 9 9 ... ... @@ -17,45 +17,39 @@ 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||_mstalt="427765"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 -* Controllable 3.3v,5v and 12v output to power external sensor51 +* Controllable 5v and 12v output to power external sensor 59 59 * SDI-12 Protocol to connect to SDI-12 Sensor 60 60 * Monitor Battery Level 61 61 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 ... ... @@ -66,23 +66,21 @@ 66 66 * 8500mAh Battery for long term use 67 67 68 68 69 -== 1.3 Specification == 62 +1. 63 +11. Specification 70 70 65 +**Micro Controller:** 71 71 72 -(% style="color:#037691" %)**Micro Controller:** 73 - 74 74 * MCU: 48Mhz ARM 75 75 * Flash: 256KB 76 76 * RAM: 64KB 77 77 78 - (% style="color:#037691" %)**Common DC Characteristics:**71 +**Common DC Characteristics:** 79 79 80 80 * Supply Voltage: 2.5v ~~ 3.6v 81 -* Support current: 5V 300mA 82 - 12V 100mA 83 83 * Operating Temperature: -40 ~~ 85°C 84 84 85 - (% style="color:#037691" %)**LoRa Spec:**76 +**LoRa Spec:** 86 86 87 87 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 88 88 * Max +22 dBm constant RF output vs. ... ... @@ -89,20 +89,23 @@ 89 89 * RX sensitivity: down to -139 dBm. 90 90 * Excellent blocking immunity 91 91 92 -(% style="color:#037691" %)**Current Input Measuring :** 93 93 84 +**Current Input Measuring :** 85 + 94 94 * Range: 0 ~~ 20mA 95 95 * Accuracy: 0.02mA 96 96 * Resolution: 0.001mA 97 97 98 -(% style="color:#037691" %)**Voltage Input Measuring:** 99 99 91 +**Voltage Input Measuring:** 92 + 100 100 * Range: 0 ~~ 30v 101 101 * Accuracy: 0.02v 102 102 * Resolution: 0.001v 103 103 104 -(% style="color:#037691" %)**Battery:** 105 105 98 +**Battery:** 99 + 106 106 * Li/SOCI2 un-chargeable battery 107 107 * Capacity: 8500mAh 108 108 * Self-Discharge: <1% / Year @ 25°C ... ... @@ -109,57 +109,68 @@ 109 109 * Max continuously current: 130mA 110 110 * Max boost current: 2A, 1 second 111 111 112 -(% style="color:#037691" %)**Power Consumption** 113 113 107 +**Power Consumption** 108 + 114 114 * Sleep Mode: 5uA @ 3.3v 115 115 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 116 116 117 117 118 -== 1.4 Connect to SDI-12 Sensor == 113 +1. 114 +11. Connect to SDI-12 Sensor 119 119 116 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]] 120 120 121 -[[image:1675212538524-889.png||_mstalt="298272"]] 122 122 123 123 124 -== 1.5 Sleep mode and working mode == 120 +1. 121 +11. Sleep mode and working mode 125 125 126 126 127 - (% style="color:blue" %)**Deep Sleep Mode:**(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.124 +**Deep Sleep Mode: Sensor doesn’t have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.** 128 128 129 -(% 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. 130 130 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.** 131 131 132 -== 1.6 Button & LEDs == 133 133 134 134 135 -[[image:1675212633011-651.png||_mstalt="291538"]] 136 136 137 137 138 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 139 -|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action** 140 -|(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT between 1s < time < 3s|(% style="background-color:#f2f2f2; width:117px" %)Send an uplink|(% style="background-color:#f2f2f2; width:225px" %)((( 141 -If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 133 +1. 134 +11. Button & LEDs 135 + 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 + 142 142 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 143 143 ))) 144 -|(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT for more than 3s|(% style="background-color:#f2f2f2; width:117px" %)Active Device|(% style="background-color:#f2f2f2; width:225px" %)((( 145 -(% style="background-color:#f2f2f2; 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. 146 -(% style="background-color:#f2f2f2; 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 + 147 147 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. 148 148 ))) 149 -| (% style="background-color:#f2f2f2; width:167px" %)Fast press ACT 5 times.|(% style="background-color:#f2f2f2; width:117px" %)Deactivate Device|(% style="background-color:#f2f2f2; width:225px" %)(% style="color:red"%)**Redled**(%%)will solid on for 5 seconds. MeansPS-LB-NAisin 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. 150 150 151 151 152 -== 1.7 Pin Mapping == 153 153 157 +1. 158 +11. Pin Mapping 154 154 155 -[[image: 1675213198663-754.png||_mstalt="297167"]]160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] 156 156 162 +1. 163 +11. BLE connection 157 157 158 -== 1.8 BLE connection == 159 - 160 - 161 161 SDI-12-LB support BLE remote configure. 162 162 167 + 163 163 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: 164 164 165 165 * Press button to send an uplink ... ... @@ -169,171 +169,175 @@ 169 169 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 170 170 171 171 172 -== 1.9 Mechanical == 173 173 174 174 175 -[[image:image-20230201090139-2.png||_mstalt="428623"]] 179 +1. 180 +11. Mechanical 176 176 177 -[[image:image -20230201090139-3.png||_mstalt="428987"]]182 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]] 178 178 179 -[[image:i mage-20230201090139-4.png||_mstalt="429351"]]184 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]] 180 180 186 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]] 181 181 182 -= 2. Configure SDI-12 to connect to LoRaWAN network = 183 183 184 -== 2.1 How it works == 185 185 186 186 187 -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 188 188 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. 189 189 190 -== 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 191 191 197 +1. 198 +11. Quick guide to connect to LoRaWAN server (OTAA) 192 192 193 193 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. 194 194 195 195 196 -[[image:i mage-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]]203 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]] 197 197 198 198 199 199 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. 200 200 201 201 202 - (% 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. 203 203 204 204 Each SDI-12-LB is shipped with a sticker with the default device EUI as below: 205 205 206 -[[image:image-20230426084456-1.png||height="241" width="519"]] 207 207 214 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]] 208 208 216 + 217 + 218 + 219 + 209 209 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 210 210 211 211 212 - (% style="color:blue" %)**Register the device**223 +**Register the device** 213 213 214 -[[image: 1675213652444-622.png||_mstalt="293657"]]225 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]] 215 215 216 216 217 - (% style="color:blue" %)**Add APP EUI and DEV EUI**228 +**Add APP EUI and DEV EUI** 218 218 219 219 220 -[[image: 1675213661769-223.png||_mstalt="295217"]]231 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]] 221 221 222 222 223 - (% style="color:blue" %)**Add APP EUI in the application**234 +**Add APP EUI in the application** 224 224 225 225 226 -[[image: 1675213675852-577.png||_mstalt="297947"]]237 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]] 227 227 228 228 229 - (% style="color:blue" %)**Add APP KEY**240 +**Add APP KEY** 230 230 231 -[[image: 1675213686734-883.png||_mstalt="298064"]]242 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] 232 232 233 233 234 - (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB245 +**Step 2**: Activate on SDI-12-LB 235 235 236 236 237 237 Press the button for 5 seconds to activate the SDI-12-LB. 238 238 239 -(% 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. 240 240 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. 241 241 242 -[[image:1675213704414-644.png||_mstalt="293748"]] 243 243 254 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]] 244 244 245 -== 2.3 SDI-12 Related Commands == 246 246 247 247 248 -User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. 249 249 250 250 251 -=== 2.3.1 Basic SDI-12 debug command === 260 +1. 261 +11. SDI-12 Related Commands 252 252 253 253 254 -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. 255 255 256 -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. 257 257 258 -The following is the display information on the serial port and the server. 267 +1. 268 +11. 269 +111. Basic SDI-12 debug command 259 259 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. 260 260 261 -[[image:image-20230201091027-6.png||_mstalt="429065"]] 262 262 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. 263 263 264 -[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]] 265 265 277 +The following is the display information on the serial port and the server. 266 266 279 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] 267 267 268 - ==== (% style="color:blue" %)**al! ~-~- Get SDI-12sensor Identification**(%%) ====281 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]] 269 269 283 +al! ~-~- Get SDI-12 sensor Identification 270 270 271 271 * AT Command: AT+ADDRI=aa 272 272 * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa 273 273 274 - (% 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) 275 275 276 - (% 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) 277 277 278 278 293 + 279 279 The following is the display information on the serial port and the server. 280 280 281 281 282 -[[image:image -20230201091257-8.png||_mstalt="431392"]]297 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]] 283 283 299 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]] 284 284 285 -[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]] 286 286 302 +aM!,aMC!, aM1!- aM9!, aMC1!- aMC9! 287 287 288 - ==== (% style="color:blue" %)**aM!,aMC!,aM1!-aM9!, aMC1!-aMC9!**(%%)====304 +aM!: Start Non-Concurrent Measurement 289 289 306 +aMC!: Start Non-Concurrent Measurement – Request CRC 290 290 291 - (% style="color:red" %)**aM!**(%%):Start Non-ConcurrentMeasurement308 +aM1!- aM9!: Additional Measurements 292 292 293 - (% style="color:red" %)**aMC!**(%%):Start Non-ConcurrentMeasurement – Request CRC310 +aMC1!- aMC9!: Additional Measurements – Request CRC 294 294 295 -(% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements 296 296 297 -(% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC 298 - 299 - 300 300 * AT Command : AT+ADDRM=0,1,0,1 301 - 302 302 * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01 303 303 304 304 Downlink:AA 01 aa bb cc dd 305 305 306 - (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.318 +aa: SDI-12 sensor address. 307 307 308 - (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC320 +bb: 0: no CRC, 1: request CRC 309 309 310 - (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement322 +cc: 1-9: Additional Measurement, 0: no additional measurement 311 311 312 - (% 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. 313 313 314 314 315 315 The following is the display information on the serial port and the server. 316 316 329 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]] 317 317 318 -[[image:image -20230201091630-10.png||_mstalt="449995"]]331 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]] 319 319 320 320 321 -[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]] 322 322 335 +aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! 323 323 337 +aC!: Start Concurrent Measurement 324 324 325 - ==== (% style="color:blue" %)**aC!, aCC!,aC1!-aC9!,aCC1!-aCC9!**(%%)====339 +aCC!: Start Concurrent Measurement – Request CRC 326 326 341 +aC1!- aC9!: Start Additional Concurrent Measurements 327 327 328 - (% style="color:red" %)**aC!**(%%): Start Concurrent Measurement343 +aCC1!- aCC9!: Start Additional Concurrent Measurements – Request CRC 329 329 330 -(% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC 331 331 332 -(% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements 333 - 334 -(% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC 335 - 336 - 337 337 * AT Command : AT+ADDRC=0,1,0,1 338 338 339 339 * LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01 ... ... @@ -340,29 +340,24 @@ 340 340 341 341 Downlink: AA 02 aa bb cc dd 342 342 343 - (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.352 +aa: SDI-12 sensor address. 344 344 345 - (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC354 +bb: 0: no CRC, 1: request CRC 346 346 347 - (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement356 +cc: 1-9: Additional Measurement, 0: no additional measurement 348 348 349 - (% 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. 350 350 351 351 352 352 The following is the display information on the serial port and the server. 353 353 363 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]] 354 354 355 -[[image:image -20230201091954-12.png||_mstalt="453687"]]365 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]] 356 356 357 357 358 - [[image:image-20230201091954-13.png||_mstalt="454064"height="203"width="1117"]]368 +aR0!- aR9!, aRC0!- aRC9! 359 359 360 - 361 - 362 - 363 -==== (% style="color:blue" %)**aR0!- aR9!, aRC0!- aRC9!**(%%) ==== 364 - 365 - 366 366 Start Continuous Measurement 367 367 368 368 Start Continuous Measurement – Request CRC ... ... @@ -373,48 +373,45 @@ 373 373 374 374 Downlink: AA 03 aa bb cc dd 375 375 376 - (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address.380 +aa: SDI-12 sensor address. 377 377 378 - (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC382 +bb: 0: no CRC, 1: request CRC 379 379 380 - (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement384 +cc: 1-9: Additional Measurement, 0: no additional measurement 381 381 382 - (% 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. 383 383 384 384 385 385 The following is the display information on the serial port and the server. 386 386 391 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]] 387 387 388 -[[image:image -20230201092208-14.png||_mstalt="452283"]]393 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]] 389 389 395 +1. 396 +11. 397 +111. Advance SDI-12 Debug command 390 390 391 -[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]] 392 - 393 - 394 -=== 2.3.2 Advance SDI-12 Debug command === 395 - 396 - 397 397 This command can be used to debug all SDI-12 command. 398 398 399 399 400 -LoRaWAN Downlink: A8 aa xx xx xx xx bb cc dd402 +LoRaWAN Downlink: A8 aa xx xx xx xx bb cc 401 401 402 -( % style="color:#037691" %)**aa**(%%): total SDI-12 command length404 +(aa: total SDI-12 command length) 403 403 404 -( % style="color:#037691" %)**xx**(%%): SDI-12 command406 +(xx: SDI-12 command) 405 405 406 -( % style="color:#037691" %)**bb**(%%): Delay to wait for return408 +(bb: Delay to wait for return) 407 407 408 -( % 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) 409 409 410 -(% style="color:#037691" %)**dd: **(%%) 0: Do not use aD0! command access, 1: use aD0! command access. 411 411 413 +Example: AT+CFGDEV =0RC0!,1 412 412 413 - (% style="color:blue" %)**Example1: **(%%) AT+CFGDEV =0RC0!,1415 +0RC0!: SDI-12 Command, 414 414 415 - (%style="color:#037691"%)**0RC0! **(%%):SDI-12Command,417 +1: Delay 1 second. ( 0: 810 mini-second) 416 416 417 -(% style="color:#037691" %)**1 **(%%): Delay 1 second. ( 0: 810 mini-second) 418 418 419 419 Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 420 420 ... ... @@ -422,182 +422,179 @@ 422 422 The following is the display information on the serial port and the server. 423 423 424 424 425 -[[image:i mage-20230201092355-16.png||_mstalt="453960"]]426 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]] 426 426 428 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]] 427 427 428 -[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]] 430 +1. 431 +11. 432 +111. Convert ASCII to String 429 429 430 - 431 -(% style="color:blue" %)**Example2: **(%%) AT+CFGDEV =0M!,1,1 or AT+CFGDEV =0C!,1,1 432 - 433 -(% style="color:#037691" %)**0M! **(%%): SDI-12 Command, 434 - 435 -(% style="color:#037691" %)**1 **(%%): Delay 1 second. ( 0: 810 mini-second) 436 - 437 -(% style="color:#037691" %)**1 **(%%):Use aD0! command access. 438 - 439 -Equal Downlink: 0xA8 03 30 4D 21 01 01 01 440 - 441 - 442 -=== 2.3.3 Convert ASCII to String === 443 - 444 - 445 445 This command is used to convert between ASCII and String format. 446 446 436 + 447 447 AT+CONVFORM ( Max length: 80 bytes) 448 448 439 +Example: 449 449 450 - (%style="color:blue"%)**Example:**441 +1)AT+CONVFORM=0,string Convert String from String to ASCII 451 451 452 - 1) AT+CONVFORM=0, stringonvertString fromStringto ASCII443 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]] 453 453 454 -[[image:1675214845056-885.png||_mstalt="297622"]] 455 455 446 +2)AT+CONVFORM=1,ASCII Convert ASCII to String. 456 456 457 - 2) AT+CONVFORM=1, ASCII ConvertASCIItoString.448 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]] 458 458 459 -[[image:1675214856590-846.png||_mstalt="297739"]] 460 460 461 461 462 -=== 2.3.4 Define periodically SDI-12 commands and uplink. === 452 +1. 453 +11. 454 +111. Define periodically SDI-12 commands and uplink. 463 463 464 - 465 465 AT+COMMANDx & AT+DATACUTx 466 466 467 467 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. 468 468 469 469 470 -* (% style="color:blue" %)**AT Command:**461 +* ** AT Command:** 471 471 472 - (% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.**463 +**AT+COMMANDx=var1,var2,var3,var4.** 473 473 474 - (% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0!465 +var1: SDI-12 command , for example: 0RC0! 475 475 476 - (% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second)467 +var2: Wait timeout for return. (unit: second) 477 477 478 - (% 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!//. 479 479 480 - (% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max3retries.471 +var4: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries. 481 481 482 - (% style="color:red" %)**0**(%%)No validation check;473 +0 No validation check; 483 483 484 - (% style="color:red" %)**1**(%%)Check if return chars are printable char(0x20 ~~ 0x7E);475 +1 Check if return chars are printable char(0x20 ~~ 0x7E); 485 485 486 - (% style="color:red" %)**2**(%%)Check if there is return from SDI-12 sensor477 +2 Check if there is return from SDI-12 sensor 487 487 488 - (% 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); 489 489 490 490 491 -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. 492 492 493 493 494 - (% 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. 495 495 496 -(% border="1" style="width:436px" %) 497 -|(% style="background-color:#f2f2f2; width:433px" %)((( 498 -(% style="color:#0070c0" %)**AT+DATACUTx=a,b,c** 487 +|((( 488 +AT+DATACUTx=a,b,c 499 499 500 - **a**:490 +a: length for the return of AT+COMMAND 501 501 502 - **b**:492 +b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. 503 503 504 - **c**:494 +c: define the position for valid value. 505 505 ))) 506 506 507 -For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload: 508 508 498 +For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload: 509 509 510 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 511 -|=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)**AT+DATACUT1 value**|=(% style="width: 344px;background-color:#D9E2F3;color:#0070C0" %)**Final Result to combine Payload** 512 -|(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 513 -|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~8+12~~16|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32 514 -|(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~34|(% style="background-color:#f2f2f2; 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 515 515 516 -* (% 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 517 517 518 -(% style="color:blue" %)**0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 519 519 520 520 521 - (%style="color:red" %)**Note: if user use AT+COMMANDx toadd a newcommand,healsoneedto send AT+DATACUTx downlink.**508 +* ** Downlink Payload:** 522 522 510 +**0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 523 523 524 -Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)** 525 525 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 + 526 526 Where: 527 527 528 -* (% style="color:#037691" %)**MM**(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,529 -* (% style="color:#037691" %)**NN**(%%): 1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.530 -* (% style="color:#037691" %)**LL**(%%): The length of AT+COMMAND or AT+DATACUT command531 -* (% style="color:#037691" %)**XX XX XX XX**(%%): AT+COMMAND or AT+DATACUT command532 -* (% style="color:#037691" %)**YY**(%%): If YY=0, SDI-12-LBwill execute the downlink command without uplink; if YY=1, SDI-12-LBwill 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. 533 533 534 - (% style="color:blue" %)**Example:**526 +Example: 535 535 536 - [[image:image-20230201094129-18.png||_mstalt="455065"]]528 +**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1** 537 537 530 +**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10** 538 538 532 +**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10** 539 539 540 -(% style="color:blue" %)**Clear SDI12 Command** 541 541 535 +**Clear SDI12 Command** 536 + 542 542 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 543 543 544 544 545 -* (% style="color:#037691" %)**AT Command:**540 +* ** AT Command:** 546 546 547 - (% 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 548 548 549 549 550 550 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 551 551 552 552 553 -* (% style="color:#037691" %)** Downlink Payload:**548 +* ** Downlink Payload:** 554 554 555 - (% style="color:#4f81bd" %)**0x09 aa bb**(%%)same as AT+CMDEAR=aa,bb550 +**~ 0x09 aa bb** same as AT+CMDEAR=aa,bb 556 556 557 557 558 558 559 -(% style="color:blue" %)**command combination** 560 560 555 +**command combination** 556 + 561 561 Below shows a screen shot how the results combines together to a uplink payload. 562 562 563 -[[image: 1675215745275-920.png||_mstalt="295334"]]559 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]] 564 564 565 565 566 -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. 567 567 568 - (% 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. 569 569 570 570 571 - (% 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. 572 572 573 573 574 -[[image: 1675215782925-448.png||_mstalt="297466"]]570 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]] 575 575 576 576 577 -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. 578 578 579 579 580 580 581 - (% style="color:blue" %)**Compose Uplink**577 +**Compose Uplink** 582 582 583 - (% style="color:#4f81bd" %)**AT+DATAUP=0**579 +**AT+DATAUP=0** 584 584 585 -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. 586 586 587 -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 588 588 589 589 Where PAYVER is defined by AT+PAYVER, below is an example screen shot. 590 590 591 591 592 -[[image: 1675215828102-844.png||_mstalt="294645"]]588 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]] 593 593 594 594 595 - (% style="color:#4f81bd" %)**AT+DATAUP=1**591 +**AT+DATAUP=1** 596 596 597 -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. 598 598 599 -Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__595 +Final Payload is 600 600 597 +**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA** 598 + 601 601 1. Battery Info (2 bytes): Battery voltage 602 602 1. PAYVER (1 byte): Defined by AT+PAYVER 603 603 1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling. ... ... @@ -604,77 +604,91 @@ 604 604 1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT) 605 605 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 606 606 607 -[[image: 1675215848113-696.png||_mstalt="296998"]]605 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]] 608 608 609 609 610 - (% 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:** 611 611 612 -* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) 613 -* For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 614 -* For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). 615 -* 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) 616 616 617 - (%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). 618 618 619 - (%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). 620 620 616 + ~* For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). 621 621 622 - ==2.4UplinkPayload==618 + *** When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;** 623 623 624 - ===2.4.1 DevicePayload,FPORT~=5===620 +**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.** 625 625 622 +1. 623 +11. Uplink Payload 626 626 625 + 626 +Uplink payloads have two types: 627 + 628 +* Distance Value: Use FPORT=2 629 +* Other control commands: Use other FPORT fields. 630 + 631 +The application server should parse the correct value based on FPORT settings. 632 + 633 + 634 +1. 635 +11. 636 +111. Device Payload, FPORT=5 637 + 627 627 Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server. 628 628 640 + 629 629 Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink. 630 630 631 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 632 -|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)** 633 -|(% style="background-color:#f2f2f2; width:103px" %)**Size (bytes)**|(% style="background-color:#f2f2f2; width:72px" %)**1**|(% style="background-color:#f2f2f2" %)**2**|(% style="background-color:#f2f2f2; width:91px" %)**1**|(% style="background-color:#f2f2f2; width:86px" %)**1**|(% style="background-color:#f2f2f2; width:44px" %)**2** 634 -|(% style="background-color:#f2f2f2; width:103px" %)**Value**|(% style="background-color:#f2f2f2; width:72px" %)Sensor Model|(% style="background-color:#f2f2f2" %)Firmware Version|(% style="background-color:#f2f2f2; width:91px" %)Frequency Band|(% style="background-color:#f2f2f2; width:86px" %)Sub-band|(% style="background-color:#f2f2f2; width:44px" %)BAT 635 635 636 -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 637 637 638 -[[image:1675215946738-635.png||_mstalt="297778"]] 639 639 649 +Example parse in TTNv3 640 640 641 - (% style="color:#037691" %)**Sensor Model**(%%): ForSDI-12-LB,this valueisx17651 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]] 642 642 643 - (% style="color:#037691" %)**FirmwareVersion**(%%):0x0100,Means:v1.0.0 version653 +**Sensor Model**: For SDI-12-LB, this value is 0x17 644 644 645 - (% style="color:#037691" %)**FrequencyBand**:655 +**Firmware Version**: 0x0100, Means: v1.0.0 version 646 646 647 - 0x01:EU868657 +**Frequency Band**: 648 648 649 -0x0 2: US915659 +*0x01: EU868 650 650 651 -0x0 3:IN865661 +*0x02: US915 652 652 653 -0x0 4:AU915663 +*0x03: IN865 654 654 655 -0x0 5:KZ865665 +*0x04: AU915 656 656 657 -0x0 6:RU864667 +*0x05: KZ865 658 658 659 -0x0 7:AS923669 +*0x06: RU864 660 660 661 -0x0 8: AS923-1671 +*0x07: AS923 662 662 663 -0x0 9: AS923-2673 +*0x08: AS923-1 664 664 665 -0x0 a: AS923-3675 +*0x09: AS923-2 666 666 667 -0x0 b:CN470677 +*0x0a: AS923-3 668 668 669 -0x0 c:EU433679 +*0x0b: CN470 670 670 671 -0x0 d:KR920681 +*0x0c: EU433 672 672 673 -0x0 e:MA869683 +*0x0d: KR920 674 674 685 +*0x0e: MA869 675 675 676 -(% style="color:#037691" %)**Sub-Band**: 677 677 688 +**Sub-Band**: 689 + 678 678 AU915 and US915:value 0x00 ~~ 0x08 679 679 680 680 CN470: value 0x0B ~~ 0x0C ... ... @@ -682,7 +682,7 @@ 682 682 Other Bands: Always 0x00 683 683 684 684 685 - (% style="color:#037691" %)**Battery Info**:697 +**Battery Info**: 686 686 687 687 Check the battery voltage. 688 688 ... ... @@ -691,7 +691,9 @@ 691 691 Ex2: 0x0B49 = 2889mV 692 692 693 693 694 -=== 2.4.2 Uplink Payload, FPORT~=2 === 706 +1. 707 +11. 708 +111. Uplink Payload, FPORT=2 695 695 696 696 697 697 There are different cases for uplink. See below ... ... @@ -700,25 +700,33 @@ 700 700 701 701 * Periodically Uplink: FPORT=2 702 702 703 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 704 -|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)((( 705 -**Size(bytes)** 706 -)))|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 240px;background-color:#D9E2F3;color:#0070C0" %)**Length depends on the return from the commands** 707 -|(% 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**|((( 708 708 Battery(mV) 725 + 709 709 & 727 + 710 710 Interrupt_Flag 711 -)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)((( 712 -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 + 713 713 Payload length in server,server will show payload not provided in the LoRaWAN server. 714 714 ))) 715 715 716 -[[image:1675216282284-923.png||_mstalt="295633"]] 717 717 736 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]] 718 718 719 -=== 2.4.3 Battery Info === 720 720 721 721 740 +1. 741 +11. 742 +111. Battery Info 743 + 722 722 Check the battery voltage for SDI-12-LB. 723 723 724 724 Ex1: 0x0B45 = 2885mV ... ... @@ -726,12 +726,14 @@ 726 726 Ex2: 0x0B49 = 2889mV 727 727 728 728 729 -=== 2.4.4 Interrupt Pin === 751 +1. 752 +11. 753 +111. Interrupt Pin 730 730 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]]. 731 731 732 -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"]]. 733 733 734 - **Example:**758 +Example: 735 735 736 736 Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet. 737 737 ... ... @@ -738,324 +738,244 @@ 738 738 Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet. 739 739 740 740 741 -=== 2.4.5 Payload version === 765 +1. 766 +11. 767 +111. Payload version 742 742 743 743 744 -The version number of the payload, mainly used for decoding. The default is 01. 745 745 746 746 747 -=== 2.4.6 Decode payload in The Things Network === 748 748 749 749 774 + 775 +1. 776 +11. 777 +111. Decode payload in The Things Network 778 + 750 750 While using TTN network, you can add the payload format to decode the payload. 751 751 752 -[[image: 1675216779406-595.png||_mstalt="298376"]]781 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.png]] 753 753 754 754 755 755 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. 756 756 757 -SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]] 758 758 787 +下面的解码生成超链接放进去. 759 759 760 - == 2.5 UplinkInterval==789 +function Decoder(bytes, port) { 761 761 791 + if(port==5) 762 762 763 - TheSDI-12-LBby default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link:793 + { 764 764 765 - [[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]]795 + var freq_band; 766 766 797 + var sub_band; 767 767 768 - ==2.6ExamplesToSet SDI commands==799 + var sensor; 769 769 770 -=== 2.6.1 Examples 1 ~-~- General Example === 771 771 802 + if(bytes[0]==0x17) 772 772 773 - COM portandSDI-12sensorcommunication converted toSDI-12-LBand SDI-12 sensor communication.804 + sensor= "SDI12-LB"; 774 774 775 -[[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]] 776 776 807 + var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f); 777 777 778 -(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:** 779 779 780 - a.Sendthefirstcommand and get the firstreply:810 + if(bytes[3]==0x01) 781 781 782 - (%style="color:#037691"%)**AT+COMMANDx=1I!,0,0,1**812 + freq_band="EU868"; 783 783 784 - b.Sendthesecondcommandandgetthecondreply:814 + else if(bytes[3]==0x02) 785 785 786 - (%style="color:#037691"%)**AT+COMMANDx=2I!,0,0,1**816 + freq_band="US915"; 787 787 788 - c.Sendthethirdcommandandgetthethird reply:818 + else if(bytes[3]==0x03) 789 789 790 - (%style="color:#037691"%)**AT+COMMANDx=3I!,0,0,1**820 + freq_band="IN865"; 791 791 792 - d.Sendthefourthcommandandgetthe fourth reply:822 + else if(bytes[3]==0x04) 793 793 794 - (%style="color:#037691"%)**AT+COMMANDx=4I!,0,0,1**824 + freq_band="AU915"; 795 795 796 - e.Sendthefifthcommandplusthesixth command, get thesixth reply:826 + else if(bytes[3]==0x05) 797 797 798 - (%style="color:#037691"%)**AT+COMMANDx=1M!,2,1,1**828 + freq_band="KZ865"; 799 799 800 - f.Sendtheseventhcommandplustheeighth command, getthe eighth reply:830 + else if(bytes[3]==0x06) 801 801 802 - (%style="color:#037691"%)**AT+COMMANDx=2M!,2,1,1**832 + freq_band="RU864"; 803 803 804 - g.Sendtheninthcommandplusthetenth command, getthetenth reply:834 + else if(bytes[3]==0x07) 805 805 806 - (%style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**836 + freq_band="AS923"; 807 807 808 - h.Sendtheeleventhcommandplusthetwelfth command, getthe twelfth reply:838 + else if(bytes[3]==0x08) 809 809 810 - (%style="color:#037691"%)**AT+COMMANDx=4M!,1,1,1**840 + freq_band="AS923_1"; 811 811 842 + else if(bytes[3]==0x09) 812 812 813 - (%style="color:blue"%)**2) TheAT+DATACUTxcommandisappliedtothe greenarrow part, receiving andcut out data from theSDI12sensor:**844 + freq_band="AS923_2"; 814 814 815 - a.Thefirstreply,all34characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”846 + else if(bytes[3]==0x0A) 816 816 817 - Cutoutallcharacters:(%_mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691"%);848 + freq_band="AS923_3"; 818 818 819 - b. Thesixthreply,all31characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>”850 + else if(bytes[3]==0x0F) 820 820 821 - Cutoutallcharacters:(%_mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);852 + freq_band="AS923_4"; 822 822 823 - c. Theeighthreply,all31characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>”854 + else if(bytes[3]==0x0B) 824 824 825 - Cutoutallcharacters:(%_mstmutation="1"style="color:#037691"%)**AT+ALLDATAMOD=1orAT+DATACUTx=31,2,1~~31**(% style="color:#037691"%);856 + freq_band="CN470"; 826 826 827 - d. Thetenthreply,all15characters:”3-2919.8+24.0<CR><LF>”858 + else if(bytes[3]==0x0C) 828 828 829 - Cutoutallcharacters:(%_mstmutation="1"style="color:#037691"%)**AT+ALLDATAMOD=1orAT+DATACUTx=15,2,1~~15**(% style="color:#037691"%);860 + freq_band="EU433"; 830 830 831 - e. Thetwelfthreply,all25characters:”4+30.8+22.84+4.7+954.38<CR><LF>”862 + else if(bytes[3]==0x0D) 832 832 833 - Partialcut,thecutsensoraddressandthefirst two parameters:(% style="color:#037691" %)**AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”**.864 + freq_band="KR920"; 834 834 866 + else if(bytes[3]==0x0E) 835 835 836 - ===2.6.2Example2~-~-ConnecttoHygrovue10===868 + freq_band="MA869"; 837 837 838 -==== 2.6.2.1 Reference Manual and Command ==== 839 839 871 + if(bytes[4]==0xff) 840 840 841 - *[[Hygrovue10ProductPage>>https://www.campbellsci.com/hygrovue10]]873 + sub_band="NULL"; 842 842 843 - *CommandstobeusedinPCandoutput.875 + else 844 844 845 - ~1.checkdeviceaddress877 + sub_band=bytes[4]; 846 846 847 -2. change device address 848 848 849 - 3.checkdeviceID880 + var bat= (bytes[5]<<8 | bytes[6])/1000; 850 850 851 -4. start measure 852 852 853 - 5.GetMeausreresult883 + return { 854 854 855 - [[image:image-20230603120209-2.png||height="281" width="267"]]885 + SENSOR_MODEL:sensor, 856 856 887 + FIRMWARE_VERSION:firm_ver, 857 857 858 - ====2.6.2.2HardwareConnectiontoSDI-12-LB====889 + FREQUENCY_BAND:freq_band, 859 859 891 + SUB_BAND:sub_band, 860 860 861 - [[image:image-20230603120515-3.png]]893 + BAT:bat, 862 862 895 + } 863 863 864 - ====2.6.2.3Commands set in SDI-12-LB and uplink payload ====897 + } 865 865 899 + else if(port==100) 866 866 867 - [[image:image-20230603120648-4.png]]901 + { 868 868 869 - [[image:image-20230603120726-5.png]]903 + var datas_sum={}; 870 870 905 + for(var j=0;j<bytes.length;j++) 871 871 872 - **DatainTTN:**907 + { 873 873 874 - [[image:image-20230603120859-6.png||height="118"width="1285"]]909 + var datas= String.fromCharCode(bytes[j]); 875 875 911 + if(j=='0') 876 876 877 - ===(%id="cke_bm_1172015S"style="display:none"%)(%%)2.6.3Example3~-~-Connectto SIL-400===913 + datas_sum.datas_sum=datas; 878 878 879 - ====2.6.3.1ReferenceManualandCommand====915 + else 880 880 917 + datas_sum.datas_sum+=datas; 881 881 882 - *[[SIL-400ProductPage>>https://www.apogeeinstruments.com/sil-411-commercial-grade-sdi-12-digital-output-standard-field-of-view-infrared-radiometer-sensor/]]919 + } 883 883 884 -* Commands to be used in PC and output. 885 885 886 - ~1.checkdeviceaddress922 + return datas_sum; 887 887 888 - 2.changedevice address924 + } 889 889 890 - 3.checkdeviceID926 + else 891 891 892 - 4.startmeasure928 + { 893 893 894 - 5.GetMeausreresult930 + var decode={}; 895 895 896 - [[image:image-20230603121606-7.png||height="242"width="307"]]932 + decode.EXTI_Trigger= (bytes[0] & 0x80)? "TRUE":"FALSE"; 897 897 934 + decode.BatV= ((bytes[0]<<8 | bytes[1])&0x7FFF)/1000; 898 898 899 - ====2.6.3.2HardwareConnectionto SDI-12-LB ====936 + decode.Payver= bytes[2]; 900 900 938 + for(var i=3;i<bytes.length;i++) 901 901 902 - [[image:image-20230603121643-8.png||height="442"width="656"]]940 + { 903 903 942 + var data= String.fromCharCode(bytes[i]); 904 904 905 - ====2.6.3.3CommandssetinSDI-12-LBanduplinkpayload====944 + if(i=='3') 906 906 946 + decode.data_sum=data; 907 907 908 - [[image:image-20230603121721-9.png]]948 + else 909 909 910 - [[image:image-20230603121752-10.png]]950 + decode.data_sum+=data; 911 911 912 - DatainTTN:952 + } 913 913 914 - [[image:image-20230603121826-11.png||height="155"width="1104"]]954 + return decode; 915 915 956 + } 916 916 917 917 918 - === (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.4 Example 4 ~-~- Connect to TEROS-12 ===959 +} 919 919 920 -==== 2.6.4.1 Reference Manual and Command ==== 921 921 962 +1. 963 +11. Uplink Interval 922 922 923 - * [[TEROS-12ProductPage>>https://www.metergroup.com/en/meter-environment/products/teros-12-soil-moisture-sensor]]965 +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: 924 924 925 - *Commandstobe usedPCutput.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]] 926 926 927 -1.check device address 928 928 929 -2.change device address 930 930 931 -3.check device ID 971 +1. 972 +11. Frequency Plans 932 932 933 - 4.startmeasure974 +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. 934 934 935 -5.Get Meausre result 936 936 937 -[[i mage:image-20230603122248-16.png||height="196"width="198"]]977 +[[https:~~/~~/wiki.dragino.com/index.php?title=End_Device_Frequency_Band>>url:https://wiki.dragino.com/index.php?title=End_Device_Frequency_Band]] 938 938 939 939 940 -==== 2.6.4.2 Hardware Connection to SDI-12-LB ==== 941 941 981 +1. 982 +11. Firmware Change Log 942 942 943 -[[image:image-20230603122212-15.png||height="502" width="667"]] 944 - 945 - 946 -==== 2.6.4.3 Commands set in SDI-12-LB and uplink payload ==== 947 - 948 - 949 -[[image:image-20230603122040-12.png]] 950 - 951 -[[image:image-20230603122109-13.png||height="469" width="762"]] 952 - 953 - 954 -**Data in TTN:** 955 - 956 -[[image:image-20230603122139-14.png||height="148" width="1128"]] 957 - 958 - 959 -=== (% id="cke_bm_1489640S" style="display:none" %) (% id="cke_bm_1172015S" style="display:none" %) (%%)2.6.5 Example 5 ~-~- Connect to SIL-400/TEROS-12 & Hygrovue10 === 960 - 961 -==== 2.6.5.1 Important Notice! ==== 962 - 963 - 964 -* The product page and reference command see above example 2,3,4 965 - 966 -* All of these SDI-12 sensors use the same address (address 0) by default. So we need to change their address to different address, by using **aAb!** command. See above example. 967 - 968 -* The sensor needs to be powered to a steady statue. So the 12VT time need to be set to the maximum stable time for the sensors. in this example, it is 13 seconds. 969 - 970 -* If these SDI-12 sensors are powered by external power source. It will add 300uA in the total current in SDI-12-LB. 971 - 972 - 973 -==== 2.6.5.2 Hardware Connection to SDI-12-LB ==== 974 - 975 - 976 -[[image:image-20230603122508-17.png||height="526" width="742"]] 977 - 978 - 979 -==== 2.6.5.3 Commands set in SDI-12-LB and uplink payload ==== 980 - 981 - 982 -[[image:image-20230603122549-18.png]] 983 - 984 -[[image:image-20230603122623-19.png||height="483" width="1121"]] 985 - 986 - 987 -**Data in TTN:** 988 - 989 -[[image:image-20230603122719-20.png||height="151" width="1179"]] 990 - 991 - 992 -=== (% id="cke_bm_4783S" style="display:none" %) (%%)2.6.6 Example 6 ~-~- Connect to ENTELECHY-EP_SDI-12 === 993 - 994 -==== 2.6.4.1 Reference Manual and Command ==== 995 - 996 - 997 -* [[https:~~/~~/enviroprosoilprobes.com/wp-content/uploads/2019/11/ENTELECHY-EP_SDI-12-Commands.pdf>>url:https://enviroprosoilprobes.com/wp-content/uploads/2019/11/ENTELECHY-EP_SDI-12-Commands.pdf]] 998 - 999 -* Commands to be used in PC and output. 1000 - 1001 -1.check device address 1002 - 1003 -2.change device address 1004 - 1005 -3.check device ID 1006 - 1007 -4.start measure 1008 - 1009 -5.Get Meausre result 1010 - 1011 - 1012 -[[image:image-20230627174559-3.png]] 1013 - 1014 -==== 2.6.4.2 Hardware Connection to SDI-12-LB ==== 1015 - 1016 -[[image:image-20230627174446-2.png]] 1017 - 1018 - 1019 - 1020 -==== 2.6.4.3 Commands set in SDI-12-LB and uplink payload ==== 1021 - 1022 - 1023 -[[image:image-20230627175513-4.png||height="596" width="576"]] 1024 - 1025 -[[image:image-20230627175736-5.png||height="429" width="693"]] 1026 - 1027 - 1028 -**Data in TTN:** 1029 - 1030 -[[image:image-20230627180303-6.png||height="292" width="1171"]] 1031 - 1032 -== 2.7 Frequency Plans == 1033 - 1034 - 1035 -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. 1036 - 1037 -[[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/]] 1038 - 1039 - 1040 -== 2.8 Firmware Change Log == 1041 - 1042 - 1043 1043 **Firmware download link:** 1044 1044 1045 -[[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]] 1046 1046 1047 1047 1048 -= 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = 1049 1049 990 +1. Configure SDI-12-LB via AT Command or LoRaWAN Downlink 1050 1050 1051 1051 Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink. 1052 1052 1053 -* AT Command Connection: See [[FAQ>> ||anchor="H7.FAQ"]].1054 -* 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: 1055 1055 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 + 1056 1056 There are two kinds of commands to configure SDI-12-LB, they are: 1057 1057 1058 -* (% style="color:blue" %)**General Commands**.1002 +* **General Commands**. 1059 1059 1060 1060 These commands are to configure: 1061 1061 ... ... @@ -1064,309 +1064,388 @@ 1064 1064 1065 1065 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: 1066 1066 1067 -[[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]] 1068 1068 1069 1069 1070 -* (% style="color:blue" %)**Commands special design for SDI-12-LB**1014 +* **Commands special design for SDI-12-LB** 1071 1071 1072 1072 These commands only valid for SDI-12-LB, as below: 1073 1073 1074 1074 1075 -== 3.1 Set Transmit Interval Time == 1076 1076 1020 +1. 1021 +11. Set Transmit Interval Time 1077 1077 1078 1078 Feature: Change LoRaWAN End Node Transmit Interval. 1079 1079 1080 - (% style="color:blue" %)**AT Command: AT+TDC**1025 +**AT Command: AT+TDC** 1081 1081 1082 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1083 -|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Command Example**|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1084 -|(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval|(% style="background-color:#f2f2f2" %)((( 1027 +|**Command Example**|**Function**|**Response** 1028 +|AT+TDC=?|Show current transmit Interval|((( 1085 1085 30000 1030 + 1086 1086 OK 1032 + 1087 1087 the interval is 30000ms = 30s 1088 1088 ))) 1089 -| (% style="background-color:#f2f2f2; width:157px" %)AT+TDC=60000|(% style="background-color:#f2f2f2; width:166px" %)Set Transmit Interval|(% style="background-color:#f2f2f2" %)(((1035 +|AT+TDC=60000|Set Transmit Interval|((( 1090 1090 OK 1037 + 1091 1091 Set transmit interval to 60000ms = 60 seconds 1092 1092 ))) 1093 1093 1094 -(% style="color:blue" %)**Downlink Command: 0x01** 1095 1095 1042 +**Downlink Command: 0x01** 1096 1096 1097 1097 Format: Command Code (0x01) followed by 3 bytes time value. 1098 1098 1099 -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. 1100 1100 1101 -* Example 1: Downlink Payload: 0100001E 1102 -* 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 1103 1103 1104 1104 1105 -== 3.2 Set Interrupt Mode == 1106 1106 1053 +1. 1054 +11. Set Interrupt Mode 1107 1107 1108 1108 Feature, Set Interrupt mode for GPIO_EXIT. 1109 1109 1110 - (% style="color:blue" %)**AT Command: AT+INTMOD**1058 +**AT Command: AT+INTMOD** 1111 1111 1112 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1113 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1114 -|(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=?|(% style="background-color:#f2f2f2; width:196px" %)Show current interrupt mode|(% style="background-color:#f2f2f2; width:157px" %)((( 1060 +|**Command Example**|**Function**|**Response** 1061 +|AT+INTMOD=?|Show current interrupt mode|((( 1115 1115 0 1063 + 1116 1116 OK 1117 -the mode is 0 =Disable Interrupt 1065 + 1066 +the mode is 0 = No interruption 1118 1118 ))) 1119 -| (% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=2|(% style="background-color:#f2f2f2; width:196px" %)(((1068 +|AT+INTMOD=2|((( 1120 1120 Set Transmit Interval 1121 -0. (Disable Interrupt), 1122 -~1. (Trigger by rising and falling edge) 1123 -2. (Trigger by falling edge) 1124 -3. (Trigger by rising edge) 1125 -)))|(% style="background-color:#f2f2f2; width:157px" %)OK 1126 1126 1127 -(% 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 1128 1128 1077 + 1078 +**Downlink Command: 0x06** 1079 + 1129 1129 Format: Command Code (0x06) followed by 3 bytes. 1130 1130 1131 1131 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 1132 1132 1133 -* Example 1: Downlink Payload: 06000000 1134 -* 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 1135 1135 1136 1136 1137 -== 3.3 Set the output time == 1088 +1. 1089 +11. Set the output time 1138 1138 1139 - 1140 1140 Feature, Control the output 3V3 , 5V or 12V. 1141 1141 1142 - (% style="color:blue" %)**AT Command: AT+3V3T**1093 +**AT Command: AT+3V3T** 1143 1143 1144 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:474px" %) 1145 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 201px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 116px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1146 -|(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=?|(% style="background-color:#f2f2f2; width:201px" %)Show 3V3 open time.|(% style="background-color:#f2f2f2; width:116px" %)((( 1095 +|**Command Example**|**Function**|**Response** 1096 +|AT+3V3T=?|Show 3V3 open time.|((( 1147 1147 0 1098 + 1148 1148 OK 1149 1149 ))) 1150 -| (% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=0|(% style="background-color:#f2f2f2; width:201px" %)Normally open 3V3 power supply.|(% style="background-color:#f2f2f2; width:116px" %)(((1101 +|AT+3V3T=0|Normally open 3V3 power supply.|((( 1151 1151 OK 1103 + 1152 1152 default setting 1153 1153 ))) 1154 -| (% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=1000|(% style="background-color:#f2f2f2; width:201px" %)Close after a delay of 1000 milliseconds.|(% style="background-color:#f2f2f2; width:116px" %)(((1106 +|AT+3V3T=1000|Close after a delay of 1000 milliseconds.|((( 1155 1155 OK 1108 + 1109 + 1156 1156 ))) 1157 -| (% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=65535|(% style="background-color:#f2f2f2; width:201px" %)Normally closed 3V3 power supply.|(% style="background-color:#f2f2f2; width:116px" %)(((1111 +|AT+3V3T=65535|Normally closed 3V3 power supply.|((( 1158 1158 OK 1113 + 1114 + 1159 1159 ))) 1160 1160 1161 -(% style="color:blue" %)**AT Command: AT+5VT** 1162 1162 1163 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %) 1164 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 114px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1165 -|(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=?|(% style="background-color:#f2f2f2; width:196px" %)Show 5V open time.|(% style="background-color:#f2f2f2; width:114px" %)((( 1118 +**AT Command: AT+5VT** 1119 + 1120 +|**Command Example**|**Function**|**Response** 1121 +|AT+5VT=?|Show 5V open time.|((( 1166 1166 0 1123 + 1167 1167 OK 1168 1168 ))) 1169 -| (% style="background-color:#f2f2f2; width:155px" %)AT+5VT=0|(% style="background-color:#f2f2f2; width:196px" %)Normally closed 5V power supply.|(% style="background-color:#f2f2f2; width:114px" %)(((1126 +|AT+5VT=0|Normally closed 5V power supply.|((( 1170 1170 OK 1128 + 1171 1171 default setting 1172 1172 ))) 1173 -| (% style="background-color:#f2f2f2; width:155px" %)AT+5VT=1000|(% style="background-color:#f2f2f2; width:196px" %)Close after a delay of 1000 milliseconds.|(% style="background-color:#f2f2f2; width:114px" %)(((1131 +|AT+5VT=1000|Close after a delay of 1000 milliseconds.|((( 1174 1174 OK 1133 + 1134 + 1175 1175 ))) 1176 -| (% style="background-color:#f2f2f2; width:155px" %)AT+5VT=65535|(% style="background-color:#f2f2f2; width:196px" %)Normally open 5V power supply.|(% style="background-color:#f2f2f2; width:114px" %)(((1136 +|AT+5VT=65535|Normally open 5V power supply.|((( 1177 1177 OK 1138 + 1139 + 1178 1178 ))) 1179 1179 1180 -(% style="color:blue" %)**AT Command: AT+12VT ** 1181 1181 1182 - (% style="color:blue" %)**(Thev1.2 version is enabled for 1 secondby default, and the version below v1.2is disabled by default)**1143 +**AT Command: AT+12VT** 1183 1183 1184 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:443px" %) 1185 -|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 199px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 83px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1186 -|(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=?|(% style="background-color:#f2f2f2; width:199px" %)Show 12V open time.|(% style="background-color:#f2f2f2; width:83px" %)((( 1145 +|**Command Example**|**Function**|**Response** 1146 +|AT+12VT=?|Show 12V open time.|((( 1187 1187 0 1148 + 1188 1188 OK 1189 1189 ))) 1190 -| (% style="background-color:#f2f2f2; width:156px" %)AT+12VT=0|(% style="background-color:#f2f2f2; width:199px" %)Normally closed 12V power supply.|(% style="background-color:#f2f2f2; width:83px" %)OK1191 -| (% style="background-color:#f2f2f2; width:156px" %)AT+12VT=500|(% style="background-color:#f2f2f2; width:199px" %)Close after a delay of 500 milliseconds.|(% style="background-color:#f2f2f2; width:83px" %)(((1151 +|AT+12VT=0|Normally closed 12V power supply.|OK 1152 +|AT+12VT=500|Close after a delay of 500 milliseconds.|((( 1192 1192 OK 1154 + 1155 + 1193 1193 ))) 1194 1194 1195 -(% style="color:blue" %)**Downlink Command: 0x07** 1196 1196 1159 +**Downlink Command: 0x07** 1160 + 1197 1197 Format: Command Code (0x07) followed by 3 bytes. 1198 1198 1199 1199 The first byte is which power, the second and third bytes are the time to turn on. 1200 1200 1201 -* Example 1: Downlink Payload: 070101F4 **~-~-->**1202 -* Example 2: Downlink Payload: 0701FFFF **~-~-->**AT+3V3T=655351203 -* Example 3: Downlink Payload: 070203E8 **~-~-->**AT+5VT=10001204 -* Example 4: Downlink Payload: 07020000 **~-~-->**AT+5VT=01205 -* Example 5: Downlink Payload: 070301F4 **~-~-->**AT+12VT=5001206 -* 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 1207 1207 1208 1208 1209 -== 3.4 Set the all data mode == 1173 +1. 1174 +11. Set the all data mode 1210 1210 1211 - 1212 1212 Feature, Set the all data mode. 1213 1213 1214 - (% style="color:blue" %)**AT Command: AT+ALLDATAMOD**1178 +**AT Command: AT+ALLDATAMOD** 1215 1215 1216 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %) 1217 -|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response** 1218 -|(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=?|(% style="background-color:#f2f2f2" %)Show current all data mode|(% style="background-color:#f2f2f2" %)((( 1180 +|**Command Example**|**Function**|**Response** 1181 +|AT+ALLDATAMOD=?|Show current all data mode|((( 1219 1219 0 1183 + 1184 + 1220 1220 OK 1221 1221 ))) 1222 -| (% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=1|(% style="background-color:#f2f2f2" %)Set all data mode is 1.|(% style="background-color:#f2f2f2" %)OK1187 +|AT+ALLDATAMOD=1|Set all data mode is 1.|OK 1223 1223 1224 -(% style="color:blue" %)**Downlink Command: 0xAB** 1225 1225 1190 +**Downlink Command: 0xAB** 1191 + 1226 1226 Format: Command Code (0xAB) followed by 1 bytes. 1227 1227 1228 -* Example 1: Downlink Payload: AB 00 1229 -* 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 1230 1230 1231 1231 1232 -== 3.5 Set the splicing payload for uplink == 1198 +1. 1199 +11. Set the splicing payload for uplink 1233 1233 1234 - 1235 1235 Feature, splicing payload for uplink. 1236 1236 1237 - (% style="color:blue" %)**AT Command: AT+DATAUP**1203 +**AT Command: AT+DATAUP** 1238 1238 1239 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1240 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 266px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response** 1241 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =?|(% style="background-color:#f2f2f2; width:266px" %)Show current splicing payload for uplink mode|(% style="background-color:#f2f2f2" %)((( 1205 +|**Command Example**|**Function**|**Response** 1206 +|AT+DATAUP =?|Show current splicing payload for uplink mode|((( 1242 1242 0 1208 + 1209 + 1243 1243 OK 1244 1244 ))) 1245 -| (% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =0|(% style="background-color:#f2f2f2; width:266px" %)(((1212 +|AT+DATAUP =0|((( 1246 1246 Set splicing payload for uplink mode is 0. 1247 -)))|(% style="background-color:#f2f2f2" %)((( 1214 + 1215 + 1216 +)))|((( 1248 1248 OK 1218 + 1219 + 1249 1249 ))) 1250 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1|(% style="background-color:#f2f2f2; width:266px" %)Set splicing payload for uplink mode is 1 , and the each splice uplink is sent sequentially.|(% style="background-color:#f2f2f2" %)OK 1251 -|(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1,20000|(% style="background-color:#f2f2f2; width:266px" %)((( 1252 -Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds. 1253 -)))|(% style="background-color:#f2f2f2" %)OK 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. 1254 1254 1255 -(% style="color:blue" %)**Downlink Command: 0xAD** 1225 + 1226 +)))|OK 1256 1256 1228 + 1229 +**Downlink Command: 0xAD** 1230 + 1257 1257 Format: Command Code (0xAD) followed by 1 bytes or 5 bytes. 1258 1258 1259 -* Example 1: Downlink Payload: AD 00 1260 -* Example 2: Downlink Payload: AD 01 1261 -* 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 1262 1262 1263 1263 This means that the interval is set to 0x000014=20S 1264 1264 1265 1265 1266 -== 3.6 Set the payload version == 1240 +1. 1241 +11. Set the payload version 1267 1267 1268 - 1269 1269 Feature, Set the payload version. 1270 1270 1271 - (% style="color:blue" %)**AT Command: AT+PAYVER**1245 +**AT Command: AT+PAYVER** 1272 1272 1273 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %) 1274 -|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 192px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response** 1275 -|(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=?|(% style="background-color:#f2f2f2; width:192px" %)Show current payload version|(% style="background-color:#f2f2f2" %)((( 1247 +|**Command Example**|**Function**|**Response** 1248 +|AT+PAYVER=?|Show current payload version|((( 1276 1276 1 1250 + 1251 + 1277 1277 OK 1278 1278 ))) 1279 -| (% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=5|(% style="background-color:#f2f2f2; width:192px" %)Set payload version is 5.|(% style="background-color:#f2f2f2" %)OK1254 +|AT+PAYVER=5|Set payload version is 5.|OK 1280 1280 1281 -(% style="color:blue" %)**Downlink Command: 0xAE** 1282 1282 1257 +**Downlink Command: 0xAE** 1258 + 1283 1283 Format: Command Code (0xAE) followed by 1 bytes. 1284 1284 1285 -* Example 1: Downlink Payload: AE 01 1286 -* 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 1287 1287 1288 1288 1289 -= 4. Battery & Power Consumption = 1290 1290 1266 +1. Battery & how to replace 1267 +11. Battery Type 1291 1291 1292 -SDI-12-LB usesER26500+SPC1520batteryk.See belowlink fordetail informationaboutthe battery infoandhowto replace.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. 1293 1293 1294 -[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 1295 1295 1272 +The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance. 1296 1296 1297 - = 5. RemoteConfiguredevice=1274 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]] 1298 1298 1299 -== 5.1 Connect via BLE == 1300 1300 1277 +Minimum Working Voltage for the SDI-12-LB: 1301 1301 1302 - 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/]]1279 +SDI-12-LB: 2.45v ~~ 3.6v 1303 1303 1304 1304 1305 -== 5.2 AT Command Set == 1282 +1. 1283 +11. Replace Battery 1306 1306 1285 +Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery. 1307 1307 1287 +And make sure the positive and negative pins match. 1308 1308 1309 -= 6. OTA firmware update = 1310 1310 1311 1311 1312 -Please see this link for how to do OTA firmware update. 1291 +1. 1292 +11. Power Consumption Analyze 1313 1313 1314 -[[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/]] 1315 1315 1295 +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. 1316 1316 1317 -= 7. FAQ = 1318 1318 1319 - == 7.1 Howto useAT Command via UART to accessdevice? ==1298 +Instruction to use as below: 1320 1320 1321 1321 1322 -S ee: [[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]]1301 +Step 1: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: 1323 1323 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/]] 1324 1324 1325 -== 7.2 How to update firmware via UART port? == 1326 1326 1306 +Step 2: Open it and choose 1327 1327 1328 -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]] 1308 +* Product Model 1309 +* Uplink Interval 1310 +* Working Mode 1329 1329 1312 +And the Life expectation in difference case will be shown on the right. 1330 1330 1331 - == 7.3 How to changetheRa Frequency Bands/Region? ==1314 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image037.png]] 1332 1332 1333 1333 1334 -You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. 1335 -When downloading the images, choose the required image file for download. 1317 +The battery related documents as below: 1336 1336 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]] 1337 1337 1338 -= 8. Order Info = 1339 1339 1340 1340 1341 -((( 1342 - (%style="color:blue" %)**PartNumber: SDI-12-LB-XXX**1325 +|((( 1326 +JST-XH-2P connector 1343 1343 ))) 1344 1344 1345 -((( 1346 -(% style="color:blue" %)**XXX**(%%): The default frequency band 1347 -))) 1329 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image038.png]] 1348 1348 1349 -((( 1350 -(% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 1351 -(% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band 1352 -(% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band 1353 -(% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band 1354 -(% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band 1355 -(% style="color:red" %)**US915**(%%): LoRaWAN US915 band 1356 -(% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1357 -(% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1358 -))) 1359 1359 1360 1360 1361 -= 9. Packing Info = 1333 +1. 1334 +11. 1335 +111. Battery Note 1362 1362 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. 1363 1363 1364 -(% style="color:#037691" %)**Package Includes**: 1365 1365 1366 -* SDI-12-LB SDI-12 to LoRaWAN Converter x 1 1340 +1. 1341 +11. 1342 +111. Replace the battery 1367 1367 1368 - (%style="color:#037691"%)**Dimension and weight**: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. 1369 1369 1346 + 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) 1348 + 1349 + 1350 + 1351 + 1352 + 1353 + 1354 +1. Remote Configure device 1355 +11. Connect via BLE 1356 + 1357 + 1358 +Please see this instruction for how to configure via BLE: 1359 + 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/]] 1361 + 1362 + 1363 +1. 1364 +11. AT Command Set 1365 + 1366 + 1367 + 1368 +1. OTA firmware update 1369 + 1370 +Please see this link for how to do OTA firmware update. 1371 + 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/]] 1373 + 1374 + 1375 + 1376 + 1377 + 1378 + 1379 + 1380 + 1381 + 1382 + 1383 + 1384 +1. Order Info 1385 + 1386 +**Package Includes**: 1387 + 1388 +* SDI-12-LB SDI-12 to LoRaWAN Converter 1389 + 1390 + 1391 +**Dimension and weight**: 1392 + 1370 1370 * Device Size: cm 1371 1371 * Device Weight: g 1372 1372 * Package Size / pcs : cm ... ... @@ -1373,9 +1373,14 @@ 1373 1373 * Weight / pcs : g 1374 1374 1375 1375 1376 -= 10. Support = 1377 1377 1378 1378 1401 + 1402 +1. Support 1403 + 1379 1379 * 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 1380 1380 1381 -* 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]] 1408 + 1409 +
- 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
- image-20230222143809-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -322.1 KB - Content
- image-20230426084456-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -190.0 KB - Content
- image-20230603120127-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -5.7 KB - Content
- image-20230603120209-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -22.8 KB - Content
- image-20230603120515-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -489.3 KB - Content
- image-20230603120648-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -100.8 KB - Content
- image-20230603120726-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -133.2 KB - Content
- image-20230603120859-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -55.9 KB - Content
- image-20230603121606-7.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -24.4 KB - Content
- image-20230603121643-8.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -889.7 KB - Content
- image-20230603121721-9.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -105.4 KB - Content
- image-20230603121752-10.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -160.0 KB - Content
- image-20230603121826-11.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -52.8 KB - Content
- image-20230603122040-12.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -128.1 KB - Content
- image-20230603122109-13.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -271.1 KB - Content
- image-20230603122139-14.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -70.4 KB - Content
- image-20230603122212-15.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -818.3 KB - Content
- image-20230603122248-16.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -12.7 KB - Content
- image-20230603122508-17.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -980.2 KB - Content
- image-20230603122549-18.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -90.9 KB - Content
- image-20230603122623-19.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -139.5 KB - Content
- image-20230603122719-20.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -83.8 KB - Content
- image-20230627164957-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -835.0 KB - Content
- image-20230627165744-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -4.6 KB - Content
- image-20230627174446-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -835.0 KB - Content
- image-20230627174559-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -4.6 KB - Content
- image-20230627175513-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -12.0 KB - Content
- image-20230627175736-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -10.4 KB - Content
- image-20230627180303-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Bei - Size
-
... ... @@ -1,1 +1,0 @@ 1 -65.1 KB - Content