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 90.4 to 90.5 From 142.2 to 143.1

From version 90.5

edited by Xiaoling
on 2024/01/03 17:11

Change comment: There is no comment for this version

To version 142.2

edited by Mengting Qiu
on 2025/05/14 19:35

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 32 added, 0 removed)

Details

Page properties

Author

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

Content

@@ -1,7 +1,7 @@
  (% style="text-align:center" %)
--[[image:image-20240103165259-3.png]]
++[[image:image-20240103165259-3.png||height="433" width="591"]]
@@ -47,7 +47,7 @@
  )))
  (((
--SDI-12-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%) or (% style="color:blue" %)**solar powered + li-on battery**(%%) it is designed for long term use up to 5 years.
++SDI-12-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%) or (% style="color:blue" %)**solar powered + Li-ion battery,**(%%) it is designed for long term use up to 5 years.
  )))
  (((
@@ -55,9 +55,6 @@
  )))
--[[image:image-20230201084414-1.png||_mstalt="427765" height="464" width="1108"]]
--
--
  == 1.2 Features ==
@@ -72,7 +72,7 @@
  * Uplink on periodically
  * Downlink to change configure
  * 8500mAh Li/SOCl2 Battery (SDI-12-LB)
--* Solar panel + 3000mAh Li-on battery (SDI-12-LS)
++* Solar panel + 3000mAh Li-ion battery (SDI-12-LS)
  == 1.3 Specification ==
@@ -138,11 +138,10 @@
  == 1.6 Button & LEDs ==
