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

Version 131.1 by Mengting Qiu on 2023/12/06 19:44

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

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

Applications

Navigation