Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 171.1
edited by Mengting Qiu
on 2023/12/12 11:11
on 2023/12/12 11:11
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 33 removed)
- 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,40 +215,45 @@ 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 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 +))) 227 227 228 - **MOD+Alarm+Interrupt:**229 +==== (% style="color:red" %)**MOD~=1** ==== 229 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 231 +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. 235 235 236 - 0:NoAlarm;233 +Uplink Payload totals 10 bytes. 237 237 238 -1: Alarm 239 -))) 235 +(% border="1" cellspacing="4" style="width:510px;background-color:#f2f2f2" %) 236 +|(% style="width:60px;background-color:#4F81BD;color:white" %)**Size(bytes)**|(% style="width:30px;background-color:#4F81BD;color:white" %)**2**|(% style="width:130px;background-color:#4F81BD;color:white" %)**1**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2**|(% style="width:100px;background-color:#4F81BD;color:white" %)**1**|(% style="width:120px;background-color:#4F81BD;color:white" %)**4** 237 +|(% style="width:91px" %)Value|(% style="width:41px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count 240 240 241 -Example parse in TTNv3 242 242 243 -[[image:i mage-20231209152917-1.png||height="300" width="1172"]]240 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 244 244 245 -(% style="color:blue" %)**Battery Info :**242 +(% style="color:blue" %)**Battery Info** 246 246 247 247 Check the battery voltage for DS20L 248 248 249 249 Ex1: 0x0E10 = 3600mV 250 250 251 - 252 252 (% style="color:blue" %)**MOD & Alarm & Interrupt:** 253 253 254 254 (% style="color:red" %)**MOD:** ... ... @@ -266,80 +266,36 @@ 266 266 267 267 Whether it is an external interrupt. 268 268 265 +(% style="color:blue" %)**Distance info** 269 269 270 -(% style="color:blue" %)**Distance info:** 271 - 272 272 **Example**: 273 273 274 274 If payload is: 0708H: distance = 0708H = 1800 mm 275 275 271 +(% style="color:blue" %)**Sensor State** 276 276 277 -(% style="color:blue" %)**Sensor State:** 278 - 279 279 Ex1: 0x00: Normal collection distance 280 280 281 -Ex2 :0x0x: Distance collection is wrong275 +Ex2 0x0x: Distance collection is wrong 282 282 277 +(% style="color:blue" %)**Interript Count** 283 283 284 -(% style="color:blue" %)**Interrupt Count:** 285 - 286 286 If payload is:000007D0H: count = 07D0H =2000 287 287 288 288 289 289 290 -==== (% style="color:red" %)**AT+MOD~=2**(%%)** ** ==== 291 291 284 +==== (% style="color:red" %)**MOD=2** ==== 292 292 293 - The power consumptionof uninterrupted measurementishigh, andthe deviceneeds touseexternalpowersupply.(TheswitchisswitchedtoEandtheexternal power supplysused.)286 +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. 294 294 295 -[[image:image-20231128133704-1.png||height="189" width="441"]] 288 +(% border="1" cellspacing="4" style="width:510px;background-color:#f2f2f2" %) 289 +|(% style="width:70px;background-color:#4F81BD;color:white" %)**Size(bytes)**|(% style="width:40px;background-color:#4F81BD;color:white" %)**2**|(% style="width:130px;background-color:#4F81BD;color:white" %)**1**|(% style="width:130px;background-color:#4F81BD;color:white" %)**4**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2**|(% style="width:70px;background-color:#4F81BD;color:white" %)**2** 290 +|(% style="width:91px" %)Value|(% style="width:41px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% 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 296 296 297 297 298 - * **Set over-limitalarm mode:T+DOL=3,500,244,**(%style="color:red" %)0(%%)**,120**293 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 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. 302 - 303 -(% class="wikigeneratedid" %) 304 -**Uplink Payload totals 9 bytes.** 305 - 306 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 307 -|(% 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** 308 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:74px" %)Distance |(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 309 - 310 -**MOD+DO+ Alarm+ Do flag+ Limit flag:** 311 - 312 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 313 -|(% 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:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]** 314 -|(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)((( 315 -((( 316 -DO 317 -))) 318 - 319 -((( 320 -0:Within limit 321 - 322 -1:Out of limit 323 -))) 324 -)))|(% style="width:73px" %)((( 325 -Alarm 326 - 327 -0: No Alarm; 328 - 329 -1: Alarm 330 -)))|(% style="width:150px" %)((( 331 -DO flag 332 - 333 -0:the over-limit alarm mode 334 - 335 -1:the person or object count mode 336 -)))|(% style="width:103px" %)Limit flag 337 -(0~~3) 338 - 339 -Example parse in TTNv3 340 - 341 -[[image:image-20231209171127-3.png||height="374" width="1209"]] 342 - 343 343 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 344 344 345 345 (% style="color:red" %)**MOD:** ... ... @@ -353,154 +353,124 @@ 353 353 354 354 When the detection distance exceeds the limit, the alarm flag is set to 1. 355 355 356 -(% style="color:red" %)**D O:**308 +(% style="color:red" %)**Do:** 357 357 358 358 When the distance exceeds the set threshold, pull the Do pin high. 359 359 360 360 (% style="color:red" %)**Limit flag:** 361 361 362 -Mode for setting threshold: **0~~3**314 +Mode for setting threshold: 0~~5 363 363 364 - **0:**does not use upper and lower limits316 +0: does not use upper and lower limits 365 365 366 - **1:**Use upper and lower limits318 +1: Use upper and lower limits 367 367 368 - **2:**Less than theupper limit320 +2: is less than the lower limit value 369 369 370 - **3:**Greater than the lower limit322 +3: is greater than the lower limit value 371 371 324 +4: is less than the upper limit 372 372 373 - (%style="color:blue"%)**Distance:**326 +5: is greater than the upper limit 374 374 375 - Actual sampling distance values. 376 376 377 -**Example:** 378 - 379 -**AT+DOL=1,500,244,**(% style="color:red" %)0(%%)**,120 ** 380 - 381 -The distance is detected every 120ms. 382 - 383 -When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time. 384 - 385 -When the actual detection value is outside the range of [244mm,500mm], the uplink data will be immediately alerted. 386 - 387 -If payload is: 0708H: distance = 0708H = 1800 mm 388 - 389 - 390 390 (% style="color:blue" %)**Upper limit:** 391 391 392 392 The upper limit of the threshold cannot exceed 2000mm. 393 393 394 - 395 395 (% style="color:blue" %)**Lower limit:** 396 396 397 397 The lower limit of the threshold cannot be less than 3mm. 398 398 399 399 400 - ***Setthe person orobjectcountmode: AT+DOL=1,500,244,**(%style="color:red" %)1(%%)**,120**338 +=== 2.3.3 Historical measuring distance, FPORT~=3 === 401 401 402 -Continuous measurement, detect and count people or things passing by in distance limit mode. 403 403 404 - **UplinkPayload totals11bytes.**341 +DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]]. 405 405 406 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 407 -|(% 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** 408 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:176px" %)Distance limit alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit 343 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance. 409 409 410 -**MOD+DO+ Alarm+ Do flag+ Limit flag:** 345 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 346 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 347 +**Size(bytes)** 348 +)))|=(% 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 349 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)((( 350 +Reserve(0xFF) 351 +)))|Distance|Distance signal strength|(% style="width:88px" %)((( 352 +LiDAR temp 353 +)))|(% style="width:85px" %)Unix TimeStamp 411 411 412 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %) 413 -|(% 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:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]** 414 -|(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)((( 415 -((( 416 -DO 355 +**Interrupt flag & Interrupt level:** 356 + 357 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %) 358 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 359 +**Size(bit)** 360 +)))|=(% 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** 361 +|(% 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" %)((( 362 +Interrupt flag 417 417 ))) 418 418 419 -((( 420 -0:Within limit 421 - 422 -1:Out of limit 365 +* ((( 366 +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. 423 423 ))) 424 -)))|(% style="width:73px" %)((( 425 -Alarm 426 426 427 - 0: NoAlarm;369 +For example, in the US915 band, the max payload for different DR is: 428 428 429 -1: Alarm 430 -)))|(% style="width:150px" %)((( 431 -DO flag 371 +**a) DR0:** max is 11 bytes so one entry of data 432 432 433 - 0:the over-limitalarmmode373 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 434 434 435 -1:the person or object count mode 436 -)))|(% style="width:103px" %)Limit flag 437 -(0~~3) 375 +**c) DR2:** total payload includes 11 entries of data 438 438 439 - ExampleparseinTTNv3377 +**d) DR3:** total payload includes 22 entries of data. 440 440 441 - [[image:image-20231209173457-5.png||height="277"width="1098"]]379 +If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0 442 442 443 -(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:** 444 444 445 - (% style="color:red" %)**MOD:**382 +**Downlink:** 446 446 447 - **Example:**(0x60>>6)&0x3f=1384 +0x31 64 CC 68 0C 64 CC 69 74 05 448 448 449 -**0x01:** Regularly detect distance and report. 450 -**0x02: ** Uninterrupted measurement (external power supply). 386 +[[image:image-20230805144936-2.png||height="113" width="746"]] 451 451 452 - (% style="color:red" %)**Alarm:**388 +**Uplink:** 453 453 454 - Whenthedetectiondistanceexceedsthelimit,thealarmflagissetto1.390 +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 455 455 456 -(% style="color:red" %)**Do:** 457 457 458 - When the distance exceeds the set threshold,pull theDo pin high.393 +**Parsed Value:** 459 459 460 - (%style="color:red"%)**Limitflag:**395 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS , EXTI_FLAG , TIME] 461 461 462 -Mode for setting threshold: **0~~3** 463 463 464 - **0:** does notuseupper and lower limits398 +[360,176,30,High,True,2023-08-04 02:53:00], 465 465 466 - **1:** Use upper and lowerlimits400 +[355,168,30,Low,False,2023-08-04 02:53:29], 467 467 468 - **2:**Less than theupper limit402 +[245,211,30,Low,False,2023-08-04 02:54:29], 469 469 470 - **3: **Greater than the lowerlimit404 +[57,700,30,Low,False,2023-08-04 02:55:29], 471 471 406 +[361,164,30,Low,True,2023-08-04 02:56:00], 472 472 473 - (% style="color:blue" %)**Distancelimit alarm count:**408 +[337,184,30,Low,False,2023-08-04 02:56:40], 474 474 475 - People or objects are collected and countedwithinaimited distance.410 +[20,4458,30,Low,False,2023-08-04 02:57:40], 476 476 477 - The detection of a stationary person or object at each sampling timewill be repeated three times,nd the fourth sampling count will beadded by 1.412 +[362,173,30,Low,False,2023-08-04 02:58:53], 478 478 479 -**Example:** 480 480 481 -** AT+DOL=1,500,244,**(%style="color:red"%)1(%%)**,120**415 +**History read from serial port:** 482 482 483 - People or objects passingwithin thedistance rangeof [244mm,500mm] are detected and counted every120ms.417 +[[image:image-20230805145056-3.png]] 484 484 485 -If payload is: 0x56H, interrupt count =0x56H =86 486 486 420 +=== 2.3.4 Decode payload in The Things Network === 487 487 488 -(% style="color:blue" %)**Upper limit:** 489 489 490 -The upper limit of the threshold cannot exceed 2000mm. 491 - 492 - 493 -(% style="color:blue" %)**Lower limit:** 494 - 495 -The lower limit of the threshold cannot be less than 3mm. 496 - 497 - 498 -== 2.4 Decode payload in The Things Network == 499 - 500 - 501 501 While using TTN network, you can add the payload format to decode the payload. 502 502 503 -[[image:i mage-20231206143515-1.png||height="534" width="759"]]425 +[[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"]] 504 504 505 505 506 506 ((( ... ... @@ -512,11 +512,11 @@ 512 512 ))) 513 513 514 514 515 -== 2. 5Show Data in DataCake IoT Server ==437 +== 2.4 Show Data in DataCake IoT Server == 516 516 517 517 518 518 ((( 519 -[[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:441 +[[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: 520 520 ))) 521 521 522 522 ... ... @@ -529,29 +529,25 @@ 529 529 ))) 530 530 531 531 532 -[[image:i mage-20231207153532-6.png||height="562" width="861"]]454 +[[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"]] 533 533 534 534 535 -[[image:i mage-20231207155940-8.png]]457 +[[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"]] 536 536 537 -For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]] 538 538 539 -[[image:image-20231207160733-11.png||height="429" width="759"]] 540 - 541 - 542 542 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 543 543 544 544 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.** 545 545 546 -[[image:i mage-20231207160343-10.png||height="665" width="705"]]464 +[[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"]] 547 547 548 548 549 549 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake. 550 550 551 -[[image: image-20231129100454-2.png||height="501" width="928"]]469 +[[image:1701152946067-561.png]] 552 552 553 553 554 -== 2. 6Frequency Plans ==472 +== 2.5 Frequency Plans == 555 555 556 556 557 557 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. ... ... @@ -589,7 +589,7 @@ 589 589 == 3.3 Commands special design for DS20L == 590 590 591 591 592 - Belowcommands only valid for DS20L, as below:510 +These commands only valid for DS20L, as below: 593 593 594 594 595 595 === 3.3.1 Set Transmit Interval Time === ... ... @@ -632,9 +632,6 @@ 632 632 ))) 633 633 * ((( 634 634 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 635 - 636 - 637 - 638 638 ))) 639 639 640 640 === 3.3.2 Set Interrupt Mode === ... ... @@ -675,9 +675,10 @@ 675 675 676 676 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 677 677 678 -=== 3.3.3 Set work mode === 679 679 594 +== 3.3.3 Set work mode == 680 680 596 + 681 681 Feature: Switch working mode 682 682 683 683 (% style="color:blue" %)**AT Command: AT+MOD** ... ... @@ -692,9 +692,9 @@ 692 692 693 693 (% style="color:blue" %)**Downlink Command:** 694 694 695 -* **Example: **0x0A0 1~/~/ Same as AT+MOD=1611 +* **Example: **0x0A00 ~/~/ Same as AT+MOD=0 696 696 697 -* **Example:** 0x0A0 2~/~/ Same as AT+MOD=2613 +* **Example:** 0x0A01 ~/~/ Same as AT+MOD=1 698 698 699 699 === 3.3.4 Set threshold and threshold mode === 700 700 ... ... @@ -713,37 +713,21 @@ 713 713 ))) 714 714 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK 715 715 716 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 717 -|=(% 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 718 -|(% rowspan="11" style="color:blue; width:120px" %)((( 719 - 720 720 721 721 722 - 723 - 724 - 725 - 726 - 727 - 728 - 729 - 730 -**AT+DOL=1,1800,3,0,400** 731 -)))|(% rowspan="4" style="width:240px" %)((( 732 - 733 - 734 - 735 - 736 -The first bit sets the limit mode 737 -)))|(% style="width:150px" %)0: Do not use upper and lower limits 634 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 635 +|(% 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 738 738 |(% style="width:251px" %)1: Use upper and lower limits 739 -|(% style="width:251px" %)2:Less than the upper limit637 +|(% style="width:251px" %)2: Less than the lower limit 740 740 |(% style="width:251px" %)3: Greater than the lower limit 639 +|(% style="width:251px" %)4: Less than the upper limit 640 +|(% style="width:251px" %)5: Greater than the upper limit 741 741 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM 742 742 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM 743 743 |(% 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 744 744 |(% style="width:251px" %)1 Person or object counting statistics 745 745 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)((( 746 - 100~~10000ms646 +0~~10000ms 747 747 748 748 749 749 ))) ... ... @@ -750,42 +750,14 @@ 750 750 751 751 (% style="color:blue" %)**Downlink Command: 0x07** 752 752 753 -Format: Command Code (0x07) followed by 9 653 +Format: Command Code (0x07) followed by 9bytes. 754 754 755 - 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.655 +* Example 0: Downlink Payload: 070000000000000190 **~-~-->** AT+MOD=0,0,0,0,400 756 756 757 -* Example 0: Downlink Payload: 07 00 0000 0000 00 0190 **~-~-->** AT+MOD=0,0,0,0,400 758 - 759 759 * Example 1: Downlink Payload: 070107080064000190 **~-~-->** AT+MOD=1,1800,100,0,400 760 760 761 -* Example 2: Downlink Payload: 070200000064000190 **~-~-->** AT+MOD=2,1800,100,0,400 762 762 763 -* Example 3: Downlink Payload: 070300000064000190 **~-~-->** AT+MOD=3,0,100,0,400 764 764 765 -(% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.** 766 - 767 -**For example:** 768 - 769 -* **AT+MOD=1** 770 - 771 - **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 772 - 773 -Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1: 774 - 775 -[[image:image-20231211113204-2.png||height="292" width="1093"]] 776 - 777 -* **AT+MOD=2 ** 778 - 779 - **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300** 780 - 781 -If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1: 782 - 783 -[[image:image-20231211114932-3.png||height="277" width="1248"]] 784 - 785 - 786 - 787 - 788 - 789 789 = 4. Battery & Power Consumption = 790 790 791 791 ... ... @@ -822,33 +822,6 @@ 822 822 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"]] 823 823 824 824 825 -== 6.2 DS20L programming line == 826 - 827 - 828 -缺图 后续补上 829 - 830 -feature: 831 - 832 -for AT commands 833 - 834 -Update the firmware of DS20L 835 - 836 -Support interrupt mode 837 - 838 - 839 -== 6.3 LiDAR probe position == 840 - 841 - 842 -[[image:1701155390576-216.png||height="285" width="307"]] 843 - 844 -The black oval hole in the picture is the LiDAR probe. 845 - 846 - 847 -== 6.4 Interface definition == 848 - 849 -[[image:image-20231128151132-2.png||height="305" width="557"]] 850 - 851 - 852 852 = 7. Trouble Shooting = 853 853 854 854 == 7.1 AT Command input doesn't work ==
- 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