Changes for page NDDS75 -- NB-IoT Distance Detect Sensor User Manual
Last modified by Bei Jinggeng on 2024/05/31 09:53
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -3,11 +3,15 @@ 3 3 4 4 5 5 6 +**Contents:** 6 6 8 +{{toc/}} 7 7 8 8 9 9 10 10 13 + 14 + 11 11 = 1. Introduction = 12 12 13 13 == 1.1 What is LoRaWAN Soil Moisture & EC Sensor == ... ... @@ -87,7 +87,7 @@ 87 87 ))) 88 88 89 89 ((( 90 -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"]].94 +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"]]. 91 91 ))) 92 92 93 93 ... ... @@ -140,86 +140,107 @@ 140 140 141 141 == 2.3 Uplink Payload == 142 142 147 +=== === 148 + 143 143 === 2.3.1 MOD~=0(Default Mode) === 144 144 145 145 LSE01 will uplink payload via LoRaWAN with below payload format: 146 146 147 - 153 +((( 148 148 Uplink payload includes in total 11 bytes. 149 - 155 +))) 150 150 157 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 151 151 |((( 152 152 **Size** 153 153 154 154 **(bytes)** 155 155 )))|**2**|**2**|**2**|**2**|**2**|**1** 156 -|**Value**|[[BAT>> path:#bat]]|(((163 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 157 157 Temperature 158 158 159 159 (Reserve, Ignore now) 160 -)))|[[Soil Moisture>> path:#soil_moisture]]|[[Soil Temperature>>path:#soil_tem]]|[[Soil Conductivity (EC)>>path:#EC]]|(((167 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|((( 161 161 MOD & Digital Interrupt 162 162 163 163 (Optional) 164 164 ))) 165 165 166 -[[image:1654504881641-514.png]] 167 167 168 - 169 - 170 170 === 2.3.2 MOD~=1(Original value) === 171 171 172 172 This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation). 173 173 178 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 174 174 |((( 175 175 **Size** 176 176 177 177 **(bytes)** 178 178 )))|**2**|**2**|**2**|**2**|**2**|**1** 179 -|**Value**|[[BAT>> path:#bat]]|(((184 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|((( 180 180 Temperature 181 181 182 182 (Reserve, Ignore now) 183 -)))|[[Soil Moisture>> path:#soil_moisture]](raw)|[[Soil Temperature>>path:#soil_tem]]|[[Soil Conductivity (EC)>>path:#EC]](raw)|(((188 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|((( 184 184 MOD & Digital Interrupt 185 185 186 186 (Optional) 187 187 ))) 188 188 189 -[[image:1654504907647-967.png]] 190 190 191 - 192 - 193 193 === 2.3.3 Battery Info === 194 194 197 +((( 195 195 Check the battery voltage for LSE01. 199 +))) 196 196 201 +((( 197 197 Ex1: 0x0B45 = 2885mV 203 +))) 198 198 205 +((( 199 199 Ex2: 0x0B49 = 2889mV 207 +))) 200 200 201 201 202 202 203 203 === 2.3.4 Soil Moisture === 204 204 213 +((( 205 205 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. 215 +))) 206 206 217 +((( 207 207 For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is 219 +))) 208 208 221 +((( 222 + 223 +))) 209 209 225 +((( 210 210 (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.** 227 +))) 211 211 212 212 213 213 214 214 === 2.3.5 Soil Temperature === 215 215 233 +((( 216 216 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 235 +))) 217 217 237 +((( 218 218 **Example**: 239 +))) 219 219 241 +((( 220 220 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C 243 +))) 221 221 245 +((( 222 222 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C 247 +))) 223 223 224 224 225 225 ... ... @@ -254,7 +254,7 @@ 254 254 mod=(bytes[10]>>7)&0x01=1. 255 255 256 256 257 -Downlink Command: 282 +**Downlink Command:** 258 258 259 259 If payload = 0x0A00, workmode=0 260 260 ... ... @@ -269,19 +269,22 @@ 269 269 270 270 [[image:1654505570700-128.png]] 271 271 297 +((( 272 272 The payload decoder function for TTN is here: 299 +))) 273 273 301 +((( 274 274 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/]] 303 +))) 275 275 276 276 306 + 277 277 == 2.4 Uplink Interval == 278 278 279 -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: 309 +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"]] 280 280 281 -[[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]] 282 282 283 283 284 - 285 285 == 2.5 Downlink Payload == 286 286 287 287 By default, LSE50 prints the downlink payload to console port. ... ... @@ -289,21 +289,41 @@ 289 289 [[image:image-20220606165544-8.png]] 290 290 291 291 320 +((( 292 292 **Examples:** 322 +))) 293 293 324 +((( 325 + 326 +))) 294 294 295 -* **Set TDC** 328 +* ((( 329 +**Set TDC** 330 +))) 296 296 332 +((( 297 297 If the payload=0100003C, it means set the END Node’s TDC to 0x00003C=60(S), while type code is 01. 334 +))) 298 298 336 +((( 299 299 Payload: 01 00 00 1E TDC=30S 338 +))) 300 300 340 +((( 301 301 Payload: 01 00 00 3C TDC=60S 342 +))) 302 302 344 +((( 345 + 346 +))) 303 303 304 -* **Reset** 348 +* ((( 349 +**Reset** 350 +))) 305 305 352 +((( 306 306 If payload = 0x04FF, it will reset the LSE01 354 +))) 307 307 308 308 309 309 * **CFM** ... ... @@ -314,12 +314,21 @@ 314 314 315 315 == 2.6 Show Data in DataCake IoT Server == 316 316 365 +((( 317 317 [[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: 367 +))) 318 318 369 +((( 370 + 371 +))) 319 319 373 +((( 320 320 **Step 1**: Be sure that your device is programmed and properly connected to the network at this time. 375 +))) 321 321 377 +((( 322 322 **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: 379 +))) 323 323 324 324 325 325 [[image:1654505857935-743.png]] ... ... @@ -627,6 +627,7 @@ 627 627 * Solid ON for 5 seconds once device successful Join the network. 628 628 * Blink once when device transmit a packet. 629 629 687 + 630 630 == 2.9 Installation in Soil == 631 631 632 632 **Measurement the soil surface** ... ... @@ -746,13 +746,13 @@ 746 746 747 747 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. 748 748 749 -[[image:1654501986557-872.png]] 807 +[[image:1654501986557-872.png||height="391" width="800"]] 750 750 751 751 752 752 Or if you have below board, use below connection: 753 753 754 754 755 -[[image:1654502005655-729.png]] 813 +[[image:1654502005655-729.png||height="503" width="801"]] 756 756 757 757 758 758 ... ... @@ -759,7 +759,7 @@ 759 759 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: 760 760 761 761 762 - [[image:1654502050864-459.png]] 820 + [[image:1654502050864-459.png||height="564" width="806"]] 763 763 764 764 765 765 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/]] ... ... @@ -874,20 +874,38 @@ 874 874 875 875 == 4.1 How to change the LoRa Frequency Bands/Region? == 876 876 877 -You can follow the instructions for [[how to upgrade image>>||anchor="H2.10FirmwareChangeLog"]]. 935 +((( 936 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]]. 878 878 When downloading the images, choose the required image file for download. 938 +))) 879 879 940 +((( 941 + 942 +))) 880 880 944 +((( 881 881 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. 946 +))) 882 882 948 +((( 949 + 950 +))) 883 883 952 +((( 884 884 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. 954 +))) 885 885 956 +((( 957 + 958 +))) 886 886 960 +((( 887 887 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. 962 +))) 888 888 889 889 [[image:image-20220606154726-3.png]] 890 890 966 + 891 891 When you use the TTN network, the US915 frequency bands use are: 892 892 893 893 * 903.9 - SF7BW125 to SF10BW125 ... ... @@ -900,7 +900,9 @@ 900 900 * 905.3 - SF7BW125 to SF10BW125 901 901 * 904.6 - SF8BW500 902 902 979 +((( 903 903 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: 981 +))) 904 904 905 905 (% class="box infomessage" %) 906 906 ((( ... ... @@ -912,10 +912,17 @@ 912 912 **ATZ** 913 913 ))) 914 914 993 +((( 915 915 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. 995 +))) 916 916 997 +((( 998 + 999 +))) 917 917 1001 +((( 918 918 The **AU915** band is similar. Below are the AU915 Uplink Channels. 1003 +))) 919 919 920 920 [[image:image-20220606154825-4.png]] 921 921 ... ... @@ -930,7 +930,9 @@ 930 930 931 931 == 5.2 AT Command input doesn’t work == 932 932 1018 +((( 933 933 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. 1020 +))) 934 934 935 935 936 936 == 5.3 Device rejoin in at the second uplink packet == ... ... @@ -942,7 +942,9 @@ 942 942 943 943 (% style="color:#4f81bd" %)**Cause for this issue:** 944 944 1032 +((( 945 945 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. 1034 +))) 946 946 947 947 948 948 (% style="color:#4f81bd" %)**Solution: ** ... ... @@ -949,7 +949,7 @@ 949 949 950 950 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: 951 951 952 -[[image:1654500929571-736.png]] 1041 +[[image:1654500929571-736.png||height="458" width="832"]] 953 953 954 954 955 955 = 6. Order Info = ... ... @@ -982,7 +982,9 @@ 982 982 = 7. Packing Info = 983 983 984 984 ((( 985 -**Package Includes**: 1074 + 1075 + 1076 +(% style="color:#037691" %)**Package Includes**: 986 986 ))) 987 987 988 988 * ((( ... ... @@ -991,10 +991,8 @@ 991 991 992 992 ((( 993 993 994 -))) 995 995 996 -((( 997 -**Dimension and weight**: 1086 +(% style="color:#037691" %)**Dimension and weight**: 998 998 ))) 999 999 1000 1000 * ((( ... ... @@ -1009,7 +1009,6 @@ 1009 1009 * ((( 1010 1010 Weight / pcs : g 1011 1011 1012 - 1013 1013 1014 1014 ))) 1015 1015