Skip to Content
Version 118.7 by Xiaoling on 2023/11/28 14:07
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20231110085342-2.png||height="481" width="481"]]
3
4
5
6
7
8
9
10
11 **Table of Contents：**
12
13 {{toc/}}
14
15
16
17
18
19
20 = 1. Introduction =
21
22 == 1.1 What is LoRaWAN Smart Distance Detector ==
23
24
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.
26
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.
29
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.**
31
32 DS20L is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
33
34
35 [[image:image-20231110102635-5.png||height="402" width="807"]]
36
37
38 == 1.2 ​Features ==
39
40
41 * LoRaWAN Class A protocol
42 * LiDAR distance detector, range 3 ~~ 200cm
43 * Periodically detect or continuously detect mode
44 * AT Commands to change parameters
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
49
50 == 1.3 Specification ==
51
52
53 (% style="color:#037691" %)**LiDAR Sensor:**
54
55 * Operation Temperature: -40 ~~ 80 °C
56 * Operation Humidity: 0~~99.9%RH (no Dew)
57 * Storage Temperature: -10 ~~ 45°C
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
62
63 == 1.4 Power Consumption ==
64
65
66 (% style="color:#037691" %)**Battery Power Mode:**
67
68 * Idle: 0.003 mA @ 3.3v
69 * Max : 360 mA
70
71 (% style="color:#037691" %)**Continuously mode**:
72
73 * Idle: 21 mA @ 3.3v
74 * Max : 360 mA
75
76 = 2. Configure DS20L to connect to LoRaWAN network =
77
78 == 2.1 How it works ==
79
80
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.
82
83 (% style="display:none" %) (%%)
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
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" %)
91
92 [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
93
94 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
95
96 Each DS20L is shipped with a sticker with the default device EUI as below:
97
98 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
99
100
101 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
102
103
104 (% style="color:blue" %)**Register the device**
105
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"]]
107
108
109 (% style="color:blue" %)**Add APP EUI and DEV EUI**
110
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"]]
112
113
114 (% style="color:blue" %)**Add APP EUI in the application**
115
116
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"]]
118
119
120 (% style="color:blue" %)**Add APP KEY**
121
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"]]
123
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
131 (% 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.
132
133 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
134
135
136 == 2.3 ​Uplink Payload ==
137
138 === 2.3.1 Device Status, FPORT~=5 ===
139
140
141 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.
142
143 The Payload format is as below.
144
145 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
146 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
147 **Size(bytes)**
148 )))|=(% 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**
149 |(% 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
150
151 Example parse in TTNv3
152
153 [[image:1701149922873-259.png]]
154
155 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
156
157 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
158
159 (% style="color:blue" %)**Frequency Band**:
160
161 0x01: EU868
162
163 0x02: US915
164
165 0x03: IN865
166
167 0x04: AU915
168
169 0x05: KZ865
170
171 0x06: RU864
172
173 0x07: AS923
174
175 0x08: AS923-1
176
177 0x09: AS923-2
178
179 0x0a: AS923-3
180
181 0x0b: CN470
182
183 0x0c: EU433
184
185 0x0d: KR920
186
187 0x0e: MA869
188
189 (% style="color:blue" %)**Sub-Band**:
190
191 AU915 and US915:value 0x00 ~~ 0x08
192
193 CN470: value 0x0B ~~ 0x0C
194
195 Other Bands: Always 0x00
196
197 (% style="color:blue" %)**Battery Info**:
198
199 Check the battery voltage.
200
201 Ex1: 0x0B45 = 2885mV
202
203 Ex2: 0x0B49 = 2889mV
204
205
206 === 2.3.2 Uplink Payload, FPORT~=2 ===
207
208
209 (((
210 DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will:
211
212 periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
213
214 Uplink Payload totals 11 bytes.
215 )))
216
217 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
218 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
219 **Size(bytes)**
220 )))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white; width: 80px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**
221 |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)(((
222 [[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]]
223 )))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)(((
224 [[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]]
225 )))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)(((
226 [[Message Type>>||anchor="HMessageType"]]
227 )))
228
229 [[image:image-20230805104104-2.png||height="136" width="754"]]
230
231
232 ==== (% style="color:blue" %)**Battery Info**(%%) ====
233
234
235 Check the battery voltage for DS20L.
236
237 Ex1: 0x0B45 = 2885mV
238
239 Ex2: 0x0B49 = 2889mV
240
241
242 ==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ====
243
244
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.
246
247
248 **Example**:
249
250 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
251
252 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
253
254
255 ==== (% style="color:blue" %)**Distance**(%%) ====
256
257
258 Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength.
259
260
261 **Example**:
262
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.
264
265
266 ==== (% style="color:blue" %)**Distance signal strength**(%%) ====
267
268
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.
270
271
272 **Example**:
273
274 If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.
275
276 Customers can judge whether they need to adjust the environment based on the signal strength.
277
278
279 **1) When the sensor detects valid data:**
280
281 [[image:image-20230805155335-1.png||height="145" width="724"]]
282
283
284 **2) When the sensor detects invalid data:**
285
286 [[image:image-20230805155428-2.png||height="139" width="726"]]
287
288
289 **3) When the sensor is not connected:**
290
291 [[image:image-20230805155515-3.png||height="143" width="725"]]
292
293
294 ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
295
296
297 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.
298
299 Note: The Internet Pin is a separate pin in the screw terminal. See pin mapping of GPIO_EXTI .
300
301 **Example:**
302
303 If byte[0]&0x01=0x00 : Normal uplink packet.
304
305 If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
306
307
308 ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
309
310
311 Characterize the internal temperature value of the sensor.
312
313 **Example: **
314 If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.
315 If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.
316
317
318 ==== (% style="color:blue" %)**Message Type**(%%) ====
319
320
321 (((
322 For a normal uplink payload, the message type is always 0x01.
323 )))
324
325 (((
326 Valid Message Type:
327 )))
328
329 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
330 |=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload**
331 |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
332 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
333
334 [[image:image-20230805150315-4.png||height="233" width="723"]]
335
336
337 === 2.3.3 Historical measuring distance, FPORT~=3 ===
338
339
340 DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
341
342 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
343
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
353
354 **Interrupt flag & Interrupt level:**
355
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 )))
363
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 )))
367
368 For example, in the US915 band, the max payload for different DR is:
369
370 **a) DR0:** max is 11 bytes so one entry of data
371
372 **b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
373
374 **c) DR2:** total payload includes 11 entries of data
375
376 **d) DR3:** total payload includes 22 entries of data.
377
378 If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
379
380
381 **Downlink:**
382
383 0x31 64 CC 68 0C 64 CC 69 74 05
384
385 [[image:image-20230805144936-2.png||height="113" width="746"]]
386
387 **Uplink:**
388
389 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
390
391
392 **Parsed Value:**
393
394 [DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
395
396
397 [360,176,30,High,True,2023-08-04 02:53:00],
398
399 [355,168,30,Low,False,2023-08-04 02:53:29],
400
401 [245,211,30,Low,False,2023-08-04 02:54:29],
402
403 [57,700,30,Low,False,2023-08-04 02:55:29],
404
405 [361,164,30,Low,True,2023-08-04 02:56:00],
406
407 [337,184,30,Low,False,2023-08-04 02:56:40],
408
409 [20,4458,30,Low,False,2023-08-04 02:57:40],
410
411 [362,173,30,Low,False,2023-08-04 02:58:53],
412
413
414 **History read from serial port：**
415
416 [[image:image-20230805145056-3.png]]
417
418
419 === 2.3.4 Decode payload in The Things Network ===
420
421
422 While using TTN network, you can add the payload format to decode the payload.
423
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"]]
425
426
427 (((
428 The payload decoder function for TTN is here:
429 )))
430
431 (((
432 DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
433 )))
434
435
436 == 2.4 ​Show Data in DataCake IoT Server ==
437
438
439 (((
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:
441 )))
442
443
444 (((
445 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
446 )))
447
448 (((
449 (% 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:**
450 )))
451
452
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"]]
454
455
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"]]
457
458
459 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
460
461 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
462
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"]]
464
465
466 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
467
468 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]]
469
470
471 == 2.5 Frequency Plans ==
472
473
474 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.
475
476 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
477
478
479 = 3. Configure DS20L =
480
481 == 3.1 Configure Methods ==
482
483
484 DS20L supports below configure method:
485
486 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
487
488 * 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]].
489
490 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
491
492 == 3.2 General Commands ==
493
494
495 These commands are to configure:
496
497 * General system settings like: uplink interval.
498
499 * LoRaWAN protocol & radio related command.
500
501 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
502
503 [[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/]]
504
505
506 == 3.3 Commands special design for DS20L ==
507
508
509 These commands only valid for DS20L, as below:
510
511
512 === 3.3.1 Set Transmit Interval Time ===
513
514
515 (((
516 Feature: Change LoRaWAN End Node Transmit Interval.
517 )))
518
519 (((
520 (% style="color:blue" %)**AT Command: AT+TDC**
521 )))
522
523 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
524 |=(% 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**
525 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
526 30000
527 OK
528 the interval is 30000ms = 30s
529 )))
530 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
531 OK
532 Set transmit interval to 60000ms = 60 seconds
533 )))
534
535 (((
536 (% style="color:blue" %)**Downlink Command: 0x01**
537 )))
538
539 (((
540 Format: Command Code (0x01) followed by 3 bytes time value.
541 )))
542
543 (((
544 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
545 )))
546
547 * (((
548 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
549 )))
550 * (((
551 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
552 )))
553
554
555 === 3.3.2 Set Interrupt Mode ===
556
557
558 Feature, Set Interrupt mode for pin of GPIO_EXTI.
559
560 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
561
562 (% style="color:blue" %)**AT Command: AT+INTMOD**
563
564 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
565 |=(% 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**
566 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
567 0
568 OK
569 the mode is 0 =Disable Interrupt
570 )))
571 |(% style="width:154px" %)(((
572 AT+INTMOD=3
573
574 (default)
575 )))|(% style="width:196px" %)(((
576 Set Transmit Interval
577 0. (Disable Interrupt),
578 ~1. (Trigger by rising and falling edge)
579 2. (Trigger by falling edge)
580 3. (Trigger by rising edge)
581 )))|(% style="width:157px" %)OK
582
583 (% style="color:blue" %)**Downlink Command: 0x06**
584
585 Format: Command Code (0x06) followed by 3 bytes.
586
587 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
588
589 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
590
591 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
592
593
594
595 == 3.3.3 Set work mode ==
596
597
598 Feature: Switch working mode
599
600 (% style="color:blue" %)**AT Command: AT+MOD**
601
602 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:463px" %)
603 |=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 108px;background-color:#4F81BD;color:white" %)**Response**
604 |(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
605 |(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
606 OK
607
608 Attention:Take effect after ATZ
609 )))
610
611 (% style="color:blue" %)**Downlink Command:**
612
613 * **Example: **0x0A00  ~/~/  Same as AT+MOD=0
614
615 * **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
616
617
618 === 3.3.4 Set threshold and threshold mode ===
619
620
621 Feature, Set threshold and threshold mode
622
623 When **AT+DOL=0,0,0,0,400** is set, No threshold is used, the sampling time is 400ms.
624
625 (% style="color:blue" %)**AT Command: AT+DOL**
626
627 (% border="1" cellspacing="4" style="width:571.818px" %)
628 |(% style="width:172px;background-color:#4F81BD;color:white" %)**Command Example**|(% style="width:279px;background-color:#4F81BD;color:white" %)**Function**|(% style="width:118px;background-color:#4F81BD;color:white" %)**Response**
629 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
630 0,0,0,0,400
631
632 OK
633 )))
634 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
635
636
637 (% border="1" cellspacing="4" style="width:668.818px;background-color:#f2f2f2" %)
638 |(% rowspan="11" style="width:166px;color:blue" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:226px" %)The first bit sets the limit mode|(% style="width:251px" %)0:Do not use upper and lower limits
639 |(% style="width:251px" %)1:Use upper and lower limits
640 |(% style="width:251px" %)2:Less than the lower limit
641 |(% style="width:251px" %)3:Greater than the lower limit
642 |(% style="width:251px" %)4:Less than the upper limit
643 |(% style="width:251px" %)5: Greater than the upper limit
644 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
645 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
646 |(% 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
647 |(% style="width:251px" %)1 Person or object counting statistics
648 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
649 0~~10000ms
650
651
652 )))
653
654 (% style="color:blue" %)**Downlink Command: 0x07**
655
656 Format: Command Code (0x07) followed by 9bytes.
657
658 * Example 0: Downlink Payload: 070000000000000190  **~-~-->**  AT+MOD=0,0,0,0,400
659
660 * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
661
662
663
664
665 = 4. Battery & Power Consumption =
666
667
668 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.
669
670 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
671
672
673 = 5. OTA Firmware update =
674
675
676 (% class="wikigeneratedid" %)
677 User can change firmware DS20L to:
678
679 * Change Frequency band/ region.
680
681 * Update with new features.
682
683 * Fix bugs.
684
685 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
686
687 Methods to Update Firmware:
688
689 * (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/]]**
690
691 * 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]]**.
692
693 = 6. FAQ =
694
695 == 6.1 What is the frequency plan for DS20L? ==
696
697
698 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"]]
699
700
701 = 7. Trouble Shooting =
702
703 == 7.1 AT Command input doesn't work ==
704
705
706 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.
707
708
709 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
710
711
712 (((
713 (% 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.)
714 )))
715
716 (((
717 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
718 )))
719
720
721 (((
722 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
723 )))
724
725 (((
726 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
727 )))
728
729
730 = 8. Order Info =
731
732
733 Part Number: (% style="color:blue" %)**DS20L-XXX**
734
735 (% style="color:red" %)**XXX**(%%): **The default frequency band**
736
737 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
738
739 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
740
741 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
742
743 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
744
745 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
746
747 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
748
749 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
750
751 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
752
753 = 9. ​Packing Info =
754
755
756 (% style="color:#037691" %)**Package Includes**:
757
758 * DS20L LoRaWAN Smart Distance Detector x 1
759
760 (% style="color:#037691" %)**Dimension and weight**:
761
762 * Device Size: cm
763
764 * Device Weight: g
765
766 * Package Size / pcs : cm
767
768 * Weight / pcs : g
769
770 = 10. Support =
771
772
773 * 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.
774
775 * 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]].