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

Last modified by Xiaoling on 2025/04/25 08:58

From version < 41.4 >

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

To version < 41.20 >

edited by Xiaoling
on 2023/02/01 17:20

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -22,24 +22,34 @@
  == 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 ==
@@ -55,6 +55,8 @@
  * Downlink to change configure
  * 8500mAh Battery for long term use
++
++
  == 1.3 Specification ==
@@ -101,6 +101,8 @@
  * Sleep Mode: 5uA @ 3.3v
  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
++
++
  == 1.4 Connect to SDI-12 Sensor ==
@@ -122,20 +122,21 @@
  [[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 PS-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]]
@@ -459,7 +459,7 @@
  (% 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);
@@ -484,10 +484,10 @@
  (% 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:**
@@ -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.
@@ -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.
  )))
@@ -750,8 +750,6 @@
  [[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 Frequency Plans ==
@@ -765,7 +765,7 @@
  **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 =
@@ -824,6 +824,8 @@
  * 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 ==
@@ -855,6 +855,8 @@
  * 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,8 @@
  * 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,8 @@
  * 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,8 @@
  * 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,8 @@
  * Package Size / pcs : cm
  * Weight / pcs : g
++
++
  = 10. Support =

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

Summary

Details

Applications

Navigation