Changes for page LDDS45 - LoRaWAN Distance Detection Sensor User Manual

Last modified by Mengting Qiu on 2025/02/26 15:04

From version < 26.2 >

edited by Xiaoling
on 2022/06/07 14:57

To version < 13.1 >

edited by Xiaoling
on 2022/06/07 14:02

Change comment: Uploaded new attachment "1654581735133-458.png", version {1}

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -5,9 +5,7 @@
--**Contents:**
--{{toc/}}
@@ -17,9 +17,6 @@
--
--
--
  = 1. Introduction =
  == 1.1 What is LoRaWAN Soil pH Sensor ==
@@ -55,6 +55,7 @@
  * IP68 rate for the Sensor Probe
  * 8500mAh Battery for long term use
++
  == 1.3 Probe Specification ==
@@ -75,10 +75,13 @@
  * IP68 Protection
  * Length: 3.5 meters
++
++
  == 1.4 Applications ==
  * Smart Agriculture
++
  == 1.5 Pin mapping and power on ==
  [[image:1654580482666-473.png]]
@@ -113,7 +113,7 @@
  )))
  (((
--(% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LSPH01.
++**Step 1**: Create a device in TTN with the OTAA keys from LSPH01.
  )))
  (((
@@ -150,7 +150,7 @@
  [[image:1654581517630-991.png]]
--(% style="color:blue" %)**Step 2**(%%): Power on LSPH01
++**Step 2**: Power on LSPH01
  Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
@@ -158,43 +158,50 @@
  [[image:image-20220607135918-2.png]]
--(% style="color:blue" %)**Step 3**(%%)**:** The LSPH01 will auto join to the TTN network. After join success, it will start to upload messages to TTN and you can see the messages in the panel.
++**Step 3:** The LSPH01 will auto join to the TTN network. After join success, it will start to upload messages to TTN and you can see the messages in the panel.
  [[image:1654581590132-631.png]]
--== 2.3 Uplink Payload ==
++1.
++11. Uplink Payload
  LSPH01 will uplink payload via LoRaWAN with below payload format:
++
  Uplink payload includes in total 11 bytes.
++
  Normal uplink payload:
--(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
  |(((
  **Size**
  **(bytes)**
  )))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
--|**Value**|[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(((
--[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
++|**Value**|[[BAT>>path:#bat]]|(((
++[[Temperature>>path:#DS18B20]]
--[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
--)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
--[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
++[[( Optional )>>path:#DS18B20]]
++)))|[[Soil pH>>path:#Soil_Nitrogen]]|[[Soil Temperature>>path:#Soil_Phosphorus]]|(((
++[[Digital Interrupt>>path:#Int_pin]]
++
++[[(Optional)>>path:#Int_pin]]
  )))|Reserve|(((
--[[Message Type>>||anchor="H2.3.6MessageType"]]
++[[Message>>path:#Message_Type]]
++
++[[Type>>path:#Message_Type]]
  )))
--[[image:1654581735133-458.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
--=== 2.3.1 Battery Info ===
++1.
++11.
++111. Battery Info
--
  Check the battery voltage for LSPH01.
  Ex1: 0x0B45 = 2885mV
@@ -202,12 +202,13 @@
  Ex2: 0x0B49 = 2889mV
++1.
++11.
++111. DS18B20 Temperature sensor
--=== 2.3.2 DS18B20 Temperature sensor ===
++This is optional, user can connect external DS18B20 sensor to the [[+3.3v, 1-wire and GND pin>>path:#DS18B20]] . and this field will report temperature.
--This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
--
  **Example**:
  If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
@@ -216,35 +216,40 @@
--=== 2.3.3 Soil pH ===
++1.
++11.
++111. Soil pH
  Range: 0 ~~ 14 pH
--**Example:**
++Example:
--(% style="color:#037691" %)** 0x02B7(H) = 695(D) = 6.95pH**
++**0x02B7(H) = 695(D) = 6.95pH**
++1.
++11.
++111. Soil Temperature
--=== 2.3.4 Soil Temperature ===
--
  Get Soil Temperature
  **Example**:
--If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
++If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
--If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
++If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
--=== 2.3.5 Interrupt Pin ===
++1.
++11.
++111. Interrupt Pin
--This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up.
++This data field shows if this packet is generated by interrupt or not. [[Click here>>path:#Int_mod]] for the hardware and software set up.
--**Example:**
++Example:
 x00: Normal uplink packet.
@@ -251,166 +251,183 @@
 x01: Interrupt Uplink Packet.
++1.
++11.
++111. Message Type
--=== 2.3.6 Message Type ===
--
  For a normal uplink payload, the message type is always 0x01.
  Valid Message Type:
--(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
--|**Message Type Code**|**Description**|**Payload**
--|0x01|Normal Uplink|[[Normal Uplink Payload>>||anchor="H2.3Uplink Payload"]]
--|0x02|Reply configures info|[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
--|0x03|Reply Calibration Info|[[Calibration Payload>>||anchor="H2.7Calibration"]]
++|Message Type Code|Description|Payload
++|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#Normal_Uplink]]
++|0x02|Reply configures info|[[Configure Info Payload>>path:#Configure_Info_Payload]]
++|0x03|Reply Calibration Info|[[Calibration Payload>>path:#Calibration_Payload]]
++1.
++11.
++111. Decode payload in The Things Network
--
--=== 2.3.7 Decode payload in The Things Network ===
--
  While using TTN network, you can add the payload format to decode the payload.
--[[image:1654582541848-906.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
--(((
  The payload decoder function for TTN is here:
--)))
--(((
  LSPH01 TTN Payload Decoder: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSNPK01/Decoder/]]
--)))
++1.
++11. Uplink Interval
--== 2.4 Uplink Interval ==
++The LSPH01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link:
--The LSPH01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
++[[http:~~/~~/wiki.dragino.com/index.pHp?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval]]
--== 2.5 Show Data in DataCake IoT Server ==
++1.
++11. Show Data in DataCake IoT Server
  [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
--(% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
++**Step 1**: Be sure that your device is programmed and properly connected to the network at this time.
--(% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**
++**Step 2**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:
--[[image:1654583683416-869.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
--[[image:1654583694084-878.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
--(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
++Step 3: Create an account or log in Datacake.
--(% style="color:blue" %)**Step 4**(%%)**: Create LSPH01 product.**
++Step 4: Create LSPH01 product.
--[[image:1654583711590-413.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
--[[image:1654583732798-193.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
--[[image:1654583749683-259.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
--(% style="color:blue" %)**Step 5**(%%)**: add payload decode**
++Step 5: add payload decode
  Download Datacake decoder from: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSNPK01/Decoder/]]
--[[image:1654583770974-935.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
--[[image:1654583781517-146.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
--[[image:1654583791351-557.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
  After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
--[[image:1654583805491-713.png]]
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
--== 2.6 Installation and Maintain ==
--=== 2.6.1 Before measurement ===
--(((
++1.
++11. Installation and Maintain
++111. Before measurement
++
  If the LSPH01 has more than 7 days not use or just clean the pH probe. User should put the probe inside pure water for more than 24 hours for activation. If no put in water, user need to put inside soil for more than 24 hours to ensure the measurement accuracy.
--)))
++1.
++11.
++111. Measurement
--=== 2.6.2 Measurement ===
++**Measurement the soil surface**
--(% style="color:#4f81bd" %)**Measurement the soil surface:**
++[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]] Choose the proper measuring position. Split the surface soil according to the measured deep.
--[[image:1654584128046-287.png]]
--Choose the proper measuring position. Split the surface soil according to the measured deep.
--
  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
++
  Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
++
  Put soil over the probe after insert. And start to measure.
--(% style="color:#4f81bd" %)**Measurement inside soil:**
++**Measurement inside soil**
++
++
  Dig a hole with diameter > 20CM.
++
  Insert the probe inside, method like measure the surface.
++1.
++11.
++111. Maintain Probe
++1111. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
++1111. After long time use (3~~ 6  months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it.
++1111. Probe reference electrode is also no strong, need to avoid strong force or hitting.
++1111. User should keep reference electrode wet while not use.
++1111. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
++1111. The probe is IP68 can be put in water.
--=== 2.6.3 Maintain Probe ===
++1.
++11. Calibration
--1. (((
--pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
--)))
--1. (((
--After long time use (3~~ 6  months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it.
--)))
--1. (((
--Probe reference electrode is also no strong, need to avoid strong force or hitting.
--)))
--1. (((
--User should keep reference electrode wet while not use.
--)))
--1. (((
--Avoid the probes to touch oily matter. Which will cause issue in accuracy.
--)))
--1. (((
--The probe is IP68 can be put in water.
++User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable).
--
--)))
++**After stable, user can use below command to calibrate.**
--== 2.7 Calibration ==
--User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable).
++|**pH buffer solution**|**AT Command to calibrate**|**Downlink Command**|**Read Cal Value**
++|**4.00**|**AT+PHCAL=4**|(((
++**0x13 04**
--After stable, user can use below command to calibrate.
++**Reply with Calibrate payload**
++)))|(((
++**AT+PHCAL=?**
--[[image:image-20220607144936-3.png]]
++**Example 41,61,91**
++)))
++|**6.86**|**AT+PHCAL=6**|(((
++**0x13 06**
++**Reply with Calibrate payload**
++)))|**AT+PHCAL=?**
++|**9.18**|**AT+PHCAL=9**|(((
++**0x13 09**
++**Reply with Calibrate payload**
++)))|**AT+PHCAL=?**
++|**Factory Default**|**AT+PHCAL=15**|(((
++**0x13 15**
--(% style="color:#037691" %)**Calibration Payload**
++**Reply with Calibrate payload**
++)))|(((
++**AT+PHCAL=?**
--(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
++**Example 151**
++)))
++
++Calibration Payload
++
  |(((
  **Size**
@@ -425,26 +425,29 @@
  Calibrate value
  )))|Reserve|(((
--[[Message Type>>||anchor="H2.3.6MessageType"]]
++[[Message>>path:#Message_Type]]
++[[Type>>path:#Message_Type]]
++
  Always 0x03
  )))
  User can also send 0x14 downlink command to poll the current calibration payload.
--[[image:image-20220607145603-4.png]]
++|**Downlink Control Type**|**FPort**|**Type Code**|**Downlink payload size(bytes)**
++|Get Calibration Version Info|Any|14|2
++
  * Reply to the confirmation package: 14 01
  * Reply to non-confirmed packet: 14 00
++1.
++11. Frequency Plans
--
--Frequency Plans
--
  The LSPH01 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.
--1.
--11.
++1.
++11.
 . EU863-870 (EU868)
  Uplink:
@@ -475,8 +475,8 @@
 .525 - SF9BW125 (RX2 downlink only)
--1.
--11.
++1.
++11.
 . US902-928(US915)
  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
@@ -490,8 +490,8 @@
  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
--1.
--11.
++1.
++11.
 . CN470-510 (CN470)
  Used in China, Default use CHE=1
@@ -536,8 +536,8 @@
 .3 - SF12BW125 (RX2 downlink only)
--1.
--11.
++1.
++11.
 . AU915-928(AU915)
  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
@@ -551,8 +551,8 @@
  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
  * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
--1.
--11.
++1.
++11.
 . AS920-923 & AS923-925 (AS923)
  **Default Uplink channel:**
@@ -604,8 +604,8 @@
 .2 - SF10BW125 (RX2)
--1.
--11.
++1.
++11.
 . KR920-923 (KR920)
  Default channel:
@@ -641,8 +641,8 @@
 .9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
--1.
--11.
++1.
++11.
 . IN865-867 (IN865)
  Uplink:
@@ -661,7 +661,7 @@
 .550 - SF10BW125 (RX2)
--1.
++1.
 . LED Indicator
  The LSPH01 has an internal LED which is to show the status of different state.
@@ -670,7 +670,7 @@
  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
  * Blink once when device transmit a packet.
--1.
++1.
 . Firmware Change Log
  **Firmware download link:**
@@ -716,7 +716,7 @@
  These commands only valid for LSPH01, as below:
--1.
++1.
 . Set Transmit Interval Time
  Feature: Change LoRaWAN End Node Transmit Interval.
@@ -746,7 +746,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.
@@ -779,7 +779,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.
 . Calibrate Sensor
  Detail See [[Calibration Guide>>path:#Calibration]] for the user of 0x13 and 0x14 downlink commands
@@ -786,7 +786,7 @@
--1.
++1.
 . Get Firmware Version Info
  Feature: use downlink to get firmware version.
@@ -895,7 +895,7 @@
  LSPH01:  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.
@@ -904,7 +904,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.
@@ -944,14 +944,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 LSPH01.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.
@@ -1040,4 +1040,3 @@
  [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
--

1654582541848-906.png

Author

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

Size

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

Content

1654583683416-869.png

Author

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

Size

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

Content

1654583694084-878.png

Author

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

Size

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

Content

1654583711590-413.png

Author

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

Size

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

Content

1654583732798-193.png

Author

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

Size

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

Content

1654583749683-259.png

Author

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

Size

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

Content

1654583770974-935.png

Author

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

Size

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

Content

1654583781517-146.png

Author

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

Size

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

Content

1654583791351-557.png

Author

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

Size

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

Content

1654583805491-713.png

Author

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

Size

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

Content

1654584128046-287.png

Author

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

Size

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

Content

image-20220607144936-3.png

Author

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

Size

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

Content

image-20220607145603-4.png

Author

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

Size

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

Content

Changes for page LDDS45 - LoRaWAN Distance Detection Sensor User Manual

Summary

Details

Applications

Navigation