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 < 37.11 >

edited by Xiaoling
on 2023/02/01 14:05

To version < 37.6 >

edited by Xiaoling
on 2023/02/01 10:44

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -3,7 +3,6 @@
  **Table of Contents：**
--{{toc/}}
@@ -17,23 +17,22 @@
--
  = 1. Introduction =
  == 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.
++The Dragino **SDI-12-LB** is a **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.
++**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.
++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.
++**SDI-12-LB** is powered by **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.
++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"]]
@@ -41,6 +41,8 @@
++
++
  == 1.2 Features ==
@@ -56,22 +56,21 @@
  * Downlink to change configure
  * 8500mAh Battery for long term use
--
  == 1.3 Specification ==
--**(% style="color:#037691" %)Micro Controller:**
++**Micro Controller:**
  * MCU: 48Mhz ARM
  * Flash: 256KB
  * RAM: 64KB
--**(% style="color:#037691" %)Common DC Characteristics:**
++**Common DC Characteristics:**
  * Supply Voltage: 2.5v ~~ 3.6v
  * Operating Temperature: -40 ~~ 85°C
--**(% style="color:#037691" %)LoRa Spec:**
++**LoRa Spec:**
  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
  * Max +22 dBm constant RF output vs.
@@ -78,19 +78,19 @@
  * RX sensitivity: down to -139 dBm.
  * Excellent blocking immunity
--**(% style="color:#037691" %)Current Input Measuring :**
++**Current Input Measuring :**
  * Range: 0 ~~ 20mA
  * Accuracy: 0.02mA
  * Resolution: 0.001mA
--**(% style="color:#037691" %)Voltage Input Measuring:**
++**Voltage Input Measuring:**
  * Range: 0 ~~ 30v
  * Accuracy: 0.02v
  * Resolution: 0.001v
--**(% style="color:#037691" %)Battery:**
++**Battery:**
  * Li/SOCI2 un-chargeable battery
  * Capacity: 8500mAh
@@ -98,12 +98,11 @@
  * Max continuously current: 130mA
  * Max boost current: 2A, 1 second
--**(% style="color:#037691" %)Power Consumption**
++**Power Consumption**
  * Sleep Mode: 5uA @ 3.3v
  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
--
  == 1.4 Connect to SDI-12 Sensor ==
@@ -114,9 +114,9 @@
  == 1.5 Sleep mode and working mode ==
