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.2 >

edited by Xiaoling
on 2023/03/21 09:23

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 (2 modified, 0 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Xiaoling
++XWiki.Bei

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 ==
@@ -65,8 +65,6 @@
  * Downlink to change configure
  * 8500mAh Battery for long term use
--
--
  == 1.3 Specification ==
@@ -79,8 +79,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:**
@@ -115,13 +115,11 @@
  * Sleep Mode: 5uA @ 3.3v
  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
--
--
  == 1.4 Connect to SDI-12 Sensor ==
--[[image:1675212538524-889.png||_mstalt="298272"]]
++[[image:1675212538524-889.png]]
  == 1.5 Sleep mode and working mode ==
@@ -135,7 +135,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" %)
@@ -151,12 +151,10 @@
  )))
  |(% 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||_mstalt="297167"]]
++[[image:1675213198663-754.png]]
  == 1.8 BLE connection ==
@@ -176,11 +176,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 =
@@ -197,7 +197,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.
@@ -208,7 +208,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:
@@ -216,24 +216,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
@@ -244,7 +244,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 ==
@@ -263,10 +263,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"]]
@@ -284,10 +284,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!**(%%) ====
@@ -320,10 +320,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"]]
@@ -357,10 +357,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"]]
@@ -390,10 +390,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 ===
@@ -425,10 +425,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 ===
@@ -443,12 +443,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. ===
@@ -525,7 +525,7 @@
  (% style="color:blue" %)**Example:**
--[[image:image-20230201094129-18.png||_mstalt="455065"]]
++[[image:image-20230201094129-18.png]]
@@ -552,7 +552,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.
@@ -563,7 +563,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.
@@ -581,7 +581,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**
@@ -596,7 +596,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:**
@@ -627,7 +627,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
@@ -705,7 +705,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 ===
@@ -740,7 +740,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.
@@ -753,7 +753,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. ==
@@ -760,69 +760,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 ==
@@ -896,8 +896,6 @@
  * 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 ==
@@ -929,8 +929,6 @@
  * 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 ==
@@ -1000,8 +1000,6 @@
  * Example 5: Downlink Payload: 070301F4  **~-~-->**  AT+12VT=500
  * Example 6: Downlink Payload: 07030000  **~-~-->**  AT+12VT=0
--
--
  == 3.4 Set the all data mode ==
@@ -1024,8 +1024,6 @@
  * 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 ==
@@ -1082,8 +1082,6 @@
  * 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 ==
@@ -1094,7 +1094,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:
@@ -1128,7 +1128,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:
@@ -1137,7 +1137,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 ===
@@ -1218,7 +1218,6 @@
  )))
--
  = 9. Packing Info =
@@ -1233,8 +1233,6 @@
  * 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