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

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

To version < 48.1 >

edited by Bei Jinggeng
on 2023/03/24 10:15

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -1,5 +1,5 @@
  (% style="text-align:center" %)
--[[image:image-20230131183542-1.jpeg||height="694" width="694"]]
++[[image:image-20230131183542-1.jpeg||_mstalt="470678" height="694" width="694"]]
  **Table of Contents：**
@@ -47,7 +47,7 @@
  )))
--[[image:image-20230201084414-1.png||height="464" width="1108"]]
++[[image:image-20230201084414-1.png||_mstalt="427765" height="464" width="1108"]]
  == 1.2 Features ==
@@ -65,6 +65,7 @@
  * Downlink to change configure
  * 8500mAh Battery for long term use
++
  == 1.3 Specification ==
@@ -77,6 +77,8 @@
  (% style="color:#037691" %)**Common DC Characteristics:**
  * Supply Voltage: 2.5v ~~ 3.6v
++* Support current: 5V 300mA
++                           12V 100mA
  * Operating Temperature: -40 ~~ 85°C
  (% style="color:#037691" %)**LoRa Spec:**
@@ -111,11 +111,12 @@
  * Sleep Mode: 5uA @ 3.3v
  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
++
  == 1.4 Connect to SDI-12 Sensor ==
--[[image:1675212538524-889.png]]
++[[image:1675212538524-889.png||_mstalt="298272"]]
  == 1.5 Sleep mode and working mode ==
@@ -129,7 +129,7 @@
  == 1.6 Button & LEDs ==
--[[image:1675212633011-651.png]]
++[[image:1675212633011-651.png||_mstalt="291538"]]
  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
@@ -145,10 +145,11 @@
  )))
  |(% 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 ==
--[[image:1675213198663-754.png]]
++[[image:1675213198663-754.png||_mstalt="297167"]]
  == 1.8 BLE connection ==
@@ -168,11 +168,11 @@
  == 1.9 Mechanical ==
--[[image:image-20230201090139-2.png]]
++[[image:image-20230201090139-2.png||_mstalt="428623"]]
--[[image:image-20230201090139-3.png]]
++[[image:image-20230201090139-3.png||_mstalt="428987"]]
--[[image:image-20230201090139-4.png]]
++[[image:image-20230201090139-4.png||_mstalt="429351"]]
  = 2. Configure SDI-12 to connect to LoRaWAN network =
@@ -189,7 +189,7 @@
  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.
--[[image:image-20230201090528-5.png||height="465" width="1111"]]
++[[image:image-20230201090528-5.png||_mstalt="430300" height="465" width="1111"]]
  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.
@@ -200,7 +200,7 @@
  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
--[[image:image-20230201152430-20.jpeg]]
++[[image:image-20230201152430-20.jpeg||_mstalt="492245"]]
  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
@@ -208,24 +208,24 @@
  (% style="color:blue" %)**Register the device**
--[[image:1675213652444-622.png]]
++[[image:1675213652444-622.png||_mstalt="293657"]]
  (% style="color:blue" %)**Add APP EUI and DEV EUI**
--[[image:1675213661769-223.png]]
++[[image:1675213661769-223.png||_mstalt="295217"]]
  (% style="color:blue" %)**Add APP EUI in the application**
--[[image:1675213675852-577.png]]
++[[image:1675213675852-577.png||_mstalt="297947"]]
  (% style="color:blue" %)**Add APP KEY**
--[[image:1675213686734-883.png]]
++[[image:1675213686734-883.png||_mstalt="298064"]]
  (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
@@ -236,7 +236,7 @@
  (% 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.
--[[image:1675213704414-644.png]]
++[[image:1675213704414-644.png||_mstalt="293748"]]
  == 2.3 SDI-12 Related Commands ==
@@ -255,10 +255,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091027-6.png]]
++[[image:image-20230201091027-6.png||_mstalt="429065"]]
--[[image:image-20230201091027-7.png||height="261" width="1179"]]
++[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
@@ -276,10 +276,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091257-8.png]]
++[[image:image-20230201091257-8.png||_mstalt="431392"]]
--[[image:image-20230201091257-9.png||height="225" width="1242"]]
++[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
  ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
@@ -312,10 +312,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091630-10.png]]
++[[image:image-20230201091630-10.png||_mstalt="449995"]]
--[[image:image-20230201091630-11.png||height="247" width="1165"]]
++[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
@@ -349,10 +349,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091954-12.png]]
++[[image:image-20230201091954-12.png||_mstalt="453687"]]
--[[image:image-20230201091954-13.png||height="203" width="1117"]]
++[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
@@ -382,10 +382,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201092208-14.png]]
++[[image:image-20230201092208-14.png||_mstalt="452283"]]
--[[image:image-20230201092208-15.png||height="214" width="1140"]]
++[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
  === 2.3.2 Advance SDI-12 Debug command ===
@@ -417,10 +417,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201092355-16.png]]
++[[image:image-20230201092355-16.png||_mstalt="453960"]]
--[[image:image-20230201092355-17.png||height="426" width="1135"]]
++[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
  === 2.3.3 Convert ASCII to String ===
@@ -435,12 +435,12 @@
 ) AT+CONVFORM=0, string Convert String from String to ASCII
--[[image:1675214845056-885.png]]
++[[image:1675214845056-885.png||_mstalt="297622"]]
 ) AT+CONVFORM=1, ASCII Convert ASCII to String.
