Last modified by Mengting Qiu on 2025/05/14 20:00
<
From version < 40.8 >
edited by Xiaoling
on 2023/02/01 15:00
To version < 41.21 >
edited by Xiaoling
on 2023/02/01 17:44
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -22,24 +22,34 @@
22 22  == 1.1 ​What is SDI-12 to LoRaWAN Converter ==
23 23  
24 24  
25 +(((
25 25  The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
27 +)))
26 26  
29 +(((
27 27  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 +)))
28 28  
33 +(((
29 29  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 +)))
30 30  
37 +(((
31 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.
39 +)))
32 32  
41 +(((
33 33  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 +)))
34 34  
45 +(((
35 35  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 +)))
36 36  
37 37  
38 38  [[image:image-20230201084414-1.png||height="464" width="1108"]]
39 39  
40 40  
41 -
42 -
43 43  == ​1.2 Features ==
44 44  
45 45  
... ... @@ -55,6 +55,8 @@
55 55  * Downlink to change configure
56 56  * 8500mAh Battery for long term use
57 57  
68 +
69 +
58 58  == 1.3 Specification ==
59 59  
60 60  
... ... @@ -101,6 +101,8 @@
101 101  * Sleep Mode: 5uA @ 3.3v
102 102  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
103 103  
116 +
117 +
104 104  == 1.4 Connect to SDI-12 Sensor ==
105 105  
106 106  
... ... @@ -122,20 +122,21 @@
122 122  [[image:1675212633011-651.png]]
123 123  
124 124  
125 -
126 126  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
127 -|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
128 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
140 +|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
141 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)(((
129 129  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
130 130  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
131 131  )))
132 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
145 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)(((
133 133  (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
134 134  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
135 135  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.
136 136  )))
137 -|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
150 +|(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:109px" %)Deactivate Device|(% style="width:231px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB is in Deep Sleep Mode.
138 138  
152 +
153 +
139 139  == 1.7 Pin Mapping ==
140 140  
141 141  
... ... @@ -191,12 +191,9 @@
191 191  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
192 192  
193 193  
194 -[[image:image-20230131134744-2.jpeg]]
209 +[[image:image-20230201152430-20.jpeg]]
195 195  
196 196  
197 -
198 -
199 -
200 200  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
201 201  
202 202  
... ... @@ -227,7 +227,6 @@
227 227  
228 228  Press the button for 5 seconds to activate the SDI-12-LB.
229 229  
230 -
231 231  (% 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.
232 232  
233 233  
... ... @@ -250,7 +250,6 @@
250 250  The following is the display information on the serial port and the server.
251 251  
252 252  
253 -
254 254  [[image:image-20230201091027-6.png]]
255 255  
256 256  
... ... @@ -257,6 +257,7 @@
257 257  [[image:image-20230201091027-7.png||height="261" width="1179"]]
258 258  
259 259  
270 +
260 260  ==== (% style="color:blue" %)**al!  ~-~- Get SDI-12 sensor Identification**(%%) ====
261 261  
262 262  
... ... @@ -265,7 +265,7 @@
265 265  
266 266  (% style="color:#037691" %)**Parameter:  **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
267 267  
268 -(% style="color:blue" %)**Example :   **AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
279 +(% style="color:blue" %)**Example :   **(%%)AT+ADDRI=0 ( Equal to downlink: 0x AA 00 30)
269 269  
270 270  
271 271  The following is the display information on the serial port and the server.
... ... @@ -301,7 +301,7 @@
301 301  
302 302  (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
303 303  
304 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
315 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return.
305 305  
306 306  
307 307  The following is the display information on the serial port and the server.
... ... @@ -338,7 +338,7 @@
338 338  
339 339  (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
340 340  
341 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
352 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%)__ __to get return.
342 342  
343 343  
344 344  The following is the display information on the serial port and the server.
... ... @@ -371,13 +371,12 @@
371 371  
372 372  (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
373 373  
374 -(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
385 +(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return.
375 375  
376 376  
377 377  The following is the display information on the serial port and the server.
378 378  
379 379  
380 -
381 381  [[image:image-20230201092208-14.png]]
382 382  
383 383  
... ... @@ -463,7 +463,7 @@
463 463  
464 464  (% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
465 465  
466 -(% style="color:#red" %)**2**(%%)  Check if there is return from SDI-12 sensor
476 +(% style="color:red" %)**2**(%%)  Check if there is return from SDI-12 sensor
467 467  
468 468  (% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
469 469  
... ... @@ -488,10 +488,10 @@
488 488  
489 489  
490 490  (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
491 -|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
492 -|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
493 -|(% style="width:170px" %)34,2,1~~8+12~~16|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
494 -|(% style="width:170px" %)34,2,1~~34|(% style="width:338px" %)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
501 +|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
502 +|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
503 +|(% style="width:164px" %)34,2,1~~8+12~~16|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
504 +|(% style="width:164px" %)34,2,1~~34|(% style="width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 20 20 20 54 45 52 31 32 20 31 31 32 54 31 32 2D 30 30 30 32 34 38 39 35 0D 0A
495 495  
496 496  * (% style="color:blue" %)** Downlink Payload:**
497 497  
... ... @@ -516,6 +516,7 @@
516 516  [[image:image-20230201094129-18.png]]
517 517  
518 518  
529 +
519 519  (% style="color:blue" %)**Clear SDI12 Command**
520 520  
521 521  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
... ... @@ -547,7 +547,7 @@
547 547  (% 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.
548 548  
549 549  
550 -(% 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.
561 +(% style="color:#4f81bd" %)**For example: **(%%) as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
551 551  
552 552  
553 553  [[image:1675215782925-448.png]]
... ... @@ -559,12 +559,11 @@
559 559  
560 560  (% style="color:blue" %)**Compose Uplink**
561 561  
562 -
563 563  (% style="color:#4f81bd" %)**AT+DATAUP=0**
564 564  
565 -Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
575 +Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
566 566  
567 -Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
577 +Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__**
568 568  
569 569  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
570 570  
... ... @@ -574,12 +574,10 @@
574 574  
575 575  (% style="color:#4f81bd" %)**AT+DATAUP=1**
576 576  
577 -Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs.
587 +Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**.
578 578  
579 -Final Payload is
589 +Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
580 580  
581 -__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
582 -
583 583  1. Battery Info (2 bytes): Battery voltage
584 584  1. PAYVER (1 byte): Defined by AT+PAYVER
585 585  1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
... ... @@ -619,10 +619,10 @@
619 619  
620 620  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
621 621  
622 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
630 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
623 623  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
624 -|(% style="width:102px" %)**Size (bytes)**|(% style="width:67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2**
625 -|(% style="width:102px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT
632 +|(% style="width:114px" %)**Size(bytes)**|(% style="width:39px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:59px" %)**1**|(% style="width:37px" %)**2**
633 +|(% style="width:114px" %)**Value**|(% style="width:39px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:59px" %)Sub-band|(% style="width:37px" %)BAT
626 626  
627 627  Example parse in TTNv3
628 628  
... ... @@ -691,15 +691,15 @@
691 691  
692 692  * Periodically Uplink: FPORT=2
693 693  
694 -(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
695 -|(% style="width:93px" %)(((
702 +(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
703 +|=(% style="width: 90px;" %)(((
696 696  **Size(bytes)**
697 -)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
705 +)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
698 698  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
699 699  Battery(mV)
700 700  &
701 701  Interrupt_Flag
702 -)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)(((
710 +)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((
703 703  If the valid payload is too long and exceed the maximum support.
704 704  Payload length in server,server will show payload not provided in the LoRaWAN server.
705 705  )))
... ... @@ -754,8 +754,6 @@
754 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]]]]
755 755  
756 756  
757 -
758 -
759 759  == 2.6 Frequency Plans ==
760 760  
761 761  
... ... @@ -769,7 +769,7 @@
769 769  
770 770  **Firmware download link:**
771 771  
772 -[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
778 +[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
773 773  
774 774  
775 775  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
... ... @@ -994,6 +994,7 @@
994 994  
995 995  == 3.6 Set the payload version ==
996 996  
1003 +
997 997  Feature, Set the payload version.
998 998  
999 999  (% style="color:blue" %)**AT Command: AT+PAYVER**
... ... @@ -1129,10 +1129,15 @@
1129 1129  = 8. ​Order Info =
1130 1130  
1131 1131  
1139 +(((
1132 1132  (% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
1141 +)))
1133 1133  
1143 +(((
1134 1134  XXX: The default frequency band
1145 +)))
1135 1135  
1147 +(((
1136 1136  (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1137 1137  (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1138 1138  (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
... ... @@ -1141,13 +1141,9 @@
1141 1141  (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1142 1142  (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
1143 1143  (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1156 +)))
1144 1144  
1145 1145  
1146 -
1147 -
1148 -
1149 -
1150 -
1151 1151  = 9. Packing Info =
1152 1152  
1153 1153  
image-20230201152430-20.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +16.5 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0