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 42.1 to 43.1 From 48.1 to 48.2

From version 43.1

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

Change comment: There is no comment for this version

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 ==
@@ -78,6 +78,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:**
@@ -117,7 +117,7 @@
--[[image:1675212538524-889.png]]
++[[image:1675212538524-889.png||_mstalt="298272"]]
  == 1.5 Sleep mode and working mode ==
@@ -131,7 +131,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" %)
@@ -151,7 +151,7 @@
  == 1.7 Pin Mapping ==
--[[image:1675213198663-754.png]]
++[[image:1675213198663-754.png||_mstalt="297167"]]
  == 1.8 BLE connection ==
@@ -171,11 +171,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 =
@@ -192,7 +192,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.
@@ -203,7 +203,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:
@@ -211,24 +211,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
@@ -239,7 +239,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 ==
@@ -258,10 +258,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"]]
@@ -279,10 +279,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!**(%%) ====
@@ -315,10 +315,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"]]
@@ -352,10 +352,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"]]
@@ -385,10 +385,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 ===
@@ -420,10 +420,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 ===
@@ -438,12 +438,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. ===
@@ -464,7 +464,7 @@
  (% 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 4 retries.
++(% style="color:red" %)**var4**(%%): validation check for return. If return invalid, SDI-12-LB will resend this command. Max 3 retries.
  (% style="color:red" %)**0 **(%%) No validation check;
@@ -520,7 +520,7 @@
  (% style="color:blue" %)**Example:**
--[[image:image-20230201094129-18.png]]
++[[image:image-20230201094129-18.png||_mstalt="455065"]]
@@ -547,7 +547,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.
@@ -558,7 +558,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.
@@ -576,7 +576,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**
@@ -591,7 +591,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:**
@@ -622,7 +622,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
@@ -700,7 +700,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 ===
@@ -735,7 +735,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.
@@ -748,7 +748,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. ==
@@ -755,69 +755,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”**.
--(% class="wikigeneratedid" %)
--==   ==
  == 2.7 Frequency Plans ==
@@ -1084,7 +1084,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:
@@ -1118,7 +1118,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:
@@ -1127,7 +1127,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 ===
@@ -1166,7 +1166,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]]
@@ -1208,6 +1208,7 @@
  )))
++
  = 9. Packing Info =

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

Summary

Details

Applications

Navigation