Wiki source code of SDI-12-LB -- SDI-12 to LoRaWAN Converter User Manual
Version 65.1 by Edwin Chen on 2023/06/03 12:25
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
40.7 | 1 | (% style="text-align:center" %) |
![]() |
47.1 | 2 | [[image:image-20230131183542-1.jpeg||_mstalt="470678" height="694" width="694"]] |
![]() |
2.2 | 3 | |
4 | **Table of Contents:** | ||
5 | |||
![]() |
40.7 | 6 | {{toc/}} |
![]() |
2.2 | 7 | |
8 | |||
9 | |||
10 | |||
11 | |||
12 | |||
13 | |||
14 | |||
15 | |||
16 | |||
17 | |||
18 | |||
19 | |||
![]() |
9.2 | 20 | = 1. Introduction = |
![]() |
2.2 | 21 | |
![]() |
9.2 | 22 | == 1.1 What is SDI-12 to LoRaWAN Converter == |
![]() |
2.2 | 23 | |
24 | |||
![]() |
41.13 | 25 | ((( |
![]() |
40.2 | 26 | The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution. |
![]() |
41.13 | 27 | ))) |
![]() |
9.2 | 28 | |
![]() |
41.13 | 29 | ((( |
![]() |
2.2 | 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. |
![]() |
41.13 | 31 | ))) |
![]() |
2.2 | 32 | |
![]() |
41.13 | 33 | ((( |
![]() |
37.8 | 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. |
![]() |
41.13 | 35 | ))) |
![]() |
2.2 | 36 | |
![]() |
41.13 | 37 | ((( |
![]() |
37.8 | 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. |
![]() |
41.13 | 39 | ))) |
![]() |
2.2 | 40 | |
![]() |
41.13 | 41 | ((( |
![]() |
40.2 | 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. |
![]() |
41.13 | 43 | ))) |
![]() |
2.2 | 44 | |
![]() |
41.13 | 45 | ((( |
![]() |
37.8 | 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. |
![]() |
41.13 | 47 | ))) |
![]() |
2.2 | 48 | |
49 | |||
![]() |
47.1 | 50 | [[image:image-20230201084414-1.png||_mstalt="427765" height="464" width="1108"]] |
![]() |
2.2 | 51 | |
52 | |||
![]() |
9.2 | 53 | == 1.2 Features == |
54 | |||
55 | |||
![]() |
2.2 | 56 | * LoRaWAN 1.0.3 Class A |
57 | * Ultra-low power consumption | ||
![]() |
43.1 | 58 | * Controllable 3.3v, 5v and 12v output to power external sensor |
![]() |
2.2 | 59 | * SDI-12 Protocol to connect to SDI-12 Sensor |
60 | * Monitor Battery Level | ||
61 | * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 | ||
62 | * Support Bluetooth v5.1 and LoRaWAN remote configure. | ||
63 | * Support wireless OTA update firmware | ||
64 | * Uplink on periodically | ||
65 | * Downlink to change configure | ||
66 | * 8500mAh Battery for long term use | ||
67 | |||
![]() |
48.17 | 68 | |
![]() |
9.2 | 69 | == 1.3 Specification == |
![]() |
2.2 | 70 | |
71 | |||
![]() |
40.2 | 72 | (% style="color:#037691" %)**Micro Controller:** |
![]() |
2.2 | 73 | |
74 | * MCU: 48Mhz ARM | ||
75 | * Flash: 256KB | ||
76 | * RAM: 64KB | ||
77 | |||
![]() |
40.2 | 78 | (% style="color:#037691" %)**Common DC Characteristics:** |
![]() |
2.2 | 79 | |
80 | * Supply Voltage: 2.5v ~~ 3.6v | ||
![]() |
45.1 | 81 | * Support current: 5V 300mA |
82 | 12V 100mA | ||
![]() |
2.2 | 83 | * Operating Temperature: -40 ~~ 85°C |
84 | |||
![]() |
40.2 | 85 | (% style="color:#037691" %)**LoRa Spec:** |
![]() |
2.2 | 86 | |
87 | * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz | ||
88 | * Max +22 dBm constant RF output vs. | ||
89 | * RX sensitivity: down to -139 dBm. | ||
90 | * Excellent blocking immunity | ||
91 | |||
![]() |
40.2 | 92 | (% style="color:#037691" %)**Current Input Measuring :** |
![]() |
2.2 | 93 | |
94 | * Range: 0 ~~ 20mA | ||
95 | * Accuracy: 0.02mA | ||
96 | * Resolution: 0.001mA | ||
97 | |||
![]() |
40.2 | 98 | (% style="color:#037691" %)**Voltage Input Measuring:** |
![]() |
2.2 | 99 | |
100 | * Range: 0 ~~ 30v | ||
101 | * Accuracy: 0.02v | ||
102 | * Resolution: 0.001v | ||
103 | |||
![]() |
40.2 | 104 | (% style="color:#037691" %)**Battery:** |
![]() |
2.2 | 105 | |
106 | * Li/SOCI2 un-chargeable battery | ||
107 | * Capacity: 8500mAh | ||
108 | * Self-Discharge: <1% / Year @ 25°C | ||
109 | * Max continuously current: 130mA | ||
110 | * Max boost current: 2A, 1 second | ||
111 | |||
![]() |
40.2 | 112 | (% style="color:#037691" %)**Power Consumption** |
![]() |
2.2 | 113 | |
114 | * Sleep Mode: 5uA @ 3.3v | ||
115 | * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm | ||
116 | |||
![]() |
48.17 | 117 | |
![]() |
9.2 | 118 | == 1.4 Connect to SDI-12 Sensor == |
![]() |
2.2 | 119 | |
120 | |||
121 | |||
![]() |
47.1 | 122 | [[image:1675212538524-889.png||_mstalt="298272"]] |
![]() |
2.2 | 123 | |
124 | |||
![]() |
9.2 | 125 | == 1.5 Sleep mode and working mode == |
![]() |
2.2 | 126 | |
127 | |||
![]() |
40.2 | 128 | (% 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. |
![]() |
2.2 | 129 | |
![]() |
40.2 | 130 | (% style="color:blue" %)**Working Mode: **(%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. |
![]() |
2.2 | 131 | |
132 | |||
![]() |
9.2 | 133 | == 1.6 Button & LEDs == |
![]() |
2.2 | 134 | |
135 | |||
![]() |
47.1 | 136 | [[image:1675212633011-651.png||_mstalt="291538"]] |
![]() |
2.2 | 137 | |
138 | |||
![]() |
48.21 | 139 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) |
![]() |
48.3 | 140 | |=(% 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** |
141 | |(% 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" %)((( | ||
![]() |
9.2 | 142 | If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. |
![]() |
2.2 | 143 | Meanwhile, BLE module will be active and user can connect via BLE to configure device. |
144 | ))) | ||
![]() |
48.3 | 145 | |(% 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" %)((( |
146 | (% 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. | ||
147 | (% style="background-color:#f2f2f2; color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. | ||
![]() |
2.2 | 148 | Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network. |
149 | ))) | ||
![]() |
48.3 | 150 | |(% 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" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB-NA is in Deep Sleep Mode. |
![]() |
2.2 | 151 | |
![]() |
48.17 | 152 | |
![]() |
9.2 | 153 | == 1.7 Pin Mapping == |
![]() |
2.2 | 154 | |
155 | |||
![]() |
47.1 | 156 | [[image:1675213198663-754.png||_mstalt="297167"]] |
![]() |
2.2 | 157 | |
158 | |||
![]() |
9.2 | 159 | == 1.8 BLE connection == |
![]() |
2.2 | 160 | |
![]() |
9.2 | 161 | |
![]() |
2.2 | 162 | SDI-12-LB support BLE remote configure. |
163 | |||
164 | 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: | ||
165 | |||
166 | * Press button to send an uplink | ||
167 | * Press button to active device. | ||
168 | * Device Power on or reset. | ||
169 | |||
170 | If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. | ||
171 | |||
172 | |||
![]() |
9.2 | 173 | == 1.9 Mechanical == |
![]() |
2.2 | 174 | |
175 | |||
![]() |
47.1 | 176 | [[image:image-20230201090139-2.png||_mstalt="428623"]] |
![]() |
2.2 | 177 | |
![]() |
47.1 | 178 | [[image:image-20230201090139-3.png||_mstalt="428987"]] |
![]() |
2.2 | 179 | |
![]() |
47.1 | 180 | [[image:image-20230201090139-4.png||_mstalt="429351"]] |
![]() |
2.2 | 181 | |
182 | |||
![]() |
19.2 | 183 | = 2. Configure SDI-12 to connect to LoRaWAN network = |
![]() |
9.2 | 184 | |
![]() |
19.2 | 185 | == 2.1 How it works == |
![]() |
9.2 | 186 | |
187 | |||
![]() |
40.2 | 188 | 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. |
![]() |
9.2 | 189 | |
![]() |
2.2 | 190 | |
![]() |
19.2 | 191 | == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == |
![]() |
2.2 | 192 | |
193 | |||
194 | 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. | ||
195 | |||
196 | |||
![]() |
47.1 | 197 | [[image:image-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]] |
![]() |
2.2 | 198 | |
199 | |||
200 | 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. | ||
201 | |||
202 | |||
![]() |
40.2 | 203 | (% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB. |
![]() |
2.2 | 204 | |
205 | Each SDI-12-LB is shipped with a sticker with the default device EUI as below: | ||
206 | |||
207 | |||
![]() |
49.3 | 208 | [[image:image-20230426084456-1.png||height="241" width="519"]] |
![]() |
2.2 | 209 | |
210 | |||
211 | You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: | ||
212 | |||
213 | |||
![]() |
40.2 | 214 | (% style="color:blue" %)**Register the device** |
![]() |
2.2 | 215 | |
![]() |
47.1 | 216 | [[image:1675213652444-622.png||_mstalt="293657"]] |
![]() |
2.2 | 217 | |
218 | |||
![]() |
40.2 | 219 | (% style="color:blue" %)**Add APP EUI and DEV EUI** |
![]() |
2.2 | 220 | |
221 | |||
![]() |
47.1 | 222 | [[image:1675213661769-223.png||_mstalt="295217"]] |
![]() |
2.2 | 223 | |
224 | |||
![]() |
40.2 | 225 | (% style="color:blue" %)**Add APP EUI in the application** |
![]() |
2.2 | 226 | |
227 | |||
![]() |
47.1 | 228 | [[image:1675213675852-577.png||_mstalt="297947"]] |
![]() |
2.2 | 229 | |
230 | |||
![]() |
40.2 | 231 | (% style="color:blue" %)**Add APP KEY** |
![]() |
2.2 | 232 | |
![]() |
47.1 | 233 | [[image:1675213686734-883.png||_mstalt="298064"]] |
![]() |
2.2 | 234 | |
235 | |||
![]() |
40.2 | 236 | (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB |
![]() |
2.2 | 237 | |
238 | |||
239 | Press the button for 5 seconds to activate the SDI-12-LB. | ||
240 | |||
![]() |
40.2 | 241 | (% 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. |
![]() |
2.2 | 242 | |
243 | |||
![]() |
47.1 | 244 | [[image:1675213704414-644.png||_mstalt="293748"]] |
![]() |
2.2 | 245 | |
246 | |||
![]() |
19.2 | 247 | == 2.3 SDI-12 Related Commands == |
![]() |
2.2 | 248 | |
249 | |||
![]() |
19.2 | 250 | User need to configure SDI-12-LB to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes. |
![]() |
2.2 | 251 | |
252 | |||
![]() |
29.2 | 253 | === 2.3.1 Basic SDI-12 debug command === |
![]() |
2.2 | 254 | |
255 | |||
256 | 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. | ||
257 | |||
258 | 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. | ||
259 | |||
260 | The following is the display information on the serial port and the server. | ||
261 | |||
262 | |||
![]() |
47.1 | 263 | [[image:image-20230201091027-6.png||_mstalt="429065"]] |
![]() |
2.2 | 264 | |
![]() |
19.2 | 265 | |
![]() |
47.1 | 266 | [[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]] |
![]() |
19.2 | 267 | |
268 | |||
![]() |
41.4 | 269 | |
![]() |
40.2 | 270 | ==== (% style="color:blue" %)**al! ~-~- Get SDI-12 sensor Identification**(%%) ==== |
![]() |
19.2 | 271 | |
272 | |||
![]() |
2.2 | 273 | * AT Command: AT+ADDRI=aa |
274 | * LoRaWAN Downlink(prefix 0xAA00): AA 00 aa | ||
275 | |||
![]() |
40.2 | 276 | (% style="color:#037691" %)**Parameter: **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command) |
![]() |
2.2 | 277 | |
![]() |
41.4 | 278 | (% style="color:blue" %)**Example : **(%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30) |
![]() |
2.2 | 279 | |
280 | |||
281 | The following is the display information on the serial port and the server. | ||
282 | |||
283 | |||
![]() |
47.1 | 284 | [[image:image-20230201091257-8.png||_mstalt="431392"]] |
![]() |
2.2 | 285 | |
286 | |||
![]() |
47.1 | 287 | [[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]] |
![]() |
19.2 | 288 | |
289 | |||
![]() |
40.2 | 290 | ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ==== |
![]() |
2.2 | 291 | |
292 | |||
![]() |
40.2 | 293 | (% style="color:red" %)**aM! **(%%): Start Non-Concurrent Measurement |
![]() |
2.2 | 294 | |
![]() |
40.2 | 295 | (% style="color:red" %)**aMC! **(%%): Start Non-Concurrent Measurement – Request CRC |
![]() |
2.2 | 296 | |
![]() |
40.2 | 297 | (% style="color:red" %)**aM1!- aM9! **(%%): Additional Measurements |
![]() |
2.2 | 298 | |
![]() |
40.2 | 299 | (% style="color:red" %)**aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC |
![]() |
2.2 | 300 | |
![]() |
27.2 | 301 | |
![]() |
2.2 | 302 | * AT Command : AT+ADDRM=0,1,0,1 |
![]() |
37.10 | 303 | |
![]() |
2.2 | 304 | * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01 |
305 | |||
306 | Downlink:AA 01 aa bb cc dd | ||
307 | |||
![]() |
40.2 | 308 | (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. |
![]() |
2.2 | 309 | |
![]() |
40.2 | 310 | (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC |
![]() |
2.2 | 311 | |
![]() |
40.2 | 312 | (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement |
![]() |
2.2 | 313 | |
![]() |
41.5 | 314 | (% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return. |
![]() |
2.2 | 315 | |
316 | |||
317 | The following is the display information on the serial port and the server. | ||
318 | |||
319 | |||
![]() |
47.1 | 320 | [[image:image-20230201091630-10.png||_mstalt="449995"]] |
![]() |
2.2 | 321 | |
322 | |||
![]() |
47.1 | 323 | [[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]] |
![]() |
2.2 | 324 | |
325 | |||
326 | |||
![]() |
40.2 | 327 | ==== (% style="color:blue" %)**aC!, aCC!, aC1!- aC9!, aCC1!- aCC9! **(%%) ==== |
![]() |
2.2 | 328 | |
329 | |||
![]() |
40.2 | 330 | (% style="color:red" %)**aC!**(%%) : Start Concurrent Measurement |
![]() |
2.2 | 331 | |
![]() |
40.2 | 332 | (% style="color:red" %)**aCC!** (%%): Start Concurrent Measurement – Request CRC |
![]() |
2.2 | 333 | |
![]() |
40.2 | 334 | (% style="color:red" %)**aC1!- aC9!**(%%) : Start Additional Concurrent Measurements |
![]() |
27.2 | 335 | |
![]() |
40.2 | 336 | (% style="color:red" %)**aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC |
![]() |
27.2 | 337 | |
338 | |||
![]() |
2.2 | 339 | * AT Command : AT+ADDRC=0,1,0,1 |
340 | |||
341 | * LoRaWAN Downlink(0xAA02): 0xAA 02 30 01 00 01 | ||
342 | |||
343 | Downlink: AA 02 aa bb cc dd | ||
344 | |||
![]() |
40.2 | 345 | (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. |
![]() |
2.2 | 346 | |
![]() |
40.2 | 347 | (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC |
![]() |
2.2 | 348 | |
![]() |
40.2 | 349 | (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement |
![]() |
2.2 | 350 | |
![]() |
41.5 | 351 | (% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%)__ __to get return. |
![]() |
2.2 | 352 | |
353 | |||
354 | The following is the display information on the serial port and the server. | ||
355 | |||
356 | |||
![]() |
47.1 | 357 | [[image:image-20230201091954-12.png||_mstalt="453687"]] |
![]() |
2.2 | 358 | |
359 | |||
![]() |
47.1 | 360 | [[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]] |
![]() |
2.2 | 361 | |
![]() |
27.2 | 362 | |
363 | |||
364 | |||
![]() |
40.2 | 365 | ==== (% style="color:blue" %)**aR0!- aR9!, aRC0!- aRC9!**(%%) ==== |
![]() |
27.2 | 366 | |
![]() |
37.10 | 367 | |
![]() |
2.2 | 368 | Start Continuous Measurement |
369 | |||
370 | Start Continuous Measurement – Request CRC | ||
371 | |||
372 | |||
373 | * AT Command : AT+ADDRR=0,1,0,1 | ||
374 | * LoRaWAN Downlink (0xAA 03): 0xAA 03 30 01 00 01 | ||
375 | |||
376 | Downlink: AA 03 aa bb cc dd | ||
377 | |||
![]() |
40.2 | 378 | (% style="color:#037691" %)**aa**(%%): SDI-12 sensor address. |
![]() |
2.2 | 379 | |
![]() |
40.2 | 380 | (% style="color:#037691" %)**bb**(%%): 0: no CRC, 1: request CRC |
![]() |
2.2 | 381 | |
![]() |
40.2 | 382 | (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement |
![]() |
2.2 | 383 | |
![]() |
41.5 | 384 | (% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return. |
![]() |
2.2 | 385 | |
386 | |||
387 | The following is the display information on the serial port and the server. | ||
388 | |||
389 | |||
![]() |
47.1 | 390 | [[image:image-20230201092208-14.png||_mstalt="452283"]] |
![]() |
2.2 | 391 | |
![]() |
27.2 | 392 | |
![]() |
47.1 | 393 | [[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]] |
![]() |
27.2 | 394 | |
395 | |||
![]() |
37.2 | 396 | === 2.3.2 Advance SDI-12 Debug command === |
![]() |
27.2 | 397 | |
398 | |||
![]() |
2.2 | 399 | This command can be used to debug all SDI-12 command. |
400 | |||
401 | |||
402 | LoRaWAN Downlink: A8 aa xx xx xx xx bb cc | ||
403 | |||
![]() |
40.2 | 404 | (% style="color:#037691" %)**aa **(%%): total SDI-12 command length |
![]() |
2.2 | 405 | |
![]() |
40.2 | 406 | (% style="color:#037691" %)**xx **(%%): SDI-12 command |
![]() |
2.2 | 407 | |
![]() |
40.2 | 408 | (% style="color:#037691" %)**bb **(%%): Delay to wait for return |
![]() |
2.2 | 409 | |
![]() |
40.2 | 410 | (% style="color:#037691" %)**cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100 |
![]() |
2.2 | 411 | |
412 | |||
![]() |
40.2 | 413 | (% style="color:blue" %)**Example: **(%%) AT+CFGDEV =0RC0!,1 |
![]() |
2.2 | 414 | |
![]() |
40.2 | 415 | (% style="color:#037691" %)**0RC0! **(%%): SDI-12 Command, |
![]() |
2.2 | 416 | |
![]() |
40.2 | 417 | (% style="color:#037691" %)**1 **(%%): Delay 1 second. ( 0: 810 mini-second) |
![]() |
2.2 | 418 | |
419 | Equal Downlink: 0xA8 05 30 52 43 30 21 01 01 | ||
420 | |||
421 | |||
422 | The following is the display information on the serial port and the server. | ||
423 | |||
424 | |||
![]() |
47.1 | 425 | [[image:image-20230201092355-16.png||_mstalt="453960"]] |
![]() |
2.2 | 426 | |
427 | |||
![]() |
47.1 | 428 | [[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]] |
![]() |
27.2 | 429 | |
![]() |
29.2 | 430 | |
431 | === 2.3.3 Convert ASCII to String === | ||
432 | |||
433 | |||
![]() |
2.2 | 434 | This command is used to convert between ASCII and String format. |
435 | |||
436 | AT+CONVFORM ( Max length: 80 bytes) | ||
437 | |||
438 | |||
![]() |
40.2 | 439 | (% style="color:blue" %)**Example:** |
![]() |
2.2 | 440 | |
![]() |
29.2 | 441 | 1) AT+CONVFORM=0, string Convert String from String to ASCII |
![]() |
2.2 | 442 | |
![]() |
47.1 | 443 | [[image:1675214845056-885.png||_mstalt="297622"]] |
![]() |
2.2 | 444 | |
445 | |||
![]() |
29.2 | 446 | 2) AT+CONVFORM=1, ASCII Convert ASCII to String. |
![]() |
2.2 | 447 | |
![]() |
47.1 | 448 | [[image:1675214856590-846.png||_mstalt="297739"]] |
![]() |
2.2 | 449 | |
![]() |
29.2 | 450 | |
451 | === 2.3.4 Define periodically SDI-12 commands and uplink. === | ||
452 | |||
453 | |||
![]() |
2.2 | 454 | AT+COMMANDx & AT+DATACUTx |
455 | |||
456 | 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. | ||
457 | |||
458 | |||
![]() |
40.2 | 459 | * (% style="color:blue" %)**AT Command:** |
![]() |
2.2 | 460 | |
![]() |
40.2 | 461 | (% style="color:#037691" %)**AT+COMMANDx=var1,var2,var3,var4.** |
![]() |
2.2 | 462 | |
![]() |
40.2 | 463 | (% style="color:red" %)**var1**(%%): SDI-12 command , for example: 0RC0! |
![]() |
2.2 | 464 | |
![]() |
40.2 | 465 | (% style="color:red" %)**var2**(%%): Wait timeout for return. (unit: second) |
![]() |
2.2 | 466 | |
![]() |
40.2 | 467 | (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//. |
![]() |
2.2 | 468 | |
![]() |
44.1 | 469 | (% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries. |
![]() |
2.2 | 470 | |
![]() |
40.2 | 471 | (% style="color:red" %)**0 **(%%) No validation check; |
![]() |
2.2 | 472 | |
![]() |
40.2 | 473 | (% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E); |
![]() |
2.2 | 474 | |
![]() |
41.5 | 475 | (% style="color:red" %)**2**(%%) Check if there is return from SDI-12 sensor |
![]() |
2.2 | 476 | |
![]() |
40.2 | 477 | (% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request); |
![]() |
2.2 | 478 | |
479 | |||
![]() |
40.2 | 480 | 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. |
![]() |
2.2 | 481 | |
482 | |||
![]() |
40.2 | 483 | (% style="color:blue" %)**AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes. |
![]() |
2.2 | 484 | |
![]() |
48.4 | 485 | (% border="1" style="width:436px" %) |
![]() |
48.16 | 486 | |(% style="background-color:#f2f2f2; width:433px" %)((( |
487 | (% style="color:#0070c0" %)**AT+DATACUTx=a,b,c** | ||
![]() |
2.2 | 488 | |
![]() |
29.2 | 489 | **a**: length for the return of AT+COMMAND |
![]() |
2.2 | 490 | |
![]() |
37.11 | 491 | **b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections. |
![]() |
2.2 | 492 | |
![]() |
29.2 | 493 | **c**: define the position for valid value. |
![]() |
2.2 | 494 | ))) |
495 | |||
![]() |
43.1 | 496 | For example, if return from AT+COMMAND1 is “013METER TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload: |
![]() |
2.2 | 497 | |
498 | |||
![]() |
48.21 | 499 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) |
![]() |
48.4 | 500 | |=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)**AT+DATACUT1 value**|=(% style="width: 344px;background-color:#D9E2F3;color:#0070C0" %)**Final Result to combine Payload** |
![]() |
48.16 | 501 | |(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 |
502 | |(% 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 | ||
503 | |(% 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 | ||
![]() |
2.2 | 504 | |
![]() |
40.2 | 505 | * (% style="color:blue" %)** Downlink Payload:** |
![]() |
2.2 | 506 | |
![]() |
40.2 | 507 | (% style="color:blue" %)**0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx. |
![]() |
2.2 | 508 | |
509 | |||
![]() |
40.2 | 510 | (% style="color:red" %)**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.** |
![]() |
2.2 | 511 | |
512 | |||
![]() |
40.2 | 513 | Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY(%%)** |
![]() |
2.2 | 514 | |
515 | Where: | ||
516 | |||
![]() |
40.2 | 517 | * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, |
![]() |
43.1 | 518 | * (% style="color:#037691" %)**NN **(%%): 1: set the AT+COMMAND value ; 2: set the AT+DATACUT value. |
![]() |
40.2 | 519 | * (% style="color:#037691" %)**LL **(%%): The length of AT+COMMAND or AT+DATACUT command |
520 | * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command | ||
![]() |
43.1 | 521 | * (% style="color:#037691" %)**YY **(%%): If YY=0, SDI-12-LB will execute the downlink command without uplink; if YY=1, SDI-12-LB will execute an uplink after got this command. |
![]() |
2.2 | 522 | |
![]() |
40.2 | 523 | (% style="color:blue" %)**Example:** |
![]() |
2.2 | 524 | |
![]() |
47.1 | 525 | [[image:image-20230201094129-18.png||_mstalt="455065"]] |
![]() |
2.2 | 526 | |
527 | |||
![]() |
41.16 | 528 | |
![]() |
40.2 | 529 | (% style="color:blue" %)**Clear SDI12 Command** |
![]() |
2.2 | 530 | |
531 | The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. | ||
532 | |||
533 | |||
![]() |
40.2 | 534 | * (% style="color:#037691" %)**AT Command:** |
![]() |
2.2 | 535 | |
![]() |
40.2 | 536 | (% style="color:#4f81bd" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase |
![]() |
2.2 | 537 | |
538 | |||
539 | Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 | ||
540 | |||
541 | |||
![]() |
40.2 | 542 | * (% style="color:#037691" %)** Downlink Payload:** |
![]() |
2.2 | 543 | |
![]() |
40.2 | 544 | (% style="color:#4f81bd" %)**0x09 aa bb**(%%) same as AT+CMDEAR=aa,bb |
![]() |
2.2 | 545 | |
546 | |||
547 | |||
![]() |
40.2 | 548 | (% style="color:blue" %)**command combination** |
![]() |
2.2 | 549 | |
550 | Below shows a screen shot how the results combines together to a uplink payload. | ||
551 | |||
![]() |
47.1 | 552 | [[image:1675215745275-920.png||_mstalt="295334"]] |
![]() |
2.2 | 553 | |
554 | |||
![]() |
35.2 | 555 | 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. |
![]() |
2.2 | 556 | |
![]() |
40.2 | 557 | (% 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. |
![]() |
2.2 | 558 | |
559 | |||
![]() |
41.7 | 560 | (% 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. |
![]() |
2.2 | 561 | |
562 | |||
![]() |
47.1 | 563 | [[image:1675215782925-448.png||_mstalt="297466"]] |
![]() |
2.2 | 564 | |
565 | |||
![]() |
40.2 | 566 | 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. |
![]() |
2.2 | 567 | |
568 | |||
569 | |||
![]() |
41.17 | 570 | (% style="color:blue" %)**Compose Uplink** |
![]() |
2.2 | 571 | |
![]() |
40.2 | 572 | (% style="color:#4f81bd" %)**AT+DATAUP=0** |
![]() |
2.2 | 573 | |
![]() |
41.8 | 574 | Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**. |
![]() |
2.2 | 575 | |
![]() |
41.8 | 576 | Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__** |
![]() |
2.2 | 577 | |
578 | Where PAYVER is defined by AT+PAYVER, below is an example screen shot. | ||
579 | |||
580 | |||
![]() |
47.1 | 581 | [[image:1675215828102-844.png||_mstalt="294645"]] |
![]() |
2.2 | 582 | |
583 | |||
![]() |
40.2 | 584 | (% style="color:#4f81bd" %)**AT+DATAUP=1** |
![]() |
2.2 | 585 | |
![]() |
41.8 | 586 | Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**. |
![]() |
2.2 | 587 | |
![]() |
41.8 | 588 | Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__ |
![]() |
2.2 | 589 | |
590 | 1. Battery Info (2 bytes): Battery voltage | ||
591 | 1. PAYVER (1 byte): Defined by AT+PAYVER | ||
592 | 1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling. | ||
593 | 1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT) | ||
594 | 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 | ||
595 | |||
![]() |
47.1 | 596 | [[image:1675215848113-696.png||_mstalt="296998"]] |
![]() |
2.2 | 597 | |
598 | |||
![]() |
40.2 | 599 | (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:** |
![]() |
2.2 | 600 | |
![]() |
35.2 | 601 | * For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date) |
602 | * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). | ||
603 | * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date). | ||
604 | * For all other bands: max 51 bytes for each uplink ( so 51 -5 = 46 max valid date). | ||
![]() |
2.2 | 605 | |
![]() |
40.2 | 606 | (% style="color:red" %)**When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;** |
![]() |
2.2 | 607 | |
![]() |
40.2 | 608 | (% style="color:red" %)**When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.** |
![]() |
2.2 | 609 | |
610 | |||
![]() |
40.7 | 611 | == 2.4 Uplink Payload == |
![]() |
2.2 | 612 | |
![]() |
37.2 | 613 | === 2.4.1 Device Payload, FPORT~=5 === |
![]() |
2.2 | 614 | |
![]() |
37.2 | 615 | |
![]() |
2.2 | 616 | Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server. |
617 | |||
618 | Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink. | ||
619 | |||
![]() |
48.21 | 620 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) |
![]() |
48.5 | 621 | |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)** |
622 | |(% 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** | ||
623 | |(% 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 | ||
![]() |
2.2 | 624 | |
625 | Example parse in TTNv3 | ||
626 | |||
![]() |
47.1 | 627 | [[image:1675215946738-635.png||_mstalt="297778"]] |
![]() |
2.2 | 628 | |
![]() |
37.2 | 629 | |
![]() |
40.2 | 630 | (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17 |
![]() |
2.2 | 631 | |
![]() |
40.2 | 632 | (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version |
![]() |
2.2 | 633 | |
![]() |
40.2 | 634 | (% style="color:#037691" %)**Frequency Band**: |
![]() |
2.2 | 635 | |
636 | *0x01: EU868 | ||
637 | |||
638 | *0x02: US915 | ||
639 | |||
640 | *0x03: IN865 | ||
641 | |||
642 | *0x04: AU915 | ||
643 | |||
644 | *0x05: KZ865 | ||
645 | |||
646 | *0x06: RU864 | ||
647 | |||
648 | *0x07: AS923 | ||
649 | |||
650 | *0x08: AS923-1 | ||
651 | |||
652 | *0x09: AS923-2 | ||
653 | |||
654 | *0x0a: AS923-3 | ||
655 | |||
656 | *0x0b: CN470 | ||
657 | |||
658 | *0x0c: EU433 | ||
659 | |||
660 | *0x0d: KR920 | ||
661 | |||
662 | *0x0e: MA869 | ||
663 | |||
664 | |||
![]() |
40.2 | 665 | (% style="color:#037691" %)**Sub-Band**: |
![]() |
2.2 | 666 | |
667 | AU915 and US915:value 0x00 ~~ 0x08 | ||
668 | |||
669 | CN470: value 0x0B ~~ 0x0C | ||
670 | |||
671 | Other Bands: Always 0x00 | ||
672 | |||
673 | |||
![]() |
40.2 | 674 | (% style="color:#037691" %)**Battery Info**: |
![]() |
2.2 | 675 | |
676 | Check the battery voltage. | ||
677 | |||
678 | Ex1: 0x0B45 = 2885mV | ||
679 | |||
680 | Ex2: 0x0B49 = 2889mV | ||
681 | |||
682 | |||
![]() |
37.2 | 683 | === 2.4.2 Uplink Payload, FPORT~=2 === |
![]() |
2.2 | 684 | |
![]() |
37.2 | 685 | |
![]() |
2.2 | 686 | There are different cases for uplink. See below |
687 | |||
688 | * SDI-12 Debug Command return: FPORT=100 | ||
689 | |||
690 | * Periodically Uplink: FPORT=2 | ||
691 | |||
![]() |
48.16 | 692 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) |
![]() |
48.19 | 693 | |=(% style="width: 90px;background-color:#D9E2F3" %)((( |
![]() |
37.2 | 694 | **Size(bytes)** |
![]() |
48.19 | 695 | )))|=(% style="width: 80px;background-color:#D9E2F3" %)**2**|=(% style="width: 90px;background-color:#D9E2F3" %)**1**|=(% style="width: 240px;background-color:#D9E2F3" %)**Length depends on the return from the commands** |
![]() |
37.2 | 696 | |(% style="width:93px" %)**Value**|(% style="width:83px" %)((( |
![]() |
2.2 | 697 | Battery(mV) |
698 | & | ||
699 | Interrupt_Flag | ||
![]() |
41.18 | 700 | )))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)((( |
![]() |
37.2 | 701 | If the valid payload is too long and exceed the maximum support. |
![]() |
2.2 | 702 | Payload length in server,server will show payload not provided in the LoRaWAN server. |
703 | ))) | ||
704 | |||
![]() |
47.1 | 705 | [[image:1675216282284-923.png||_mstalt="295633"]] |
![]() |
2.2 | 706 | |
707 | |||
![]() |
37.2 | 708 | === 2.4.3 Battery Info === |
![]() |
2.2 | 709 | |
710 | |||
711 | Check the battery voltage for SDI-12-LB. | ||
712 | |||
713 | Ex1: 0x0B45 = 2885mV | ||
714 | |||
715 | Ex2: 0x0B49 = 2889mV | ||
716 | |||
717 | |||
![]() |
37.2 | 718 | === 2.4.4 Interrupt Pin === |
![]() |
2.2 | 719 | |
![]() |
37.2 | 720 | |
![]() |
40.2 | 721 | 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"]]. |
![]() |
2.2 | 722 | |
![]() |
37.2 | 723 | **Example:** |
![]() |
2.2 | 724 | |
725 | Ex1: 0x0B45:0x0B&0x80= 0x00 Normal uplink packet. | ||
726 | |||
727 | Ex2: 0x8B49:0x8B&0x80= 0x80 Interrupt Uplink Packet. | ||
728 | |||
729 | |||
![]() |
37.2 | 730 | === 2.4.5 Payload version === |
![]() |
2.2 | 731 | |
![]() |
49.3 | 732 | |
![]() |
43.1 | 733 | The version number of the payload, mainly used for decoding. The default is 01. |
![]() |
2.2 | 734 | |
735 | |||
![]() |
37.2 | 736 | === 2.4.6 Decode payload in The Things Network === |
![]() |
2.2 | 737 | |
738 | |||
739 | While using TTN network, you can add the payload format to decode the payload. | ||
740 | |||
![]() |
47.1 | 741 | [[image:1675216779406-595.png||_mstalt="298376"]] |
![]() |
2.2 | 742 | |
743 | |||
744 | 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. | ||
745 | |||
![]() |
37.2 | 746 | SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]] |
![]() |
2.2 | 747 | |
748 | |||
![]() |
37.3 | 749 | == 2.5 Uplink Interval == |
![]() |
2.2 | 750 | |
751 | |||
752 | 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: | ||
753 | |||
![]() |
44.2 | 754 | [[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]] |
![]() |
2.2 | 755 | |
756 | |||
![]() |
56.1 | 757 | == 2.6 Examples To Set SDI commands == |
![]() |
2.2 | 758 | |
![]() |
56.1 | 759 | === 2.6.1 Examples 1 ~-~- General Example === |
![]() |
2.2 | 760 | |
![]() |
44.2 | 761 | |
![]() |
43.1 | 762 | COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication. |
763 | |||
![]() |
47.1 | 764 | [[image:image-20230222143809-1.png||_mstalt="429962" height="564" width="729"]] |
![]() |
43.1 | 765 | |
766 | |||
![]() |
44.2 | 767 | (% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:** |
![]() |
43.1 | 768 | |
![]() |
44.2 | 769 | a. Send the first command and get the first reply: |
![]() |
43.1 | 770 | |
![]() |
44.2 | 771 | (% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1** |
![]() |
43.1 | 772 | |
![]() |
44.2 | 773 | b. Send the second command and get the second reply: |
![]() |
43.1 | 774 | |
![]() |
44.2 | 775 | (% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1** |
![]() |
43.1 | 776 | |
![]() |
44.2 | 777 | c. Send the third command and get the third reply: |
![]() |
43.1 | 778 | |
![]() |
44.2 | 779 | (% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1** |
![]() |
43.1 | 780 | |
![]() |
44.2 | 781 | d. Send the fourth command and get the fourth reply: |
![]() |
43.1 | 782 | |
![]() |
44.2 | 783 | (% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1** |
![]() |
43.1 | 784 | |
![]() |
44.2 | 785 | e. Send the fifth command plus the sixth command, get the sixth reply: |
![]() |
43.1 | 786 | |
![]() |
44.2 | 787 | (% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1** |
![]() |
43.1 | 788 | |
![]() |
44.2 | 789 | f. Send the seventh command plus the eighth command, get the eighth reply: |
![]() |
43.1 | 790 | |
![]() |
44.2 | 791 | (% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1** |
![]() |
43.1 | 792 | |
![]() |
44.2 | 793 | g. Send the ninth command plus the tenth command, get the tenth reply: |
![]() |
43.1 | 794 | |
![]() |
44.2 | 795 | (% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1** |
![]() |
43.1 | 796 | |
![]() |
44.2 | 797 | h. Send the eleventh command plus the twelfth command, get the twelfth reply: |
![]() |
43.1 | 798 | |
![]() |
44.2 | 799 | (% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1** |
![]() |
43.1 | 800 | |
801 | |||
![]() |
44.2 | 802 | (% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor:** |
![]() |
43.1 | 803 | |
![]() |
44.2 | 804 | a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>” |
![]() |
43.1 | 805 | |
![]() |
47.1 | 806 | Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %); |
![]() |
44.2 | 807 | |
![]() |
43.1 | 808 | b. The sixth reply, all 31 characters:”1+19210+1.04+0.00+22.49+11.75<CR><LF>” |
809 | |||
![]() |
47.1 | 810 | Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %); |
![]() |
43.1 | 811 | |
812 | c. The eighth reply, all 31 characters:”2+18990+1.08+0.00+22.24+11.80<CR><LF>” | ||
813 | |||
![]() |
47.1 | 814 | Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %); |
![]() |
43.1 | 815 | |
816 | d. The tenth reply, all 15 characters:”3-2919.8+24.0<CR><LF>” | ||
817 | |||
![]() |
47.1 | 818 | Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1 or AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %); |
![]() |
43.1 | 819 | |
820 | e. The twelfth reply, all 25 characters:”4+30.8+22.84+4.7+954.38<CR><LF>” | ||
821 | |||
![]() |
44.2 | 822 | Partial cut, the cut sensor address and the first two parameters:(% style="color:#037691" %)**AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”**. |
![]() |
43.1 | 823 | |
824 | |||
![]() |
56.1 | 825 | === 2.6.2 Example ~-~- Connect to Hygrovue10 === |
826 | |||
827 | ==== 2.6.2.1 Reference Manual and Command ==== | ||
828 | |||
829 | * [[Hygrovue10 Product Page>>https://www.campbellsci.com/hygrovue10]] | ||
830 | * Commands to be used in PC and output. | ||
831 | |||
832 | 1.check device address | ||
833 | |||
834 | 2.change device address | ||
835 | |||
836 | 3.check device ID | ||
837 | |||
838 | 4.start measure | ||
839 | |||
840 | 5.Get Meausre result | ||
841 | |||
842 | [[image:image-20230603120209-2.png||height="281" width="267"]] | ||
843 | |||
844 | |||
845 | ==== 2.6.2.2 Hardware Connection to SDI-12-LB ==== | ||
846 | |||
847 | [[image:image-20230603120515-3.png]] | ||
848 | |||
849 | |||
850 | ==== 2.6.2.3 Commands set in SDI-12-LB and uplink payload ==== | ||
851 | |||
852 | [[image:image-20230603120648-4.png]] | ||
853 | |||
854 | [[image:image-20230603120726-5.png]] | ||
855 | |||
856 | Data in TTN: | ||
857 | |||
858 | [[image:image-20230603120859-6.png||height="118" width="1285"]] | ||
859 | |||
860 | |||
861 | |||
862 | |||
![]() |
43.1 | 863 | == 2.7 Frequency Plans == |
864 | |||
865 | |||
![]() |
37.3 | 866 | 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. |
![]() |
2.2 | 867 | |
![]() |
37.3 | 868 | [[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/]] |
![]() |
2.2 | 869 | |
870 | |||
![]() |
43.1 | 871 | == 2.8 Firmware Change Log == |
![]() |
37.3 | 872 | |
873 | |||
![]() |
2.2 | 874 | **Firmware download link:** |
875 | |||
![]() |
41.9 | 876 | [[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]] |
![]() |
2.2 | 877 | |
878 | |||
![]() |
37.3 | 879 | = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink = |
![]() |
2.2 | 880 | |
881 | |||
882 | Use can configure SDI-12-LB via AT Command or LoRaWAN Downlink. | ||
883 | |||
![]() |
40.8 | 884 | * AT Command Connection: See [[FAQ>>||anchor="H7.FAQ"]]. |
![]() |
37.3 | 885 | * LoRaWAN Downlink instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. |
![]() |
2.2 | 886 | |
887 | There are two kinds of commands to configure SDI-12-LB, they are: | ||
888 | |||
![]() |
40.7 | 889 | * (% style="color:blue" %)**General Commands**. |
![]() |
2.2 | 890 | |
891 | These commands are to configure: | ||
892 | |||
893 | * General system settings like: uplink interval. | ||
894 | * LoRaWAN protocol & radio related command. | ||
895 | |||
896 | They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: | ||
897 | |||
![]() |
40.2 | 898 | [[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/]] |
![]() |
2.2 | 899 | |
900 | |||
![]() |
40.7 | 901 | * (% style="color:blue" %)**Commands special design for SDI-12-LB** |
![]() |
2.2 | 902 | |
903 | These commands only valid for SDI-12-LB, as below: | ||
904 | |||
905 | |||
![]() |
43.1 | 906 | == 3.1 Set Transmit Interval Time == |
![]() |
2.2 | 907 | |
908 | |||
909 | Feature: Change LoRaWAN End Node Transmit Interval. | ||
910 | |||
![]() |
37.3 | 911 | (% style="color:blue" %)**AT Command: AT+TDC** |
![]() |
2.2 | 912 | |
![]() |
48.21 | 913 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) |
![]() |
48.7 | 914 | |=(% 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** |
915 | |(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval|(% style="background-color:#f2f2f2" %)((( | ||
![]() |
2.2 | 916 | 30000 |
917 | OK | ||
918 | the interval is 30000ms = 30s | ||
919 | ))) | ||
![]() |
48.7 | 920 | |(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=60000|(% style="background-color:#f2f2f2; width:166px" %)Set Transmit Interval|(% style="background-color:#f2f2f2" %)((( |
![]() |
2.2 | 921 | OK |
922 | Set transmit interval to 60000ms = 60 seconds | ||
923 | ))) | ||
924 | |||
![]() |
37.3 | 925 | (% style="color:blue" %)**Downlink Command: 0x01** |
![]() |
2.2 | 926 | |
![]() |
37.3 | 927 | |
![]() |
2.2 | 928 | Format: Command Code (0x01) followed by 3 bytes time value. |
929 | |||
![]() |
37.6 | 930 | If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. |
![]() |
2.2 | 931 | |
![]() |
37.6 | 932 | * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds |
933 | * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds | ||
![]() |
2.2 | 934 | |
![]() |
48.17 | 935 | |
![]() |
37.3 | 936 | == 3.2 Set Interrupt Mode == |
![]() |
2.2 | 937 | |
![]() |
37.6 | 938 | |
![]() |
2.2 | 939 | Feature, Set Interrupt mode for GPIO_EXIT. |
940 | |||
![]() |
37.3 | 941 | (% style="color:blue" %)**AT Command: AT+INTMOD** |
![]() |
2.2 | 942 | |
![]() |
48.21 | 943 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) |
![]() |
48.8 | 944 | |=(% 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** |
945 | |(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=?|(% style="background-color:#f2f2f2; width:196px" %)Show current interrupt mode|(% style="background-color:#f2f2f2; width:157px" %)((( | ||
![]() |
2.2 | 946 | 0 |
947 | OK | ||
![]() |
48.8 | 948 | the mode is 0 =Disable Interrupt |
![]() |
2.2 | 949 | ))) |
![]() |
48.8 | 950 | |(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=2|(% style="background-color:#f2f2f2; width:196px" %)((( |
![]() |
2.2 | 951 | Set Transmit Interval |
![]() |
43.1 | 952 | 0. (Disable Interrupt), |
953 | ~1. (Trigger by rising and falling edge) | ||
954 | 2. (Trigger by falling edge) | ||
955 | 3. (Trigger by rising edge) | ||
![]() |
48.8 | 956 | )))|(% style="background-color:#f2f2f2; width:157px" %)OK |
![]() |
2.2 | 957 | |
![]() |
37.3 | 958 | (% style="color:blue" %)**Downlink Command: 0x06** |
![]() |
2.2 | 959 | |
960 | Format: Command Code (0x06) followed by 3 bytes. | ||
961 | |||
962 | This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. | ||
963 | |||
![]() |
37.6 | 964 | * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode |
965 | * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger | ||
![]() |
2.2 | 966 | |
![]() |
48.17 | 967 | |
![]() |
37.3 | 968 | == 3.3 Set the output time == |
969 | |||
970 | |||
![]() |
2.2 | 971 | Feature, Control the output 3V3 , 5V or 12V. |
972 | |||
![]() |
37.3 | 973 | (% style="color:blue" %)**AT Command: AT+3V3T** |
![]() |
2.2 | 974 | |
![]() |
48.21 | 975 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:474px" %) |
![]() |
48.9 | 976 | |=(% 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** |
977 | |(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=?|(% style="background-color:#f2f2f2; width:201px" %)Show 3V3 open time.|(% style="background-color:#f2f2f2; width:116px" %)((( | ||
![]() |
2.2 | 978 | 0 |
979 | OK | ||
980 | ))) | ||
![]() |
48.9 | 981 | |(% 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" %)((( |
![]() |
2.2 | 982 | OK |
983 | default setting | ||
984 | ))) | ||
![]() |
48.9 | 985 | |(% 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" %)((( |
![]() |
2.2 | 986 | OK |
987 | ))) | ||
![]() |
48.9 | 988 | |(% 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" %)((( |
![]() |
2.2 | 989 | OK |
990 | ))) | ||
991 | |||
![]() |
37.3 | 992 | (% style="color:blue" %)**AT Command: AT+5VT** |
![]() |
2.2 | 993 | |
![]() |
48.21 | 994 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %) |
![]() |
48.9 | 995 | |=(% 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** |
996 | |(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=?|(% style="background-color:#f2f2f2; width:196px" %)Show 5V open time.|(% style="background-color:#f2f2f2; width:114px" %)((( | ||
![]() |
2.2 | 997 | 0 |
998 | OK | ||
999 | ))) | ||
![]() |
48.9 | 1000 | |(% 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" %)((( |
![]() |
2.2 | 1001 | OK |
1002 | default setting | ||
1003 | ))) | ||
![]() |
48.9 | 1004 | |(% 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" %)((( |
![]() |
2.2 | 1005 | OK |
1006 | ))) | ||
![]() |
48.9 | 1007 | |(% 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" %)((( |
![]() |
2.2 | 1008 | OK |
1009 | ))) | ||
1010 | |||
![]() |
37.3 | 1011 | (% style="color:blue" %)**AT Command: AT+12VT** |
![]() |
2.2 | 1012 | |
![]() |
48.21 | 1013 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:443px" %) |
![]() |
48.9 | 1014 | |=(% 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** |
1015 | |(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=?|(% style="background-color:#f2f2f2; width:199px" %)Show 12V open time.|(% style="background-color:#f2f2f2; width:83px" %)((( | ||
![]() |
2.2 | 1016 | 0 |
1017 | OK | ||
1018 | ))) | ||
![]() |
48.9 | 1019 | |(% 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" %)OK |
1020 | |(% 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" %)((( | ||
![]() |
2.2 | 1021 | OK |
1022 | ))) | ||
1023 | |||
![]() |
37.3 | 1024 | (% style="color:blue" %)**Downlink Command: 0x07** |
![]() |
2.2 | 1025 | |
1026 | Format: Command Code (0x07) followed by 3 bytes. | ||
1027 | |||
1028 | The first byte is which power, the second and third bytes are the time to turn on. | ||
1029 | |||
![]() |
37.3 | 1030 | * Example 1: Downlink Payload: 070101F4 **~-~-->** AT+3V3T=500 |
1031 | * Example 2: Downlink Payload: 0701FFFF **~-~-->** AT+3V3T=65535 | ||
1032 | * Example 3: Downlink Payload: 070203E8 **~-~-->** AT+5VT=1000 | ||
1033 | * Example 4: Downlink Payload: 07020000 **~-~-->** AT+5VT=0 | ||
1034 | * Example 5: Downlink Payload: 070301F4 **~-~-->** AT+12VT=500 | ||
1035 | * Example 6: Downlink Payload: 07030000 **~-~-->** AT+12VT=0 | ||
![]() |
2.2 | 1036 | |
![]() |
48.17 | 1037 | |
![]() |
37.3 | 1038 | == 3.4 Set the all data mode == |
1039 | |||
![]() |
37.5 | 1040 | |
![]() |
2.2 | 1041 | Feature, Set the all data mode. |
1042 | |||
![]() |
37.5 | 1043 | (% style="color:blue" %)**AT Command: AT+ALLDATAMOD** |
![]() |
2.2 | 1044 | |
![]() |
48.21 | 1045 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %) |
![]() |
48.11 | 1046 | |=(% style="background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response** |
![]() |
48.16 | 1047 | |(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=?|(% style="background-color:#f2f2f2" %)Show current all data mode|(% style="background-color:#f2f2f2" %)((( |
![]() |
2.2 | 1048 | 0 |
1049 | OK | ||
1050 | ))) | ||
![]() |
48.16 | 1051 | |(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=1|(% style="background-color:#f2f2f2" %)Set all data mode is 1.|(% style="background-color:#f2f2f2" %)OK |
![]() |
2.2 | 1052 | |
![]() |
37.5 | 1053 | (% style="color:blue" %)**Downlink Command: 0xAB** |
![]() |
2.2 | 1054 | |
1055 | Format: Command Code (0xAB) followed by 1 bytes. | ||
1056 | |||
![]() |
37.5 | 1057 | * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0 |
1058 | * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1 | ||
![]() |
2.2 | 1059 | |
![]() |
48.17 | 1060 | |
![]() |
37.3 | 1061 | == 3.5 Set the splicing payload for uplink == |
1062 | |||
![]() |
37.5 | 1063 | |
![]() |
2.2 | 1064 | Feature, splicing payload for uplink. |
1065 | |||
![]() |
37.5 | 1066 | (% style="color:blue" %)**AT Command: AT+DATAUP** |
![]() |
2.2 | 1067 | |
![]() |
48.21 | 1068 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) |
![]() |
48.12 | 1069 | |=(% 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** |
![]() |
48.16 | 1070 | |(% 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" %)((( |
![]() |
2.2 | 1071 | 0 |
1072 | OK | ||
1073 | ))) | ||
![]() |
48.16 | 1074 | |(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =0|(% style="background-color:#f2f2f2; width:266px" %)((( |
![]() |
2.2 | 1075 | Set splicing payload for uplink mode is 0. |
![]() |
48.16 | 1076 | )))|(% style="background-color:#f2f2f2" %)((( |
![]() |
2.2 | 1077 | OK |
1078 | ))) | ||
![]() |
48.16 | 1079 | |(% 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 |
1080 | |(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =1,20000|(% style="background-color:#f2f2f2; width:266px" %)((( | ||
![]() |
37.3 | 1081 | Set splicing payload for uplink mode is 1, and the uplink interval of each splice to 20000 milliseconds. |
![]() |
48.16 | 1082 | )))|(% style="background-color:#f2f2f2" %)OK |
![]() |
2.2 | 1083 | |
![]() |
37.5 | 1084 | (% style="color:blue" %)**Downlink Command: 0xAD** |
![]() |
2.2 | 1085 | |
1086 | Format: Command Code (0xAD) followed by 1 bytes or 5 bytes. | ||
1087 | |||
![]() |
37.6 | 1088 | * Example 1: Downlink Payload: AD 00 ~/~/ AT+DATAUP=0 |
1089 | * Example 2: Downlink Payload: AD 01 ~/~/ AT+DATAUP =1 | ||
1090 | * Example 3: Downlink Payload: AD 01 00 00 14 ~/~/ AT+DATAUP =1,20000 | ||
![]() |
2.2 | 1091 | |
1092 | This means that the interval is set to 0x000014=20S | ||
1093 | |||
1094 | |||
![]() |
37.3 | 1095 | == 3.6 Set the payload version == |
![]() |
2.2 | 1096 | |
![]() |
41.20 | 1097 | |
![]() |
2.2 | 1098 | Feature, Set the payload version. |
1099 | |||
![]() |
37.5 | 1100 | (% style="color:blue" %)**AT Command: AT+PAYVER** |
![]() |
2.2 | 1101 | |
![]() |
48.21 | 1102 | (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %) |
![]() |
48.13 | 1103 | |=(% 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** |
![]() |
48.16 | 1104 | |(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=?|(% style="background-color:#f2f2f2; width:192px" %)Show current payload version|(% style="background-color:#f2f2f2" %)((( |
![]() |
2.2 | 1105 | 1 |
1106 | OK | ||
1107 | ))) | ||
![]() |
48.16 | 1108 | |(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=5|(% style="background-color:#f2f2f2; width:192px" %)Set payload version is 5.|(% style="background-color:#f2f2f2" %)OK |
![]() |
2.2 | 1109 | |
![]() |
37.5 | 1110 | (% style="color:blue" %)**Downlink Command: 0xAE** |
![]() |
2.2 | 1111 | |
1112 | Format: Command Code (0xAE) followed by 1 bytes. | ||
1113 | |||
![]() |
37.6 | 1114 | * Example 1: Downlink Payload: AE 01 ~/~/ AT+PAYVER=1 |
1115 | * Example 2: Downlink Payload: AE 05 ~/~/ AT+PAYVER=5 | ||
![]() |
2.2 | 1116 | |
![]() |
48.17 | 1117 | |
![]() |
48.14 | 1118 | = 4. Battery & Power Consumption = |
![]() |
2.2 | 1119 | |
![]() |
48.16 | 1120 | |
![]() |
48.15 | 1121 | SDI-12-LB uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. |
![]() |
2.2 | 1122 | |
![]() |
48.16 | 1123 | [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . |
![]() |
37.3 | 1124 | |
1125 | |||
1126 | = 5. Remote Configure device = | ||
![]() |
2.2 | 1127 | |
![]() |
37.3 | 1128 | == 5.1 Connect via BLE == |
![]() |
2.2 | 1129 | |
1130 | |||
![]() |
37.3 | 1131 | 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/]] |
![]() |
2.2 | 1132 | |
1133 | |||
![]() |
37.3 | 1134 | == 5.2 AT Command Set == |
![]() |
2.2 | 1135 | |
1136 | |||
1137 | |||
![]() |
37.3 | 1138 | = 6. OTA firmware update = |
1139 | |||
1140 | |||
![]() |
2.2 | 1141 | Please see this link for how to do OTA firmware update. |
1142 | |||
1143 | [[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/]] | ||
1144 | |||
1145 | |||
![]() |
40.2 | 1146 | = 7. FAQ = |
![]() |
2.2 | 1147 | |
![]() |
48.1 | 1148 | == 7.1 How to use AT Command via UART to access device? == |
![]() |
2.2 | 1149 | |
1150 | |||
![]() |
40.2 | 1151 | 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]] |
1152 | |||
1153 | |||
1154 | == 7.2 How to update firmware via UART port? == | ||
1155 | |||
1156 | |||
1157 | 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]] | ||
1158 | |||
1159 | |||
1160 | == 7.3 How to change the LoRa Frequency Bands/Region? == | ||
1161 | |||
1162 | |||
1163 | You can follow the instructions for [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]. | ||
1164 | When downloading the images, choose the required image file for download. | ||
1165 | |||
1166 | |||
1167 | = 8. Order Info = | ||
1168 | |||
1169 | |||
![]() |
41.20 | 1170 | ((( |
![]() |
40.7 | 1171 | (% style="color:blue" %)**Part Number: SDI-12-LB-XXX** |
![]() |
41.20 | 1172 | ))) |
![]() |
40.7 | 1173 | |
![]() |
41.20 | 1174 | ((( |
![]() |
37.4 | 1175 | XXX: The default frequency band |
![]() |
41.20 | 1176 | ))) |
![]() |
2.2 | 1177 | |
![]() |
41.20 | 1178 | ((( |
![]() |
40.7 | 1179 | (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band |
1180 | (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band | ||
1181 | (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band | ||
1182 | (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band | ||
1183 | (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band | ||
1184 | (% style="color:red" %)**US915**(%%): LoRaWAN US915 band | ||
1185 | (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band | ||
1186 | (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band | ||
![]() |
41.20 | 1187 | ))) |
![]() |
2.2 | 1188 | |
1189 | |||
![]() |
40.2 | 1190 | = 9. Packing Info = |
![]() |
37.3 | 1191 | |
1192 | |||
![]() |
40.7 | 1193 | (% style="color:#037691" %)**Package Includes**: |
![]() |
2.2 | 1194 | |
![]() |
37.3 | 1195 | * SDI-12-LB SDI-12 to LoRaWAN Converter x 1 |
![]() |
2.2 | 1196 | |
![]() |
40.7 | 1197 | (% style="color:#037691" %)**Dimension and weight**: |
![]() |
2.2 | 1198 | |
1199 | * Device Size: cm | ||
1200 | * Device Weight: g | ||
1201 | * Package Size / pcs : cm | ||
1202 | * Weight / pcs : g | ||
1203 | |||
![]() |
48.17 | 1204 | |
![]() |
40.2 | 1205 | = 10. Support = |
![]() |
37.3 | 1206 | |
1207 | |||
![]() |
2.2 | 1208 | * 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. |
1209 | |||
![]() |
37.3 | 1210 | * 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]] |