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

Version 175.3 by Mengting Qiu on 2023/12/12 15:48

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
	50	== 1.3 Specification ==
	51
113.5	52	(% style="color:#037691" %)LiDAR Sensor:
70.6	53
113.5	54	* Operation Temperature: -40 ~~ 80 °C
	55	* Operation Humidity: 0~~99.9%RH (no Dew)
	56	* Storage Temperature: -10 ~~ 45°C
113.4	57	* Measure Range: 3cm~~200cm @ 90% reflectivity
	58	* Accuracy: ±2cm @ (3cm~~100cm); ±5% @ (100~~200cm)
	59	* ToF FoV: ±9°, Total 18°
	60	* Light source: VCSEL
82.3	61
115.1	62	== 1.4 Power Consumption ==
114.2	63
115.1	64
116.2	65	(% style="color:#037691" %)Battery Power Mode:
115.1	66
170.1	67	* Idle: 3uA @ 3.3v
116.1	68	* Max : 360 mA
115.1	69
116.2	70	(% style="color:#037691" %)Continuously mode:
115.1	71
116.1	72	* Idle: 21 mA @ 3.3v
	73	* Max : 360 mA
115.1	74
170.1	75	== 1.5 Use Case ==
	76
	77	(% class="mark" %)Regular Distance Detect
	78
	79	[[image:image-20231211220922-1.png\|\|height="352" width="605"]]
	80
	81
	82	(% class="mark" %)Counting / Alarm
	83
	84	[[image:image-20231211221253-2.png]]
	85
	86
	87	[[image:image-20231211221436-3.png]]
	88
	89
113.5	90	= 2. Configure DS20L to connect to LoRaWAN network =
77.4	91
1.1	92	== 2.1 How it works ==
	93
	94
113.6	95	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	96
64.2	97	(% style="display:none" %) (%%)
1.1	98
	99	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
	100
	101
	102	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.
	103
114.2	104	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	105
114.2	106	[[image:image-20231110102635-5.png\|\|height="402" width="807"]](% style="display:none" %)
1.1	107
140.1	108	=== Step 1: Create a device in TTN with the OTAA keys from DS20L. ===
1.1	109
113.6	110	Each DS20L is shipped with a sticker with the default device EUI as below:
1.1	111
30.1	112	[[image:image-20230426084152-1.png\|\|alt="图片-20230426084152-1.png" height="233" width="502"]]
1.1	113
	114
140.1	115	You can enter this key in the LoRaWAN Server portal. Below is TTN V3 screenshot:
1.1	116
	117
	118	(% style="color:blue" %)Register the device
	119
140.1	120	[[image:image-20231207144600-2.png\|\|height="703" width="756"]]
1.1	121
	122
140.1	123	(% style="color:blue" %)Add DevEUI and AppKey
1.1	124
140.1	125	[[image:image-20231207145121-5.png\|\|height="540" width="756"]]
1.1	126
	127
	128
170.1	129	=== Step 2: Activate DS20L ===
1.1	130
118.2	131	[[image:image-20231128133704-1.png\|\|height="189" width="441"]]
1.1	132
113.6	133	Press the button for 5 seconds to activate the DS20L.
6.1	134
159.1	135	The switch is switched to (% style="color:blue" %)E (%%)and the external power supply is used.
	136
170.1	137	The switch is switched to (% style="color:blue" %)I (%%)and DS20L will be power by the built-in battery.
159.1	138
1.1	139	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:blue" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	140
	141	After join success, it will start to upload messages to TTN and you can see the messages in the panel.
	142
	143
140.1	144
82.8	145	== 2.3 Uplink Payload ==
1.1	146
85.1	147	=== 2.3.1 Device Status, FPORT~=5 ===
	148
90.2	149
113.6	150	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	151
	152	The Payload format is as below.
	153