--**(% 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.
++**Deep Sleep Mode: **Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
--**(% 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.
++**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.
  == 1.6 Button & LEDs ==
@@ -139,7 +139,6 @@
  )))
  |(% 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.
--
  == 1.7 Pin Mapping ==
@@ -163,6 +163,9 @@
  == 1.9 Mechanical ==
++
++
++
  [[image:image-20230201090139-2.png]]
  [[image:image-20230201090139-3.png]]
@@ -175,7 +175,7 @@
  == 2.1 How it works ==
--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.
++The SDI-12-LB is configured as **LoRaWAN OTAA Class A** mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and activate the SDI-12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
  == 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
@@ -190,7 +190,7 @@
  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.
--**(% style="color:blue" %)Step 1**(%%): Create a device in TTN with the OTAA keys from SDI-12-LB.
++**Step 1**: Create a device in TTN with the OTAA keys from SDI-12-LB.
  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
@@ -204,35 +204,35 @@
  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
--**(% style="color:blue" %)Register the device**
++**Register the device**
  [[image:1675213652444-622.png]]
--**(% style="color:blue" %)Add APP EUI and DEV EUI**
++**Add APP EUI and DEV EUI**
  [[image:1675213661769-223.png]]
--**(% style="color:blue" %)Add APP EUI in the application**
++**Add APP EUI in the application**
  [[image:1675213675852-577.png]]
--**(% style="color:blue" %)Add APP KEY**
++**Add APP KEY**
  [[image:1675213686734-883.png]]
--**(% style="color:blue" %)Step 2**(%%): Activate on SDI-12-LB
++**Step 2**: Activate on SDI-12-LB
  Press the button for 5 seconds to activate the SDI-12-LB.
--**(% 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.
++**Green led** will fast blink 5 times, device will enter **OTA mode** for 3 seconds. And then start to JOIN LoRaWAN network. **Green led** will solidly turn on for 5 seconds after joined in network.
  [[image:1675213704414-644.png]]
@@ -261,15 +261,15 @@
  [[image:image-20230201091027-7.png||height="261" width="1179"]]
--==== **(% style="color:blue" %)al!  ~-~- Get SDI-12 sensor Identification** ====
++==== **al!  ~-~- Get SDI-12 sensor Identification** ====
  * AT Command:  AT+ADDRI=aa
  * LoRaWAN Downlink(prefix 0xAA00):  AA 00 aa
--**(% style="color:#037691" %)Parameter:  **(%%)aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
++**Parameter:  **aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
--**(% style="color:blue" %)Example :   **AT+ADDRI=0  ( Equal to downlink: 0x AA 00 30)
++**Example :   **AT+ADDRI=0  ( Equal to downlink: 0x AA 00 30)
  The following is the display information on the serial port and the server.
@@ -281,31 +281,30 @@
  [[image:image-20230201091257-9.png||height="225" width="1242"]]
--==== **(% style="color:blue" %)aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
++==== **aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!** ====
--**(% style="color:red" %)aM! **(%%): Start Non-Concurrent Measurement
++**aM! **: Start Non-Concurrent Measurement
--**(% style="color:red" %)aMC! **(%%): Start Non-Concurrent Measurement – Request CRC
++**aMC! **: Start Non-Concurrent Measurement – Request CRC
--**(% style="color:red" %)aM1!- aM9! **(%%): Additional Measurements
++**aM1!- aM9! **: Additional Measurements
--**(% style="color:red" %)aMC1!- aMC9!**(%%) : Additional Measurements – Request CRC
++**aMC1!- aMC9!** : Additional Measurements – Request CRC
  * AT Command : AT+ADDRM=0,1,0,1
--
  * LoRaWAN Downlink(prefix 0xAA01): 0xAA 01 30 01 00 01
  Downlink：AA 01 aa bb cc dd
--**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
++**aa**: SDI-12 sensor address.
--**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
++**bb**: 0: no CRC, 1: request CRC
--**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
++**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.
++**dd**: delay (in second) to send **aD0!** to get return.
  The following is the display information on the serial port and the server.
@@ -318,16 +318,16 @@
--==== **(% style="color:blue" %)aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
++==== **aC!, aCC!,  aC1!- aC9!,  aCC1!- aCC9! ** ====
--**(% style="color:red" %)aC!**(%%) : Start Concurrent Measurement
++**aC!** : Start Concurrent Measurement
--**(% style="color:red" %)aCC!** (%%): Start Concurrent Measurement – Request CRC
++**aCC!** : Start Concurrent Measurement – Request CRC
--**(% style="color:red" %)aC1!- aC9!**(%%) : Start Additional Concurrent Measurements
++**aC1!- aC9!** : Start Additional Concurrent Measurements
--**(% style="color:red" %)aCC1!- aCC9!**(%%) : Start Additional Concurrent Measurements – Request CRC
++**aCC1!- aCC9!** : Start Additional Concurrent Measurements – Request CRC
  * AT Command : AT+ADDRC=0,1,0,1
@@ -336,13 +336,13 @@
  Downlink: AA 02 aa bb cc dd
--**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
++**aa**: SDI-12 sensor address.
--**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
++**bb**: 0: no CRC, 1: request CRC
--**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
++**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.
++**dd**: delay (in second) to send **aD0!** to get return.
  The following is the display information on the serial port and the server.
@@ -354,11 +354,11 @@
  [[image:image-20230201091954-13.png||height="203" width="1117"]]
++(% style="display:none" %) (%%)
++==== **aR0!- aR9!,  aRC0!- aRC9!** ====
--==== **(% style="color:blue" %)aR0!- aR9!,  aRC0!- aRC9!** ====
--
  Start Continuous Measurement
  Start Continuous Measurement – Request CRC
@@ -369,13 +369,13 @@
  Downlink: AA 03 aa bb cc dd
--**(% style="color:#037691" %)aa**(%%): SDI-12 sensor address.
++**aa**: SDI-12 sensor address.
--**(% style="color:#037691" %)bb**(%%): 0: no CRC, 1: request CRC
++**bb**: 0: no CRC, 1: request CRC
--**(% style="color:#037691" %)cc**(%%): 1-9: Additional Measurement, 0: no additional measurement
++**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.
++**dd**: delay (in second) to send **aD0!** to get return.
  The following is the display information on the serial port and the server.
@@ -396,20 +396,20 @@
  LoRaWAN Downlink: A8 aa xx xx xx xx bb cc
--**(% style="color:#037691" %)aa **(%%): total SDI-12 command length
++**aa **: total SDI-12 command length
--**(% style="color:#037691" %)xx **(%%): SDI-12 command
++**xx **: SDI-12 command
--**(% style="color:#037691" %)bb **(%%): Delay to wait for return
++**bb **: Delay to wait for return
--**(% style="color:#037691" %)cc **(%%): 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
++**cc **: 0: don't uplink return to LoRaWAN, 1: Uplink return to LoRaWAN on FPORT=100
--**(% style="color:blue" %)Example: **(%%) AT+CFGDEV =0RC0!,1
++**Example: **AT+CFGDEV =0RC0!,1
--**(% style="color:#037691" %)0RC0! **(%%): SDI-12 Command,
++**0RC0! **: SDI-12 Command,
--**(% style="color:#037691" %)1 **(%%): Delay 1 second.  ( 0: 810 mini-second)
++**1 **: Delay 1 second.  ( 0: 810 mini-second)
  Equal Downlink: 0xA8 05 30 52 43 30 21 01 01
@@ -431,7 +431,7 @@
  AT+CONVFORM ( Max length: 80 bytes)
--**(% style="color:blue" %)Example:**
++**Example:**
 ) AT+CONVFORM=0, string Convert String from String to ASCII
@@ -451,31 +451,31 @@
  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.
--* ** (% style="color:blue" %)AT Command:**
++* ** AT Command:**
--**(% style="color:#037691" %)AT+COMMANDx=var1,var2,var3,var4.**
++**AT+COMMANDx=var1,var2,var3,var4.**
--**(% style="color:red" %)var1**(%%): SDI-12 command , for example: 0RC0!
++**var1**: SDI-12 command , for example: 0RC0!
--**(% style="color:red" %)var2**(%%): Wait timeout for return. (unit: second)
++**var2**: Wait timeout for return. (unit: second)
--**(% style="color:red" %)var3**(%%): Whether to send //addrD0!// to get return after var2 timeout. 0: Don't Send //addrD0! //; 1: Send //addrD0!//.
++**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.
++**var4**: validation check for return. If return invalid, SDI-12-LB will resend this command. Max 2 retries.
--**(% style="color:red" %)0 **(%%) No validation check;
++**0 ** No validation check;
--**(% style="color:red" %)1** (%%) Check if return chars are printable char(0x20 ~~ 0x7E);
++**1**  Check if return chars are printable char(0x20 ~~ 0x7E);
--**(% style="color:#red" %)2**(%%)  Check if there is return from SDI-12 sensor
++**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);
++**3**  Check if return pass CRC check ( SDI-12 command var1 must include CRC request);
--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.
++Each AT+COMMANDx is followed by a **AT+DATACUT** command. AT+DATACUT command is used to take the useful string from the SDI-12 sensor so the final payload will have the minimum length to uplink.
--**(% style="color:blue" %)AT+DATACUTx**(%%) : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
++**AT+DATACUTx** : This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
  (% border="1" style="background-color:#f7faff; width:436px" %)
  |(% style="width:433px" %)(((
@@ -483,7 +483,7 @@
  **a**:  length for the return of AT+COMMAND
--**b**:  1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
++**b**: 1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.
  **c**:  define the position for valid value.
  )))