--[[image:1675214856590-846.png]]
++[[image:1675214856590-846.png||_mstalt="297739"]]
  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
@@ -517,7 +517,7 @@
  (% style="color:blue" %)**Example:**
--[[image:image-20230201094129-18.png]]
++[[image:image-20230201094129-18.png||_mstalt="455065"]]
@@ -544,7 +544,7 @@
  Below shows a screen shot how the results combines together to a uplink payload.
--[[image:1675215745275-920.png]]
++[[image:1675215745275-920.png||_mstalt="295334"]]
  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.
@@ -555,7 +555,7 @@
  (% 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]]
++[[image:1675215782925-448.png||_mstalt="297466"]]
  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.
@@ -573,7 +573,7 @@
  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
--[[image:1675215828102-844.png]]
++[[image:1675215828102-844.png||_mstalt="294645"]]
  (% style="color:#4f81bd" %)**AT+DATAUP=1**
@@ -588,7 +588,7 @@
 . PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
 . 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
--[[image:1675215848113-696.png]]
++[[image:1675215848113-696.png||_mstalt="296998"]]
  (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
@@ -619,7 +619,7 @@
  Example parse in TTNv3
--[[image:1675215946738-635.png]]
++[[image:1675215946738-635.png||_mstalt="297778"]]
  (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
@@ -697,7 +697,7 @@
  Payload length in server,server will show payload not provided in the LoRaWAN server.
  )))
--[[image:1675216282284-923.png]]
++[[image:1675216282284-923.png||_mstalt="295633"]]
  === 2.4.3 Battery Info ===
@@ -732,7 +732,7 @@
  While using TTN network, you can add the payload format to decode the payload.
--[[image:1675216779406-595.png]]
++[[image:1675216779406-595.png||_mstalt="298376"]]
  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,7 +745,7 @@
  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:
--[[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]]]]
++[[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. ==
@@ -752,68 +752,69 @@
  === 2.6.1 Examples 1 ===
++
  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"]]
++[[image:image-20230222143809-1.png||_mstalt="429962" 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：
++(% style="color:blue" %)**1) The AT+COMMANDx command is applied to the red arrow part, and sends the SDI12 command to the SDI12 sensor:**
--AT+COMMANDx=1I!,0,0,1
++a. Send the first command and get the first reply：
--b.Send the second command and get the second reply：
++(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
--AT+COMMANDx=2I!,0,0,1
++b. Send the second command and get the second reply：
--c.Send the third command and get the third reply：
++(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
--AT+COMMANDx=3I!,0,0,1
++c. Send the third command and get the third reply：
--d.Send the fourth command and get the fourth reply：
++(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
--AT+COMMANDx=4I!,0,0,1
++d. Send the fourth command and get the fourth reply：
--e.Send the fifth command plus the sixth command, get the sixth reply：
++(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
--AT+COMMANDx=1M!,2,1,1
++e. Send the fifth command plus the sixth command, get the sixth reply：
--f.Send the seventh command plus the eighth command, get the eighth reply：
++(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
--AT+COMMANDx=2M!,2,1,1
++f. Send the seventh command plus the eighth command, get the eighth reply：
--g.Send the ninth command plus the tenth command, get the tenth reply：
++(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
--AT+COMMANDx=3M!,1,1,1
++g. Send the ninth command plus the tenth command, get the tenth reply：
--h.Send the eleventh command plus the twelfth command, get the twelfth reply：
++(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
--AT+COMMANDx=4M!,1,1,1
++h. Send the eleventh command plus the twelfth command, get the twelfth reply：
++(% style="color:#037691" %)**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>”
++(% style="color:blue" %)**2) The AT+DATACUTx command is applied to the green arrow part, receiving and cut out data from the SDI12 sensor：**
--Cut out all characters: AT+ALLDATAMOD=1  or  AT+DATACUTx=34,2,1~~34;
++a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
++Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=34,2,1~~34**(% style="color:#037691" %);
++
  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;
++Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
  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;
++Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
  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;
++Cut out all characters: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
  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”.
++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”**.
--==   ==
  == 2.7 Frequency Plans ==
@@ -887,6 +887,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 ==
@@ -918,6 +918,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 ==
@@ -987,6 +987,7 @@
  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
++
  == 3.4 Set the all data mode ==
@@ -1009,6 +1009,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 ==
@@ -1065,6 +1065,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 ==
@@ -1075,7 +1075,7 @@
  The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
--[[image:1675234124233-857.png]]
++[[image:1675234124233-857.png||_mstalt="295035"]]
  Minimum Working Voltage for the SDI-12-LB:
@@ -1109,7 +1109,7 @@
  And the Life expectation in difference case will be shown on the right.
--[[image:1675234155374-163.png]]
++[[image:1675234155374-163.png||_mstalt="294411"]]
  The battery related documents as below:
@@ -1118,7 +1118,7 @@
  * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
  * [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]]
--[[image:image-20230201145019-19.png]]
++[[image:image-20230201145019-19.png||_mstalt="453947"]]
  === 4.3.1 Battery Note ===
@@ -1157,7 +1157,7 @@
  = 7. FAQ =
--== 7.1 How to use AT Command to access device? ==
++== 7.1 How to use AT Command  via UART to access device? ==
  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]]
@@ -1199,6 +1199,7 @@
  )))
++
  = 9. Packing Info =
@@ -1213,6 +1213,7 @@
  * 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