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

edited by Bei Jinggeng
on 2023/03/20 10:22

To version < 44.1 >

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

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||_mstalt="470678" height="694" width="694"]]
++[[image:image-20230131183542-1.jpeg||height="694" width="694"]]
  **Table of Contents：**
@@ -47,7 +47,7 @@
  )))
--[[image:image-20230201084414-1.png||_mstalt="427765" height="464" width="1108"]]
++[[image:image-20230201084414-1.png||height="464" width="1108"]]
  == 1.2 Features ==
@@ -77,8 +77,6 @@
  (% 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||_mstalt="298272"]]
++[[image:1675212538524-889.png]]
  == 1.5 Sleep mode and working mode ==
@@ -131,7 +131,7 @@
  == 1.6 Button & LEDs ==
--[[image:1675212633011-651.png||_mstalt="291538"]]
++[[image:1675212633011-651.png]]
  (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
@@ -150,7 +150,7 @@
  == 1.7 Pin Mapping ==
--[[image:1675213198663-754.png||_mstalt="297167"]]
++[[image:1675213198663-754.png]]
  == 1.8 BLE connection ==
@@ -170,11 +170,11 @@
  == 1.9 Mechanical ==
--[[image:image-20230201090139-2.png||_mstalt="428623"]]
++[[image:image-20230201090139-2.png]]
--[[image:image-20230201090139-3.png||_mstalt="428987"]]
++[[image:image-20230201090139-3.png]]
--[[image:image-20230201090139-4.png||_mstalt="429351"]]
++[[image:image-20230201090139-4.png]]
  = 2. Configure SDI-12 to connect to LoRaWAN network =
@@ -191,7 +191,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||_mstalt="430300" height="465" width="1111"]]
++[[image:image-20230201090528-5.png||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.
@@ -202,7 +202,7 @@
  Each SDI-12-LB is shipped with a sticker with the default device EUI as below:
--[[image:image-20230201152430-20.jpeg||_mstalt="492245"]]
++[[image:image-20230201152430-20.jpeg]]
  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
@@ -210,24 +210,24 @@
  (% style="color:blue" %)**Register the device**
--[[image:1675213652444-622.png||_mstalt="293657"]]
++[[image:1675213652444-622.png]]
  (% style="color:blue" %)**Add APP EUI and DEV EUI**
--[[image:1675213661769-223.png||_mstalt="295217"]]
++[[image:1675213661769-223.png]]
  (% style="color:blue" %)**Add APP EUI in the application**
--[[image:1675213675852-577.png||_mstalt="297947"]]
++[[image:1675213675852-577.png]]
  (% style="color:blue" %)**Add APP KEY**
--[[image:1675213686734-883.png||_mstalt="298064"]]
++[[image:1675213686734-883.png]]
  (% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB
@@ -238,7 +238,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||_mstalt="293748"]]
++[[image:1675213704414-644.png]]
  == 2.3 SDI-12 Related Commands ==
@@ -257,10 +257,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091027-6.png||_mstalt="429065"]]
++[[image:image-20230201091027-6.png]]
--[[image:image-20230201091027-7.png||_mstalt="429429" height="261" width="1179"]]
++[[image:image-20230201091027-7.png||height="261" width="1179"]]
@@ -278,10 +278,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091257-8.png||_mstalt="431392"]]
++[[image:image-20230201091257-8.png]]
--[[image:image-20230201091257-9.png||_mstalt="431756" height="225" width="1242"]]
++[[image:image-20230201091257-9.png||height="225" width="1242"]]
  ==== (% style="color:blue" %)**aM!,aMC!, aM1!- aM9!, aMC1!- aMC9!**(%%) ====
@@ -314,10 +314,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091630-10.png||_mstalt="449995"]]
++[[image:image-20230201091630-10.png]]
--[[image:image-20230201091630-11.png||_mstalt="450372" height="247" width="1165"]]
++[[image:image-20230201091630-11.png||height="247" width="1165"]]
@@ -351,10 +351,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201091954-12.png||_mstalt="453687"]]
++[[image:image-20230201091954-12.png]]
--[[image:image-20230201091954-13.png||_mstalt="454064" height="203" width="1117"]]
++[[image:image-20230201091954-13.png||height="203" width="1117"]]
@@ -384,10 +384,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201092208-14.png||_mstalt="452283"]]
++[[image:image-20230201092208-14.png]]
--[[image:image-20230201092208-15.png||_mstalt="452660" height="214" width="1140"]]
++[[image:image-20230201092208-15.png||height="214" width="1140"]]
  === 2.3.2 Advance SDI-12 Debug command ===
@@ -419,10 +419,10 @@
  The following is the display information on the serial port and the server.
--[[image:image-20230201092355-16.png||_mstalt="453960"]]
++[[image:image-20230201092355-16.png]]
--[[image:image-20230201092355-17.png||_mstalt="454337" height="426" width="1135"]]
++[[image:image-20230201092355-17.png||height="426" width="1135"]]
  === 2.3.3 Convert ASCII to String ===
@@ -437,12 +437,12 @@
 ) AT+CONVFORM=0, string Convert String from String to ASCII
--[[image:1675214845056-885.png||_mstalt="297622"]]
++[[image:1675214845056-885.png]]
 ) AT+CONVFORM=1, ASCII Convert ASCII to String.
