Changes for page N95S31B -- NB-IoT Temperature & Humidity Sensor User Manual

Last modified by Mengting Qiu on 2024/04/02 16:44

From 31.3 to 31.4 From 43.1 to 44.1

From version 31.4

edited by Xiaoling
on 2022/06/06 17:23

Change comment: There is no comment for this version

To version 43.1

edited by Xiaoling
on 2022/07/08 10:12

Change comment: Uploaded new attachment "image-20220708101224-1.png", version {1}

Raw
Rendered

Summary

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

Details

Page properties

Title

@@ -1,1 +1,1 @@
--LSE01-LoRaWAN Soil Moisture & EC Sensor User Manual
++NSE01 - NB-IoT Soil Moisture & EC Sensor User Manual

Content

@@ -1,5 +1,5 @@
  (% style="text-align:center" %)
--[[image:image-20220606151504-2.jpeg||height="848" width="848"]]
++[[image:image-20220606151504-2.jpeg||height="554" width="554"]]
@@ -8,35 +8,38 @@
++
++
++
++**Table of Contents:**
++
++
++
++
++
++
  = 1. Introduction =
  == 1.1 What is LoRaWAN Soil Moisture & EC Sensor ==
  (((
--The Dragino LSE01 is a (% style="color:#4f81bd" %)**LoRaWAN Soil Moisture & EC Sensor**(%%) for IoT of Agriculture. It is designed to measure the soil moisture of saline-alkali soil and loamy soil. The soil sensor uses FDR method to calculate the soil moisture with the compensation from soil temperature and conductivity. It also has been calibrated in factory for Mineral soil type.
--)))
++
--(((
--It detects (% style="color:#4f81bd" %)**Soil Moisture**(%%), (% style="color:#4f81bd" %)**Soil Temperature**(%%) and (% style="color:#4f81bd" %)**Soil Conductivity**(%%), and uploads the value via wireless to LoRaWAN IoT Server.
--)))
++Dragino NSE01 is an **NB-IOT soil moisture & EC sensor** for agricultural IoT. Used to measure the soil moisture of saline-alkali soil and loam. The soil sensor uses the FDR method to calculate soil moisture and compensates it with soil temperature and electrical conductivity. It has also been calibrated for mineral soil types at the factory.
--(((
--The LoRa wireless technology used in LES01 allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
--)))
++It can detect **Soil Moisture, Soil Temperature and Soil Conductivity**, and upload its value to the server wirelessly.
--(((
--LES01 is powered by (% style="color:#4f81bd" %)**4000mA or 8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 10 years.
--)))
++The wireless technology used in NSE01 allows the device to send data at a low data rate and reach ultra-long distances, providing ultra-long-distance spread spectrum Communication.
--(((
--Each LES01 is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
++NSE01 are powered by **8500mAh Li-SOCI2** batteries, which can be used for up to 5 years.
++
++
  )))
--
  [[image:1654503236291-817.png]]
--[[image:1654503265560-120.png]]
++[[image:1657245163077-232.png]]
@@ -85,7 +85,7 @@
  )))
  (((
--In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H3.UsingtheATCommands"]].
++In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H3.200BUsingtheATCommands"]].
  )))
@@ -101,7 +101,7 @@
  The LG308 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.
--**Step 1**: Create a device in TTN with the OTAA keys from LSE01.
++(% style="color:blue" %)**Step 1**(%%):  Create a device in TTN with the OTAA keys from LSE01.
  Each LSE01 is shipped with a sticker with the default device EUI as below:
@@ -122,7 +122,7 @@
--**Step 2**: Power on LSE01
++(% style="color:blue" %)**Step 2**(%%): Power on LSE01
  Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
@@ -130,7 +130,7 @@
  [[image:image-20220606163915-7.png]]
--**Step 3:** The LSE01 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.
++(% style="color:blue" %)**Step 3**(%%)**:** The LSE01 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:1654504778294-788.png]]
@@ -138,86 +138,104 @@
  == 2.3 Uplink Payload ==
