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

edited by Xiaoling
on 2023/02/01 09:45

To version < 37.2 >

edited by Xiaoling
on 2023/02/01 10:02

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 2 added, 0 removed)
- 1675216282284-923.png
- 1675216779406-595.png

Details

Page properties

Content

@@ -269,7 +269,7 @@
  **Parameter:  **aa: ASCII value of SDI-12 sensor address in downlink or HEX value in AT Command)
--**Example :   **AT+ADDRI=0  ( Equal to downlink: 0x AA 00 30)
++**Example :   **AT+ADDRI=0  ( Equal to downlink: 0x AA 00 30)
  The following is the display information on the serial port and the server.
@@ -387,7 +387,7 @@
  [[image:image-20230201092208-15.png||height="214" width="1140"]]
--=== 2.3.2 Advance SDI-12 Debug command ===
++=== 2.3.2 Advance SDI-12 Debug command ===
  This command can be used to debug all SDI-12 command.
@@ -421,7 +421,6 @@
  [[image:image-20230201092355-17.png||height="426" width="1135"]]
--
  === 2.3.3 Convert ASCII to String ===
@@ -443,9 +443,6 @@
  [[image:1675214856590-846.png]]
--
--
--
  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
@@ -484,7 +484,7 @@
  (% border="1" style="background-color:#f7faff; width:436px" %)
  |(% style="width:433px" %)(((
--AT+DATACUTx=a,b,c
++**AT+DATACUTx=a,b,c**
  **a**:  length for the return of AT+COMMAND
@@ -493,13 +493,14 @@
  **c**:  define the position for valid value.
  )))
--For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” ,. Below AT+DATACUT1 will get different result to combine payload:
++For example, if return from AT+COMMAND1 is “013METER   TER12 112T12-00024895” , Below AT+DATACUT1 will get different result to combine payload:
--|AT+DATACUT1 value|Final Result to combine Payload
--|34,1,1+2+3|0D 00 01 30 31 33
--|34,2,1~~8+12~~16|0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
--|34,2,1~~34|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
++(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
++|(% style="width:170px" %)**AT+DATACUT1 value**|(% style="width:338px" %)**Final Result to combine Payload**
++|(% style="width:170px" %)34,1,1+2+3|(% style="width:338px" %)0D 00 01 30 31 33
++|(% style="width:170px" %)34,2,1~~8+12~~16|(% style="width:338px" %)0D 00 01 30 31 33 4D 45 54 45 52 54 45 52 31 32
++|(% style="width:170px" %)34,2,1~~34|(% style="width:338px" %)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
  * ** Downlink Payload:**
@@ -513,21 +513,17 @@
  Where:
--* MM: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
--* NN:  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
--* LL:   The length of AT+COMMAND or AT+DATACUT command
--* XX XX XX XX: AT+COMMAND or AT+DATACUT command
--* YY:   If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
++* **MM **: the AT+COMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
++* **NN **:  1: set the AT+DATACUT value ; 2: set the AT+DATACUT value.
++* **LL **:   The length of AT+COMMAND or AT+DATACUT command
++* **XX XX XX XX **: AT+COMMAND or AT+DATACUT command
++* **YY **:   If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
--Example:
++**Example:**
--**AF 03 01 07 30 4D 43 21 01 01 01 00**: Same as AT+COMMAND3=**0MC!**,** 1**,** 1**,** 1**
++[[image:image-20230201094129-18.png]]
--**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
--**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
--
--
  **Clear SDI12 Command**
  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
@@ -547,23 +547,22 @@
--
  **command combination**
  Below shows a screen shot how the results combines together to a uplink payload.
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
++[[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.
++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.
--**AT+ALLDATAMOD** will simply get all return and don’t do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
++**AT+ALLDATAMOD** will simply get all return and don't do CRC check as result for SDI-12 command. AT+DATACUTx command has higher priority, if AT+DATACUTx has been set, AT+ALLDATAMOD will be ignore for this SDI-12 command.
--For example:  as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
++**For example: ** as below photo, AT+ALLDATAMOD=1, but AT+DATACUT1 has been set, AT+DATACUT1 will be still effect the result.
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
++[[image:1675215782925-448.png]]
  If AT+ALLDATAMOD=1, **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.
@@ -572,6 +572,7 @@
  **Compose Uplink**
++
  **AT+DATAUP=0**
  Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
@@ -581,7 +581,7 @@
  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
++[[image:1675215828102-844.png]]
  **AT+DATAUP=1**
@@ -590,7 +590,7 @@
  Final Payload is
--**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
++__**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**__
 . Battery Info (2 bytes): Battery voltage
 . PAYVER (1 byte): Defined by AT+PAYVER
@@ -598,26 +598,24 @@
 . 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:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
++[[image:1675215848113-696.png]]
  **Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
--   ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
++*    For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
++*    For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
++*    For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
++*    For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
--   * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
++**~ When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
--   * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
++**~ When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
--   ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
--   *** When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
++== 2.4 Uplink Payload ==
--**~      When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value.**
--1.
--11. Uplink Payload
--
  Uplink payloads have two types:
  * Distance Value: Use FPORT=2
@@ -626,24 +626,23 @@
  The application server should parse the correct value based on FPORT settings.
--1.
--11.
--111. Device Payload, FPORT=5
++=== 2.4.1 Device Payload, FPORT~=5 ===
++
  Include device configure status. Once SDI-12-LB Joined the network, it will uplink this message to the server.
--
  Users can also use the downlink command(0x26 01) to ask SDI-12-LB to resend this uplink.
++(% border="1" cellspacing="4" style="background-color:#f7faff; width:437px" %)
++|(% colspan="6" style="width:434px" %)**Device Status (FPORT=5)**
++|(% style="width:102px" %)**Size (bytes)**|(% style="width:67px" %)**1**|(% style="width:80px" %)**2**|(% style="width:89px" %)**1**|(% style="width:52px" %)**1**|(% style="width:44px" %)**2**
++|(% style="width:102px" %)**Value**|(% style="width:67px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:89px" %)Frequency Band|(% style="width:52px" %)Sub-band|(% style="width:44px" %)BAT
--|(% colspan="6" %)**Device Status (FPORT=5)**
--|**Size (bytes)**|**1**|**2**|**1**|**1**|**2**
--|**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT
--
  Example parse in TTNv3
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]]
++[[image:1675215946738-635.png]]
++
  **Sensor Model**: For SDI-12-LB, this value is 0x17
  **Firmware Version**: 0x0100, Means: v1.0.0 version
@@ -697,10 +697,9 @@
  Ex2: 0x0B49 = 2889mV
--1.
--11.
--111. Uplink Payload, FPORT=2
++=== 2.4.2 Uplink Payload, FPORT~=2 ===
++
  There are different cases for uplink. See below
  * SDI-12 Debug Command return: FPORT=100
@@ -707,30 +707,24 @@
  * Periodically Uplink: FPORT=2
--|(((
--**Size**
--
--**(bytes)**
--)))|**2**|**1**|**Length depends on the return from the commands**
--|**Value**|(((
++(% border="1" cellspacing="4" style="background-color:#f7faff; width:510px" %)
++|(% style="width:93px" %)(((
++**Size(bytes)**
++)))|(% style="width:83px" %)**2**|(% style="width:70px" %)**1**|(% style="width:234px" %)**Length depends on the return from the commands**
++|(% style="width:93px" %)**Value**|(% style="width:83px" %)(((
  Battery(mV)
--
  &
--
  Interrupt_Flag
--)))|[[PAYLOAD_VER>>path:#Probe_Model]]|(((
--If the valid payload is too long and exceed the maximum support
--
++)))|(% style="width:70px" %)[[PAYLOAD_VER>>path:#Probe_Model]]|(% style="width:234px" %)(((
++If the valid payload is too long and exceed the maximum support.
  Payload length in server,server will show payload not provided in the LoRaWAN server.
  )))
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]]
++[[image:1675216282284-923.png]]
++=== 2.4.3 Battery Info ===
--1.
--11.
--111. Battery Info
  Check the battery voltage for SDI-12-LB.