90.2	154	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
90.11	155	\|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
85.1	156	Size(bytes)
90.11	157	)))\|=(% 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	158	\|(% 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
	159
	160	Example parse in TTNv3
	161
130.2	162	[[image:image-20231206151412-3.png\|\|height="179" width="1070"]]
93.1	163
118.2	164	(% style="color:blue" %)Sensor Model(%%): For DS20L, this value is 0x21
85.1	165
90.17	166	(% style="color:blue" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
85.1	167
90.17	168	(% style="color:blue" %)Frequency Band:
85.1	169
	170	0x01: EU868
	171
	172	0x02: US915
	173
	174	0x03: IN865
	175
	176	0x04: AU915
	177
	178	0x05: KZ865
	179
	180	0x06: RU864
	181
	182	0x07: AS923
	183
	184	0x08: AS923-1
	185
	186	0x09: AS923-2
	187
	188	0x0a: AS923-3
	189
	190	0x0b: CN470
	191
	192	0x0c: EU433
	193
	194	0x0d: KR920
	195
	196	0x0e: MA869
	197
90.17	198	(% style="color:blue" %)Sub-Band:
85.1	199
	200	AU915 and US915:value 0x00 ~~ 0x08
	201
	202	CN470: value 0x0B ~~ 0x0C
	203
	204	Other Bands: Always 0x00
	205
90.17	206	(% style="color:blue" %)Battery Info:
85.1	207
	208	Check the battery voltage.
	209
	210	Ex1: 0x0B45 = 2885mV
	211
	212	Ex2: 0x0B49 = 2889mV
	213
	214
89.1	215	=== 2.3.2 Uplink Payload, FPORT~=2 ===
85.1	216
90.2	217
159.1	218	==== (% style="color:red" %)AT+MOD~=1(%%) ====
1.1	219
120.2	220	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	221
170.2	222	Uplink Payload totals 10 bytes.
1.1	223
124.2	224	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
170.2	225	\|(% style="background-color:#4f81bd; color:White; width:60px" %)Size(bytes)\|(% style="background-color:#4f81bd; color:White; width:30px" %)2\|(% style="background-color:#4f81bd; color:White; width:130px" %)1\|(% style="background-color:#4f81bd; color:White; width:70px" %)2\|(% style="background-color:#4f81bd; color:White; width:100px" %)1\|(% style="background-color:#4f81bd; color:White; width:120px" %)4
	226	\|(% style="width:91px" %)Value\|(% style="width:41px" %)BAT\|(% style="width:176px" %)MOD+ Alarm+ Interrupt\|(% style="width:74px" %)Distance\|(% style="width:100px" %)Sensor State\|(% style="width:119px" %)Interrupt Count
1.1	227
170.2	228	MOD+ Alarm+ Interrupt:
	229
	230	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:400px" %)
	231	\|(% style="background-color:#4f81bd; color:White; width:50px" %)Size(bit)\|(% style="background-color:#4f81bd; color:White; width:60px" %)[bit7:bit6]\|(% style="background-color:#4f81bd; color:White; width:70px" %)bit5\|(% style="background-color:#4f81bd; color:White; width:120px" %)bit4
	232	\|(% style="width:80px" %)Value\|(% style="width:80px" %)MOD\|(% style="width:89px" %)Digital Interrupt
	233	\|(% style="width:167px" %)(((
	234	Distance Alarm
	235
	236	0: No Alarm;
	237
	238	1: Alarm
	239	)))
	240
	241	Example parse in TTNv3
	242
154.1	243	[[image:image-20231209152917-1.png\|\|height="300" width="1172"]]
1.1	244
124.2	245	(% style="color:blue" %)Battery Info:
1.1	246
120.2	247	Check the battery voltage for DS20L
1.1	248
120.2	249	Ex1: 0x0E10 = 3600mV
67.7	250
124.2	251
120.8	252	(% style="color:blue" %)MOD & Alarm & Interrupt:
67.7	253
120.8	254	(% style="color:red" %)MOD:
1.1	255
120.2	256	Example: (0x60>>6) & 0x3f =1
14.22	257
120.2	258	0x01: Regularly detect distance and report.
	259	0x02: Uninterrupted measurement (external power supply).
1.1	260
120.8	261	(% style="color:red" %)Alarm:
79.11	262
120.2	263	When the detection distance exceeds the limit, the alarm flag is set to 1.
67.7	264
120.8	265	(% style="color:red" %)Interrupt:
67.7	266
120.2	267	Whether it is an external interrupt.
10.1	268
1.1	269
124.2	270	(% style="color:blue" %)Distance info:
	271
82.4	272	Example:
	273
120.2	274	If payload is: 0708H: distance = 0708H = 1800 mm
82.4	275
	276
124.2	277	(% style="color:blue" %)Sensor State:
	278
171.2	279	Ex1: 0x00: Distance Reading is valid
82.4	280
171.2	281	Ex2: 0x0x: Distance Reading is invalid
82.4	282
	283
170.1	284	(% style="color:blue" %)Interrupt Count:
124.2	285
120.2	286	If payload is:000007D0H: count = 07D0H =2000
82.4	287
	288
120.8	289
159.1	290	==== (% style="color:red" %)AT+MOD~=2(%%) ====
120.8	291
82.4	292
159.1	293	The power consumption of uninterrupted measurement is high, and the device needs to use external power supply.(The switch is switched to E and the external power supply is used.)
	294
	295	[[image:image-20231128133704-1.png\|\|height="189" width="441"]]
	296
	297
	298	* Set over-limit alarm mode: AT+DOL=3,500,244,(% style="color:red" %)0(%%),120
	299
	300	(% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %)
172.1	301	Continuously measurement with Alarm. When the distance exceeds the limit, the output IO high, instant alarm.
159.1	302
171.1	303	(% class="wikigeneratedid" %)
	304	Uplink Payload totals 9 bytes.
	305
	306	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
159.1	307	\|(% style="background-color:#4f81bd; color:white; width:70px" %)Size(bytes)\|(% style="background-color:#4f81bd; color:white; width:40px" %)2\|(% style="background-color:#4f81bd; color:white; width:130px" %)1\|(% style="background-color:#4f81bd; color:white; width:130px" %)2\|(% style="background-color:#4f81bd; color:white; width:70px" %)2\|(% style="background-color:#4f81bd; color:white; width:70px" %)2
171.1	308	\|(% style="width:91px" %)Value\|(% style="width:41px" %)BAT\|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag\|(% style="width:74px" %)Distance \|(% style="width:100px" %)Upper limit\|(% style="width:119px" %)Lower limit
82.4	309
171.1	310	MOD+DO+ Alarm+ Do flag+ Limit flag:
	311
	312	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
	313	\|(% style="background-color:#4f81bd; color:white; width:50px" %)Size(bit)\|(% style="background-color:#4f81bd; color:white; width:60px" %)[bit7:bit6]\|(% style="background-color:#4f81bd; color:white; width:90px" %)bit5\|(% style="background-color:#4f81bd; color:white; width:90px" %)bit4\|(% style="background-color:#4f81bd; color:white; width:120px" %)bit3\|(% style="background-color:#4f81bd; color:white; width:100px" %)[bit2:bit1:bit0]
	314	\|(% style="width:50px" %)Value\|(% style="width:60px" %)MOD\|(% style="width:89px" %)(((
	315	(((
	316	DO
	317	)))
	318
	319	(((
	320	0：Within limit
	321
	322	1：Out of limit
	323	)))
	324	)))\|(% style="width:73px" %)(((
	325	Alarm
	326
	327	0: No Alarm;
	328
	329	1: Alarm
	330	)))\|(% style="width:150px" %)(((
	331	DO flag
	332
	333	0：the over-limit alarm mode
	334
	335	1：the person or object count mode
	336	)))\|(% style="width:103px" %)Limit flag
	337	(0~~3)
	338
	339	Example parse in TTNv3
	340
159.1	341	[[image:image-20231209171127-3.png\|\|height="374" width="1209"]]
82.4	342
120.8	343	(% style="color:blue" %)MOD & Alarm & Do & Limit flag:
104.1	344
120.8	345	(% style="color:red" %)MOD:
104.1	346
120.2	347	Example: (0x60>>6) & 0x3f =1
104.1	348
120.2	349	0x01: Regularly detect distance and report.
	350	0x02: Uninterrupted measurement (external power supply).
104.1	351
120.8	352	(% style="color:red" %)Alarm:
104.1	353
120.2	354	When the detection distance exceeds the limit, the alarm flag is set to 1.
104.1	355
170.1	356	(% style="color:red" %)DO:
104.1	357
171.2	358	Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm.
104.1	359
171.2	360	(% style="color:red" %)Threshold Flag for Alarm:
82.4	361
152.1	362	Mode for setting threshold: 0~~3
82.4	363
171.2	364	0: Distance limit range is not enabled, alarm:0.
82.4	365
171.2	366	1: Trigger Alarm if distance exceed the range between lower and upper.
82.4	367
171.2	368	2: Trigger Alarm if distance smaller than the upper limit.
1.1	369
171.2	370	3: Trigger Alarm if distance bigger than the lower limit .
1.1	371
	372
159.1	373	(% style="color:blue" %)Distance:
	374
	375	Actual sampling distance values.
	376
164.1	377	Example:
159.1	378
164.1	379	AT+DOL=1,500,244,(% style="color:red" %)0(%%),120
	380
	381	The distance is detected every 120ms.
	382
	383	When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time.
	384
	385	When the actual detection value is outside the range of [244mm,500mm], the uplink data will be immediately alerted.
	386
	387	If payload is: 0708H: distance = 0708H = 1800 mm
	388
	389
120.8	390	(% style="color:blue" %)Upper limit:
	391
171.2	392	Show the pre-set upper limit in Hex, Unit: mm.
1.1	393
171.2	394	Ex: 01F4(H)=500mm
124.2	395
171.2	396
120.8	397	(% style="color:blue" %)Lower limit:
1.1	398
171.2	399	Show the pre-set lower limit in Hex, Unit: mm.
1.1	400
171.2	401	Ex: 0xF4(H)=244mm
39.5	402
171.2	403
159.1	404	* Set the person or object count mode: AT+DOL=1,500,244,(% style="color:red" %)1(%%),120
	405
172.1	406	Continuously measurement with Alarm, detect and count people or things passing by in distance limit mode.
159.1	407
171.1	408	Uplink Payload totals 11 bytes.
	409
	410	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
159.2	411	\|(% 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
171.1	412	\|(% style="width:91px" %)Value\|(% style="width:41px" %)BAT\|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag\|(% style="width:176px" %)Distance limit alarm count\|(% style="width:100px" %)Upper limit\|(% style="width:119px" %)Lower limit
159.2	413
171.1	414	MOD+DO+ Alarm+ Do flag+ Limit flag:
	415
	416	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
	417	\|(% style="background-color:#4f81bd; color:white; width:50px" %)Size(bit)\|(% style="background-color:#4f81bd; color:white; width:60px" %)[bit7:bit6]\|(% style="background-color:#4f81bd; color:white; width:90px" %)bit5\|(% style="background-color:#4f81bd; color:white; width:90px" %)bit4\|(% style="background-color:#4f81bd; color:white; width:120px" %)bit3\|(% style="background-color:#4f81bd; color:white; width:100px" %)[bit2:bit1:bit0]
	418	\|(% style="width:50px" %)Value\|(% style="width:60px" %)MOD\|(% style="width:89px" %)(((
	419	(((
	420	DO
	421	)))
	422
	423	(((
	424	0：Within limit
	425
	426	1：Out of limit
	427	)))
	428	)))\|(% style="width:73px" %)(((
	429	Alarm
	430
	431	0: No Alarm;
	432
	433	1: Alarm
	434	)))\|(% style="width:150px" %)(((
	435	DO flag
	436
	437	0：the over-limit alarm mode
	438
	439	1：the person or object count mode
	440	)))\|(% style="width:103px" %)Limit flag
	441	(0~~3)
	442
	443	Example parse in TTNv3
	444
159.1	445	[[image:image-20231209173457-5.png\|\|height="277" width="1098"]]
	446
164.1	447	(% style="color:blue" %)MOD & Alarm & Do & Limit flag:
159.1	448
164.1	449	(% style="color:red" %)MOD:
159.1	450
164.1	451	Example: (0x60>>6) & 0x3f =1
159.1	452
164.1	453	0x01: Regularly detect distance and report.
	454	0x02: Uninterrupted measurement (external power supply).
	455
	456	(% style="color:red" %)Alarm:
	457
	458	When the detection distance exceeds the limit, the alarm flag is set to 1.
	459
	460	(% style="color:red" %)Do:
	461
171.2	462	Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm.
164.1	463
171.2	464	(% style="color:red" %)Threshold Flag for Alarm:
164.1	465
	466	Mode for setting threshold: 0~~3
	467
	468	0: does not use upper and lower limits
	469
	470	1: Use upper and lower limits
	471
	472	2: Less than the upper limit
	473
	474	3: Greater than the lower limit
	475
	476
	477	(% style="color:blue" %)Distance limit alarm count:
	478
	479	People or objects are collected and counted within a limited distance.
	480
	481	The detection of a stationary person or object at each sampling time will be repeated three times, and the fourth sampling count will be added by 1.
	482
	483	Example:
	484
	485	AT+DOL=1,500,244,(% style="color:red" %)1(%%),120
	486
	487	People or objects passing within the distance range of [244mm,500mm] are detected and counted every 120ms.
	488
	489	If payload is: 0x56H, interrupt count =0x56H =86
	490
	491
	492	(% style="color:blue" %)Upper limit:
	493
171.2	494	Show the pre-set upper limit in Hex, Unit: mm.
164.1	495
171.2	496	Ex: 01F4(H)=500mm
164.1	497
171.2	498
164.1	499	(% style="color:blue" %)Lower limit:
	500
171.2	501	Show the pre-set lower limit in Hex, Unit: mm.
164.1	502
171.2	503	Ex: 0xF4(H)=244mm
164.1	504
171.2	505
125.8	506	== 2.4 Decode payload in The Things Network ==
97.1	507
99.1	508
70.10	509	While using TTN network, you can add the payload format to decode the payload.
1.1	510
130.2	511	[[image:image-20231206143515-1.png\|\|height="534" width="759"]]
1.1	512
	513
62.5	514	(((
82.4	515	The payload decoder function for TTN is here:
62.5	516	)))
1.1	517
82.4	518	(((
113.6	519	DS20L TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
82.4	520	)))
1.1	521
82.4	522
125.8	523	== 2.5 Show Data in DataCake IoT Server ==
1.1	524
	525
62.5	526	(((
170.1	527	[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, onhuman-friendlya in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
62.5	528	)))
1.1	529
	530
62.5	531	(((
70.10	532	(% style="color:blue" %)Step 1(%%): Be sure that your device is programmed and properly connected to the network at this time.
62.5	533	)))
1.1	534
62.5	535	(((
70.10	536	(% 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	537	)))
14.26	538
55.1	539
148.1	540	[[image:image-20231207153532-6.png\|\|height="562" width="861"]]
1.1	541
	542
148.1	543	[[image:image-20231207155940-8.png]]
1.1	544
148.1	545	For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]]
1.1	546
148.1	547	[[image:image-20231207160733-11.png\|\|height="429" width="759"]]
	548
	549
70.10	550	(% style="color:blue" %)Step 3(%%): Create an account or log in Datacake.
1.1	551
113.6	552	(% style="color:blue" %)Step 4(%%): Search the DS20L and add DevEUI.
1.1	553
148.1	554	[[image:image-20231207160343-10.png\|\|height="665" width="705"]]
62.5	555
1.1	556
70.10	557	After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
1.1	558
126.2	559	[[image:image-20231129100454-2.png\|\|height="501" width="928"]]
1.1	560
	561
125.8	562	== 2.6 Frequency Plans ==
1.1	563
	564
113.7	565	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	566
	567	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
	568
	569
118.2	570	= 3. Configure DS20L =
82.4	571
16.4	572	== 3.1 Configure Methods ==
1.1	573
	574
113.7	575	DS20L supports below configure method:
1.1	576
173.2	577	* 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.5UARTConnectionforDS20Lmotherboard]].
67.20	578
1.1	579	* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
	580
	581	== 3.2 General Commands ==
	582
	583
	584	These commands are to configure:
	585
	586	* General system settings like: uplink interval.
67.20	587
1.1	588	* LoRaWAN protocol & radio related command.
	589
	590	They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	591
	592	[[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/]]
	593
	594
113.7	595	== 3.3 Commands special design for DS20L ==
1.1	596
	597
170.1	598	Below commands only valid for DS20L, as below:
1.1	599
	600
	601	=== 3.3.1 Set Transmit Interval Time ===
	602
	603
62.5	604	(((
1.1	605	Feature: Change LoRaWAN End Node Transmit Interval.
62.5	606	)))
	607
	608	(((
1.1	609	(% style="color:blue" %)AT Command: AT+TDC
62.5	610	)))
1.1	611
14.34	612	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
82.16	613	\|=(% 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	614	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	615	30000
	616	OK
	617	the interval is 30000ms = 30s
	618	)))
	619	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	620	OK
	621	Set transmit interval to 60000ms = 60 seconds
	622	)))
	623