++
  === 2.3.1 MOD~=0(Default Mode) ===
  LSE01 will uplink payload via LoRaWAN with below payload format:
--
++(((
  Uplink payload includes in total 11 bytes.
--
++)))
++(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
  |(((
  **Size**
  **(bytes)**
  )))|**2**|**2**|**2**|**2**|**2**|**1**
--|**Value**|[[BAT>>path:#bat]]|(((
++|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
  Temperature
  (Reserve, Ignore now)
--)))|[[Soil Moisture>>path:#soil_moisture]]|[[Soil Temperature>>path:#soil_tem]]|[[Soil Conductivity (EC)>>path:#EC]]|(((
++)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|(((
  MOD & Digital Interrupt
  (Optional)
  )))
--[[image:1654504881641-514.png]]
--
--
--
  === 2.3.2 MOD~=1(Original value) ===
  This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
++(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
  |(((
  **Size**
  **(bytes)**
  )))|**2**|**2**|**2**|**2**|**2**|**1**
--|**Value**|[[BAT>>path:#bat]]|(((
++|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
  Temperature
  (Reserve, Ignore now)
--)))|[[Soil Moisture>>path:#soil_moisture]](raw)|[[Soil Temperature>>path:#soil_tem]]|[[Soil Conductivity (EC)>>path:#EC]](raw)|(((
++)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|(((
  MOD & Digital Interrupt
  (Optional)
  )))
--[[image:1654504907647-967.png]]
--
--
--
  === 2.3.3 Battery Info ===
++(((
  Check the battery voltage for LSE01.
++)))
++(((
  Ex1: 0x0B45 = 2885mV
++)))
++(((
  Ex2: 0x0B49 = 2889mV
++)))
  === 2.3.4 Soil Moisture ===
++(((
  Get the moisture content of the soil. The value range of the register is 0-10000(Decimal), divide this value by 100 to get the percentage of moisture in the soil.
++)))
++(((
  For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
++)))
++(((
++
++)))
++(((
  (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
++)))
  === 2.3.5 Soil Temperature ===
++(((
   Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is 0x09 0xEC, the temperature content in the soil is
++)))
++(((
  **Example**:
++)))
++(((
  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
++)))
++(((
  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
++)))
@@ -252,7 +252,7 @@
  mod=(bytes[10]>>7)&0x01=1.
--Downlink Command:
++**Downlink Command:**
  If payload = 0x0A00,  workmode=0
@@ -267,19 +267,21 @@
  [[image:1654505570700-128.png]]
++(((
  The payload decoder function for TTN is here:
++)))
--LSE01 TTN Payload Decoder: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Payload_Decoder/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Payload_Decoder/]]
++(((
++LSE01 TTN Payload Decoder: [[https:~~/~~/www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0>>https://www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0]]
++)))
  == 2.4 Uplink Interval ==
--The LSE01 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 LSE01 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 Downlink Payload ==
  By default, LSE50 prints the downlink payload to console port.
@@ -287,24 +287,44 @@
  [[image:image-20220606165544-8.png]]
--**Examples:**
++(((
++(% style="color:blue" %)**Examples:**
++)))
++(((
++
++)))
--* **Set TDC**
++* (((
++(% style="color:blue" %)**Set TDC**
++)))
++(((
  If the payload=0100003C, it means set the END Node’s TDC to 0x00003C=60(S), while type code is 01.
++)))
++(((
  Payload:    01 00 00 1E    TDC=30S
++)))
++(((
  Payload:    01 00 00 3C    TDC=60S
++)))
++(((
++
++)))
--* **Reset**
++* (((
++(% style="color:blue" %)**Reset**
++)))
++(((
  If payload = 0x04FF, it will reset the LSE01
++)))
--* **CFM**
++* (% style="color:blue" %)**CFM**
  Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
@@ -312,12 +312,21 @@
  == 2.6 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:
++)))
++(((
++
++)))
--**Step 1**: Be sure that your device is programmed and properly connected to the network at this time.
++(((
++(% style="color:blue" %)**Step 1**(%%):   Be sure that your device is programmed and properly connected to the network at this time.
++)))
--**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:
++(((
++(% 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:
++)))
  [[image:1654505857935-743.png]]
@@ -325,11 +325,12 @@
  [[image:1654505874829-548.png]]
--Step 3: Create an account or log in Datacake.
--Step 4: Search the LSE01 and add DevEUI.
++(% style="color:blue" %)**Step 3**(%%)**:**   Create an account or log in Datacake.
++(% style="color:blue" %)**Step 4**(%%)**:**   Search the LSE01 and add DevEUI.
++
  [[image:1654505905236-553.png]]
@@ -625,7 +625,6 @@
  * Solid ON for 5 seconds once device successful Join the network.
  * Blink once when device transmit a packet.
--
  == 2.9 Installation in Soil ==
  **Measurement the soil surface**
@@ -634,31 +634,53 @@
  [[image:1654506634463-199.png]]
  (((
++(((
  Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting.
  )))
++)))
  [[image:1654506665940-119.png]]
++(((
  Dig a hole with diameter > 20CM.
++)))
++(((
  Horizontal insert the probe to the soil and fill the hole for long term measurement.
++)))
  == 2.10 Firmware Change Log ==
++(((
  **Firmware download link:**
++)))
++(((
  [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Firmware/]]
++)))
++(((
++
++)))
++(((
  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
++)))
++(((
++
++)))
++(((
  **V1.0.**
++)))
++(((
  Release
++)))
  == 2.11 Battery Analysis ==
