Skip to Content
Version 156.1 by Mengting Qiu on 2023/12/09 17:11
Hide last authors
Ellie Zhang 26.1 1 (% style="text-align:center" %)
Xiaoling 111.2 2 [[image:image-20231110085342-2.png||height="481" width="481"]]
Edwin Chen 1.1 3
4
Xiaoling 67.2 5
Xiaoling 75.2 6
7
8
9
Xiaoling 111.2 10
Xiaoling 126.3 11 **Table of Contents:(% style="display:none" %) (%%)**
Ellie Zhang 30.1 12
Edwin Chen 1.1 13 {{toc/}}
14
15
16
17
18
19
kai 31.1 20 = 1. Introduction =
Edwin Chen 1.1 21
Xiaoling 113.3 22 == 1.1 What is LoRaWAN Smart Distance Detector ==
Edwin Chen 1.1 23
Xiaoling 39.6 24
Edwin Chen 115.1 25 The Dragino (% style="color:blue" %)**DS20L is a smart distance detector**(%%) base on long-range wireless LoRaWAN technology. It uses (% style="color:blue" %)**LiDAR sensor**(%%) to detect the distance between DS20L and object, then DS20L will send the distance data to the IoT Platform via LoRaWAN. DS20L can measure range between 3cm ~~ 200cm.
Edwin Chen 1.1 26
Xiaoling 113.3 27 DS20L allows users to send data and reach extremely long ranges via LoRaWAN. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current 
28 consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on.
Edwin Chen 1.1 29
Xiaoling 113.3 30 DS20L has a (% style="color:blue" %)**built-in 2400mAh non-chargeable battery**(%%) for long-term use up to several years*. Users can also power DS20L with an external power source for (% style="color:blue" %)**continuous measuring and distance alarm / counting purposes.**
Edwin Chen 1.1 31
Xiaoling 113.3 32 DS20L is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
Xiaoling 62.4 33
Edwin Chen 1.1 34
Xiaoling 114.2 35 [[image:image-20231110102635-5.png||height="402" width="807"]]
Edwin Chen 1.1 36
Xiaoling 64.2 37
Edwin Chen 1.1 38 == 1.2 ​Features ==
39
Xiaoling 39.6 40
Xiaoling 113.4 41 * LoRaWAN Class A protocol
42 * LiDAR distance detector, range 3 ~~ 200cm
43 * Periodically detect or continuously detect mode
Xiaoling 70.5 44 * AT Commands to change parameters
Xiaoling 113.4 45 * Remotely configure parameters via LoRaWAN Downlink
46 * Alarm & Counting mode
47 * Firmware upgradable via program port or LoRa protocol
48 * Built-in 2400mAh battery or power by external power source
Edwin Chen 1.1 49
50 == 1.3 Specification ==
51
52
Xiaoling 113.5 53 (% style="color:#037691" %)**LiDAR Sensor:**
Xiaoling 70.6 54
Xiaoling 113.5 55 * Operation Temperature: -40 ~~ 80 °C
56 * Operation Humidity: 0~~99.9%RH (no Dew)
57 * Storage Temperature: -10 ~~ 45°C
Xiaoling 113.4 58 * Measure Range: 3cm~~200cm @ 90% reflectivity
59 * Accuracy: ±2cm @ (3cm~~100cm); ±5% @ (100~~200cm)
60 * ToF FoV: ±9°, Total 18°
61 * Light source: VCSEL
Xiaoling 82.3 62
Edwin Chen 115.1 63 == 1.4 Power Consumption ==
Xiaoling 114.2 64
Edwin Chen 115.1 65
Xiaoling 116.2 66 (% style="color:#037691" %)**Battery Power Mode:**
Edwin Chen 115.1 67
kai 116.1 68 * Idle: 0.003 mA @ 3.3v
69 * Max : 360 mA
Edwin Chen 115.1 70
Xiaoling 116.2 71 (% style="color:#037691" %)**Continuously mode**:
Edwin Chen 115.1 72
kai 116.1 73 * Idle: 21 mA @ 3.3v
74 * Max : 360 mA
Edwin Chen 115.1 75
Xiaoling 113.5 76 = 2. Configure DS20L to connect to LoRaWAN network =
Xiaoling 77.4 77
Edwin Chen 1.1 78 == 2.1 How it works ==
79
80
Xiaoling 113.6 81 The DS20L is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS20L. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
Edwin Chen 1.1 82
Xiaoling 64.2 83 (% style="display:none" %) (%%)
Edwin Chen 1.1 84
85 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
86
87
88 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
89
Xiaoling 114.2 90 The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.(% style="display:none" %)
Edwin Chen 1.1 91
Xiaoling 114.2 92 [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
Edwin Chen 1.1 93
Mengting Qiu 140.1 94 === Step 1: Create a device in TTN with the OTAA keys from DS20L. ===
Edwin Chen 1.1 95
Xiaoling 113.6 96 Each DS20L is shipped with a sticker with the default device EUI as below:
Edwin Chen 1.1 97
Ellie Zhang 30.1 98 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
Edwin Chen 1.1 99
100
Mengting Qiu 140.1 101 You can enter this key in the LoRaWAN Server portal. Below is TTN V3 screenshot:
Edwin Chen 1.1 102
103
104 (% style="color:blue" %)**Register the device**
105
Mengting Qiu 140.1 106 [[image:image-20231207144600-2.png||height="703" width="756"]]
Edwin Chen 1.1 107
108
Mengting Qiu 140.1 109 (% style="color:blue" %)**Add DevEUI and AppKey**
Edwin Chen 1.1 110
Mengting Qiu 140.1 111 [[image:image-20231207145121-5.png||height="540" width="756"]]
Edwin Chen 1.1 112
113
114
Mengting Qiu 140.1 115 === Step 2: Activate on DS20L ===
Edwin Chen 1.1 116
Xiaoling 118.2 117 [[image:image-20231128133704-1.png||height="189" width="441"]]
Edwin Chen 1.1 118
Xiaoling 113.6 119 Press the button for 5 seconds to activate the DS20L.
Edwin Chen 6.1 120
Edwin Chen 1.1 121 (% 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.
122
123 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
124
125
Mengting Qiu 140.1 126
Xiaoling 82.8 127 == 2.3 ​Uplink Payload ==
Edwin Chen 1.1 128
Saxer Lin 85.1 129 === 2.3.1 Device Status, FPORT~=5 ===
130
Xiaoling 90.2 131
Xiaoling 113.6 132 Users can use the downlink command(**0x26 01**) to ask DS20L to send device configure detail, include device configure status. DS20L will uplink a payload via FPort=5 to server.
Saxer Lin 85.1 133
134 The Payload format is as below.
135
Xiaoling 90.2 136 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 90.11 137 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
Saxer Lin 85.1 138 **Size(bytes)**
Xiaoling 90.11 139 )))|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**1**|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**2**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 50px;" %)**2**
Saxer Lin 85.1 140 |(% style="width:62.5px" %)Value|(% style="width:110px" %)Sensor Model|(% style="width:48px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:91px" %)Sub-band|(% style="width:60px" %)BAT
141
142 Example parse in TTNv3
143
Mengting Qiu 130.2 144 [[image:image-20231206151412-3.png||height="179" width="1070"]]
Saxer Lin 93.1 145
Xiaoling 118.2 146 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
Saxer Lin 85.1 147
Xiaoling 90.17 148 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
Saxer Lin 85.1 149
Xiaoling 90.17 150 (% style="color:blue" %)**Frequency Band**:
Saxer Lin 85.1 151
152 0x01: EU868
153
154 0x02: US915
155
156 0x03: IN865
157
158 0x04: AU915
159
160 0x05: KZ865
161
162 0x06: RU864
163
164 0x07: AS923
165
166 0x08: AS923-1
167
168 0x09: AS923-2
169
170 0x0a: AS923-3
171
172 0x0b: CN470
173
174 0x0c: EU433
175
176 0x0d: KR920
177
178 0x0e: MA869
179
Xiaoling 90.17 180 (% style="color:blue" %)**Sub-Band**:
Saxer Lin 85.1 181
182 AU915 and US915:value 0x00 ~~ 0x08
183
184 CN470: value 0x0B ~~ 0x0C
185
186 Other Bands: Always 0x00
187
Xiaoling 90.17 188 (% style="color:blue" %)**Battery Info**:
Saxer Lin 85.1 189
190 Check the battery voltage.
191
192 Ex1: 0x0B45 = 2885mV
193
194 Ex2: 0x0B49 = 2889mV
195
196
Saxer Lin 89.1 197 === 2.3.2 Uplink Payload, FPORT~=2 ===
Saxer Lin 85.1 198
Xiaoling 90.2 199
Xiaoling 124.2 200 ==== (% style="color:red" %)**MOD~=1**(%%) ====
Edwin Chen 1.1 201
Xiaoling 120.2 202 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.
Edwin Chen 1.1 203
Xiaoling 120.2 204 Uplink Payload totals 10 bytes.
Edwin Chen 1.1 205
Xiaoling 124.2 206 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
207 |(% 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**
208 |(% 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
Edwin Chen 1.1 209
Mengting Qiu 154.1 210 [[image:image-20231209152917-1.png||height="300" width="1172"]]
Edwin Chen 1.1 211
Xiaoling 124.2 212 (% style="color:blue" %)**Battery Info:**
Edwin Chen 1.1 213
Xiaoling 120.2 214 Check the battery voltage for DS20L
Edwin Chen 1.1 215
Xiaoling 120.2 216 Ex1: 0x0E10 = 3600mV
Xiaoling 67.7 217
Xiaoling 124.2 218
Xiaoling 120.8 219 (% style="color:blue" %)**MOD & Alarm & Interrupt:**
Xiaoling 67.7 220
Xiaoling 120.8 221 (% style="color:red" %)**MOD:**
Edwin Chen 1.1 222
Xiaoling 120.2 223 **Example: ** (0x60>>6) & 0x3f =1
Xiaoling 14.22 224
Xiaoling 120.2 225 **0x01:**  Regularly detect distance and report.
226 **0x02: ** Uninterrupted measurement (external power supply).
Edwin Chen 1.1 227
Xiaoling 120.8 228 (% style="color:red" %)**Alarm:**
Xiaoling 79.11 229
Xiaoling 120.2 230 When the detection distance exceeds the limit, the alarm flag is set to 1.
Xiaoling 67.7 231
Xiaoling 120.8 232 (% style="color:red" %)**Interrupt:**
Xiaoling 67.7 233
Xiaoling 120.2 234 Whether it is an external interrupt.
Edwin Chen 10.1 235
Edwin Chen 1.1 236
Xiaoling 124.2 237 (% style="color:blue" %)**Distance info:**
238
Xiaoling 82.4 239 **Example**:
240
Xiaoling 120.2 241 If payload is: 0708H: distance = 0708H = 1800 mm
Xiaoling 82.4 242
243
Xiaoling 124.2 244 (% style="color:blue" %)**Sensor State:**
245
Xiaoling 120.2 246 Ex1: 0x00: Normal collection distance
Xiaoling 82.4 247
Xiaoling 120.2 248 Ex2 0x0x: Distance collection is wrong
Xiaoling 82.4 249
250
Xiaoling 124.2 251 (% style="color:blue" %)**Interript Count:**
252
Xiaoling 120.2 253 If payload is:000007D0H: count = 07D0H =2000
Xiaoling 82.4 254
255
Xiaoling 120.8 256
Xiaoling 124.2 257 ==== (% style="color:red" %)**MOD~=2**(%%)** ** ====
Xiaoling 120.8 258
Xiaoling 120.2 259 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.
Xiaoling 82.4 260
Xiaoling 124.2 261 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
262 |(% 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**
263 |(% 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
Xiaoling 82.4 264
Mengting Qiu 155.2 265 [[image:image-20231209155616-2.png||height="271" width="1262"]]
Xiaoling 82.4 266
Xiaoling 120.8 267 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
Saxer Lin 104.1 268
Xiaoling 120.8 269 (% style="color:red" %)**MOD:**
Saxer Lin 104.1 270
Xiaoling 120.2 271 **Example: ** (0x60>>6) & 0x3f =1
Saxer Lin 104.1 272
Xiaoling 120.2 273 **0x01:**  Regularly detect distance and report.
274 **0x02: ** Uninterrupted measurement (external power supply).
Saxer Lin 104.1 275
Xiaoling 120.8 276 (% style="color:red" %)**Alarm:**
Saxer Lin 104.1 277
Xiaoling 120.2 278 When the detection distance exceeds the limit, the alarm flag is set to 1.
Saxer Lin 104.1 279
Xiaoling 120.8 280 (% style="color:red" %)**Do:**
Saxer Lin 104.1 281
Xiaoling 120.2 282 When the distance exceeds the set threshold, pull the Do pin high.
Saxer Lin 104.1 283
Xiaoling 120.8 284 (% style="color:red" %)**Limit flag:**
Xiaoling 82.4 285
Mengting Qiu 152.1 286 Mode for setting threshold: **0~~3**
Xiaoling 82.4 287
Xiaoling 125.6 288 **0:** does not use upper and lower limits
Xiaoling 82.4 289
Xiaoling 125.6 290 **1:** Use upper and lower limits
Xiaoling 82.4 291
Mengting Qiu 152.1 292 **2:** Less than the upper limit
Edwin Chen 1.1 293
Mengting Qiu 152.1 294 **3: **Greater than the lower limit
Edwin Chen 1.1 295
296
Xiaoling 120.8 297 (% style="color:blue" %)**Upper limit:**
298
Xiaoling 120.2 299 The upper limit of the threshold cannot exceed 2000mm.
Edwin Chen 1.1 300
Xiaoling 124.2 301
Xiaoling 120.8 302 (% style="color:blue" %)**Lower limit:**
Edwin Chen 1.1 303
Xiaoling 120.2 304 The lower limit of the threshold cannot be less than 3mm.
Edwin Chen 1.1 305
Xiaoling 39.5 306
Xiaoling 125.8 307 == 2.4 Decode payload in The Things Network ==
Saxer Lin 97.1 308
Saxer Lin 99.1 309
Xiaoling 70.10 310 While using TTN network, you can add the payload format to decode the payload.
Edwin Chen 1.1 311
Mengting Qiu 130.2 312 [[image:image-20231206143515-1.png||height="534" width="759"]]
Edwin Chen 1.1 313
314
Xiaoling 62.5 315 (((
Xiaoling 82.4 316 The payload decoder function for TTN is here:
Xiaoling 62.5 317 )))
Edwin Chen 1.1 318
Xiaoling 82.4 319 (((
Xiaoling 113.6 320 DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
Xiaoling 82.4 321 )))
Edwin Chen 1.1 322
Xiaoling 82.4 323
Xiaoling 125.8 324 == 2.5 ​Show Data in DataCake IoT Server ==
Edwin Chen 1.1 325
326
Xiaoling 62.5 327 (((
Xiaoling 70.10 328 [[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:
Xiaoling 62.5 329 )))
Edwin Chen 1.1 330
331
Xiaoling 62.5 332 (((
Xiaoling 70.10 333 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
Xiaoling 62.5 334 )))
Edwin Chen 1.1 335
Xiaoling 62.5 336 (((
Xiaoling 70.10 337 (% style="color:blue" %)**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:**
Xiaoling 62.5 338 )))
Xiaoling 14.26 339
Saxer Lin 55.1 340
Mengting Qiu 148.1 341 [[image:image-20231207153532-6.png||height="562" width="861"]]
Edwin Chen 1.1 342
343
Mengting Qiu 148.1 344 [[image:image-20231207155940-8.png]]
Edwin Chen 1.1 345
Mengting Qiu 148.1 346 For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]]
Edwin Chen 1.1 347
Mengting Qiu 148.1 348 [[image:image-20231207160733-11.png||height="429" width="759"]]
349
350
Xiaoling 70.10 351 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
Edwin Chen 1.1 352
Xiaoling 113.6 353 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
Edwin Chen 1.1 354
Mengting Qiu 148.1 355 [[image:image-20231207160343-10.png||height="665" width="705"]]
Xiaoling 62.5 356
Edwin Chen 1.1 357
Xiaoling 70.10 358 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
Edwin Chen 1.1 359
Xiaoling 126.2 360 [[image:image-20231129100454-2.png||height="501" width="928"]]
Edwin Chen 1.1 361
362
Xiaoling 125.8 363 == 2.6 Frequency Plans ==
Edwin Chen 1.1 364
365
Xiaoling 113.7 366 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.
Edwin Chen 1.1 367
368 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
369
370
Xiaoling 118.2 371 = 3. Configure DS20L =
Xiaoling 82.4 372
kai 16.4 373 == 3.1 Configure Methods ==
Edwin Chen 1.1 374
375
Xiaoling 113.7 376 DS20L supports below configure method:
Edwin Chen 1.1 377
378 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
Xiaoling 67.20 379
Edwin Chen 11.1 380 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
Xiaoling 67.20 381
Edwin Chen 1.1 382 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
383
384 == 3.2 General Commands ==
385
386
387 These commands are to configure:
388
389 * General system settings like: uplink interval.
Xiaoling 67.20 390
Edwin Chen 1.1 391 * LoRaWAN protocol & radio related command.
392
393 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
394
395 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
396
397
Xiaoling 113.7 398 == 3.3 Commands special design for DS20L ==
Edwin Chen 1.1 399
400
Xiaoling 113.7 401 These commands only valid for DS20L, as below:
Edwin Chen 1.1 402
403
404 === 3.3.1 Set Transmit Interval Time ===
405
406
Xiaoling 62.5 407 (((
Edwin Chen 1.1 408 Feature: Change LoRaWAN End Node Transmit Interval.
Xiaoling 62.5 409 )))
410
411 (((
Edwin Chen 1.1 412 (% style="color:blue" %)**AT Command: AT+TDC**
Xiaoling 62.5 413 )))
Edwin Chen 1.1 414
Xiaoling 14.34 415 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 82.16 416 |=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
Edwin Chen 1.1 417 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
418 30000
419 OK
420 the interval is 30000ms = 30s
421 )))
422 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
423 OK
424 Set transmit interval to 60000ms = 60 seconds
425 )))
426
Xiaoling 62.5 427 (((
Edwin Chen 1.1 428 (% style="color:blue" %)**Downlink Command: 0x01**
Xiaoling 62.5 429 )))
Edwin Chen 1.1 430
Xiaoling 62.5 431 (((
Edwin Chen 1.1 432 Format: Command Code (0x01) followed by 3 bytes time value.
Xiaoling 62.5 433 )))
Edwin Chen 1.1 434
Xiaoling 62.5 435 (((
Edwin Chen 1.1 436 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
Xiaoling 62.5 437 )))
Edwin Chen 1.1 438
Xiaoling 62.5 439 * (((
440 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
441 )))
442 * (((
Xiaoling 118.2 443 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
Xiaoling 124.4 444
445
446
Xiaoling 118.2 447 )))
Xiaoling 82.22 448
Xiaoling 70.11 449 === 3.3.2 Set Interrupt Mode ===
Xiaoling 62.5 450
451
Saxer Lin 109.1 452 Feature, Set Interrupt mode for pin of GPIO_EXTI.
Edwin Chen 1.1 453
Saxer Lin 107.1 454 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
Saxer Lin 46.1 455
Edwin Chen 1.1 456 (% style="color:blue" %)**AT Command: AT+INTMOD**
457
Xiaoling 14.34 458 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 82.16 459 |=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
Edwin Chen 1.1 460 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
461 0
462 OK
463 the mode is 0 =Disable Interrupt
464 )))
Saxer Lin 107.1 465 |(% style="width:154px" %)(((
Xiaoling 118.2 466 AT+INTMOD=3
Saxer Lin 107.1 467
468 (default)
469 )))|(% style="width:196px" %)(((
Edwin Chen 1.1 470 Set Transmit Interval
471 0. (Disable Interrupt),
472 ~1. (Trigger by rising and falling edge)
473 2. (Trigger by falling edge)
474 3. (Trigger by rising edge)
475 )))|(% style="width:157px" %)OK
476
477 (% style="color:blue" %)**Downlink Command: 0x06**
478
479 Format: Command Code (0x06) followed by 3 bytes.
480
481 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
482
483 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
Xiaoling 62.6 484
Edwin Chen 1.1 485 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
486
Xiaoling 125.4 487 === 3.3.3 Set work mode ===
Xiaoling 118.2 488
489
490 Feature: Switch working mode
491
492 (% style="color:blue" %)**AT Command: AT+MOD**
493
Xiaoling 118.12 494 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
495 |=(% 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" %)**Response**
Xiaoling 118.2 496 |(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
497 |(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
498 OK
499 Attention:Take effect after ATZ
500 )))
501
502 (% style="color:blue" %)**Downlink Command:**
503
Mengting Qiu 130.2 504 * **Example: **0x0A01 ~/~/  Same as AT+MOD=1
Xiaoling 118.2 505
Mengting Qiu 130.2 506 * **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
Xiaoling 118.2 507
508 === 3.3.4 Set threshold and threshold mode ===
509
510
511 Feature, Set threshold and threshold mode
512
Xiaoling 118.9 513 When (% style="color:#037691" %)**AT+DOL=0,0,0,0,400**(%%) is set, No threshold is used, the sampling time is 400ms.
Xiaoling 118.2 514
Xiaoling 118.3 515 (% style="color:blue" %)**AT Command: AT+DOL**
Xiaoling 118.2 516
Xiaoling 118.17 517 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
518 |(% 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**
Xiaoling 118.2 519 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
520 0,0,0,0,400
521 OK
522 )))
523 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
524
Xiaoling 118.17 525 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
Xiaoling 125.4 526 |(% rowspan="11" style="color:blue; width:120px" %)(((
Xiaoling 118.2 527
528
Xiaoling 125.3 529
530
531
532
533
534
535
Xiaoling 125.4 536
537
Mengting Qiu 130.2 538 **AT+DOL=5,1800,0,0,400**
Mengting Qiu 150.1 539 )))|(% rowspan="4" style="width:240px" %)(((
Mengting Qiu 130.2 540
Xiaoling 125.10 541
542
543
Xiaoling 125.11 544
545
Mengting Qiu 130.2 546 The first bit sets the limit mode
547 )))|(% style="width:150px" %)0: Do not use upper and lower limits
Xiaoling 125.3 548 |(% style="width:251px" %)1: Use upper and lower limits
Mengting Qiu 150.1 549 |(% style="width:251px" %)2:Less than the upper limit
Xiaoling 125.3 550 |(% style="width:251px" %)3: Greater than the lower limit
551 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
552 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
553 |(% 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
554 |(% style="width:251px" %)1 Person or object counting statistics
555 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
Mengting Qiu 154.1 556 100~~10000ms
Xiaoling 125.3 557
558
559 )))
560
Xiaoling 118.3 561 (% style="color:blue" %)**Downlink Command: 0x07**
Xiaoling 118.2 562
Mengting Qiu 131.1 563 Format: Command Code (0x07) followed by 9 bytes.
Xiaoling 118.2 564
Mengting Qiu 131.1 565 If the downlink payload=**07 01 0708 0064 00 0190**, it means set the END Node's limit mode to 0x01,upper limit value to 0x0708=1800(mm), lower limit value to 0x0064=100(mm), to over-limit alarm(0x00) ,the sampling time to 0x0190=400(ms), while type code is 0x07.
Xiaoling 118.3 566
Mengting Qiu 131.1 567 * Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
568
Xiaoling 118.2 569 * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
570
Mengting Qiu 151.1 571 * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800100,0,400
Xiaoling 118.3 572
Mengting Qiu 151.1 573 * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,0,100,0,400
Xiaoling 124.3 574
kai 16.4 575 = 4. Battery & Power Consumption =
Xiaoling 14.45 576
Edwin Chen 1.1 577
Xiaoling 113.7 578 DS20L use built-in 2400mAh non-chargeable battery for long-term use up to several years*. See below link for detail information about the battery info and how to replace.
Edwin Chen 1.1 579
580 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
581
582
kai 16.4 583 = 5. OTA Firmware update =
Edwin Chen 1.1 584
585
Edwin Chen 13.1 586 (% class="wikigeneratedid" %)
Xiaoling 113.7 587 User can change firmware DS20L to:
Edwin Chen 1.1 588
Edwin Chen 13.1 589 * Change Frequency band/ region.
Xiaoling 62.7 590
Edwin Chen 13.1 591 * Update with new features.
Xiaoling 62.7 592
Edwin Chen 13.1 593 * Fix bugs.
Edwin Chen 1.1 594
Xiaoling 113.6 595 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
Edwin Chen 1.1 596
kai 31.1 597 Methods to Update Firmware:
Edwin Chen 1.1 598
Xiaoling 79.15 599 * (Recommanded way) OTA firmware update via wireless:  **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
Xiaoling 62.7 600
Xiaoling 70.18 601 * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
Edwin Chen 1.1 602
kai 31.1 603 = 6. FAQ =
Edwin Chen 1.1 604
Xiaoling 113.8 605 == 6.1 What is the frequency plan for DS20L? ==
Edwin Chen 1.1 606
Xiaoling 62.7 607
Xiaoling 113.8 608 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"]]
Xiaoling 62.7 609
Edwin Chen 1.1 610
Xiaoling 124.2 611 == 6.2 DS20L programming line ==
612
613
614 缺图 后续补上
615
616 feature:
617
618 for AT commands
619
620 Update the firmware of DS20L
621
622 Support interrupt mode
623
624
625 == 6.3 LiDAR probe position ==
626
627
628 [[image:1701155390576-216.png||height="285" width="307"]]
629
630 The black oval hole in the picture is the LiDAR probe.
631
632
633 == 6.4 Interface definition ==
634
635 [[image:image-20231128151132-2.png||height="305" width="557"]]
636
637
Xiaoling 80.4 638 = 7. Trouble Shooting =
Edwin Chen 1.1 639
Xiaoling 80.4 640 == 7.1 AT Command input doesn't work ==
Edwin Chen 1.1 641
Xiaoling 70.14 642
Xiaoling 80.4 643 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:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
Xiaoling 70.14 644
645
Xiaoling 80.4 646 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
Xiaoling 70.14 647
648
Xiaoling 80.4 649 (((
Xiaoling 82.21 650 (% style="color:blue" %)**Cause ①**(%%)**：**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance. (such as glass and water, etc.)
Xiaoling 80.4 651 )))
Xiaoling 70.14 652
Xiaoling 80.4 653 (((
Xiaoling 82.21 654 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
Xiaoling 80.4 655 )))
Xiaoling 70.14 656
657
Xiaoling 80.4 658 (((
659 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
660 )))
Xiaoling 70.14 661
Xiaoling 79.7 662 (((
Xiaoling 82.21 663 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
Xiaoling 79.7 664 )))
Xiaoling 70.14 665
666
667 = 8. Order Info =
668
669
Xiaoling 113.5 670 Part Number: (% style="color:blue" %)**DS20L-XXX**
Xiaoling 70.14 671
Xiaoling 70.12 672 (% style="color:red" %)**XXX**(%%): **The default frequency band**
Edwin Chen 1.1 673
Ellie Zhang 38.1 674 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
Edwin Chen 1.1 675
Ellie Zhang 38.1 676 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
Edwin Chen 1.1 677
Ellie Zhang 38.1 678 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
Edwin Chen 1.1 679
Ellie Zhang 38.1 680 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
Edwin Chen 1.1 681
Ellie Zhang 38.1 682 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
Edwin Chen 1.1 683
Ellie Zhang 38.1 684 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
Edwin Chen 1.1 685
Ellie Zhang 38.1 686 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
Edwin Chen 1.1 687
Ellie Zhang 38.1 688 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
Edwin Chen 1.1 689
Xiaoling 70.14 690 = 9. ​Packing Info =
Xiaoling 67.11 691
692
Ellie Zhang 39.1 693 (% style="color:#037691" %)**Package Includes**:
Edwin Chen 1.1 694
Xiaoling 113.5 695 * DS20L LoRaWAN Smart Distance Detector x 1
Edwin Chen 1.1 696
Ellie Zhang 39.1 697 (% style="color:#037691" %)**Dimension and weight**:
Edwin Chen 1.1 698
kai 31.1 699 * Device Size: cm
Edwin Chen 1.1 700
kai 31.1 701 * Device Weight: g
Edwin Chen 1.1 702
kai 31.1 703 * Package Size / pcs : cm
Edwin Chen 1.1 704
kai 31.1 705 * Weight / pcs : g
Edwin Chen 1.1 706
Xiaoling 70.14 707 = 10. Support =
708
709
kai 31.1 710 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
Xiaoling 39.6 711
712 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].