--[[image:1675212633011-651.png||_mstalt="291538"]]
++[[image:image-20250416151419-4.jpeg]]
--
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 226px;background-color:#4F81BD;color:white" %)**Action**
  |(% style="background-color:#f2f2f2; width:167px" %)Pressing ACT between 1s < time < 3s|(% style="background-color:#f2f2f2; width:117px" %)Send an uplink|(% style="background-color:#f2f2f2; width:225px" %)(((
  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
@@ -152,7 +152,7 @@
  (% style="background-color:#f2f2f2; color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
  Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
  )))
--|(% style="background-color:#f2f2f2; width:167px" %)Fast press ACT 5 times.|(% style="background-color:#f2f2f2; width:117px" %)Deactivate Device|(% style="background-color:#f2f2f2; width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means PS-LB-NA is in Deep Sleep Mode.
++|(% style="background-color:#f2f2f2; width:167px" %)Fast press ACT 5 times.|(% style="background-color:#f2f2f2; width:117px" %)Deactivate Device|(% style="background-color:#f2f2f2; width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means SDI-12-LB/LS is in Deep Sleep Mode.
  == 1.7 Pin Mapping ==
@@ -176,14 +176,18 @@
  == 1.9 Mechanical ==
++=== 1.9.1 for LB version ===
--[[image:image-20230201090139-2.png||_mstalt="428623"]]
--[[image:image-20230201090139-3.png||_mstalt="428987"]]
++[[image:image-20250416151406-3.jpeg]]
--[[image:image-20230201090139-4.png||_mstalt="429351"]]
++=== 1.9.2 for LS version ===
++
++[[image:image-20250329133856-1.jpeg]]
++
++
  = 2. Configure SDI-12 to connect to LoRaWAN network =
  == 2.1 How it works ==
@@ -197,10 +197,9 @@
  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-20250416151346-2.png]]
--[[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.
@@ -213,37 +213,53 @@
  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
++**Create the application.**
--(% style="color:blue" %)**Register the device**
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]
--[[image:1675213652444-622.png||_mstalt="293657"]]
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]
--(% style="color:blue" %)**Add APP EUI and DEV EUI**
++**Add devices to the created Application.**
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]
--[[image:1675213661769-223.png||_mstalt="295217"]]
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]
--(% style="color:blue" %)**Add APP EUI in the application**
++**Enter end device specifics manually.**
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]
--[[image:1675213675852-577.png||_mstalt="297947"]]
++**Add DevEUI and AppKey.**
--(% style="color:blue" %)**Add APP KEY**
++**Customize a platform ID for the device.**
--[[image:1675213686734-883.png||_mstalt="298064"]]
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]
--(% style="color:blue" %)**Step 2**(%%): Activate on SDI-12-LB/LS
++(% style="color:blue" %)**Step 2: **(%%)Add decoder
++While using TTN network, you can add the payload format to decode the payload.
++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.
++
++SDI-12-LB/LS TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
++
++Below is TTN screen shot:
++
++[[image:image-20241118165746-3.png||height="470" width="869"]]
++
++[[image:image-20241118165832-4.png||height="336" width="724"]]
++
++
++(% style="color:blue" %)**Step 3**(%%): Activate on SDI-12-LB/LS
++
  Press the button for 5 seconds to activate the SDI-12-LB/LS.
  (% 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"]]
@@ -252,7 +252,16 @@
  User need to configure SDI-12-LB/LS to communicate with SDI-12 sensors otherwise the uplink payload will only include a few bytes.
++If you use UART to connect a computer, refer to the following connection methods:
++[[image:image-20240823165402-1.jpeg||height="488" width="678"]]
++
++Screenshot example:
++
++[[image:image-20240823165526-2.png||height="489" width="690"]]
++
++
++
  === 2.3.1 Basic SDI-12 debug command ===
@@ -519,8 +519,8 @@
  For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895<CR><LF>” , Below AT+DATACUT1 will get different result to combine payload:
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)**AT+DATACUT1 value**|=(% style="width: 344px;background-color:#D9E2F3;color:#0070C0" %)**Final Result to combine Payload**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**AT+DATACUT1 value**|=(% style="width: 346px;background-color:#4F81BD;color:white" %)**Final Result to combine Payload**
  |(% style="background-color:#f2f2f2; width:164px" %)34,1,1+2+3|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33
  |(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~8+12~~16|(% style="background-color:#f2f2f2; width:344px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
  |(% style="background-color:#f2f2f2; width:164px" %)34,2,1~~34|(% style="background-color:#f2f2f2; width:344px" %)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
@@ -562,7 +562,7 @@
  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
--* (% style="color:#037691" %)** Downlink Payload:**
++* (% style="color:#037691" %)**Downlink Payload:**
  (% style="color:#4f81bd" %)**0x09 aa bb**(%%)  same as AT+CMDEAR=aa,bb
@@ -589,7 +589,6 @@
  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.
--
  (% style="color:blue" %)**Compose Uplink**
  (% style="color:#4f81bd" %)**AT+DATAUP=0**
@@ -640,8 +640,8 @@
  Users can also use the downlink command(0x26 01) to ask SDI-12-LB/LS to resend this uplink.
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|(% colspan="6" style="background-color:#4f81bd; color:white" %)**Device Status (FPORT=5)**
  |(% style="background-color:#f2f2f2; width:103px" %)**Size (bytes)**|(% style="background-color:#f2f2f2; width:72px" %)**1**|(% style="background-color:#f2f2f2" %)**2**|(% style="background-color:#f2f2f2; width:91px" %)**1**|(% style="background-color:#f2f2f2; width:86px" %)**1**|(% style="background-color:#f2f2f2; width:44px" %)**2**
  |(% style="background-color:#f2f2f2; width:103px" %)**Value**|(% style="background-color:#f2f2f2; width:72px" %)Sensor Model|(% style="background-color:#f2f2f2" %)Firmware Version|(% style="background-color:#f2f2f2; width:91px" %)Frequency Band|(% style="background-color:#f2f2f2; width:86px" %)Sub-band|(% style="background-color:#f2f2f2; width:44px" %)BAT
@@ -712,10 +712,10 @@
  * Periodically Uplink: FPORT=2
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
--|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)(((
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:500px" %)
++|=(% style="width: 90px;background-color:#4F81BD;color:white" %)(((
  **Size(bytes)**
--)))|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 240px;background-color:#D9E2F3;color:#0070C0" %)**Length depends on the return from the commands**
++)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 240px;background-color:#4F81BD;color:white" %)**Length depends on the return from the commands**
  |(% style="width:93px" %)Value|(% style="width:83px" %)(((
  Battery(mV)
  &
@@ -822,27 +822,27 @@
  (% style="color:#037691" %)**AT+COMMANDx=4M!,1,1,1**
--(% style="color:blue" %)**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>”
  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>”
++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" %);
--c. The eighth reply, all 31 characters：”2+18990+1.08+0.00+22.24+11.80<CR><LF>”
++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" %);
--d. The tenth reply, all 15 characters：”3-2919.8+24.0<CR><LF>”
++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" %);
--e. The twelfth reply, all 25 characters：”4+30.8+22.84+4.7+954.38<CR><LF>”
++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:(% style="color:#037691" %)**AT+DATACUTx=25,2,1~~12, cut out the character field "4+30.8+22.84"**.
  === 2.6.2 Example 2 ~-~- Connect to Hygrovue10 ===
@@ -926,7 +926,6 @@
  [[image:image-20230603121826-11.png||height="155" width="1104"]]
--
  === 2.6.4 Example 4 ~-~- Connect to TEROS-12 ===
  ==== 2.6.4.1 Reference Manual and Command ====
@@ -1029,7 +1029,6 @@
  [[image:image-20230627174446-2.png]]
--
  ==== 2.6.6.3 Commands set in SDI-12-LB/LS and uplink payload ====
@@ -1043,10 +1043,89 @@
  [[image:image-20230627180303-6.png||height="292" width="1171"]]
++=== 2.6.7 Example 7 ~-~- Connect to GroPoint Profile-8 (SDI-12 Version) ===
++
++==== 2.6.7.1  Reference Manual and Command ====
++
++
++* [[https:~~/~~/static1.squarespace.com/static/5db0b690c4990258f8f6d042/t/64189e1ab3ebc54e6947b0c0/1679334941034/2625-N-T+GroPoint+Profile+User+Manual-V1.1.3.pdf>>https://static1.squarespace.com/static/5db0b690c4990258f8f6d042/t/64189e1ab3ebc54e6947b0c0/1679334941034/2625-N-T+GroPoint+Profile+User+Manual-V1.1.3.pdf]]
++
++* Commands to be used in PC and output.
++
++1. check device address
++1. change device address
++1. check device ID
++1. start measure
++1. Get Meausre result
++
++[[image:image-20240423143921-1.png]]
++
++
++==== 2.6.7.2 Hardware Connection to SDI-12-LB/LS ====
++
++
++(% style="color:red" %)**Note: When the bytes returned by the sensor are not fixed, the full byte interception can be used: AT+ALLDATAMOD=1 (The DATACUTx parameter needs to be cleared when using this directive, or it will not work.)**
++
++[[image:image-20240423145522-2.png||height="345" width="400"]]
++
++
++==== 2.6.7.3 Commands set in SDI-12-LB/LS and uplink payload ====
++
++[[image:image-20240423151202-3.png]]
++
++(% class="wikigeneratedid" id="H" %)
++[[image:image-20240423162851-6.png||height="251" width="935"]]
++
++
++DATA in TTN:
++
++[[image:image-20240423162322-4.png||height="269" width="933"]]
++
++
++=== 2.6.8 Example 8 ~-~- Connect to Acclima TDR Soil Moisture Sensor ===
++
++==== 2.6.8.1  Reference Manual and Command ====
++
++
++* [[Acclima TDR Soil Moisture Sensor User Manual>>url:https://acclima.com/tdr-soil-moisture-sensor-user-manual/]]
++
++* Commands to be used in PC and output.
++
++1. check device address
++1. change device address
++1. check device ID
++1. start measure
++1. Get Meausre result
++
++[[image:image-20240903152650-3.png]]
++
++[[image:image-20240903152627-2.png]]
++
++
++==== 2.6.8.2 Hardware Connection to SDI-12-LB/LS ====
++
++
++(% style="color:red" %)**Note: When the bytes returned by the sensor are not fixed, the full byte interception can be used: AT+ALLDATAMOD=1 (The DATACUTx parameter needs to be cleared when using this directive, or it will not work.)**
++
++[[image:image-20240903153004-5.png||height="358" width="660"]]
++
++
++==== 2.6.8.3 Commands set in SDI-12-LB/LS and uplink payload ====
++
++
++[[image:image-20240903153258-6.png]]
++
++[[image:image-20240903153627-7.png]]
++
++DATA in TTN:
++
++[[image:image-20240903154020-10.png||height="467" width="961"]]
++
++
  == 2.7 Frequency Plans ==
--The SDI-12-LB/LS uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
++The SDI-12-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
@@ -1059,6 +1059,187 @@
  [[https:~~/~~/www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0>>https://www.dropbox.com/sh/qrbgbikb109lkiv/AACBR-v_ZhZAMengcY7Nsa1ja?dl=0]]
++
++== 2.9 Datalog Feature(Since v1.3.0) ==
++
++
++(((
++Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, SDI-12-LB will store the reading for future retrieving purposes. There are two ways for IoT servers to get datalog from SDI-12-LB.
++)))
++
++
++=== 2.9.1 Ways to get datalog via LoRaWAN ===
++
++
++There are two methods:
++
++(% style="color:blue" %)**Method 1:** (%%)IoT Server sends a downlink LoRaWAN command to [[poll the value>>||anchor="H2.8.4Pollsensorvalue"]] for specified time range.
++
++
++(% style="color:blue" %)**Method 2: **(%%)Set PNACKMD=1, SDI-12-LB will wait for ACK for every uplink, when there is no LoRaWAN network, SDI-12-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
++
++
++(% style="color:red" %)**Note for method 2:**
++
++* a) SDI-12-LB will do an ACK check for data records sending to make sure every data arrive server.
++* b) SDI-12-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but SDI-12-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if SDI-12-LB gets a ACK, SDI-12-LB will consider there is a network connection and resend all NONE-ACK Message.
++
++=== 2.9.2 Unix TimeStamp ===
++
++
++SDI-12-LB uses Unix TimeStamp format based on
++
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="image-20220523001219-11.png"]]
++
++
++User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
++
++Below is the converter example
++
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="image-20220523001219-12.png"]]
++
++So, we can use AT+TIMESTAMP=1742889625 or downlink 3067E26299 to set the current time 2025 – March ~-~- 25 Tuesday  08:00:25
++
++
++=== 2.9.3 Set Device Time ===
++
++
++(((
++(% style="color:blue" %)**There are two ways to set device's time:**
++)))
++
++(((
++**1.  Through LoRaWAN MAC Command (Default settings)**
++)))
++
++(((
++User need to set SYNCMOD=1 to enable sync time via MAC command.
++)))
++
++(((
++Once SDI-12-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to SDI-12-LB. If SDI-12-LB fails to get the time from the server, SDI-12-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
++)))
++
++(((
++(% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
++)))
++
++
++(((
++**2. Manually Set Time**
++)))
++
++(((
++User needs to set SYNCMOD=0 to manual time, otherwise, the user set time will be overwritten by the time set by the server.
++)))
++
++
++=== 2.9.4 Poll sensor value ===
++
++
++User can poll sensor value based on timestamps from the server. Below is the downlink command.
++
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:438.778px" %)
++|(% style="background-color:#4f81bd; color:white; width:59px" %)**1byte**|(% style="background-color:#4f81bd; color:white; width:123px" %)**4bytes**|(% style="background-color:#4f81bd; color:white; width:114px" %)**4bytes**|(% style="background-color:#4f81bd; color:white; width:142.778px" %)**1byte**
++|(% style="width:58px" %)31|(% style="width:123px" %)Timestamp start|(% style="width:114px" %)Timestamp end|(% style="width:137px" %)(((
++Uplink Interval(range 5~~255s)
++)))
++
++Timestamp start and Timestamp end use Unix TimeStamp format as mentioned above. Devices will reply with all data log during this time period, use the uplink interval.
++
++For example, downlink command (% _mstmutation="1" %)**31 67E24660 67E26280 05**(%%)
++
++Is to check 2025/03/25 06:00:00 to 2025/03/25 08:00:00's data
++
++Uplink Internal =5s, means RS485-LB will send one packet every 5s.
++
++
++=== 2.9.5 Datalog Uplink payload ===
++
++
++The Datalog poll reply uplink will use below payload format.
++
++**Retrieval data payload:**
++
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:480px" %)
++|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
++**Size(bytes)**
++)))|=(% style="width: 100px; background-color: rgb(79, 129, 189); color: white;" %)**4**|=(% style="width: 100px; background-color: rgb(79, 129, 189); color: white;" %)**1**|=(% style="width: 220px; background-color: rgb(79, 129, 189); color: white;" %)**Length depends on the return from the commands**
++|(% style="width:97px" %)Value|(% style="width:104px" %)Unix Time Stamp|(% style="width:109px" %)Payload Length|(% style="width:165px" %)Data returned by the sensor
++
++**Example:**
++
++If SDI-12-LB has below data inside Flash:
++
++(Soil sensors using the SDI-12 protocol are used for testing.)
++
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 88px; background-color:#4F81BD;color:white" %)Flash Add|=(% style="width: 98px; background-color: rgb(79, 129, 189); color: white;" %)**Unix Time**|=(% style="width: 82px; background-color: rgb(79, 129, 189); color: white;" %)Payload Length|=(% style="width: 86px; background-color: rgb(79, 129, 189); color: white;" %)**BAT voltage**|=(% style="width: 92px; background-color: rgb(79, 129, 189); color: white;" %)Payload Version|=(% style="width: 64px; background-color:#4F81BD;color:white" %)**Value**
++|(% style="width:89px" %)(((
++0001
++)))|(% style="width:98px" %)(((
++2025/3/25 08:09:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)(((
++0c a8
++)))|(% style="width:92px" %)01|(% style="width:131px" %)(((
++08 21
++)))
++|(% style="width:89px" %)0002|(% style="width:98px" %)(((
++2025/3/25 08:10:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)(((
++0c ae
++)))|(% style="width:92px" %)01|(% style="width:131px" %)(((
++08 22
++)))
++|(% style="width:89px" %)0003|(% style="width:98px" %)(((
++2025/3/25 08:11:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
++|(% style="width:89px" %)0004|(% style="width:98px" %)(((
++2025/3/25 08:12:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
++|(% style="width:89px" %)0005|(% style="width:98px" %)(((
++2025/3/25 08:13:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)(((
++0c b4
++)))|(% style="width:92px" %)01|(% style="width:131px" %)08 23
++|(% style="width:89px" %)0006|(% style="width:98px" %)(((
++2025/3/25 08:14:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
++|(% style="width:89px" %)0007|(% style="width:98px" %)(((
++2025/3/25 08:15:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)0c b4|(% style="width:92px" %)01|(% style="width:131px" %)08 23
++|(% style="width:89px" %)0008|(% style="width:98px" %)(((
++2025/3/25 08:16:30
++)))|(% style="width:82px" %)5|(% style="width:86px" %)0c ae|(% style="width:92px" %)01|(% style="width:131px" %)08 22
++
++If user sends below downlink command:  (% style="background-color:yellow" %)3167E264BA67E2665E05
++
++Where : Start time: 67E264BA = time 2025/3/25 08:09:30
++
++             Stop time: 67E2665E= time 2025/3/25 08:16:30
++
++
++**SDI-12-LB will uplink this payload.**
++
++**67E264BA 05 0CA8 01 0821** 67E264F6050CAE01082267E26532050CAE01082267E2656E050CAE01082267E265AA050CB401082367E265E6050CAE01082267E26622050CB401082367E2665E050CAE010822
++
++
++Where the first 10 bytes is for the first entry:
++
++67E264BA050CA8010821
++
++Unix Time Stamp: 67E264BA(H)=1742890170(D)  ~-~->  time=2025-03-25 8:09:30
++
++Payload Length: 0x05(H)=5 bytes
++
++Battery voltage: 0x0CA8(H)=3240 mV
++
++Payload Version:  01
++
++Value: For the distance sensor used for testing, this value is the mm distance value, 0x0821(H)=2081mm.
++
++
++
  = 3. Configure SDI-12-LB/LS via AT Command or LoRaWAN Downlink =
@@ -1093,8 +1093,8 @@
  (% style="color:blue" %)**AT Command: AT+TDC**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Command Example**|=(% style="width: 160px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 160px; background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 160px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 190px;background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:157px" %)AT+TDC=?|(% style="background-color:#f2f2f2; width:166px" %)Show current transmit Interval|(% style="background-color:#f2f2f2" %)(((
  OK
@@ -1121,8 +1121,8 @@
  (% style="color:blue" %)**AT Command: AT+INTMOD**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 160px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 196px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 160px;background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:154px" %)AT+INTMOD=?|(% style="background-color:#f2f2f2; width:196px" %)Show current interrupt mode|(% style="background-color:#f2f2f2; width:157px" %)(((
  OK
@@ -1152,8 +1152,8 @@
  (% style="color:blue" %)**AT Command: AT+3V3T**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:474px" %)
--|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 201px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 120px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:474px" %)
++|=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 201px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 120px;background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:154px" %)AT+3V3T=?|(% style="background-color:#f2f2f2; width:201px" %)Show 3V3 open time.|(% style="background-color:#f2f2f2; width:116px" %)(((
  OK
@@ -1172,7 +1172,7 @@
  (% style="color:blue" %)**AT Command: AT+5VT**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %)
--|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 119px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 196px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 119px;background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:155px" %)AT+5VT=?|(% style="background-color:#f2f2f2; width:196px" %)Show 5V open time.|(% style="background-color:#f2f2f2; width:114px" %)(((
  OK
@@ -1193,7 +1193,7 @@
  (% style="color:blue" %)**(The v1.2 version is enabled for 1 second by default, and the version below v1.2 is disabled by default)**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:443px" %)
--|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 199px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 89px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 199px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 89px;background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:156px" %)AT+12VT=?|(% style="background-color:#f2f2f2; width:199px" %)Show 12V open time.|(% style="background-color:#f2f2f2; width:83px" %)(((
  OK
@@ -1223,8 +1223,8 @@
  (% style="color:blue" %)**AT Command: AT+ALLDATAMOD**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
--|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:437px" %)
++|=(% style="background-color:#4F81BD;color:white" %)**Command Example**|=(% style="background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2" %)AT+ALLDATAMOD=?|(% style="background-color:#f2f2f2" %)Show current all data mode|(% style="background-color:#f2f2f2" %)(((
  OK
@@ -1245,8 +1245,8 @@
  (% style="color:blue" %)**AT Command: AT+DATAUP**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 266px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 266px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:154px" %)AT+DATAUP =?|(% style="background-color:#f2f2f2; width:266px" %)Show current splicing payload for uplink mode|(% style="background-color:#f2f2f2" %)(((
  OK
@@ -1279,8 +1279,8 @@
  (% style="color:blue" %)**AT Command: AT+PAYVER**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:437px" %)
--|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 192px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
++(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:437px" %)
++|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 192px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
  |(% style="background-color:#f2f2f2; width:158px" %)AT+PAYVER=?|(% style="background-color:#f2f2f2; width:192px" %)Show current payload version|(% style="background-color:#f2f2f2" %)(((
  OK
@@ -1343,11 +1343,35 @@
  When downloading the images, choose the required image file for download.
++== 7.4 Why is the data uploaded to the LoRaWAN platform node empty and fProt~=0? ==
++
++
++This is due to The length of bytes sent by the node is limited by the lorawan protocol, and the fixed DR needs to be adjusted to improve this problem.
++
++Please refer to the following link for the number of bytes limited by different frequencies and different DRs in the lorawan protocol
++
++[[lora-alliance.org/wp-content/uploads/2021/05/RP002-1.0.3-FINAL-1.pdf>>url:https://lora-alliance.org/wp-content/uploads/2021/05/RP002-1.0.3-FINAL-1.pdf]]
++
++Example:
++
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LN%20%E2%80%93%20RS485%20to%20LoRaWAN%20Converter/WebHome/image-20240620145456-1.png?rev=1.1||alt="image-20240620145456-1.png"]]
++
++Please refer to the following command to fix DR
++
++AT+ADR=0
++
++AT+DR=3
++
++Downlink command:
++
++[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.4DataRate>>url:http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.4DataRate]]
++
++
  = 8. Order Info =
  (((
--(% style="color:blue" %)**Part Number: SDI-12-LB-XX-YY or SDI-12-LS-XX-YY**
++**Part Number: (% style="color:blue" %)SDI-12-LB-XX-YY(%%) or (% style="color:blue" %)SDI-12-LS-XX-YY(%%)**
  )))
  (((
@@ -1384,7 +1384,6 @@
  * Package Size / pcs : cm
  * Weight / pcs : g
--
  = 10. Support =

image-20240423143921-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.kai

Size

...	...	@@ -1,0 +1,1 @@
	1	+43.8 KB

Content

image-20240423145522-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.kai

Size

...	...	@@ -1,0 +1,1 @@
	1	+709.9 KB

Content

image-20240423151202-3.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.kai

Size

...	...	@@ -1,0 +1,1 @@
	1	+45.6 KB

Content

image-20240423162322-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.kai

Size

...	...	@@ -1,0 +1,1 @@
	1	+87.5 KB

Content

image-20240423162811-5.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.kai

Size

...	...	@@ -1,0 +1,1 @@
	1	+45.6 KB

Content

image-20240423162851-6.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.kai

Size

...	...	@@ -1,0 +1,1 @@
	1	+45.6 KB

Content

image-20240823165402-1.jpeg

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+580.7 KB

Content

image-20240823165526-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+63.0 KB

Content

image-20240903152517-1.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+11.5 KB

Content

image-20240903152627-2.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+36.2 KB

Content

image-20240903152650-3.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+22.7 KB

Content

image-20240903152742-4.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+5.2 MB

Content

image-20240903153004-5.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+1.1 MB

Content

image-20240903153258-6.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+22.4 KB

Content

image-20240903153627-7.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+21.2 KB

Content

image-20240903153727-8.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+102.0 KB

Content

image-20240903153854-9.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+214.8 KB

Content

image-20240903154020-10.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+100.9 KB

Content

image-20241118164859-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+51.6 KB

Content

image-20241118165221-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+37.2 KB

Content

image-20241118165746-3.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+89.4 KB

Content

image-20241118165832-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.ting

Size

...	...	@@ -1,0 +1,1 @@
	1	+27.2 KB

Content

image-20250329133856-1.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+31.2 KB

Content

image-20250329133946-2.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+29.6 KB

Content

image-20250329134001-3.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+59.0 KB

Content

image-20250416150535-1.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+47.6 KB

Content

image-20250416151346-2.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+79.6 KB

Content

image-20250416151406-3.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+44.8 KB

Content

image-20250416151419-4.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+47.6 KB

Content

image-20250416154628-5.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+40.4 KB

Content

image-20250416154700-6.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+65.6 KB

Content

image-20250416154716-7.jpeg

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+50.8 KB

Content

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

Summary

Details

Applications

Navigation