--[[image:1675214856590-846.png||_mstalt="297739"]]
++[[image:1675214856590-846.png]]
  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
@@ -519,7 +519,7 @@
  (% style="color:blue" %)**Example:**
--[[image:image-20230201094129-18.png||_mstalt="455065"]]
++[[image:image-20230201094129-18.png]]
@@ -546,7 +546,7 @@
  Below shows a screen shot how the results combines together to a uplink payload.
--[[image:1675215745275-920.png||_mstalt="295334"]]
++[[image:1675215745275-920.png]]
  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.
@@ -557,7 +557,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||_mstalt="297466"]]
++[[image:1675215782925-448.png]]
  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.
@@ -575,7 +575,7 @@
  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
--[[image:1675215828102-844.png||_mstalt="294645"]]
++[[image:1675215828102-844.png]]
  (% style="color:#4f81bd" %)**AT+DATAUP=1**
@@ -590,7 +590,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||_mstalt="296998"]]
++[[image:1675215848113-696.png]]
  (% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
@@ -621,7 +621,7 @@
  Example parse in TTNv3
--[[image:1675215946738-635.png||_mstalt="297778"]]
++[[image:1675215946738-635.png]]
  (% style="color:#037691" %)**Sensor Model**(%%): For SDI-12-LB, this value is 0x17
@@ -699,7 +699,7 @@
  Payload length in server,server will show payload not provided in the LoRaWAN server.
  )))
--[[image:1675216282284-923.png||_mstalt="295633"]]
++[[image:1675216282284-923.png]]
  === 2.4.3 Battery Info ===
@@ -734,7 +734,7 @@
  While using TTN network, you can add the payload format to decode the payload.
--[[image:1675216779406-595.png||_mstalt="298376"]]
++[[image:1675216779406-595.png]]
  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.
@@ -747,7 +747,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. ==
@@ -754,69 +754,68 @@
  === 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||_mstalt="429962" height="564" width="729"]]
++[[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:
--(% style="color:blue" %)**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：
--a. Send the first command and get the first reply：
++AT+COMMANDx=1I!,0,0,1
--(% style="color:#037691" %)**AT+COMMANDx=1I!,0,0,1**
++b.Send the second command and get the second reply：
--b. Send the second command and get the second reply：
++AT+COMMANDx=2I!,0,0,1
--(% style="color:#037691" %)**AT+COMMANDx=2I!,0,0,1**
++c.Send the third command and get the third reply：
--c. Send the third command and get the third reply：
++AT+COMMANDx=3I!,0,0,1
--(% style="color:#037691" %)**AT+COMMANDx=3I!,0,0,1**
++d.Send the fourth command and get the fourth reply：
--d. Send the fourth command and get the fourth reply：
++AT+COMMANDx=4I!,0,0,1
--(% style="color:#037691" %)**AT+COMMANDx=4I!,0,0,1**
++e.Send the fifth command plus the sixth command, get the sixth reply：
--e. Send the fifth command plus the sixth command, get the sixth reply：
++AT+COMMANDx=1M!,2,1,1
--(% style="color:#037691" %)**AT+COMMANDx=1M!,2,1,1**
++f.Send the seventh command plus the eighth command, get the eighth reply：
--f. Send the seventh command plus the eighth command, get the eighth reply：
++AT+COMMANDx=2M!,2,1,1
--(% style="color:#037691" %)**AT+COMMANDx=2M!,2,1,1**
++g.Send the ninth command plus the tenth command, get the tenth reply：
--g. Send the ninth command plus the tenth command, get the tenth reply：
++AT+COMMANDx=3M!,1,1,1
--(% style="color:#037691" %)**AT+COMMANDx=3M!,1,1,1**
++h.Send the eleventh command plus the twelfth command, get the twelfth reply：
--h. Send the eleventh command plus the twelfth command, get the twelfth reply：
++AT+COMMANDx=4M!,1,1,1
--(% 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：
--(% style="color:blue" %)**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>”
--a. The first reply, all 34 characters: ”113TRUEBNERSMT100038220303182331<CR><LF>”
++Cut out all characters: AT+ALLDATAMOD=1  or  AT+DATACUTx=34,2,1~~34;
--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: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
++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: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=31,2,1~~31**(% style="color:#037691" %);
++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: (% _mstmutation="1" style="color:#037691" %)**AT+ALLDATAMOD=1  or  AT+DATACUTx=15,2,1~~15**(% style="color:#037691" %);
++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：(% style="color:#037691" %)**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：AT+DATACUTx=25,2,1~~12, cut out the character field ” 4+30.8+22.84”.
++==   ==
  == 2.7 Frequency Plans ==
@@ -1078,7 +1078,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||_mstalt="295035"]]
++[[image:1675234124233-857.png]]
  Minimum Working Voltage for the SDI-12-LB:
@@ -1112,7 +1112,7 @@
  And the Life expectation in difference case will be shown on the right.
--[[image:1675234155374-163.png||_mstalt="294411"]]
++[[image:1675234155374-163.png]]
  The battery related documents as below:
@@ -1121,7 +1121,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||_mstalt="453947"]]
++[[image:image-20230201145019-19.png]]
  === 4.3.1 Battery Note ===

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

Summary

Details

Applications

Navigation