@@ -497,49 +497,49 @@
  |(% 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="color:blue" %) Downlink Payload:**
++* ** Downlink Payload:**
--**(% style="color:blue" %)0xAF**(%%)  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
++**0xAF**  downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
--**(% style="color:red" %)Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
++**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
--Format: ** (% style="color:#037691" %)AF MM NN LL XX XX XX XX YY**
++Format: ** AF MM NN LL XX XX XX XX YY**
  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" %)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.
++* **MM **: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
++* **NN **:  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
++* **LL **:   The length of AT+COMMAND or AT+DATACUT command
++* **XX XX XX XX **: AT+COMMAND or AT+DATACUT command
++* **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:blue" %)Example:**
++**Example:**
  [[image:image-20230201094129-18.png]]
--**(% style="color:blue" %)Clear SDI12 Command**
++**Clear SDI12 Command**
  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
--* ** (% style="color:#037691" %)AT Command:**
++* ** AT Command:**
--**(% style="color:#4F81BD" %)AT+CMDEAR=mm,nn** (%%)  mm: start position of erase ,nn: stop position of erase
++**~ AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
--* **(% style="color:#037691" %) Downlink Payload:**
++* ** Downlink Payload:**
--**(% style="color:#4F81BD" %)0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
++**~ 0x09 aa bb**  same as AT+CMDEAR=aa,bb
--**(% style="color:blue" %)command combination**
++**command combination**
  Below shows a screen shot how the results combines together to a uplink payload.

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

Summary

Details

Applications

Navigation