Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 170.2
edited by Mengting Qiu
on 2023/12/12 10:36
on 2023/12/12 10:36
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 35 removed)
- 1701152946067-561.png
- 1701155076393-719.png
- 1701155150328-206.png
- 1701155390576-216.png
- image-20231128151132-2.png
- image-20231129085201-1.png
- image-20231129100454-2.png
- image-20231206143515-1.png
- image-20231206144950-2.png
- image-20231206151412-3.png
- image-20231206154621-4.png
- image-20231206194804-5.png
- image-20231206195704-6.png
- image-20231207142208-1.png
- image-20231207144600-2.png
- image-20231207144837-3.png
- image-20231207144856-4.png
- image-20231207145121-5.png
- image-20231207153532-6.png
- image-20231207154046-7.png
- image-20231207155940-8.png
- image-20231207160053-9.png
- image-20231207160343-10.png
- image-20231207160733-11.png
- image-20231209152917-1.png
- image-20231209155616-2.png
- image-20231209171127-3.png
- image-20231209171549-4.png
- image-20231209173457-5.png
- image-20231211113113-1.png
- image-20231211113204-2.png
- image-20231211114932-3.png
- image-20231211220922-1.png
- image-20231211221253-2.png
- image-20231211221436-3.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. ting1 +XWiki.Xiaoling - Content
-
... ... @@ -8,7 +8,7 @@ 8 8 9 9 10 10 11 -**Table of Contents :(% style="display:none" %) (%%)**11 +**Table of Contents:** 12 12 13 13 {{toc/}} 14 14 ... ... @@ -49,6 +49,7 @@ 49 49 50 50 == 1.3 Specification == 51 51 52 + 52 52 (% style="color:#037691" %)**LiDAR Sensor:** 53 53 54 54 * Operation Temperature: -40 ~~ 80 °C ... ... @@ -64,7 +64,7 @@ 64 64 65 65 (% style="color:#037691" %)**Battery Power Mode:** 66 66 67 -* Idle: 3 uA @ 3.3v68 +* Idle: 0.003 mA @ 3.3v 68 68 * Max : 360 mA 69 69 70 70 (% style="color:#037691" %)**Continuously mode**: ... ... @@ -72,21 +72,6 @@ 72 72 * Idle: 21 mA @ 3.3v 73 73 * Max : 360 mA 74 74 75 -== 1.5 Use Case == 76 - 77 -(% class="mark" %)**Regular Distance Detect** 78 - 79 -[[image:image-20231211220922-1.png||height="352" width="605"]] 80 - 81 - 82 -(% class="mark" %)**Counting / Alarm** 83 - 84 -[[image:image-20231211221253-2.png]] 85 - 86 - 87 -[[image:image-20231211221436-3.png]] 88 - 89 - 90 90 = 2. Configure DS20L to connect to LoRaWAN network = 91 91 92 92 == 2.1 How it works == ... ... @@ -105,7 +105,7 @@ 105 105 106 106 [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %) 107 107 108 -= ==Step 1: Create a device in TTN with the OTAA keys from DS20L.===94 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L. 109 109 110 110 Each DS20L is shipped with a sticker with the default device EUI as below: 111 111 ... ... @@ -112,36 +112,41 @@ 112 112 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 113 113 114 114 115 -You can enter this key in the LoRaWAN Server portal. V3screenshot:101 +You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 116 116 117 117 118 118 (% style="color:blue" %)**Register the device** 119 119 120 -[[image:i mage-20231207144600-2.png||height="703" width="756"]]106 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]] 121 121 122 122 123 -(% style="color:blue" %)**Add DevEUI andAppKey**109 +(% style="color:blue" %)**Add APP EUI and DEV EUI** 124 124 125 -[[image:i mage-20231207145121-5.png||height="540" width="756"]]111 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1||alt="图片-20220611161308-4.png"]] 126 126 127 127 114 +(% style="color:blue" %)**Add APP EUI in the application** 128 128 129 -=== Step 2: Activate DS20L === 130 130 131 -[[image:i mage-20231128133704-1.png||height="189" width="441"]]117 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1||alt="图片-20220611161308-5.png"]] 132 132 133 -Press the button for 5 seconds to activate the DS20L. 134 134 135 - The switch is switched to(% style="color:blue" %)**E** (%%)andtheexternal power supply is used.120 +(% style="color:blue" %)**Add APP KEY** 136 136 137 - Theswitchis switchedto(% style="color:blue"%)**I** (%%)andDS20Lwill beowerbythebuilt-intery.122 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]] 138 138 124 + 125 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L 126 + 127 +[[image:image-20231128133704-1.png||height="189" width="441"]] 128 + 129 +Press the button for 5 seconds to activate the DS20L. 130 + 139 139 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 140 140 141 141 After join success, it will start to upload messages to TTN and you can see the messages in the panel. 142 142 143 143 144 - 145 145 == 2.3 Uplink Payload == 146 146 147 147 === 2.3.1 Device Status, FPORT~=5 === ... ... @@ -159,7 +159,7 @@ 159 159 160 160 Example parse in TTNv3 161 161 162 -[[image: image-20231206151412-3.png||height="179" width="1070"]]153 +[[image:1701149922873-259.png]] 163 163 164 164 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21 165 165 ... ... @@ -215,225 +215,222 @@ 215 215 === 2.3.2 Uplink Payload, FPORT~=2 === 216 216 217 217 218 -==== (% style="color:red" %)**AT+MOD~=1**(%%) ==== 209 +((( 210 +DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will: 219 219 220 - Regularlydetect distanceandreport. When the distanceexceedsthelimit, the alarm flagisset to 1, andtheeportcan betriggered by externalinterrupts.212 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 221 221 222 -**Uplink Payload totals 10 bytes.** 214 +Uplink Payload totals 11 bytes. 215 +))) 223 223 224 224 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 225 -|(% 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** 226 -|(% 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 227 - 228 -**MOD+ Alarm+ Interrupt:** 229 - 230 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:400px" %) 231 -|(% style="background-color:#4f81bd; color:White; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:White; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:White; width:70px" %)**bit5**|(% style="background-color:#4f81bd; color:White; width:120px" %)**bit4** 232 -|(% style="width:80px" %)Value|(% style="width:80px" %)MOD|(% style="width:89px" %)Digital Interrupt 233 - |(% style="width:167px" %)((( 234 -Distance Alarm 235 - 236 -0: No Alarm; 237 - 238 -1: Alarm 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"]] 239 239 ))) 240 240 241 - Examplearsen TTNv3229 +[[image:image-20230805104104-2.png||height="136" width="754"]] 242 242 243 -[[image:image-20231209152917-1.png||height="300" width="1172"]] 244 244 245 -(% style="color:blue" %)**Battery Info :**232 +==== (% style="color:blue" %)**Battery Info**(%%) ==== 246 246 247 -Check the battery voltage for DS20L 248 248 249 - Ex1:0x0E10=3600mV235 +Check the battery voltage for DS20L. 250 250 237 +Ex1: 0x0B45 = 2885mV 251 251 252 - (% style="color:blue"%)**MOD&Alarm& Interrupt:**239 +Ex2: 0x0B49 = 2889mV 253 253 254 -(% style="color:red" %)**MOD:** 255 255 256 -** Example:**0x60>>6)& 0x3f=1242 +==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ==== 257 257 258 -**0x01:** Regularly detect distance and report. 259 -**0x02: ** Uninterrupted measurement (external power supply). 260 260 261 - (%style="color:red"%)**Alarm:**245 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 262 262 263 -When the detection distance exceeds the limit, the alarm flag is set to 1. 264 264 265 -(% style="color:red" %)**Interrupt:** 266 - 267 -Whether it is an external interrupt. 268 - 269 - 270 -(% style="color:blue" %)**Distance info:** 271 - 272 272 **Example**: 273 273 274 -If payload is: 0 708H:distance = 0708H = 1800mm250 +If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 275 275 252 +If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 276 276 277 -(% style="color:blue" %)**Sensor State:** 278 278 279 - Ex1:0x00:Normalctiondistance255 +==== (% style="color:blue" %)**Distance**(%%) ==== 280 280 281 -Ex2: 0x0x: Distance collection is wrong 282 282 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. 283 283 284 -(% style="color:blue" %)**Interrupt Count:** 285 285 286 - If payload is:000007D0H: count = 07D0H =2000261 +**Example**: 287 287 263 +If the data you get from the register is 0x0B 0xEA, the distance between the sensor and the measured object is 0BEA(H) = 3050 (D)/10 = 305cm. 288 288 289 289 290 -==== (% style="color: red" %)**AT+MOD~=2**(%%)****====266 +==== (% style="color:blue" %)**Distance signal strength**(%%) ==== 291 291 292 292 293 - Thepowerconsumptionof uninterrupted measurement ishigh, andthe deviceneeds touse externalpower supply.(Theswitch isswitchedtoEand theexternalpowersupplyisused.)269 +Refers to the signal strength, the default output value will be between 0-65535. When the distance measurement gear is fixed, the farther the distance measurement is, the lower the signal strength; the lower the target reflectivity, the lower the signal strength. When Strength is greater than 100 and not equal to 65535, the measured value of Dist is considered credible. 294 294 295 -[[image:image-20231128133704-1.png||height="189" width="441"]] 296 296 272 +**Example**: 297 297 298 - ***Set over-limit alarmmode: AT+DOL=3,500,244,**(%style="color:red"%)0(%%)**,120**274 +If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible. 299 299 300 -(% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %) 301 -Uninterrupted measurement. When the distance exceeds the limit, the output IO high, instant alarm. Uplink Payload totals 9 bytes. 276 +Customers can judge whether they need to adjust the environment based on the signal strength. 302 302 303 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 304 -|(% 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" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2** 305 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+DO+Limit flag|(% style="width:74px" %)Distance |(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 306 306 307 - [[image:image-20231209171127-3.png||height="374"width="1209"]]279 +**1) When the sensor detects valid data:** 308 308 309 - (% style="color:blue" %)**MOD & Alarm & Do & Limitflag:**281 +[[image:image-20230805155335-1.png||height="145" width="724"]] 310 310 311 -(% style="color:red" %)**MOD:** 312 312 313 -** Example:**(0x60>>6)&0x3f=1284 +**2) When the sensor detects invalid data:** 314 314 315 -**0x01:** Regularly detect distance and report. 316 -**0x02: ** Uninterrupted measurement (external power supply). 286 +[[image:image-20230805155428-2.png||height="139" width="726"]] 317 317 318 -(% style="color:red" %)**Alarm:** 319 319 320 -When the detectiondistance exceeds the limit, the alarmflagissetto1.289 +**3) When the sensor is not connected:** 321 321 322 - (% style="color:red"%)**DO:**291 +[[image:image-20230805155515-3.png||height="143" width="725"]] 323 323 324 -When the distance exceeds the set threshold, pull the Do pin high. 325 325 326 -(% style="color: red" %)**Limitflag:**294 +==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ==== 327 327 328 -Mode for setting threshold: **0~~3** 329 329 330 - **0:**does notuse upper andlowerlimits297 +This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up. 331 331 332 - **1:**Useupper andlower limits299 +Note: The Internet Pin is a separate pin in the screw terminal. See pin mapping of GPIO_EXTI . 333 333 334 -** 2:** Less than the upperlimit301 +**Example:** 335 335 336 - **3:**Greaterthanthe lower limit303 +If byte[0]&0x01=0x00 : Normal uplink packet. 337 337 305 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet. 338 338 339 -(% style="color:blue" %)**Distance:** 340 340 341 - Actualsamplingdistancevalues.308 +==== (% style="color:blue" %)**LiDAR temp**(%%) ==== 342 342 343 -**Example:** 344 344 345 - **AT+DOL=1,500,244,**(%style="color:red"%)0(%%)**,120**311 +Characterize the internal temperature value of the sensor. 346 346 347 -The distance is detected every 120ms. 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℃. 348 348 349 -When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time. 350 350 351 - Whentheactualdetection value isoutsidetherangeof [244mm,500mm], the uplink data will beimmediately alerted.318 +==== (% style="color:blue" %)**Message Type**(%%) ==== 352 352 353 -If payload is: 0708H: distance = 0708H = 1800 mm 354 354 321 +((( 322 +For a normal uplink payload, the message type is always 0x01. 323 +))) 355 355 356 -(% style="color:blue" %)**Upper limit:** 325 +((( 326 +Valid Message Type: 327 +))) 357 357 358 -The upper limit of the threshold cannot exceed 2000mm. 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 359 359 334 +[[image:image-20230805150315-4.png||height="233" width="723"]] 360 360 361 -(% style="color:blue" %)**Lower limit:** 362 362 363 - Thelowerlimitf the thresholdcannotbelessthan 3mm.337 +=== 2.3.3 Historical measuring distance, FPORT~=3 === 364 364 365 365 366 - * **Settheperson orobjectcountmode: AT+DOL=1,500,244,**(%style="color:red"%)1(%%)**,120**340 +DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]]. 367 367 368 - Continuousmeasurement, detectand count people or thingspassingbyindistancelimit mode.Uplink Payloadtotals11bytes.342 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 369 369 370 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:600px" %) 371 -|(% 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** 372 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:176px" %)Distance limit alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 344 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 345 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 346 +**Size(bytes)** 347 +)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% 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: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4 348 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)((( 349 +Reserve(0xFF) 350 +)))|Distance|Distance signal strength|(% style="width:88px" %)((( 351 +LiDAR temp 352 +)))|(% style="width:85px" %)Unix TimeStamp 373 373 374 - [[image:image-20231209173457-5.png||height="277"width="1098"]]354 +**Interrupt flag & Interrupt level:** 375 375 376 -(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 356 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %) 357 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 358 +**Size(bit)** 359 +)))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0** 360 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)No ACK message|(% style="width:62.5px" %)Poll Message Flag|Reserve|(% style="width:91px" %)Interrupt level|(% style="width:88px" %)((( 361 +Interrupt flag 362 +))) 377 377 378 -(% style="color:red" %)**MOD:** 364 +* ((( 365 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS20L will send max bytes according to the current DR and Frequency bands. 366 +))) 379 379 380 - **Example:**(0x60>>6)&0x3f=1368 +For example, in the US915 band, the max payload for different DR is: 381 381 382 -**0x01:** Regularly detect distance and report. 383 -**0x02: ** Uninterrupted measurement (external power supply). 370 +**a) DR0:** max is 11 bytes so one entry of data 384 384 385 - (%style="color:red"%)**Alarm:**372 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 386 386 387 - Whenthe detectiondistance exceedsthelimit, thealarm flagisset to1.374 +**c) DR2:** total payload includes 11 entries of data 388 388 389 - (%style="color:red"%)**Do:**376 +**d) DR3:** total payload includes 22 entries of data. 390 390 391 - Whendistanceexceedsthesetthreshold,pull theDopinhigh.378 +If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0 392 392 393 -(% style="color:red" %)**Limit flag:** 394 394 395 - Mode for setting threshold:0~~3**381 +**Downlink:** 396 396 397 - **0:**doesnotuseupperandlowerlimits383 +0x31 64 CC 68 0C 64 CC 69 74 05 398 398 399 - **1:** Useupper and lowerlimits385 +[[image:image-20230805144936-2.png||height="113" width="746"]] 400 400 401 -** 2:** Less than the upperlimit387 +**Uplink:** 402 402 403 - **3:**Greaterthanthelowerlimit389 +43 FF 0E 10 00 B0 1E 64 CC 68 0C 40 FF 0D DE 00 A8 1E 64 CC 68 29 40 FF 09 92 00 D3 1E 64 CC 68 65 40 FF 02 3A 02 BC 1E 64 CC 68 A1 41 FF 0E 1A 00 A4 1E 64 CC 68 C0 40 FF 0D 2A 00 B8 1E 64 CC 68 E8 40 FF 00 C8 11 6A 1E 64 CC 69 24 40 FF 0E 24 00 AD 1E 64 CC 69 6D 404 404 405 405 406 - (% style="color:blue" %)**Distancelimitalarm count:**392 +**Parsed Value:** 407 407 408 - Peopleorobjectsarecollectedandcounted within a limited distance.394 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS , EXTI_FLAG , TIME] 409 409 410 -The detection of a stationary person or object at each sampling time will be repeated three times, and the fourth sampling count will be added by 1. 411 411 412 - **Example:**397 +[360,176,30,High,True,2023-08-04 02:53:00], 413 413 414 - **AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**399 +[355,168,30,Low,False,2023-08-04 02:53:29], 415 415 416 - People or objects passing within the distance range of[244mm,500mm]aredetected and counted every 120ms.401 +[245,211,30,Low,False,2023-08-04 02:54:29], 417 417 418 - If payload is: 0x56H,interrupt count =0x56H =86403 +[57,700,30,Low,False,2023-08-04 02:55:29], 419 419 405 +[361,164,30,Low,True,2023-08-04 02:56:00], 420 420 421 - (% style="color:blue"%)**Upper limit:**407 +[337,184,30,Low,False,2023-08-04 02:56:40], 422 422 423 - The upper limitof the threshold cannotexceed2000mm.409 +[20,4458,30,Low,False,2023-08-04 02:57:40], 424 424 411 +[362,173,30,Low,False,2023-08-04 02:58:53], 425 425 426 -(% style="color:blue" %)**Lower limit:** 427 427 428 - The lower limitfthe thresholdcannotbeessthan 3mm.414 +**History read from serial port:** 429 429 416 +[[image:image-20230805145056-3.png]] 430 430 431 -== 2.4 Decode payload in The Things Network == 432 432 419 +=== 2.3.4 Decode payload in The Things Network === 433 433 421 + 434 434 While using TTN network, you can add the payload format to decode the payload. 435 435 436 -[[image:i mage-20231206143515-1.png||height="534" width="759"]]424 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]] 437 437 438 438 439 439 ((( ... ... @@ -445,11 +445,11 @@ 445 445 ))) 446 446 447 447 448 -== 2. 5Show Data in DataCake IoT Server ==436 +== 2.4 Show Data in DataCake IoT Server == 449 449 450 450 451 451 ((( 452 -[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, onh uman-friendlya in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:440 +[[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: 453 453 ))) 454 454 455 455 ... ... @@ -462,29 +462,25 @@ 462 462 ))) 463 463 464 464 465 -[[image:i mage-20231207153532-6.png||height="562" width="861"]]453 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592790040-760.png?rev=1.1||alt="1654592790040-760.png"]] 466 466 467 467 468 -[[image:i mage-20231207155940-8.png]]456 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592800389-571.png?rev=1.1||alt="1654592800389-571.png"]] 469 469 470 -For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]] 471 471 472 -[[image:image-20231207160733-11.png||height="429" width="759"]] 473 - 474 - 475 475 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 476 476 477 477 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.** 478 478 479 -[[image:i mage-20231207160343-10.png||height="665" width="705"]]463 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654851029373-510.png?rev=1.1||alt="1654851029373-510.png"]] 480 480 481 481 482 482 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake. 483 483 484 -[[image:image-202 31129100454-2.png||height="501" width="928"]]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"]] 485 485 486 486 487 -== 2. 6Frequency Plans ==471 +== 2.5 Frequency Plans == 488 488 489 489 490 490 The DS20L uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets. ... ... @@ -522,7 +522,7 @@ 522 522 == 3.3 Commands special design for DS20L == 523 523 524 524 525 - Belowcommands only valid for DS20L, as below:509 +These commands only valid for DS20L, as below: 526 526 527 527 528 528 === 3.3.1 Set Transmit Interval Time === ... ... @@ -565,9 +565,6 @@ 565 565 ))) 566 566 * ((( 567 567 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 568 - 569 - 570 - 571 571 ))) 572 572 573 573 === 3.3.2 Set Interrupt Mode === ... ... @@ -608,9 +608,10 @@ 608 608 609 609 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 610 610 611 -=== 3.3.3 Set work mode === 612 612 593 +== 3.3.3 Set work mode == 613 613 595 + 614 614 Feature: Switch working mode 615 615 616 616 (% style="color:blue" %)**AT Command: AT+MOD** ... ... @@ -625,9 +625,9 @@ 625 625 626 626 (% style="color:blue" %)**Downlink Command:** 627 627 628 -* **Example: **0x0A0 1~/~/ Same as AT+MOD=1610 +* **Example: **0x0A00 ~/~/ Same as AT+MOD=0 629 629 630 -* **Example:** 0x0A0 2~/~/ Same as AT+MOD=2612 +* **Example:** 0x0A01 ~/~/ Same as AT+MOD=1 631 631 632 632 === 3.3.4 Set threshold and threshold mode === 633 633 ... ... @@ -646,37 +646,21 @@ 646 646 ))) 647 647 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 648 648 649 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 650 -|=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 155px;background-color:#4F81BD;color:white" %) Parameter 651 -|(% rowspan="11" style="color:blue; width:120px" %)((( 652 - 653 653 654 654 655 - 656 - 657 - 658 - 659 - 660 - 661 - 662 - 663 -**AT+DOL=1,1800,3,0,400** 664 -)))|(% rowspan="4" style="width:240px" %)((( 665 - 666 - 667 - 668 - 669 -The first bit sets the limit mode 670 -)))|(% style="width:150px" %)0: Do not use upper and lower limits 633 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 634 +|(% 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 671 671 |(% style="width:251px" %)1: Use upper and lower limits 672 -|(% style="width:251px" %)2:Less than the upper limit636 +|(% style="width:251px" %)2: Less than the lower limit 673 673 |(% style="width:251px" %)3: Greater than the lower limit 638 +|(% style="width:251px" %)4: Less than the upper limit 639 +|(% style="width:251px" %)5: Greater than the upper limit 674 674 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM 675 675 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM 676 676 |(% rowspan="2" style="width:226px" %)The fourth bit sets the over-limit alarm or person or object count.|(% style="width:251px" %)0 Over-limit alarm, DO output is high 677 677 |(% style="width:251px" %)1 Person or object counting statistics 678 678 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)((( 679 - 100~~10000ms645 +0~~10000ms 680 680 681 681 682 682 ))) ... ... @@ -683,42 +683,14 @@ 683 683 684 684 (% style="color:blue" %)**Downlink Command: 0x07** 685 685 686 -Format: Command Code (0x07) followed by 9 652 +Format: Command Code (0x07) followed by 9bytes. 687 687 688 - Ifthedownlinkpayload=**0710708006400190**, it means set the END Node's limit mode to0x01,upper limit value to0x0708=1800(mm),lowerlimitvalueto0x0064=100(mm),to over-limit alarm(0x00),the sampling time to0x0190=400(ms), while type code is 0x07.654 +* Example 0: Downlink Payload: 070000000000000190 **~-~-->** AT+MOD=0,0,0,0,400 689 689 690 -* Example 0: Downlink Payload: 07 00 0000 0000 00 0190 **~-~-->** AT+MOD=0,0,0,0,400 691 - 692 692 * Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 693 693 694 -* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,1800,100,0,400 695 695 696 -* Example 3: Downlink Payload: 070300000064000190 **~-~-->** AT+MOD=3,0,100,0,400 697 697 698 -(% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.** 699 - 700 -**For example:** 701 - 702 -* **AT+MOD=1** 703 - 704 - **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 705 - 706 -Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1: 707 - 708 -[[image:image-20231211113204-2.png||height="292" width="1093"]] 709 - 710 -* **AT+MOD=2 ** 711 - 712 - **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 713 - 714 -If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1: 715 - 716 -[[image:image-20231211114932-3.png||height="277" width="1248"]] 717 - 718 - 719 - 720 - 721 - 722 722 = 4. Battery & Power Consumption = 723 723 724 724 ... ... @@ -755,33 +755,6 @@ 755 755 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"]] 756 756 757 757 758 -== 6.2 DS20L programming line == 759 - 760 - 761 -缺图 后续补上 762 - 763 -feature: 764 - 765 -for AT commands 766 - 767 -Update the firmware of DS20L 768 - 769 -Support interrupt mode 770 - 771 - 772 -== 6.3 LiDAR probe position == 773 - 774 - 775 -[[image:1701155390576-216.png||height="285" width="307"]] 776 - 777 -The black oval hole in the picture is the LiDAR probe. 778 - 779 - 780 -== 6.4 Interface definition == 781 - 782 -[[image:image-20231128151132-2.png||height="305" width="557"]] 783 - 784 - 785 785 = 7. Trouble Shooting = 786 786 787 787 == 7.1 AT Command input doesn't work ==
- 1701152946067-561.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -52.2 KB - Content
- 1701155076393-719.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -54.6 KB - Content
- 1701155150328-206.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -54.6 KB - Content
- 1701155390576-216.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -293.9 KB - Content
- image-20231128151132-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -281.2 KB - Content
- image-20231129085201-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -70.6 KB - Content
- image-20231129100454-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -70.1 KB - Content
- image-20231206143515-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -89.5 KB - Content
- image-20231206144950-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -41.0 KB - Content
- image-20231206151412-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -58.8 KB - Content
- image-20231206154621-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -71.2 KB - Content
- image-20231206194804-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -53.7 KB - Content
- image-20231206195704-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.1 KB - Content
- image-20231207142208-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.2 KB - Content
- image-20231207144600-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -55.4 KB - Content
- image-20231207144837-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -31.1 KB - Content
- image-20231207144856-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -31.1 KB - Content
- image-20231207145121-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -33.3 KB - Content
- image-20231207153532-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -164.7 KB - Content
- image-20231207154046-7.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -23.0 KB - Content
- image-20231207155940-8.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -41.7 KB - Content
- image-20231207160053-9.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -95.5 KB - Content
- image-20231207160343-10.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -80.5 KB - Content
- image-20231207160733-11.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -136.0 KB - Content
- image-20231209152917-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -65.9 KB - Content
- image-20231209155616-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -57.1 KB - Content
- image-20231209171127-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -80.8 KB - Content
- image-20231209171549-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -45.7 KB - Content
- image-20231209173457-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -66.3 KB - Content
- image-20231211113113-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.5 KB - Content
- image-20231211113204-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -59.7 KB - Content
- image-20231211114932-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -57.3 KB - Content
- image-20231211220922-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -411.2 KB - Content
- image-20231211221253-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -90.8 KB - Content
- image-20231211221436-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.9 KB - Content