Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 6 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -206,134 +206,117 @@ 206 206 === 2.3.2 Uplink Payload, FPORT~=2 === 207 207 208 208 209 -((( 210 -DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will: 209 +==== (% style="color:red" %)**MOD~=1**(%%) ==== 211 211 212 - periodically send thisuplinkevery20minutes, thisinterval [[can bechanged>>||anchor="H3.3.1SetTransmitIntervalTime"]].211 +Regularly detect distance and report. When the distance exceeds the limit, the alarm flag is set to 1, and the report can be triggered by external interrupts. 213 213 214 -Uplink Payload totals 11 bytes. 215 -))) 213 +Uplink Payload totals 10 bytes. 216 216 217 217 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 218 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 219 -**Size(bytes)** 220 -)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white; width: 80px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1** 221 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)((( 222 -[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]] 223 -)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)((( 224 -[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]] 225 -)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)((( 226 -[[Message Type>>||anchor="HMessageType"]] 227 -))) 216 +|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:120px" %)**4** 217 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count 228 228 229 -[[image: image-20230805104104-2.png||height="136" width="754"]]219 +[[image:1701155076393-719.png]] 230 230 221 +(% style="color:blue" %)**Battery Info:** 231 231 232 - ====(% style="color:blue"%)**BatteryInfo**(%%)====223 +Check the battery voltage for DS20L 233 233 225 +Ex1: 0x0E10 = 3600mV 234 234 235 -Check the battery voltage for DS20L. 236 236 237 - Ex1:0x0B45=2885mV228 +(% style="color:blue" %)**MOD & Alarm & Interrupt:** 238 238 239 - Ex2:0x0B49=2889mV230 +(% style="color:red" %)**MOD:** 240 240 232 +**Example: ** (0x60>>6) & 0x3f =1 241 241 242 -==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ==== 234 +**0x01:** Regularly detect distance and report. 235 +**0x02: ** Uninterrupted measurement (external power supply). 243 243 237 +(% style="color:red" %)**Alarm:** 244 244 245 - Thisisoptional,user canonnectexternal DS18B20 sensorto the+3.3v,1-wire and GND pin .andthisfieldwillreport temperature.239 +When the detection distance exceeds the limit, the alarm flag is set to 1. 246 246 241 +(% style="color:red" %)**Interrupt:** 247 247 248 - **Example**:243 +Whether it is an external interrupt. 249 249 250 -If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 251 251 252 - Ifpayload is:FF3FH : (FF3F & FC00 == 1),temp= (FF3FH - 65536)/10 = -19.3 degrees.246 +(% style="color:blue" %)**Distance info:** 253 253 254 - 255 -==== (% style="color:blue" %)**Distance**(%%) ==== 256 - 257 - 258 -Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength. 259 - 260 - 261 261 **Example**: 262 262 263 -If the datayouget from the registeris0x0B0xEA, thedistancebetweenthe sensor and the measured object is0BEA(H)=3050 (D)/10= 305cm.250 +If payload is: 0708H: distance = 0708H = 1800 mm 264 264 265 265 266 - ====(% style="color:blue" %)**Distancesignalstrength**(%%) ====253 +(% style="color:blue" %)**Sensor State:** 267 267 255 +Ex1: 0x00: Normal collection distance 268 268 269 - Refersto the signal strength, the default output value will be between0-65535. When the distance measurement gear is fixed,the farther the distancemeasurement is, the lower the signalstrength; thelower the target reflectivity, the lower the signalstrength. When Strengthisgreater than 100 and not equal to 65535, the measured value of Dist is considered credible.257 +Ex2 0x0x: Distance collection is wrong 270 270 271 271 272 - **Example**:260 +(% style="color:blue" %)**Interript Count:** 273 273 274 -If payload is: 1D7(H)=471(D),distance signal strength=471,471>100,471≠65535, the measured value ofDistis considered credible.262 +If payload is:000007D0H: count = 07D0H =2000 275 275 276 -Customers can judge whether they need to adjust the environment based on the signal strength. 277 277 278 278 279 - **1)Whenthesensor detects validdata:**266 +==== (% style="color:red" %)**MOD~=2**(%%)** ** ==== 280 280 281 - [[image:image-20230805155335-1.png||height="145"width="724"]]268 +Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes. 282 282 270 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 271 +|(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2** 272 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 283 283 284 - **2) When the sensor detectsinvalid data:**274 +[[image:1701155150328-206.png]] 285 285 286 - [[image:image-20230805155428-2.png||height="139"width="726"]]276 +(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 287 287 278 +(% style="color:red" %)**MOD:** 288 288 289 -** 3) Whenthesensorisnotconnected:**280 +**Example: ** (0x60>>6) & 0x3f =1 290 290 291 -[[image:image-20230805155515-3.png||height="143" width="725"]] 282 +**0x01:** Regularly detect distance and report. 283 +**0x02: ** Uninterrupted measurement (external power supply). 292 292 285 +(% style="color:red" %)**Alarm:** 293 293 294 - ====(%style="color:blue" %)**InterruptPin& InterruptLevel**(%%)====287 +When the detection distance exceeds the limit, the alarm flag is set to 1. 295 295 289 +(% style="color:red" %)**Do:** 296 296 297 - Thisdata fieldshowsif thispacketis generatedby interruptor not.[[Clickhere>>||anchor="H3.3.2SetInterruptMode"]]forthehardware and softwareset up.291 +When the distance exceeds the set threshold, pull the Do pin high. 298 298 299 - Note:The Internet Pin is a separatepininthescrew terminal. See pin mappingof GPIO_EXTI .293 +(% style="color:red" %)**Limit flag:** 300 300 301 - **Example:**295 +Mode for setting threshold: 0~~5 302 302 303 - If byte[0]&0x01=0x00:Normaluplinkpacket.297 +0: does not use upper and lower limits 304 304 305 - If byte[0]&0x01=0x01:Interrupt UplinkPacket.299 +1: Use upper and lower limits 306 306 301 +2: is less than the lower limit value 307 307 308 - ====(%style="color:blue"%)**LiDARtemp**(%%)====303 +3: is greater than the lower limit value 309 309 305 +4: is less than the upper limit 310 310 311 - Characterizethe internaltemperaturevalue ofthe sensor.307 +5: is greater than the upper limit 312 312 313 -**Example: ** 314 -If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃. 315 -If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃. 316 316 310 +(% style="color:blue" %)**Upper limit:** 317 317 318 - ====(% style="color:blue"%)**MessageType**(%%)====312 +The upper limit of the threshold cannot exceed 2000mm. 319 319 320 320 321 -((( 322 -For a normal uplink payload, the message type is always 0x01. 323 -))) 315 +(% style="color:blue" %)**Lower limit:** 324 324 325 -((( 326 -Valid Message Type: 327 -))) 317 +The lower limit of the threshold cannot be less than 3mm. 328 328 329 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %) 330 -|=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload** 331 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload 332 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload 333 333 334 -[[image:image-20230805150315-4.png||height="233" width="723"]] 335 - 336 - 337 337 === 2.3.3 Historical measuring distance, FPORT~=3 === 338 338 339 339 ... ... @@ -465,7 +465,7 @@ 465 465 466 466 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake. 467 467 468 -[[image: http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]]451 +[[image:1701152946067-561.png]] 469 469 470 470 471 471 == 2.5 Frequency Plans == ... ... @@ -551,7 +551,6 @@ 551 551 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 552 552 ))) 553 553 554 - 555 555 === 3.3.2 Set Interrupt Mode === 556 556 557 557 ... ... @@ -590,8 +590,6 @@ 590 590 591 591 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 592 592 593 - 594 - 595 595 == 3.3.3 Set work mode == 596 596 597 597 ... ... @@ -613,7 +613,6 @@ 613 613 614 614 * **Example:** 0x0A01 ~/~/ Same as AT+MOD=1 615 615 616 - 617 617 === 3.3.4 Set threshold and threshold mode === 618 618 619 619 ... ... @@ -623,8 +623,8 @@ 623 623 624 624 (% style="color:blue" %)**AT Command: AT+DOL** 625 625 626 -(% border="1" cellspacing="4" style=" width:510px;background-color:#f2f2f2" %)627 -|(% style=" width:162px;background-color:#4F81BD;color:white" %)**Command Example**|(% style="width:240px;background-color:#4F81BD;color:white" %)**Function**|(% style="width:108px;background-color:#4F81BD;color:white" %)**Response**605 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 606 +|(% style="background-color:#4f81bd; color:white; width:162px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:240px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:108px" %)**Response** 628 628 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)((( 629 629 0,0,0,0,400 630 630 OK ... ... @@ -632,12 +632,12 @@ 632 632 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 633 633 634 634 635 -(% border="1" cellspacing="4" style=" width:510px;background-color:#f2f2f2" %)636 -|(% rowspan="11" style="width:120px ;color:blue" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0:Do not use upper and lower limits637 -|(% style="width:251px" %)1:Use upper and lower limits 638 -|(% style="width:251px" %)2:Less than the lower limit 639 -|(% style="width:251px" %)3:Greater than the lower limit 640 -|(% style="width:251px" %)4:Less than the upper limit 614 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 615 +|(% rowspan="11" style="color:blue; width:120px" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits 616 +|(% style="width:251px" %)1: Use upper and lower limits 617 +|(% style="width:251px" %)2: Less than the lower limit 618 +|(% style="width:251px" %)3: Greater than the lower limit 619 +|(% style="width:251px" %)4: Less than the upper limit 641 641 |(% style="width:251px" %)5: Greater than the upper limit 642 642 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM 643 643 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM ... ... @@ -658,8 +658,6 @@ 658 658 * Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 659 659 660 660 661 - 662 - 663 663 = 4. Battery & Power Consumption = 664 664 665 665 ... ... @@ -696,6 +696,33 @@ 696 696 DS20L use the same frequency as other Dragino products. User can see the detail from this link: [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]] 697 697 698 698 676 +== 6.2 DS20L programming line == 677 + 678 + 679 +缺图 后续补上 680 + 681 +feature: 682 + 683 +for AT commands 684 + 685 +Update the firmware of DS20L 686 + 687 +Support interrupt mode 688 + 689 + 690 +== 6.3 LiDAR probe position == 691 + 692 + 693 +[[image:1701155390576-216.png||height="285" width="307"]] 694 + 695 +The black oval hole in the picture is the LiDAR probe. 696 + 697 + 698 +== 6.4 Interface definition == 699 + 700 +[[image:image-20231128151132-2.png||height="305" width="557"]] 701 + 702 + 699 699 = 7. Trouble Shooting = 700 700 701 701 == 7.1 AT Command input doesn't work ==
- 1701152902759-553.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +52.2 KB - Content
- 1701152946067-561.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +52.2 KB - Content
- 1701155076393-719.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.6 KB - Content
- 1701155150328-206.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.6 KB - Content
- 1701155390576-216.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +293.9 KB - Content
- image-20231128151132-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +281.2 KB - Content