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 41.3 to 41.4 From 43.1 to 44.1

From version 41.4

edited by Xiaoling
on 2023/02/01 15:27

Change comment: There is no comment for this version

To version 43.1

edited by Bei Jinggeng
on 2023/02/22 14:42

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 1 added, 0 removed)
- image-20230222143809-1.png

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Xiaoling
++XWiki.Bei

Content

@@ -22,30 +22,40 @@
  == 1.1 What is SDI-12 to LoRaWAN Converter ==
++(((
  The Dragino (% style="color:blue" %)**SDI-12-LB**(%%) is a (% style="color:blue" %)**SDI-12 to LoRaWAN Converter **(%%)designed for Smart Agriculture solution.
++)))
++(((
  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.
++)))
++(((
  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.
++)))
++(((
  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.
++)))
++(((
  SDI-12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
++)))
++(((
  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.
++)))
  [[image:image-20230201084414-1.png||height="464" width="1108"]]
--
--
  == 1.2 Features ==
  * LoRaWAN 1.0.3 Class A
  * Ultra-low power consumption
--* Controllable 5v and 12v output to power external sensor
++* Controllable 3.3v, 5v and 12v output to power external sensor
  * SDI-12 Protocol to connect to SDI-12 Sensor
  * Monitor Battery Level
  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
@@ -55,6 +55,7 @@
  * Downlink to change configure
  * 8500mAh Battery for long term use
++
  == 1.3 Specification ==
@@ -101,6 +101,7 @@
  * Sleep Mode: 5uA @ 3.3v
  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
++
  == 1.4 Connect to SDI-12 Sensor ==
@@ -122,20 +122,20 @@
  [[image:1675212633011-651.png]]
--
  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
--|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 117px;" %)**Function**|=(% style="width: 225px;" %)**Action**
--|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
++|=(% style="width: 167px;" %)**Behavior on ACT**|=(% style="width: 109px;" %)**Function**|=(% style="width: 231px;" %)**Action**
++|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:109px" %)Send an uplink|(% style="width:231px" %)(((
  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
  )))
--|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
++|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:109px" %)Active Device|(% style="width:231px" %)(((
  (% 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.
  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
  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.
  )))
