Wiki source code of DS20L -- LoRaWAN Smart Distance Detector User Manual

Version 126.2 by Xiaoling on 2023/11/29 10:05

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

Wiki source code of DS20L -- LoRaWAN Smart Distance Detector User Manual

Applications

Navigation