Last modified by Xiaoling on 2025/07/16 11:58
From version 135.1
edited by Mengting Qiu
on 2025/01/17 19:04
on 2025/01/17 19:04
Change comment:
There is no comment for this version
To version 135.2
edited by Mengting Qiu
on 2025/01/17 19:42
on 2025/01/17 19:42
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -19,43 +19,40 @@ 19 19 20 20 = 1. Introduction = 21 21 22 -== 1.1 What is LoRaWAN Soil Moisture & EC Sensor ==22 +== 1.1 What is SE0X-NB/NS NB-IoT Soil Moisture & EC Sensor == 23 23 24 24 25 -The Dragino SE0X-NB/NS is a (% style="color:blue" %)** LoRaWAN Soil Moisture & EC Sensor**(%%) for Agri-IoT with up to 4 sensor probes. It is designed to measure the (% style="color:blue" %)**soil moisture of saline-alkali soil and loamy soil**(%%). The soil sensor uses (% style="color:blue" %)**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.25 +The Dragino SE0X-NB/NS is a (% style="color:blue" %)**NB-IoT Soil Moisture & EC Sensor**(%%) for Agri-IoT with up to 4 sensor probes. It is designed to measure the (% style="color:blue" %)**soil moisture of saline-alkali soil and loamy soil**(%%). The soil sensor uses (% style="color:blue" %)**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. 26 26 27 -It detects (% style="color:blue" %)**Soil Moisture**(%%), (% style="color:blue" %)**Soil Temperature**(%%) and (% style="color:blue" %)**Soil Conductivity**(%%), and upload sthevalue viawireless to LoRaWANServer.27 +It detects (% style="color:blue" %)**Soil Moisture**(%%), (% style="color:blue" %)**Soil Temperature**(%%) and (% style="color:blue" %)**Soil Conductivity**(%%), and then upload to IoT server via NB-IoT network*. 28 28 29 - The LoRa wireless technology used inSE0X-NB/NSallows deviceto send dataandreach extremelyngrangesatlowdata-rates.It provides ultra-longrange spread spectrum communicationand high interference immunitywhilst minimizingcurrentconsumption.29 +SE0X-NB/NS supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP, MQTTs or CoAP**(%%) for different application requirement. and Support Uplinks to various IoT Servers. 30 30 31 31 SE0X-NB/NS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 32 32 33 -SE0X-NB/NS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%) ** ,**5years.33 +SE0X-NB/NS 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 several years. 34 34 35 -Each SE0X-NB/NS 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. 36 - 37 37 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20240524144002-3.png?rev=1.1||alt="image-20240524144002-3.png"]] 38 38 39 39 == 1.2 Features == 40 40 41 41 42 -* LoRaWAN 1.0.3 Class A 43 -* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 40 +* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD 44 44 * Ultra-low power consumption 45 45 * Up to 4 external sensor probes, probe length: 2.5 meters 46 46 * Monitor Soil Moisture 47 47 * Monitor Soil Temperature 48 48 * Monitor Soil Conductivity 49 -* Support Bluetooth v5.1 and LoRaWAN remote configure 50 -* Support wireless OTA update firmware 46 +* IP66 Waterproof Enclosure 47 +* Multiply Sampling and one uplink 48 +* Support Bluetooth v5.1 remote configure and update firmware 49 +* Uplink on periodically 51 51 * AT Commands to change parameters 52 52 * Downlink to change configure 53 -* IP66 Waterproof Enclosure 54 -* 8500mAh Li/SOCl2 Battery 52 +* 8500mAh Li/SOCl2 Battery (SE0X-NB) 53 +* Solar panel + 3000mAh Li-ion battery (CSE0X-NS) 54 +* Nano SIM card slot for NB-IoT SIM 55 55 56 -== 1.3 Specification == 57 - 58 - 59 59 (% style="color:blue" %)**Common DC Characteristics:** 60 60 61 61 * Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v ... ... @@ -82,13 +82,30 @@ 82 82 * Accuracy: 2%FS 83 83 * Measure Method: Conductivity , with temperature compensate 84 84 85 -(% style="color:blue" %)** LoRaSpec:**82 +(% style="color:blue" %)**NB-IoT Spec:** 86 86 87 -* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 88 -* Max +22 dBm constant RF output vs. 89 -* RX sensitivity: down to -139 dBm. 90 -* Excellent blocking immunity 84 +(% style="color:#037691" %)**NB-IoT Module: BC660K-GL** 91 91 86 +(% style="color:#037691" %)**Support Bands:** 87 + 88 +* B1 @H-FDD: 2100MHz 89 +* B2 @H-FDD: 1900MHz 90 +* B3 @H-FDD: 1800MHz 91 +* B4 @H-FDD: 2100MHz 92 +* B5 @H-FDD: 860MHz 93 +* B8 @H-FDD: 900MHz 94 +* B12 @H-FDD: 720MHz 95 +* B13 @H-FDD: 740MHz 96 +* B17 @H-FDD: 730MHz 97 +* B18 @H-FDD: 870MHz 98 +* B19 @H-FDD: 870MHz 99 +* B20 @H-FDD: 790MHz 100 +* B25 @H-FDD: 1900MHz 101 +* B28 @H-FDD: 750MHz 102 +* B66 @H-FDD: 2000MHz 103 +* B70 @H-FDD: 2000MHz 104 +* B85 @H-FDD: 700MHz 105 + 92 92 (% style="color:blue" %)**Battery:** 93 93 94 94 * Li/SOCI2 un-chargeable battery ... ... @@ -110,9 +110,9 @@ 110 110 == 1.5 Sleep mode and working mode == 111 111 112 112 113 -(% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.127 +(% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life. 114 114 115 -(% style="color:blue" %)**Working Mode:** LoRaWAN Sensor to JoinLoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.129 +(% style="color:blue" %)**Working Mode:**(%%) In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode. 116 116 117 117 118 118 == 1.6 Button & LEDs == ... ... @@ -123,22 +123,23 @@ 123 123 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 124 124 |=(% 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** 125 125 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 126 -If sensor is alreadyJoined toLoRaWAN network, sensor will send an uplink packet,140 +If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led**(%%) will blink once. 127 127 Meanwhile, BLE module will be active and user can connect via BLE to configure device. 128 128 ))) 129 129 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 130 -(% style="color:green" %)**Green led**(%%) JOINLoRaWAN network.131 -(% style="color:green" %)**Green led**(%%) 132 -Once sensor is active, BLE module will be active and user can connect via BLE to configure device, join or notjoinLoRaWANnetwork.144 +(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to attach NB-IoT network. 145 +(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 146 +Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not. 133 133 ))) 134 134 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode. 135 135 150 +(% style="color:red" %)**Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.** 151 + 136 136 == 1.7 BLE connection == 137 137 138 138 139 -SE0X-NB/NS support BLE remote configure. 155 +SE0X-NB/NS support BLE remote configure and firmware update. 140 140 141 - 142 142 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case: 143 143 144 144 * Press button to send an uplink ... ... @@ -150,202 +150,194 @@ 150 150 151 151 == 1.8 Pin Definitions == 152 152 153 -[[image:i mage-20240604165452-2.jpeg||height="501" width="825"]]168 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20231103172153-1.png?rev=1.1||alt="image-20231103172153-1.png"]] 154 154 170 +=== 1.8.1 Jumper JP2 === 155 155 156 - ==1.9Mechanical==172 +Power on Device when put this jumper. 157 157 158 -=== 1.9.1 for LB version === 159 159 175 +=== 1.8.2 BOOT MODE / SW1 === 160 160 161 -(% style="color:blue" %)** MainDeviceDimension:**177 +**1)** (% style="color:blue" %)**ISP:**(%%) upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run. 162 162 163 - [[image:Main.UserManualforLoRaWAN EndNodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]]179 +**2)** (% style="color:blue" %)**Flash:**(%%) work mode, device starts to work and send out console output for further debug 164 164 165 165 166 - [[image:Main.UserManual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]]182 +=== 1.8.3 Reset Button === 167 167 184 +Press to reboot the device. 168 168 169 -[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 170 170 187 +=== 1.8.4 SIM Card Direction === 171 171 172 - (%style="color:blue"%)**ProbeDimension:**189 +See this link. [[How to insert SIM Card>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]]. 173 173 174 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/image-20221008135912-1.png?rev=1.1||alt="image-20221008135912-1.png"]] 175 175 192 +== 1.9 Mechanical == 176 176 177 - =2. ConfigureSE0X-NB/NS to connectto LoRaWAN network =194 +(% style="color:blue" %)**Main Device Dimension:** 178 178 179 - == 2.1Howitworks==196 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]] 180 180 181 181 182 - The SE0X-NB/NSis configuredas(% style="color:#037691"%)**LoRaWAN OTAA Class A**(%%) mode by default.It has OTAA keys tojoin LoRaWAN network.To connect a localLoRaWAN network, you needtoinput theOTAA keysin theLoRaWANIoTservernd pressthe button to activatetheSE0X-NB/NS. It will automatically join theetwork via OTAA andstart to send the sensorvalue. The default uplink interval is 20minutes.199 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]] 183 183 184 -(% style="display:none" %) (%%) 185 185 186 - == 2.2 Quickguideto connectto LoRaWAN server(OTAA) ==202 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 187 187 188 188 189 - Followingisan example for howto 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 inthisexample.205 +(% style="color:blue" %)**Probe Dimension:** 190 190 191 -[[image:image-202 41205143034-1.png]]207 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/image-20221008135912-1.png?rev=1.1||alt="image-20221008135912-1.png"]] 192 192 193 -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. 194 194 195 - (%style="display:none"%)210 +== 1.10 Installation in Soil == 196 196 212 +(% style="color:blue" %)**Measurement the soil surface** 197 197 198 - (% style="color:blue"%)**Step 1:**(%%)CreateadeviceinTTN with the OTAA keys from SE0X-NB/NS.214 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506634463-199.png?rev=1.1||alt="1654506634463-199.png"]] 199 199 200 - EachSE0X-NB/NSis shippedwith a stickerwiththe defaultdeviceEUIas below:216 +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. 201 201 202 -[[image:i mage-20230426084152-1.png||alt="图片-20230426084152-1.png"height="233" width="502"]]218 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506665940-119.png?rev=1.1||alt="1654506665940-119.png"]] 203 203 220 +Dig a hole with diameter > 20CM. 204 204 205 - You canenter thiskeyintheLoRaWANServerportal.BelowisTTNscreenshot:222 +Horizontal insert the probe to the soil and fill the hole for long term measurement. 206 206 207 207 208 - (%style="color:blue" %)**Registerthedevice(Enterend devicespecifics manually):**225 += 2. Use SE0X-NB/NS to communicate with IoT Server = 209 209 210 - [[image:image-20240603135829-1.png||height="815"width="956"]]227 +== 2.1 Send data to IoT server via NB-IoT network == 211 211 212 212 213 - (%style="color:blue"%)**AddAPPEUI,DEVEUI andAppKey:**230 +The SE0X-NB/NS is equipped with a NB-IoT module, the pre-loaded firmware in SE0X-NB/NS will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by SE0X-NB/NS. 214 214 215 - [[image:image-20240603135934-2.png]]232 +Below shows the network structure: 216 216 234 +(% style="display:none" %) (%%) [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20240524143914-2.png?width=793&height=295&rev=1.1||alt="image-20240524143914-2.png"]] 217 217 218 218 219 -(% style="color:blue" %)** Step 2:**(%%)Activate237 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1T**(%%) version of SE0X-NB/NS. 220 220 221 221 222 - Pressthebuttonfor5seconds toactivate the SE0X-NB/NS.240 +(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set SE0X-NB/NS send data to IoT server. 223 223 224 - (%style="color:green"%)**Greenled**(%%)will fast blink5 times,devicewill enter (%style="color:blue" %)**OTA mode**(%%) for 3 seconds.Andthen startto JOINLoRaWAN network. (% style="color:green" %)**Greenled**(%%) will solidly turnon for 5 secondsafterjoinedin network.242 +* Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]]. 225 225 226 - Afterjoinsuccess,itwillstarttouploadmessagestoTTNandyouseehesages inhepanel.244 +* Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]]. 227 227 246 +Below shows result of different server as a glance. 228 228 229 -== 2.3 Uplink Payload == 230 - 231 -=== 2.3.1 MOD~=0(Default Mode), FPORT~=2(% style="display:none" %) (%%) === 232 - 233 - 234 -SE0X-LB will uplink payload via LoRaWAN with below payload format: 235 - 236 -((% style="color:red" %)**Note: When 4 sensors are recognized, the number of bytes in the uplink is 29; 237 - When 3 sensors are recognized, the number of uplink bytes is 23; 238 - When 2 sensors are recognized, the number of bytes in the upper row is 17; 239 - When 1 sensor is recognized, the number of bytes in the uplink is 11;**(%%)) 240 - 241 -((( 242 -Uplink payload to recognize 4 sensors 29 bytes as an example. 248 +(% border="1" cellspacing="4" style="width:515px" %) 249 +|(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments** 250 +|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20230819113244-8.png?width=367&height=183&rev=1.1||alt="image-20230819113244-8.png"]]((( 251 + 252 +)))|(% style="width:170px" %) 253 +|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20230819113244-9.png?width=367&height=119&rev=1.1||alt="image-20230819113244-9.png"]]((( 254 + 255 +)))|(% style="width:170px" %) 256 +|(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %) 257 +|(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %) 258 +|(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %) 259 +|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20230819113244-10.png?width=367&height=104&rev=1.1||alt="image-20230819113244-10.png"]]((( 260 + 261 +)))|(% style="width:170px" %) 262 +|(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SE02-NB_NB-IoT_Soil_Moisture%26EC_Sensor_User_Manual/WebHome/image-20230819113244-11.png?width=367&height=141&rev=1.1||alt="image-20230819113244-11.png"]]((( 263 + 243 243 ))) 244 244 245 - [[image:image-20241104200506-7.png]]266 +(% style="color:blue" %)**1T Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to ThingsEye. User Just need to select the sensor type in ThingsEyeand Activate SE0X-NB/NS and user will be able to see data in ThingsEye. See here for [[ThingsEye Config Instruction>>url:https://wiki.thingseye.io/xwiki/bin/view/Main/]]. 246 246 247 247 248 - ExampleinTTN:269 +== 2.2 Payload Types == 249 249 250 -[[image:image-20241104190217-1.png||height="322" width="1359"]] 251 251 272 +To meet different server requirement, SE0X-NB/NS supports different payload type. 252 252 253 - === 2.3.2 MOD~=1(Originalvalue), FPORT~=2 ===274 +**Includes:** 254 254 276 +* [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5) 255 255 256 - Thismodecan get theoriginalAD valueof moistureandiginalconductivity(with temperaturedrift compensation).278 +* [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0) 257 257 258 -[[i mage:image-20241104200449-6.png]]280 +* [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1) 259 259 282 +* [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3) 260 260 261 - Example inTTN:284 +User can specify the payload type when choose the connection protocol. Example: 262 262 263 - [[image:image-20241104202257-8.png||height="347"width="1398"]]286 +(% style="color:#037691" %)**AT+PRO=2,0** (%%) ~/~/ Use UDP Connection & hex Payload 264 264 288 +(% style="color:#037691" %)**AT+PRO=2,5** (%%) ~/~/ Use UDP Connection & Json Payload 265 265 266 -= ==2.3.3DeviceStatus,FPORT~=5 ===290 +(% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload 267 267 268 268 269 -((( 270 -Users can use the downlink command(**0x26 01**) to ask SE0X-NB/NS to send device configure detail, include device configure status. SE0X-NB/NS will uplink a payload via FPort=5 to server. 293 +=== 2.2.1 General Json Format(Type~=5) === 271 271 272 -The Payload format is as below. 273 -))) 274 274 275 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:490px" %) 276 -|=(% colspan="6" style="background-color:#4F81BD;color:white" %)Device Status (FPORT=5) 277 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:140px" %)**2**|(% style="width:140px" %)**1**|(% style="width:70px" %)**1**|(% style="width:70px" %)**2** 278 -|(% style="width:94px" %)Value|(% style="width:68px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:86px" %)Frequency Band|(% style="width:61px" %)Sub-band|(% style="width:61px" %)BAT 296 +This is the General Json Format. As below: 279 279 280 - [[image:image-20241104190415-2.png]]298 +(% style="color:#4472c4" %)**{"IMEI":"863663062798914","IMSI":"460083513507314","Model":"SE02-NB","tem":21.0,"hum":19.4,"ec":7465,"tem2":20.8,"hum2":21.2,"ec2":8147,"interrupt":0,"interrupt_level":0,"battery":3.27,"signal":17,"time":"2024/11/23 01:06:52","1":[0.0,0.0,0,0.0,0.0,0,"2024/11/23 00:53:30"],"2":[0.0,0.0,0,0.0,0.0,0,"2024/11/23 00:38:30"],"3":[0.0,0.0,0,0.0,0.0,0,"2024/11/23 00:23:30"],"4":[0.0,0.0,0,0.0,0.0,0,"2024/11/23 00:08:30"],"5":[0.0,0.0,0,0.0,0.0,0,"2024/11/22 23:53:30"],"6":[0.0,0.0,0,0.0,0.0,0,"2024/11/22 23:38:30"],"7":[0.0,0.0,0,0.0,0.0,0,"2024/11/22 23:23:30"],"8":[0.0,0.0,0,0.0,0.0,0,"2024/11/22 23:08:30"]}** 281 281 282 282 283 - * (% style="color:#037691" %)**Sensor Model**(%%)**:** For SE0X-NB/NS, this valueis0xF9301 +[[image:image-20241123090826-1.png]] 284 284 285 - *(% style="color:#037691" %)**FirmwareVersion**(%%)**:**0x0100, Means:v1.0.0 version303 +(% style="color:red" %)**Notice, from above payload:** 286 286 287 -* (%style="color:#037691" %)**Frequency Band**(%%)**:**305 +* Temperature, Humidity, Soil conductivity, Temperature 2, Humidity 2, Soil conductivity 2, Interrupt, Interrupt_level, Battery, Signal & time are the value at uplink time. 288 288 289 - 0x01:EU868307 +* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+CLOCKLOG=1,65535,15,8** (%%)Command. Each entry includes (from left to right): Soil Temperature, Soil Moisture, Soil Conductivity(EC), Soil Temperature 2, Soil Moisture 2, Soil Conductivity 2(EC) & Sampling time. 290 290 291 - 0x02:US915309 +=== 2.2.2 HEX format Payload(Type~=0) === 292 292 293 -0x03: IN865 294 294 295 - 0x04:AU915312 +This is the HEX Format. As below: 296 296 297 -0 x05: KZ865314 +(% style="color:#4472c4" %)**f863663062798914f460083513507314366e0cd811010000079f08311da7084d081e1f9067412b770000000000000000000000006741278a000000000000000000000000674124060000000000000000000000006741208200000000000000000000000067411cfe0000000000000000000000006741197a000000000000000000000000674115f60000000000000000000000006741127200000000000000000000000067410eee** 298 298 299 -0 x06:RU864316 +[[image:image-20241204101833-1.png||height="235" width="1585"]] 300 300 301 -0x07: AS923 302 302 303 - 0x08:AS923-1319 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data. 304 304 305 -0 x09: AS923-2321 +[[image:image-20241123091112-2.png]] 306 306 307 -0x0a: AS923-3 308 308 309 - 0x0b:CN470324 +(% style="color:blue" %)**Version:** 310 310 311 - 0x0c:EU433326 +These bytes include the hardware and software version. 312 312 313 -0 x0d:KR920328 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x36 for SE0X-NB/NS 314 314 315 -0 x0e:MA869330 +(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x82=130, means firmware version 1.3.0 316 316 317 -* (% style="color:#037691" %)**Sub-Band**(%%)**:** 318 -** AU915 and US915: value 0x00 ~~ 0x08 319 -** CN470: value 0x0B ~~ 0x0C 320 -** Other Bands: Always 0x00 321 321 322 - *(% style="color:#037691" %)**Battery Info:**333 +(% style="color:blue" %)**BAT (Battery Info):** 323 323 324 -C heckthebattery voltage.335 +Ex1: 0x0CD1 = 3281mV 325 325 326 -Ex1: 0x0C8A = 3210mV 327 327 328 - Ex2:0x0B49=2889mV338 +(% style="color:blue" %)**Signal Strength:** 329 329 340 +NB-IoT Network signal Strength. 330 330 331 - ===2.3.4Battery Info===342 +**Ex1: 0x16 = 22** 332 332 344 +**0** -113dBm or less 333 333 334 -((( 335 -Check the battery voltage for SE0X-NB/NS. 336 -))) 346 +**1** -111dBm 337 337 338 -((( 339 -Ex1: 0x0C8A = 3210mV 340 -))) 348 +**2...30** -109dBm... -53dBm 341 341 342 -((( 343 -Ex2: 0x0B49 = 2889mV 344 -))) 350 +**31** -51dBm or greater 345 345 352 +**99** Not known or not detectable 346 346 347 -=== 2.3.5 Soil Moisture === 348 348 355 +(% style="color:blue" %)**Soil Moisture ** 349 349 350 350 ((( 351 351 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. ... ... @@ -356,9 +356,8 @@ 356 356 ))) 357 357 358 358 359 -= ==2.3.6Soil Temperature===366 +(% style="color:blue" %)**Soil Temperature ** 360 360 361 - 362 362 ((( 363 363 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 364 364 ))) ... ... @@ -376,9 +376,8 @@ 376 376 ))) 377 377 378 378 379 -= ==2.3.7Soil Conductivity (EC)===385 +(% style="color:blue" %)**Soil Conductivity (EC) ** 380 380 381 - 382 382 ((( 383 383 Obtain (% style="color:blue" %)**__soluble salt concentration__**(%%) in soil or (% style="color:blue" %)**__soluble ion concentration in liquid fertilizer__**(%%) or (% style="color:blue" %)**__planting medium__**(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000). 384 384 ))) ... ... @@ -391,183 +391,404 @@ 391 391 Generally, the EC value of irrigation water is less than 800uS / cm. 392 392 ))) 393 393 394 -((( 395 - 396 -))) 397 397 398 -= ==2.3.8MOD ===400 +(% style="color:blue" %)**TimeStamp: ** 399 399 402 +Unit TimeStamp Example: 665eb834(H) = 1717483572(D) 400 400 401 - SE0X-NB/NSsupportsangingmode.404 +Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time. 402 402 403 -**For example,** bytes[4]=0x0F 404 404 405 - mod=(bytes[4]>>7)&0x01=0.407 +=== 2.2.3 ThingsBoard Payload(Type~=3) === 406 406 407 407 408 - (%style="color:blue"%)**Downlink Command:**410 +Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. 409 409 410 -If payload = 0x0A00, workmode=0 412 +(% style="color:#4472c4" %)** { 413 + "topic": "2276492", 414 + "payload": { 415 + "IMEI": "863663062798930", 416 + "Model": "SE02-NB", 417 + "tem": 26.0, 418 + "hum": 47.6, 419 + "ec": 8806, 420 + "tem2": 26.0, 421 + "hum2": 55.0, 422 + "ec2": 8973, 423 + "interrupt": 0, 424 + "interrupt_level": 0, 425 + "battery": 3.29, 426 + "signal": 22, 427 + "1": [26.0, 47.6, 8915, 26.0, 55.0, 8918, "2024/06/04 07:08:13"], 428 + "2": [26.0, 47.6, 8933, 26.0, 55.0, 9028, "2024/06/04 07:06:13"], 429 + "3": [26.0, 47.6, 8907, 26.0, 55.1, 8907, "2024/06/04 07:04:13"], 430 + "4": [26.0, 47.6, 8845, 26.0, 55.0, 9044, "2024/06/04 07:02:13"], 431 + "5": [26.0, 47.6, 8917, 26.0, 55.1, 8985, "2024/06/04 07:00:13"], 432 + "6": [26.0, 47.5, 8883, 26.0, 55.0, 9041, "2024/06/04 06:58:13"], 433 + "7": [26.0, 47.6, 8965, 26.0, 55.0, 8952, "2024/06/04 06:56:13"], 434 + "8": [26.0, 47.6, 8844, 26.0, 55.0, 8994, "2024/06/04 06:54:13"] 435 + } 436 +}** 411 411 412 - If** **payload =** **0x0A01,orkmode=1438 +[[image:image-20240604151141-3.png||height="607" width="1279"]] 413 413 414 414 415 -=== 2. 3.9Interrupt_flag===441 +=== 2.2.4 ThingSpeak Payload(Type~=1) === 416 416 417 417 418 - Displayswhetherupstreampacketsaregeneratedbyinterrupt.444 +This payload meets ThingSpeak platform requirement. It includes six fields. Form 1~~8 are: 419 419 420 - **0:** Normaluplinkpacket.446 +Temperature, Humidity, Conduct soil, Temperature 2, Humidity 2, Conduct soil 2, Battery & Signal. This payload type only valid for ThingsSpeak Platform. 421 421 422 - **1:** InterruptUplink Packet.448 +As below: 423 423 424 -** For example,** bytes[4]=10450 +(% style="color:#4472c4" %)**field1=Temperature value&field2=Humidity value&field3=Conduct soil value&field4=Temperature 2 value&field5=Humidity 2 value&field6=Conduct soil 2 value&field7=Battery value&field8=Signal value** 425 425 426 - Interrupt_flag=bytes[4] &0x01=0.452 +[[image:image-20240604155822-4.png||height="577" width="870"]] 427 427 454 +[[image:image-20240604155827-5.png||height="563" width="870"]] 428 428 429 -=== 2.3.10 Sensor_flag === 430 430 457 +== 2.3 Test Uplink and Change Update Interval == 431 431 432 -Displays whether sensors are connected. 433 433 434 - **0:**Sensorconnection notdetected.460 +By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) 435 435 436 - **1:** Sensorconnectiondetected.462 +User can use below commands to change the (% style="color:blue" %)**uplink interval**. 437 437 438 - **Forexample,**s_flag=1111,.Representsrecognitiontofoursensors.464 +(% style="color:#037691" %)**AT+TDC=7200 ** (%%) ~/~/ Set Update Interval to 7200s 439 439 440 - Countingfromleft toright,466 +User can also push the button for more than 1 seconds to activate an uplink. 441 441 442 -The first number represents the **01** address sensor, 443 443 444 -T hesecondnumberrepresentsthe**02** address sensor;469 +== 2.4 Trggier an uplink by external interrupt == 445 445 446 -The third number represents the **03** address sensor; 447 447 448 - Thefourth number represents the**04**addresssensor.472 +SE0X-NB/NS has an external trigger interrupt function. Users can use the GPIO_EXIT pin to trigger the upload of data packets. 449 449 474 +(% style="color:blue" %)**AT command:** 450 450 476 +* (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode 451 451 452 - ===2.3.11Decode payloadinTheThingsNetwork ===478 +* (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt 453 453 480 +* (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge 454 454 455 - WhileusingTTNnetwork,youcanaddthepayloadformatto decodethe payload.482 +* (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 456 456 457 - [[image:image-20241104202548-9.png||height="621"width="1225"]]484 +* (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 458 458 459 - [[image:image-20241104202829-10.png||height="566"width="1223"]]486 +== 2.5 Clock logging (Since firmware version v1.2.1) == 460 460 461 -((( 462 -The payload decoder function for TTN is here: 463 -))) 464 464 465 -((( 466 -SE0X-NB/NS TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]] 489 +Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature. 467 467 468 - 469 -))) 491 +We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data. 470 470 471 - ==2.4UplinkInterval ==493 +* (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)** 472 472 495 +(% style="color:#037691" %)**a:**(%%)** 0:** Disable Clock logging. ** 1: **Enable Clock Logging 473 473 474 - TheSE0X-NB/NSbydefaultuplinkthesensor dataevery 20 minutes.UsercanchangethisintervalbyATCommandorLoRaWANDownlink Command.Seethislink: [[ChangeUplinkInterval>>doc:Main.EndDevice AT Commands andDownlinkCommand.WebHome||anchor="H4.1ChangeUplinkInterval"]]497 +(% style="color:#037691" %)**b: **(%%)Specify First sampling start second: range **(0 ~~ 3599, 65535) ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets. 475 475 499 +(% style="color:#037691" %)**c:**(%%)** **Specify the sampling interval: range **(0 ~~ 255 minutes)** 476 476 477 -= =2.5DownlinkPayload==501 +(% style="color:#037691" %)**d:**(%%)** **How many entries should be uplink on every TDC **(max 32)** 478 478 503 +(% style="color:red" %)**Note: To disable clock recording, set the following parameters: AT+CLOCKLOG=1,65535,0,0** 479 479 480 - By default, SE0X-NB/NSprints thedownlink payloadtoconsoleport.505 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1||alt="image-20240315141254-1.png"]] 481 481 482 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:480px" %) 483 -|=(% style="width: 184px; background-color:#4F81BD;color:white" %)**Downlink Control Type**|=(% style="width: 56px; background-color:#4F81BD;color:white" %)FPort|=(% style="width: 94px; background-color:#4F81BD;color:white" %)**Type Code**|=(% style="width: 146px; background-color:#4F81BD;color:white" %)**Downlink payload size(bytes)** 484 -|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4 485 -|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2 486 -|(% style="width:183px" %)AT+CFM|(% style="width:55px" %)Any|(% style="width:93px" %)05|(% style="width:146px" %)4 487 -|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4 488 -|(% style="width:183px" %)MOD|(% style="width:55px" %)Any|(% style="width:93px" %)0A|(% style="width:146px" %)2 507 +**Example:** 489 489 490 -((( 491 -(% style="color:blue" %)**Examples:** 492 -))) 509 +**AT+CLOCKLOG=1,65535,1,5** 493 493 494 -* ((( 495 -(% style="color:blue" %)**Set TDC** 496 -))) 511 +After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp). 497 497 498 -((( 499 -If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01. 500 -))) 513 +[[image:image-20240315160632-1.png||height="603" width="1270"]] 501 501 502 -((( 503 -Payload: 01 00 00 1E TDC=30S 504 -))) 515 +(% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.** 505 505 506 -((( 507 -Payload: 01 00 00 3C TDC=60S 508 -))) 509 509 510 -((( 518 +* (% style="color:blue" %)**Downlink command:**(%%)** (% style="color:#037691" %)0x0A(%%)** 519 + 520 +Format: Command Code (0x0A) followed by 5 bytes. 521 + 522 +* **Example 1**: Downlink Payload:** 0A01FFFF0F08** ~/~/ Set SHT record time: AT+CLOCKLOG=1,65535,15,8 523 +* **Example 1**: Downlink Payload:** 0A0104B00F08** ~/~/ Set SHT record time: AT+CLOCKLOG=1,1200,15,8 524 + 525 +(% style="color:red" %)**Note: When entering the downlink payload, there must be no Spaces between bytes.** 526 + 527 + 528 +== 2.6 Example Query saved historical records == 529 + 530 + 531 +* (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CDP(%%)** 532 + 533 +This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes. 534 + 535 +[[image:image-20240605085514-1.png||height="669" width="909"]] 536 + 537 + 538 +== 2.7 Uplink log query == 539 + 540 + 541 +* (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+GETLOG(%%)** 542 + 543 +This command can be used to query upstream logs of data packets. 544 + 545 +[[image:image-20240605085603-2.png||height="673" width="911"]] 546 + 547 + 548 +== 2.8 Scheduled domain name resolution == 549 + 550 + 551 +This command is used to set up scheduled domain name resolution 552 + 553 +(% style="color:blue" %)**AT command:** 554 + 555 +* (% style="color:#037691" %)**AT+DNSTOMER=XX**(%%)** **~/~/ Unit: hour 556 + 557 +After setting this command, domain name resolution will be performed regularly. 558 + 559 + 560 +== 2.9 Set the QoS level == 561 + 562 + 563 +This command is used to set the QoS level of **MQTT**. 564 + 565 +(% style="color:blue" %)**AT command:** 566 + 567 +* (% style="color:#037691" %)**AT+MQOS=xx **(%%)** **~/~/ 0~~2 568 + 569 +(% style="color:blue" %)**Downlink command:**(%%)** (% style="color:#037691" %)0x07(%%)** 570 + 571 +Format: Command Code (0x07) followed by 1 byte. 572 + 573 +**Ex1:** Downlink payload: **0x0700** ~/~/ AT+MQOS=0 574 + 575 +**Ex2:** Downlink payload: **0x0701** ~/~/ AT+MQOS=1 576 + 577 + 578 +== 2.10 Set the downlink debugging mode(Since firmware v1.1.0) == 579 + 580 + 581 +Feature: Set the conversion between the standard version and 1T version downlinks. 582 + 583 +(% style="color:blue" %)**AT command: AT+DOWNTE** 584 + 585 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %) 586 +|=(% style="width: 138px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 143px; background-color: rgb(79, 129, 189); color: white;" %)**Function/Parameters**|=(% style="width: 229px; background-color: rgb(79, 129, 189); color: white;" %)**Response/Explanation** 587 +|(% style="width:134px" %)AT+DOWNTE=?|(% style="width:143px" %)Get current Settings|(% style="width:229px" %)((( 588 +0,0 (default) 589 +OK 590 +))) 591 +|(% colspan="1" rowspan="2" style="width:134px" %)((( 511 511 593 + 594 + 595 + 596 +AT+DOWNTE=a,b 597 +)))|(% style="width:143px" %)**a**: Set the conversion between the downlink of the standard version and 1T version|(% style="width:229px" %)((( 598 +**0**: Set the downlink of the standard version. 599 +**1**: Set the downlink of the 1T version(ThingsEye platform) 512 512 ))) 601 +|(% style="width:143px" %)**b**: Enable/Disable downlink debugging|(% style="width:229px" %)((( 602 +**0**: Disable downlink debugging mode. 603 +**1**: Enable downlink debugging mode, users can see the original downlink reception. 604 +))) 513 513 514 -* ((( 515 -(% style="color:blue" %)**Reset** 606 +**Example:** 607 + 608 +* AT+DOWNTE=0,1 ~/~/ Set to standard version downlink, and enable downlink debugging. 609 +* AT+DOWNTE=1,1 ~/~/ Set to 1T version downlink, and enable downlink debugging. 610 + 611 +(% style="color:blue" %)**Downlink Command: ** 612 + 613 +No downlink commands for feature 614 + 615 + 616 +== 2.11 Domain name resolution settings(Since firmware v1.1.0) == 617 + 618 + 619 +Feature: Set dynamic domain name resolution IP. 620 + 621 +(% style="color:blue" %)**AT command: AT+BKDNS** 622 + 623 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %) 624 +|=(% style="width: 138px; background-color: rgb(79, 129, 189); color: white;" %)**Command Example**|=(% style="width: 143px; background-color: rgb(79, 129, 189); color: white;" %)**Function/Parameters**|=(% style="width: 229px; background-color: rgb(79, 129, 189); color: white;" %)**Response/Explanation** 625 +|(% style="width:134px" %)((( 626 +AT+BKDNS=? 627 +)))|(% style="width:143px" %)Get current Settings|(% style="width:606px" %)((( 628 +0,0,NULL (default) 629 +OK 516 516 ))) 631 +|(% colspan="1" rowspan="3" style="width:134px" %)((( 632 + 517 517 518 -((( 519 -If payload = 0x04FF, it will reset the SE0X-NB/NS 634 + 635 + 636 + 637 + 638 + 639 + 640 + 641 + 642 + 643 +AT+BKDNS=a,b,c 644 +)))|(% style="width:143px" %)((( 645 +**a**: Enable/Disable dynamic domain name resolution. 646 +)))|(% style="width:606px" %)**1**: Disable dynamic domain name update. The ip address will be saved after the domain name is resolved, if the next domain name resolution fails, the last saved ip address will be used. 647 +**2**: Enable dynamic domain name update. The ip address will be saved after domain name resolution, if the next domain name resolution fails, the last saved ip address will be used, and the domain name resolution will be updated regularly according to the time set by the customer. 648 +|(% style="width:143px" %)**b**: Set the time to update the domain name resolution at regular intervals.|(% style="width:606px" %)((( 649 +Unit: hour 520 520 ))) 651 +|(% style="width:143px" %)((( 652 +**c**: Set the IP address manually. 653 +)))|(% style="width:606px" %)((( 654 +The format is the same as AT+SERVADDR. 655 +If domain name resolution fails, this ip address will be used directly, if domain name resolution succeeds, parameter c will be updated to the successfully resolved IP address. 656 +))) 521 521 658 +**Example:** 522 522 523 -* (% style="color:blue" %)**CFM** 660 +* AT+BKDNS=1,0 ~/~/ Dynamic domain name resolution is disabled. 661 +* AT+BKDNS=2,1 ~/~/ The dynamic domain name resolution function is enabled and the automatic update time is set to 1 hour. 662 +* AT+BKDNS=2,4,3.69.98.183,1883 ~/~/ The dynamic domain name resolution function is enabled and the automatic update time is set to 4 hour, and manually set the ip address, if the domain name failed to resolve, it will directly use this ip to communicate. When the next domain name resolution is successful, it will be updated to the ip address of the successful resolution. 524 524 525 -Downlink Payload:05010101, Set AT+CFM=1 or 05000000 , set AT+CFM=1,1,1664 +(% style="color:blue" %)**Downlink Command: ** 526 526 666 +No downlink commands for feature 527 527 528 528 529 -= =2.6Set DeviceTime==669 += 3. Configure SE0X-NB/NS = 530 530 671 +== 3.1 Configure Methods == 531 531 532 -User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 533 533 534 - OnceSE0X-NB/NSJoined LoRaWAN network, itwillsendtheMAC command (DeviceTimeReq) and the serverwillreply with (DeviceTimeAns) tosend the current time to SE0X-LB. IfSE0X-NB/NS fails toget the time from the server, SE0X-NB/NS willuse the internal timeand wait for next timerequest(AT+SYNCTDC to set the time request period, default is 10 days).674 +SE0X-NB/NS supports below configure method: 535 535 536 - (%style="color:red"%)**Note: LoRaWANServerneedtosupportLoRaWAN v1.0.3(MACv1.0.3)or highertosupport this MACcommandfeature, Chirpstack,TTN V3 v3 andloriotsupport but TTN V3 v2 doesn't support. If serverdoesn'tsupportthis command, itll throughaway uplink packetwith this command, so userwill losehe packetwithtimerequest for TTN V3 v2if SYNCMOD=1.**676 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 537 537 678 +* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.4UARTConnectionforRS485-BLbasemotherboard]]. 538 538 680 +== 3.2 Serial Access Password == 539 539 540 -== 2.7 Frequency Plans == 541 541 683 +After the Bluetooth or UART connection is successful, use the Serial Access Password to enter the AT command window. 542 542 543 -The SE0X-NB/NS uses OTAA modeandbelowfrequencyplansbydefault.Eachfrequencybandusedifferentfirmware,userupdatethefirmwareothecorrespondingbandfortheiruntry.685 +The label on the box of the node will print the initial password: AT+PIN=**xxxxxx**, and directly use the six-digit password to access the AT instruction window. 544 544 545 -[[ http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]687 +[[image:image-20240826170129-1.png]] 546 546 547 547 548 - ==2.8InstallationinSoil==690 +If you need to change the password, use **AT+PWORD=**xxxxxx (6 characters), NB nodes only support lowercase letters. 549 549 692 +[[image:image-20240826170135-2.png]] 550 550 551 -(% style="color:blue" %)**Measurement the soil surface** 552 552 553 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506634463-199.png?rev=1.1||alt="1654506634463-199.png"]]695 +(% style="color:red" %)**Note: After entering the command, you need to add a line break, and you can also set automatic line breaks in the Bluetooth tool or UART connection tool.** 554 554 555 -((( 556 -((( 557 -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. 558 -))) 559 -))) 697 +[[image:image-20240826170142-3.png]] 560 560 561 561 562 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506665940-119.png?rev=1.1||alt="1654506665940-119.png"]]700 +== 3.3 AT Commands Set == 563 563 564 -((( 565 -Dig a hole with diameter > 20CM. 566 -))) 567 567 568 -((( 569 -Horizontal insert the probe to the soil and fill the hole for long term measurement. 703 +AT+<CMD>? : Help on <CMD> 570 570 705 +AT+<CMD> : Run <CMD> 706 + 707 +AT+<CMD>=<value> : Set the value 708 + 709 +AT+<CMD>=? : Get the value 710 + 711 + 712 +(% style="color:blue" %)**General Commands** 713 + 714 +AT : Attention 715 + 716 +AT? : Short Help 717 + 718 +ATZ : MCU Reset 719 + 720 +AT+TDC : Application Data Transmission Interval 721 + 722 +AT+CFG : Print all configurations 723 + 724 +AT+CFGMOD : Working mode selection 725 + 726 +AT+DEUI : Get or set the Device ID 727 + 728 +AT+INTMOD : Set the trigger interrupt mode 729 + 730 +AT+5VT : Set extend the time of 5V power 731 + 732 +AT+PRO : Choose agreement 733 + 734 +AT+RXDL : Extend the sending and receiving time 735 + 736 +AT+DNSCFG : Get or Set DNS Server 737 + 738 +AT+GETSENSORVALUE : Returns the current sensor measurement 739 + 740 +AT+NOUD : Get or Set the number of data to be uploaded 741 + 742 +AT+CDP : Read or Clear cached data 743 + 744 +AT+SERVADDR : Server Address 745 + 746 + 747 +(% style="color:blue" %)**MQTT Management** 748 + 749 +AT+CLIENT : Get or Set MQTT client 750 + 751 +AT+UNAME : Get or Set MQTT Username 752 + 753 +AT+PWD : Get or Set MQTT password 754 + 755 +AT+PUBTOPIC : Get or Set MQTT publish topic 756 + 757 +AT+SUBTOPIC : Get or Set MQTT subscription topic 758 + 759 + 760 +(% style="color:blue" %)**Information** 761 + 762 +AT+FDR : Factory Data Reset 763 + 764 +AT+PWORD : Serial Access Password 765 + 766 +AT+LDATA : Get the last upload data 767 + 768 +AT+CDP : Read or Clear cached data 769 + 770 + 771 += 4. Battery & Power Consumption = 772 + 773 + 774 +SE0X-NB/NS use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 775 + 776 +[[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 777 + 778 + 779 += 5. Firmware update = 780 + 781 + 782 +User can change device firmware to:: 783 + 784 +* Update with new features. 785 + 786 +* Fix bugs. 787 + 788 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/scl/fo/4pmvwgzq98bb87wdoxcbt/ACwDyV32MOsviECJbqAFWQs?rlkey=hna0r2dkbodvqihvzt7ix4vtm&st=wwlz42xa&dl=0]]** 789 + 790 +Methods to Update Firmware: 791 + 792 +* (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. 793 + 794 +* Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**. 795 + 796 +((( 571 571 572 572 ))) 573 573