@@ -665,27 +665,31 @@
  === 2.11.1 Battery Type ===
++(((
  The LSE01 battery is a combination of a 4000mAh Li/SOCI2 Battery and a Super Capacitor. The battery is non-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
++)))
--
++(((
  The battery is designed to last for more than 5 years for the LSN50.
++)))
--
  (((
++(((
  The battery-related documents are as below:
  )))
++)))
  * (((
--[[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],
++[[Battery Dimension>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
  )))
  * (((
--[[Lithium-Thionyl Chloride Battery  datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
++[[Lithium-Thionyl Chloride Battery  datasheet>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
  )))
  * (((
--[[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]]
++[[Lithium-ion Battery-Capacitor datasheet>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]], [[Tech Spec>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]]
  )))
-- [[image:image-20220606171726-9.png]]
++ [[image:image-20220610172436-1.png]]
@@ -720,13 +720,13 @@
  LSE01 supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to LSE01 for using AT command, as below.
--[[image:1654501986557-872.png]]
++[[image:1654501986557-872.png||height="391" width="800"]]
  Or if you have below board, use below connection:
--[[image:1654502005655-729.png]]
++[[image:1654502005655-729.png||height="503" width="801"]]
@@ -733,10 +733,10 @@
  In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSE01. LSE01 will output system info once power on as below:
-- [[image:1654502050864-459.png]]
++ [[image:1654502050864-459.png||height="564" width="806"]]
--Below are the available commands, a more detailed AT Command manual can be found at [[AT Command Manual>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/]]: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/]]
++Below are the available commands, a more detailed AT Command manual can be found at [[AT Command Manual>>https://www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0]]: [[https:~~/~~/www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0>>https://www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0]]
  (% style="background-color:#dcdcdc" %)**AT+<CMD>=?AT+<CMD>? **(%%)                   : Help on <CMD>
@@ -848,20 +848,38 @@
  == 4.1 How to change the LoRa Frequency Bands/Region? ==
--You can follow the instructions for [[how to upgrade image>>path:#3ygebqi]].
++(((
++You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
  When downloading the images, choose the required image file for download.
++)))
++(((
++
++)))
++(((
  How to set up LSE01 to work in 8 channel mode By default, the frequency bands US915, AU915, CN470 work in 72 frequencies. Many gateways are 8 channel gateways, and in this case, the OTAA join time and uplink schedule is long and unpredictable while the end node is hopping in 72 frequencies.
++)))
++(((
++
++)))
++(((
  You can configure the end node to work in 8 channel mode by using the AT+CHE command. The 500kHz channels are always included for OTAA.
++)))
++(((
++
++)))
++(((
  For example, in **US915** band, the frequency table is as below. By default, the end node will use all channels (0~~71) for OTAA Join process. After the OTAA Join, the end node will use these all channels (0~~71) to send uplink packets.
++)))
  [[image:image-20220606154726-3.png]]
++
  When you use the TTN network, the US915 frequency bands use are:
  * 903.9 - SF7BW125 to SF10BW125
@@ -874,37 +874,47 @@
  * 905.3 - SF7BW125 to SF10BW125
  * 904.6 - SF8BW500
++(((
  Because the end node is now hopping in 72 frequency, it makes it difficult for the devices to Join the TTN network and uplink data. To solve this issue, you can access the device via the AT commands and run:
--(% class="box infomessage" %)
--(((
--**AT+CHE=2**
++* (% style="color:#037691" %)**AT+CHE=2**
++* (% style="color:#037691" %)**ATZ**
  )))
--(% class="box infomessage" %)
  (((
--**ATZ**
--)))
++
  to set the end node to work in 8 channel mode. The device will work in Channel 8-15 & 64-71 for OTAA, and channel 8-15 for Uplink.
++)))
++(((
++
++)))
++(((
  The **AU915** band is similar. Below are the AU915 Uplink Channels.
++)))
  [[image:image-20220606154825-4.png]]
++== 4.2 Can I calibrate LSE01 to different soil types? ==
++LSE01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/&file=Calibrate_to_other_Soil_20220605.pdf]].
++
++
  = 5. Trouble Shooting =
--== 5.1 Why I can’t join TTN in US915 / AU915 bands? ==
++== 5.1 Why I can't join TTN in US915 / AU915 bands? ==
--It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]] section above for details.
++It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H7.19EightChannelMode"]] section above for details.
--== 5.2 AT Command input doesn’t work ==
++== 5.2 AT Command input doesn't work ==
--In the case if user can see the console output but can’t type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn’t send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
++(((
++In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
++)))
  == 5.3 Device rejoin in at the second uplink packet ==
@@ -916,7 +916,9 @@
  (% style="color:#4f81bd" %)**Cause for this issue:**
++(((
  The fuse on LSE01 is not large enough, some of the soil probe require large current up to 5v 800mA, in a short pulse. When this happen, it cause the device reboot so user see rejoin.
++)))
  (% style="color:#4f81bd" %)**Solution: **
@@ -923,7 +923,7 @@
  All new shipped LSE01 after 2020-May-30 will have this to fix. For the customer who see this issue, please bypass the fuse as below:
--[[image:1654500929571-736.png]]
++[[image:1654500929571-736.png||height="458" width="832"]]
  = 6. Order Info =
@@ -948,10 +948,17 @@
  * (% style="color:red" %)**4**(%%): 4000mAh battery
  * (% style="color:red" %)**8**(%%): 8500mAh battery
++(% class="wikigeneratedid" %)
++(((
++
++)))
++
  = 7. Packing Info =
  (((
--**Package Includes**:
++
++
++(% style="color:#037691" %)**Package Includes**:
  )))
  * (((
@@ -960,10 +960,8 @@
  (((
--)))
--(((
--**Dimension and weight**:
++(% style="color:#037691" %)**Dimension and weight**:
  )))
  * (((
@@ -977,6 +977,8 @@
  )))
  * (((
  Weight / pcs : g
++
++
  )))
  = 8. Support =
@@ -983,5 +983,3 @@
  * 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.
  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[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]]
--
--

1657245163077-232.png

Author

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

Size

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

Content

image-20220610172436-1.png

Author

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

Size

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

Content

image-20220708101224-1.png

Author

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

Size

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

Content

Changes for page N95S31B -- NB-IoT Temperature & Humidity Sensor User Manual

Summary

Details

Applications

Navigation