--|(% 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.
++|(% 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 SDI-12-LB is in Deep Sleep Mode.
++
  == 1.7 Pin Mapping ==
@@ -297,7 +297,7 @@
  (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
--(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
++(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return.
  The following is the display information on the serial port and the server.
@@ -334,7 +334,7 @@
  (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
--(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
++(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%)__ __to get return.
  The following is the display information on the serial port and the server.
@@ -367,13 +367,12 @@
  (% style="color:#037691" %)**cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
--(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)**aD0!**(%%) to get return.
++(% style="color:#037691" %)**dd**(%%): delay (in second) to send (% style="color:#037691" %)__**aD0!**__(%%) to get return.
  The following is the display information on the serial port and the server.
--
  [[image:image-20230201092208-14.png]]
@@ -453,13 +453,13 @@
  (% style="color:red" %)**var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
--(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
++(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 4 retries.
  (% style="color:red" %)**0 **(%%) No validation check;
  (% style="color:red" %)**1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
--(% style="color:#red" %)**2**(%%)  Check if there is return from SDI-12 sensor
++(% style="color:red" %)**2**(%%)  Check if there is return from SDI-12 sensor
  (% style="color:red" %)**3** (%%) Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
@@ -480,14 +480,14 @@
  **c**:  define the position for valid value.
  )))
--For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
++For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
  (% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
--|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
--|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
--|(% 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
--|(% 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
++|=(% style="width: 164px;" %)**AT+DATACUT1 value**|=(% style="width: 344px;" %)**Final Result to combine Payload**
++|(% style="width:164px" %)34,1,1+2+3|(% style="width:344px" %)0D 00 01 30 31 33
++|(% 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
++|(% 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
  * (% style="color:blue" %)** Downlink Payload:**
@@ -502,10 +502,10 @@
  Where:
  * (% style="color:#037691" %)**MM **(%%): the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
--* (% style="color:#037691" %)**NN **(%%):  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
++* (% style="color:#037691" %)**NN **(%%):  1: set the AT+COMMAND value ; 2: set the AT+DATACUT value.
  * (% style="color:#037691" %)**LL **(%%):   The length of AT+COMMAND or AT+DATACUT command
  * (% style="color:#037691" %)**XX XX XX XX **(%%): AT+COMMAND or AT+DATACUT command
--* (% style="color:#037691" %)**YY **(%%):   If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
++* (% 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.
  (% style="color:blue" %)**Example:**
@@ -512,6 +512,7 @@
  [[image:image-20230201094129-18.png]]
++
  (% style="color:blue" %)**Clear SDI12 Command**
  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
@@ -543,7 +543,7 @@
  (% 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.
--(% 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.
++(% 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.
  [[image:1675215782925-448.png]]
@@ -555,12 +555,11 @@
  (% style="color:blue" %)**Compose Uplink**
--
  (% style="color:#4f81bd" %)**AT+DATAUP=0**
--Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
++Compose the uplink payload with value returns in sequence and send with **__A SIGNLE UPLINK__**.
--Final Payload is Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
++Final Payload is **__Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx__**
  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
@@ -570,12 +570,10 @@
  (% style="color:#4f81bd" %)**AT+DATAUP=1**
--Compose the uplink payload with value returns in sequence and send with Multiply UPLINKs.
++Compose the uplink payload with value returns in sequence and send with **__Multiply UPLINKs__**.
--Final Payload is
++Final Payload is __**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
--__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
--
 . Battery Info (2 bytes): Battery voltage
 . PAYVER (1 byte): Defined by AT+PAYVER
 . PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
@@ -599,15 +599,6 @@
  == 2.4 Uplink Payload ==
--
--Uplink payloads have two types:
--
--* Distance Value: Use FPORT=2
--* Other control commands: Use other FPORT fields.
--
--The application server should parse the correct value based on FPORT settings.
--
--
  === 2.4.1 Device Payload, FPORT~=5 ===
@@ -615,10 +615,10 @@
  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
--(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
++(% border="1" cellspacing="4" style="background-color:#f7faff; width:420px" %)
  |(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
--|(% 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**
--|(% 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
++|(% 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**
++|(% 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
  Example parse in TTNv3
@@ -687,15 +687,15 @@
  * Periodically Uplink: FPORT=2
--(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
--|(% style="width:93px" %)(((
++(% border="1" cellspacing="4" style="background-color:#f7faff; width:500px" %)
++|=(% style="width: 90px;" %)(((
  **Size(bytes)**
--)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
++)))|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**1**|=(% style="width: 240px;" %)**Length depends on the return from the commands**
  |(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
  Battery(mV)
  &
  Interrupt_Flag
--)))|(% style="width:70px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:234px" %)(((
++)))|(% style="width:91px" %)[[PAYLOAD_VER>>||anchor="H3.6Setthepayloadversion"]]|(% style="width:212px" %)(((
  If the valid payload is too long and exceed the maximum support.
  Payload length in server,server will show payload not provided in the LoRaWAN server.
  )))
@@ -727,6 +727,7 @@
  === 2.4.5 Payload version ===
++The version number of the payload, mainly used for decoding. The default is 01.
  === 2.4.6 Decode payload in The Things Network ===
@@ -750,22 +750,88 @@
  [[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.6 Examples To Set SDI commands. ==
++=== 2.6.1 Examples 1 ===
--== 2.6 Frequency Plans ==
++COM port and SDI-12 sensor communication converted to SDI-12-LB and SDI-12 sensor communication.
++[[image:image-20230222143809-1.png||height="564" width="729"]]
++1)The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:
++
++a.Send the first command and get the first reply：
++
++AT+COMMANDx=1I!,0,0,1
++
++b.Send the second command and get the second reply：
++
++AT+COMMANDx=2I!,0,0,1
++
++c.Send the third command and get the third reply：
++
++AT+COMMANDx=3I!,0,0,1
++
++d.Send the fourth command and get the fourth reply：
++
++AT+COMMANDx=4I!,0,0,1
++
++e.Send the fifth command plus the sixth command, get the sixth reply：
++
++AT+COMMANDx=1M!,2,1,1
++
++f.Send the seventh command plus the eighth command, get the eighth reply：
++
++AT+COMMANDx=2M!,2,1,1
++
++g.Send the ninth command plus the tenth command, get the tenth reply：
++
++AT+COMMANDx=3M!,1,1,1
++
++h.Send the eleventh command plus the twelfth command, get the twelfth reply：
++
++AT+COMMANDx=4M!,1,1,1
++
++
++2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor：
++
++a.The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
++
++Cut out all characters: AT+ALLDATAMOD=1  or  AT+DATACUTx=34,2,1~~34;
++
++b. The sixth reply, all 31 characters：”1+19210+1.04+0.00+22.49+11.75<CR><LF>”
++
++Cut out all characters: AT+ALLDATAMOD=1  or  AT+DATACUTx=31,2,1~~31;
++
++c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
++
++Cut out all characters: AT+ALLDATAMOD=1  or  AT+DATACUTx=31,2,1~~31;
++
++d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
++
++Cut out all characters: AT+ALLDATAMOD=1  or  AT+DATACUTx=15,2,1~~15;
++
++e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
++
++Partial cut, the cut sensor address and the first two parameters：AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”.
++
++(% class="wikigeneratedid" %)
++==   ==
++
++== 2.7 Frequency Plans ==
++
++
  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.
  [[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.7 Firmware Change Log ==
++== 2.8 Firmware Change Log ==
  **Firmware download link:**
--[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
++[[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
  = 3. Configure SDI-12-LB via AT Command or LoRaWAN Downlink =
@@ -795,7 +795,7 @@
  These commands only valid for SDI-12-LB, as below:
--== 3.1 Set Transmit Interval Time ==
++== 3.1 Set Transmit Interval Time ==
  Feature: Change LoRaWAN End Node Transmit Interval.
@@ -824,6 +824,7 @@
  * Example 1: Downlink Payload: 0100001E       ~/~/ Set Transmit Interval (TDC) = 30 seconds
  * Example 2: Downlink Payload: 0100003C      ~/~/  Set Transmit Interval (TDC) = 60 seconds
++
  == 3.2 Set Interrupt Mode ==
@@ -836,14 +836,14 @@
  |(% style="width:156px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:165px" %)(((
  OK
--the mode is 0 = No interruption
++the mode is 0 = Disable Interrupt
  )))
  |(% style="width:156px" %)AT+INTMOD=2|(% style="width:187px" %)(((
  Set Transmit Interval
--~1. (Disable Interrupt),
--2. (Trigger by rising and falling edge)
--3. (Trigger by falling edge)
--4. (Trigger by rising edge)
++0. (Disable Interrupt),
++~1. (Trigger by rising and falling edge)
++2. (Trigger by falling edge)
++3. (Trigger by rising edge)
  )))|(% style="width:165px" %)OK
  (% style="color:blue" %)**Downlink Command: 0x06**
@@ -855,6 +855,7 @@
  * Example 1: Downlink Payload: 06000000       ~/~/  Turn off interrupt mode
  * Example 2: Downlink Payload: 06000003       ~/~/  Set the interrupt mode to rising edge trigger
++
  == 3.3 Set the output time ==
@@ -924,6 +924,7 @@
  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
++
  == 3.4 Set the all data mode ==
@@ -946,6 +946,7 @@
  * Example 1: Downlink Payload: AB 00    ~/~/  AT+ALLDATAMOD=0
  * Example 2: Downlink Payload: AB 01    ~/~/  AT+ALLDATAMOD=1
++
  == 3.5 Set the splicing payload for uplink ==
@@ -982,6 +982,7 @@
  == 3.6 Set the payload version ==
++
  Feature, Set the payload version.
  (% style="color:blue" %)**AT Command: AT+PAYVER**
@@ -1001,6 +1001,7 @@
  * Example 1: Downlink Payload: AE 01      ~/~/  AT+PAYVER=1
  * Example 2: Downlink Payload: AE 05      ~/~/  AT+PAYVER=5
++
  = 4. Battery & how to replace =
  == 4.1 Battery Type ==
@@ -1115,10 +1115,15 @@
  = 8. Order Info =
++(((
  (% style="color:blue" %)**Part Number: SDI-12-LB-XXX**
++)))
++(((
  XXX: The default frequency band
++)))
++(((
  (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
  (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
  (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
@@ -1127,13 +1127,9 @@
  (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
  (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
  (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
++)))
--
--
--
--
--
  = 9. Packing Info =
@@ -1148,6 +1148,7 @@
  * Package Size / pcs : cm
  * Weight / pcs : g
++
  = 10. Support =

image-20230222143809-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+322.1 KB

Content

Changes for page SDI-12-LB/LS -- SDI-12 to LoRaWAN Converter User Manual

Summary

Details

Applications

Navigation