62.5	624	(((
1.1	625	(% style="color:blue" %)Downlink Command: 0x01
62.5	626	)))
1.1	627
62.5	628	(((
1.1	629	Format: Command Code (0x01) followed by 3 bytes time value.
62.5	630	)))
1.1	631
62.5	632	(((
1.1	633	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	634	)))
1.1	635
62.5	636	* (((
	637	Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	638	)))
	639	* (((
118.2	640	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
124.4	641
	642
	643
118.2	644	)))
82.22	645
70.11	646	=== 3.3.2 Set Interrupt Mode ===
62.5	647
	648
109.1	649	Feature, Set Interrupt mode for pin of GPIO_EXTI.
1.1	650
107.1	651	When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
46.1	652
1.1	653	(% style="color:blue" %)AT Command: AT+INTMOD
	654
14.34	655	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
82.16	656	\|=(% 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	657	\|(% style="width:154px" %)AT+INTMOD=?\|(% style="width:196px" %)Show current interrupt mode\|(% style="width:157px" %)(((
	658	0
	659	OK
	660	the mode is 0 =Disable Interrupt
	661	)))
107.1	662	\|(% style="width:154px" %)(((
118.2	663	AT+INTMOD=3
107.1	664
	665	(default)
	666	)))\|(% style="width:196px" %)(((
1.1	667	Set Transmit Interval
	668	0. (Disable Interrupt),
	669	~1. (Trigger by rising and falling edge)
	670	2. (Trigger by falling edge)
	671	3. (Trigger by rising edge)
	672	)))\|(% style="width:157px" %)OK
	673
	674	(% style="color:blue" %)Downlink Command: 0x06
	675
	676	Format: Command Code (0x06) followed by 3 bytes.
	677
	678	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	679
	680	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
62.6	681
1.1	682	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
	683
125.4	684	=== 3.3.3 Set work mode ===
118.2	685
	686
	687	Feature: Switch working mode
	688
	689	(% style="color:blue" %)AT Command: AT+MOD
	690
175.1	691	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:580px" %)
118.12	692	\|=(% 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	693	\|(% style="width:162px" %)AT+MOD=?\|(% style="width:191px" %)Get the current working mode.\|(% style="width:106px" %)OK
	694	\|(% style="width:162px" %)AT+MOD=1\|(% style="width:191px" %)Set the working mode to Regular measurements.\|(% style="width:106px" %)(((
	695	OK
175.1	696	Attention: Take effect after ATZ
118.2	697	)))
175.1	698	\|(% style="width:162px" %)AT+MOD=2\|(% style="width:191px" %)Set the working mode to(((
	699	Continuously measurement with Alarm.
	700	)))\|(% style="width:191px" %)(((
	701	OK
	702	Attention: Take effect after ATZ
	703	)))
118.2	704
	705	(% style="color:blue" %)Downlink Command:
	706
130.2	707	* Example: 0x0A01 ~/~/ Same as AT+MOD=1
118.2	708
130.2	709	* Example: 0x0A02 ~/~/ Same as AT+MOD=2
118.2	710
	711	=== 3.3.4 Set threshold and threshold mode ===
	712
	713
	714	Feature, Set threshold and threshold mode
	715
118.9	716	When (% style="color:#037691" %)AT+DOL=0,0,0,0,400(%%) is set, No threshold is used, the sampling time is 400ms.
118.2	717
118.3	718	(% style="color:blue" %)AT Command: AT+DOL
118.2	719
118.17	720	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	721	\|(% 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	722	\|(% style="width:172px" %)AT+ DOL =?\|(% style="width:279px" %)Get the current threshold mode and sampling time\|(% style="width:118px" %)(((
	723	0,0,0,0,400
	724	OK
	725	)))
	726	\|(% style="width:172px" %)AT+ DOL =1,1800,100,0,400\|(% style="width:279px" %)Set only the upper and lower thresholds\|(% style="width:118px" %)OK
	727
166.1	728	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
	729	\|=(% style="width: 162px;background-color:#4F81BD;color:white" %)Command Example\|=(% style="width: 193px;background-color:#4F81BD;color:white" %)Function\|=(% style="width: 155px;background-color:#4F81BD;color:white" %) Parameter
125.4	730	\|(% rowspan="11" style="color:blue; width:120px" %)(((
118.2	731
	732
125.3	733
	734
	735
	736
	737
	738
	739
125.4	740
	741
165.1	742	AT+DOL=1,1800,3,0,400
150.1	743	)))\|(% rowspan="4" style="width:240px" %)(((
130.2	744
125.10	745
	746
	747
130.2	748	The first bit sets the limit mode
	749	)))\|(% style="width:150px" %)0: Do not use upper and lower limits
125.3	750	\|(% style="width:251px" %)1: Use upper and lower limits
150.1	751	\|(% style="width:251px" %)2:Less than the upper limit
125.3	752	\|(% style="width:251px" %)3: Greater than the lower limit
	753	\|(% style="width:226px" %)The second bit sets the upper limit value\|(% style="width:251px" %)3~~2000MM
	754	\|(% style="width:226px" %)The third bit sets the lower limit value\|(% style="width:251px" %)3~~2000MM
	755	\|(% 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
	756	\|(% style="width:251px" %)1 Person or object counting statistics
	757	\|(% style="width:226px" %)The fifth bit sets the sampling time\|(% style="width:251px" %)(((
154.1	758	100~~10000ms
125.3	759
	760
	761	)))
	762
118.3	763	(% style="color:blue" %)Downlink Command: 0x07
118.2	764
131.1	765	Format: Command Code (0x07) followed by 9 bytes.
118.2	766
131.1	767	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	768
131.1	769	* Example 0: Downlink Payload: 07 00 0000 0000 00 0190 ~-~--> AT+MOD=0,0,0,0,400
	770
118.2	771	* Example 1: Downlink Payload: 070107080064000190 ~-~--> AT+MOD=1,1800,100,0,400
	772
166.1	773	* Example 2: Downlink Payload: 070200000064000190 ~-~--> AT+MOD=2,1800,100,0,400
118.3	774
151.1	775	* Example 3: Downlink Payload: 070300000064000190 ~-~--> AT+MOD=3,0,100,0,400
124.3	776
165.1	777	(% style="color:Red" %)Note: The over-limit alarm is applied to MOD1 and MOD2.
163.1	778
165.1	779	For example:
	780
163.1	781	* AT+MOD=1
	782
165.1	783	AT+DOL=1,500,244,(% style="color:blue" %)0(%%),300
163.1	784
164.1	785	Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1:
163.1	786
	787	[[image:image-20231211113204-2.png\|\|height="292" width="1093"]]
	788
	789	* AT+MOD=2
	790
	791	AT+DOL=1,500,244,(% style="color:blue" %)0(%%),300
	792
164.1	793	If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1:
163.1	794
	795	[[image:image-20231211114932-3.png\|\|height="277" width="1248"]]
	796
	797
	798
	799
	800
16.4	801	= 4. Battery & Power Consumption =
14.45	802
1.1	803
113.7	804	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	805
	806	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	807
	808
16.4	809	= 5. OTA Firmware update =
1.1	810
	811
13.1	812	(% class="wikigeneratedid" %)
113.7	813	User can change firmware DS20L to:
1.1	814
13.1	815	* Change Frequency band/ region.
62.7	816
13.1	817	* Update with new features.
62.7	818
13.1	819	* Fix bugs.
1.1	820
113.6	821	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]
1.1	822
31.1	823	Methods to Update Firmware:
1.1	824
79.15	825	* (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	826
175.2	827	* Update through UART TTL interface: [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.5UARTConnectionforDS20Lmotherboard]].
1.1	828
31.1	829	= 6. FAQ =
1.1	830
113.8	831	== 6.1 What is the frequency plan for DS20L? ==
1.1	832
62.7	833
113.8	834	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	835
1.1	836
124.2	837	== 6.2 DS20L programming line ==
	838
	839
174.2	840	[[image:image-20231212150243-1.jpeg\|\|height="448" width="1009"]]
124.2	841
	842	feature:
	843
	844	for AT commands
	845
	846	Update the firmware of DS20L
	847
	848	Support interrupt mode
	849
	850
	851	== 6.3 LiDAR probe position ==
	852
	853
	854	[[image:1701155390576-216.png\|\|height="285" width="307"]]
	855
	856	The black oval hole in the picture is the LiDAR probe.
	857
	858
	859	== 6.4 Interface definition ==
	860
	861	[[image:image-20231128151132-2.png\|\|height="305" width="557"]]
	862
	863
80.4	864	= 7. Trouble Shooting =
1.1	865
80.4	866	== 7.1 AT Command input doesn't work ==
1.1	867
70.14	868
80.4	869	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	870
	871
80.4	872	== 7.2 Significant error between the output distant value of LiDAR and actual distance ==
70.14	873
	874
80.4	875	(((
82.21	876	(% 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	877	)))
70.14	878
80.4	879	(((
82.21	880	(% style="color:red" %)Troubleshooting(%%): Please avoid use of this product under such circumstance in practice.
80.4	881	)))
70.14	882
	883
80.4	884	(((
	885	(% style="color:blue" %)Cause ②(%%): The IR-pass filters are blocked.
	886	)))
70.14	887
79.7	888	(((
82.21	889	(% style="color:red" %)Troubleshooting(%%): please use dry dust-free cloth to gently remove the foreign matter.
79.7	890	)))
70.14	891
	892
	893	= 8. Order Info =
	894
	895
113.5	896	Part Number: (% style="color:blue" %)DS20L-XXX
70.14	897
70.12	898	(% style="color:red" %)XXX(%%): The default frequency band
1.1	899
38.1	900	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
1.1	901
38.1	902	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
1.1	903
38.1	904	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
1.1	905
38.1	906	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
1.1	907
38.1	908	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
1.1	909
38.1	910	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
1.1	911
38.1	912	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
1.1	913
38.1	914	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
1.1	915
70.14	916	= 9. Packing Info =
67.11	917
	918
39.1	919	(% style="color:#037691" %)Package Includes:
1.1	920
113.5	921	* DS20L LoRaWAN Smart Distance Detector x 1
1.1	922
39.1	923	(% style="color:#037691" %)Dimension and weight:
1.1	924
31.1	925	* Device Size: cm
1.1	926
31.1	927	* Device Weight: g
1.1	928
31.1	929	* Package Size / pcs : cm
1.1	930
31.1	931	* Weight / pcs : g
1.1	932
70.14	933	= 10. Support =
	934
	935
31.1	936	* 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	937
	938	* 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