@@ -739,216 +739,37 @@
  Ex2: 0x0B49 = 2889mV
--1.
--11.
--111. Interrupt Pin
++=== 2.4.4 Interrupt Pin ===
++
  This data field shows if this packet is generated by **Interrupt Pin** or not. [[Click here>>path:#Int_mod]] for the hardware and software set up. Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>path:#pins]].
++**Example:**
--Example:
--
  Ex1: 0x0B45:0x0B&0x80= 0x00    Normal uplink packet.
  Ex2: 0x8B49:0x8B&0x80= 0x80    Interrupt Uplink Packet.
--1.
--11.
--111. Payload version
++=== 2.4.5 Payload version ===
++=== 2.4.6 Decode payload in The Things Network ===
--1.
--11.
--111. Decode payload in The Things Network
--
  While using TTN network, you can add the payload format to decode the payload.
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.png]]
++[[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.
++SDI-12-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
--下面的解码生成超链接放进去.
--function Decoder(bytes, port) {
--  if(port==5)
--
--  {
--
--       var freq_band;
--
--       var sub_band;
--
--    var sensor;
--
--
--    if(bytes[0]==0x17)
--
--      sensor= "SDI12-LB";
--
--
--           var firm_ver= (bytes[1]&0x0f)+'.'+(bytes[2]>>4&0x0f)+'.'+(bytes[2]&0x0f);
--
--
--    if(bytes[3]==0x01)
--
--        freq_band="EU868";
--
--       else if(bytes[3]==0x02)
--
--        freq_band="US915";
--
--       else if(bytes[3]==0x03)
--
--        freq_band="IN865";
--
--       else if(bytes[3]==0x04)
--
--        freq_band="AU915";
--
--       else if(bytes[3]==0x05)
--
--        freq_band="KZ865";
--
--       else if(bytes[3]==0x06)
--
--        freq_band="RU864";
--
--       else if(bytes[3]==0x07)
--
--        freq_band="AS923";
--
--       else if(bytes[3]==0x08)
--
--        freq_band="AS923_1";
--
--       else if(bytes[3]==0x09)
--
--        freq_band="AS923_2";
--
--       else if(bytes[3]==0x0A)
--
--        freq_band="AS923_3";
--
--       else if(bytes[3]==0x0F)
--
--        freq_band="AS923_4";
--
--       else if(bytes[3]==0x0B)
--
--        freq_band="CN470";
--
--       else if(bytes[3]==0x0C)
--
--        freq_band="EU433";
--
--       else if(bytes[3]==0x0D)
--
--        freq_band="KR920";
--
--       else if(bytes[3]==0x0E)
--
--        freq_band="MA869";
--
--
--    if(bytes[4]==0xff)
--
--      sub_band="NULL";
--
--           else
--
--      sub_band=bytes[4];
--
--
--    var bat= (bytes[5]<<8 | bytes[6])/1000;
--
--
--       return {
--
--         SENSOR_MODEL:sensor,
--
--      FIRMWARE_VERSION:firm_ver,
--
--      FREQUENCY_BAND:freq_band,
--
--      SUB_BAND:sub_band,
--
--      BAT:bat,
--
--       }
--
--  }
--
--  else if(port==100)
--
--  {
--
--      var datas_sum={};
--
--      for(var j=0;j<bytes.length;j++)
--
--      {
--
--        var datas= String.fromCharCode(bytes[j]);
--
--        if(j=='0')
--
--          datas_sum.datas_sum=datas;
--
--        else
--
--          datas_sum.datas_sum+=datas;
--
--      }
--
--
--      return datas_sum;
--
--  }
--
--  else
--
--  {
--
--      var decode={};
--
--      decode.EXTI_Trigger= (bytes[0] & 0x80)? "TRUE":"FALSE";
--
--      decode.BatV= ((bytes[0]<<8 | bytes[1])&0x7FFF)/1000;
--
--      decode.Payver= bytes[2];
--
--      for(var i=3;i<bytes.length;i++)
--
--      {
--
--        var data= String.fromCharCode(bytes[i]);
--
--        if(i=='3')
--
--          decode.data_sum=data;
--
--        else
--
--          decode.data_sum+=data;
--
--      }
--
--      return decode;
--
--  }
--
--
--}
--
--
--1.
++1.
 . Uplink Interval
  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:
@@ -957,7 +957,7 @@
--1.
++1.
 . Frequency Plans
  The SDI12-LB 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.
@@ -967,7 +967,7 @@
--1.
++1.
 . Firmware Change Log
  **Firmware download link:**
@@ -1006,7 +1006,7 @@
--1.
++1.
 . Set Transmit Interval Time
  Feature: Change LoRaWAN End Node Transmit Interval.
@@ -1036,7 +1036,7 @@
  * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
  * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
--1.
++1.
 . Set Interrupt Mode
  Feature, Set Interrupt mode for GPIO_EXIT.
@@ -1069,7 +1069,7 @@
  * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
  * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
--1.
++1.
 . Set the output time
  Feature, Control the output 3V3 , 5V or 12V.
@@ -1150,7 +1150,7 @@
  * Example 5: Downlink Payload: 070301F4  -> AT+12VT=500
  * Example 6: Downlink Payload: 07030000  -> AT+12VT=0
--1.
++1.
 .   Set the all data mode
  Feature, Set the all data mode.
@@ -1173,7 +1173,7 @@
  * Example 1: Downlink Payload: AB 00 ~/~/ AT+ALLDATAMOD=0
  * Example 2: Downlink Payload: AB 01 ~/~/ AT+ALLDATAMOD=1
--1.
++1.
 .   Set the splicing payload for uplink
  Feature, splicing payload for uplink.
@@ -1214,7 +1214,7 @@
  This means that the interval is set to 0x000014=20S
--1.
++1.
 .   Set the payload version
  Feature, Set the payload version.
@@ -1253,7 +1253,7 @@
  SDI-12-LB:  2.45v ~~ 3.6v
--1.
++1.
 . Replace Battery
  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
@@ -1262,7 +1262,7 @@
--1.
++1.
 . Power Consumption Analyze
  Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
@@ -1302,14 +1302,14 @@
 .
--11.
++11.
 . Battery Note
  The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
--1.
--11.
++1.
++11.
 . Replace the battery
  You can change the battery in the SDI-12-LB.The type of battery is not limited as long as the output is between 3v to 3.6v.  On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won’t be voltage drop between battery and main board.
@@ -1330,7 +1330,7 @@
  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]
--1.
++1.
 . AT Command Set
 . OTA firmware update
@@ -1363,7 +1363,6 @@
  * Weight / pcs : g
--
 . Support
  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.

1675216282284-923.png

Author

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

Size

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

Content

1675216779406-595.png

Author

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

Size

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

Content

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

Summary

Details

Applications

Navigation