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

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

To version < 37.1 >

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

Change comment: Uploaded new attachment "1675216779406-595.png", version {1}

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

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,6 +421,7 @@
  [[image:image-20230201092355-17.png||height="426" width="1135"]]
++
  === 2.3.3 Convert ASCII to String ===
@@ -442,6 +442,9 @@
  [[image:1675214856590-846.png]]
++
++
++
  === 2.3.4 Define periodically SDI-12 commands and uplink. ===
@@ -516,6 +516,7 @@
  * **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:**
  [[image:image-20230201094129-18.png]]
@@ -549,7 +549,7 @@
  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.
@@ -564,7 +564,6 @@
  **Compose Uplink**
--
  **AT+DATAUP=0**
  Compose the uplink payload with value returns in sequence and send with A SIGNLE UPLINK.
@@ -617,13 +617,14 @@
  The application server should parse the correct value based on FPORT settings.
--=== 2.4.1 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**
@@ -633,7 +633,6 @@
  [[image:1675215946738-635.png]]
--
  **Sensor Model**: For SDI-12-LB, this value is 0x17
  **Firmware Version**: 0x0100, Means: v1.0.0 version
@@ -687,9 +687,10 @@
  Ex2: 0x0B49 = 2889mV
--=== 2.4.2 Uplink Payload, FPORT~=2 ===
++1.
++11.
++111. Uplink Payload, FPORT=2
--
  There are different cases for uplink. See below
  * SDI-12 Debug Command return: FPORT=100
@@ -696,24 +696,30 @@
  * Periodically Uplink: FPORT=2
--(% 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" %)(((
++|(((
++**Size**
++
++**(bytes)**
++)))|**2**|**1**|**Length depends on the return from the commands**
++|**Value**|(((
  Battery(mV)
++
  &
++
  Interrupt_Flag
--)))|(% style="width:70px" %)[[PAYLOAD_VER>>path:#Probe_Model]]|(% style="width:234px" %)(((
--If the valid payload is too long and exceed the maximum support.
++)))|[[PAYLOAD_VER>>path:#Probe_Model]]|(((
++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:1675216282284-923.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]]
--=== 2.4.3 Battery Info ===
++1.
++11.
++111. Battery Info
  Check the battery voltage for SDI-12-LB.
@@ -722,37 +722,216 @@
  Ex2: 0x0B49 = 2889mV
--=== 2.4.4 Interrupt Pin ===
++1.
++11.
++111. 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.
--=== 2.4.5 Payload version ===
++1.
++11.
++111. 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:1675216779406-595.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.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) {
--1.
++  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.
 . 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:
@@ -761,7 +761,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.
@@ -771,7 +771,7 @@
--1.
++1.
 . Firmware Change Log
  **Firmware download link:**
@@ -810,7 +810,7 @@
--1.
++1.
 . Set Transmit Interval Time
  Feature: Change LoRaWAN End Node Transmit Interval.
@@ -840,7 +840,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.
@@ -873,7 +873,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.
@@ -954,7 +954,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.
@@ -977,7 +977,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.
@@ -1018,7 +1018,7 @@
  This means that the interval is set to 0x000014=20S
--1.
++1.
 .   Set the payload version
  Feature, Set the payload version.
@@ -1057,7 +1057,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.
@@ -1066,7 +1066,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.
@@ -1106,14 +1106,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.
@@ -1134,7 +1134,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
@@ -1167,6 +1167,7 @@
  * 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.

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

Summary

Details

Applications

Navigation