Wiki source code of DS03A-LB Outdoor LoRaWAN Door Sensor User Manual

Version 3.1 by Xiaoling on 2023/04/26 08:52

version	line-number	content
1.1	1
	2
	3
	4	Table of Contents：
	5
	6	{{toc/}}
	7
	8
	9
	10
	11
	12
	13	= 1. Introduction =
	14
2.1	15	== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
1.1	16
	17
	18	(((
2.1	19	The Dragino DS03A-LB is a (% style="color:blue" %)LoRaWAN Door Sensor(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server.
1.1	20	)))
	21
	22	(((
2.1	23	The LoRa wireless technology used in DS03A-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
1.1	24	)))
	25
	26	(((
2.1	27	The DS03A-LB will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB can count each open event and uplink periodically.
1.1	28	)))
	29
	30	(((
2.1	31	DS03A-LB supports (% style="color:blue" %)Datalog Feature,(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.
1.1	32	)))
	33
	34	(((
2.1	35	DS03A-LB has the (% style="color:blue" %)Open Alarm Feature(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time.
	36
	37	DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
1.1	38	)))
	39
	40	(((
2.1	41	DS03A-LB (% style="color:blue" %)supports BLE configure(%%) and (% style="color:blue" %)wireless OTA update(%%) which make user easy to use.
1.1	42	)))
	43
	44	(((
2.1	45	DS03A-LB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long term use up to 5 years.
1.1	46	)))
	47
	48	(((
2.1	49	Each DS03A-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
1.1	50	)))
	51
	52
	53	== 1.2 Features ==
	54
	55	* LoRaWAN 1.0.3 Class A
	56	* Ultra-low power consumption
	57	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
2.1	58	* Door Open/Close detect
	59	* Door open/close statistics
	60	* Datalog Feature, Open Alarm Feature
1.1	61	* Support Bluetooth v5.1 and LoRaWAN remote configure
	62	* Support wireless OTA update firmware
	63	* Uplink on periodically
	64	* Downlink to change configure
	65	* 8500mAh Battery for long term use
2.1	66	* Wall Mountable
	67	* Outdoor Use
1.1	68
	69
	70	== 1.3 Specification ==
	71
	72	(% style="color:#037691" %)Common DC Characteristics:
	73
	74	* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
	75	* Operating Temperature: -40 ~~ 85°C
	76
2.1	77	(% style="color:#037691" %)Sensor Detect Distance:
1.1	78
2.1	79	* Wood Door: 10mm ~~ 30mm
	80	* Iron Door: 30 ~~ 45mm
1.1	81
	82	(% style="color:#037691" %)LoRa Spec:
	83
	84	* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz
	85	* Max +22 dBm constant RF output vs.
	86	* RX sensitivity: down to -139 dBm.
	87	* Excellent blocking immunity
	88
	89	(% style="color:#037691" %)Battery:
	90
	91	* Li/SOCI2 un-chargeable battery
	92	* Capacity: 8500mAh
	93	* Self-Discharge: <1% / Year @ 25°C
	94	* Max continuously current: 130mA
	95	* Max boost current: 2A, 1 second
	96
	97	(% style="color:#037691" %)Power Consumption
	98
	99	* Sleep Mode: 5uA @ 3.3v
	100	* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
	101
	102
2.1	103	== 1.4 Applications ==
1.1	104
2.1	105	[[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741400370-813.png]]
1.1	106
2.1	107
	108	== 1.5 Sleep mode and working mode ==
	109
	110
1.1	111	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
	112
	113	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
	114
	115
2.1	116	== 1.6 Button & LEDs ==
1.1	117
	118
2.1	119	[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
1.1	120
	121
	122	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	123	\|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)Behavior on ACT\|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)Action
	124	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
	125	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
	126	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	127	)))
	128	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
	129	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
	130	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	131	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
	132	)))
2.1	133	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:117px" %)Deactivate Device\|(% style="width:225px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means Device is in Deep Sleep Mode.
1.1	134
2.1	135	== 1.7 BLE connection ==
1.1	136
	137
	138	D2x-LB support BLE remote configure.
	139
	140
	141	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	142
	143	* Press button to send an uplink
	144	* Press button to active device.
	145	* Device Power on or reset.
	146
	147	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	148
	149
2.1	150	== 1.8 Mechanical ==
1.1	151
	152
2.1	153	[[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png\|\|height="399" width="513"]]
1.1	154
	155
2.1	156	[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
1.1	157
	158
2.1	159	[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
1.1	160
	161
2.1	162	[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
1.1	163
	164
2.1	165	= 2. Configure DS03A-LB to connect to LoRaWAN network =
1.1	166
	167	== 2.1 How it works ==
	168
	169
2.1	170	The DS03A-LB 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 DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
1.1	171
	172
	173	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
	174
	175
	176	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.
	177
	178
	179	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.
	180
	181
	182	(% style="color:blue" %)Step 1:(%%) Create a device in TTN with the OTAA keys from D2x-LB.
	183
2.1	184	Each DS03A-LB is shipped with a sticker with the default device EUI as below:
1.1	185
	186	[[image:image-20230131134744-2.jpeg]]
	187
	188
	189
	190	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	191
	192
	193	(% style="color:blue" %)Register the device
	194
	195	[[image:1675144099263-405.png]]
	196
	197
	198	(% style="color:blue" %)Add APP EUI and DEV EUI
	199
	200	[[image:1675144117571-832.png]]
	201
	202
	203	(% style="color:blue" %)Add APP EUI in the application
	204
	205
	206	[[image:1675144143021-195.png]]
	207
	208
	209	(% style="color:blue" %)Add APP KEY
	210
	211	[[image:1675144157838-392.png]]
	212
2.1	213	(% style="color:blue" %)Step 2:(%%) Activate on DS03A-LB
1.1	214
	215
2.1	216	Press the button for 5 seconds to activate the DS03A-LB.
1.1	217
2.1	218	(% 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.
1.1	219
	220	After join success, it will start to upload messages to TTN and you can see the messages in the panel.
	221
	222
	223	== 2.3 Uplink Payload ==
	224
	225	=== 2.3.1 Device Status, FPORT~=5 ===
	226
2.1	227	Users can use the downlink command(0x26 01) to ask DS03A-LB to send device configure detail, include device configure status. DS03A-LB will uplink a payload via FPort=5 to server.
1.1	228
	229	The Payload format is as below.
	230
	231
	232	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	233	\|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)Device Status (FPORT=5)
	234	\|(% style="width:103px" %)Size (bytes)\|(% style="width:72px" %)1\|2\|(% style="width:91px" %)1\|(% style="width:86px" %)1\|(% style="width:44px" %)2
	235	\|(% style="width:103px" %)Value\|(% style="width:72px" %)Sensor Model\|Firmware Version\|(% style="width:91px" %)Frequency Band\|(% style="width:86px" %)Sub-band\|(% style="width:44px" %)BAT
	236
	237	Example parse in TTNv3
	238
	239	[[image:image-20230415153147-2.png\|\|height="220" width="1120"]]
	240
	241
2.1	242	(% style="color:#037691" %)Sensor Model(%%): For DS03A-LB, this value is 0x0B
1.1	243
	244	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
	245
	246	(% style="color:#037691" %)Frequency Band:
	247
	248	*0x01: EU868
	249
	250	*0x02: US915
	251
	252	*0x03: IN865
	253
	254	*0x04: AU915
	255
	256	*0x05: KZ865
	257
	258	*0x06: RU864
	259
	260	*0x07: AS923
	261
	262	*0x08: AS923-1
	263
	264	*0x09: AS923-2
	265
	266	*0x0a: AS923-3
	267
	268	*0x0b: CN470
	269
	270	*0x0c: EU433
	271
	272	*0x0d: KR920
	273
	274	*0x0e: MA869
	275
	276
	277	(% style="color:#037691" %)Sub-Band:
	278
	279	AU915 and US915:value 0x00 ~~ 0x08
	280
	281	CN470: value 0x0B ~~ 0x0C
	282
	283	Other Bands: Always 0x00
	284
	285
	286	(% style="color:#037691" %)Battery Info:
	287
	288	Check the battery voltage.
	289
	290	Ex1: 0x0B45 = 2885mV
	291
	292	Ex2: 0x0B49 = 2889mV
	293
	294
2.1	295	=== 2.3.2 Real-Time Open/Close Status, Uplink FPORT~=2 ===
1.1	296
2.1	297	DS03A-LB will send this uplink after Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
1.1	298
2.1	299	* Every 2 hours, this interval [[can be changed>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.1A0SetTransmitIntervalTime]].
	300	* There is an Open/Close event. (This info can be disabled by AT+DISALARM=1)
1.1	301
2.1	302	Uplink Payload totals 11 bytes.
1.1	303
2.1	304	\|=(% colspan="5" %)Real-Time Open/Close Status, FPORT=2
	305	\|Size(bytes)\|1\|3\|3\|4
	306	\|Value\|Status & [[Alarm>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]\|Total open door events\|(((
	307	The last door open
	308	duration (unit: min)
	309	)))\|[[Unix TimeStamp>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.4.1A0UnixTimeStamp]]
1.1	310
2.1	311	\|=(% colspan="4" %)Status & Alarm field
	312	\|Size(bit)\|6\|1\|1
	313	\|Value\|Reserve\|[[Enable/disable Timeout Alarm>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]
	314	0: No Alarm; 1: Alarm\|Status
	315	0: Close, 1: Open
1.1	316
2.1	317	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110547-6.png?width=1191&height=337&rev=1.1\|\|alt="image-20220609110547-6.png" height="337" width="1191"]]
1.1	318
	319
2.1	320	=== 2.3.3 Historical Door Open/Close Event, FPORT~=3 ===
1.1	321
2.1	322	DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.4A0DatalogFeature]].
1.1	323
2.1	324	The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
1.1	325
2.1	326	* (((
	327	Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands.
	328	)))
1.1	329
2.1	330	For example, in the US915 band, the max payload for different DR is:
1.1	331
2.1	332	1. (((
	333	DR0: max is 11 bytes so one entry of data
	334	)))
	335	1. (((
	336	DR1: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
	337	)))
	338	1. (((
	339	DR2: total payload includes 11 entries of data
	340	)))
	341	1. (((
	342	DR3: total payload includes 22 entries of data.
	343	)))
1.1	344
	345
2.1	346	If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
1.1	347
2.1	348	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609112215-7.png?width=1250&height=277&rev=1.1\|\|alt="image-20220609112215-7.png" height="277" width="1250"]]
1.1	349
2.1	350	Downlink:
1.1	351
2.1	352	0x31 61 8E 57 40 61 8E 81 70 05
1.1	353
	354
2.1	355	Uplink:
1.1	356
2.1	357	00 00 00 00 00 00 00 61 8E 5F 8F 01 00 00 01 00 00 00 61 8E 5F D2 00 00 00 01 00 00 02 61 8E 60 64 01 00 00 02 00 00 02 61 8E 60 75 00 00 00 02 00 00 01 61 8E 60 C6 00 00 00 02 00 00 01 61 8E 7B A7 01 00 00 03 00 00 01 61 8E 7F 38 00 00 00 03 00 00 02 61 8E 7F CE 01 00 00 04 00 00 02 61 8E 81 1B 00 00 00 04 00 00 00 61 8E 81 50
1.1	358
	359
2.1	360	Parsed Value:
1.1	361
2.1	362	[ALARM, DOOR_OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]
1.1	363
	364
2.1	365	[FALSE, CLOSE, 0, 0, 2021-11-12 12:35:27],
1.1	366
2.1	367	[FALSE, OPEN, 1, 0, 2021-11-12 12:36:34],
1.1	368
2.1	369	[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
1.1	370
2.1	371	[FALSE, OPEN, 2, 2, 2021-11-12 12:39:17],
1.1	372
2.1	373	[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
1.1	374
2.1	375	[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
1.1	376
2.1	377	[FALSE, OPEN, 3, 1, 2021-11-12 14:50:32],
1.1	378
2.1	379	[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
1.1	380
2.1	381	[FALSE, OPEN, 4, 2, 2021-11-12 14:58:35],
1.1	382
2.1	383	[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
1.1	384
	385
2.1	386	=== 2.3.4 Sensor Configuration, FPORT~=4 ===
1.1	387
2.1	388	DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
1.1	389
2.1	390	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110123-5.png?rev=1.1\|\|alt="image-20220609110123-5.png"]]
1.1	391
	392
2.1	393	* (((
	394	TDC: (default: 0x001C20)
	395	)))
1.1	396
2.1	397	Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
1.1	398
	399
2.1	400	* (((
	401	Disalarm: (default: 0)
	402	)))
1.1	403
2.1	404	If Disalarm = 1, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
1.1	405
2.1	406	If Disalarm = 0, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
1.1	407
	408
2.1	409	~ Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast.
1.1	410
	411
2.1	412	* (((
	413	Keep Status & Keep Time
	414	)))
1.1	415
2.1	416	Shows the configure value of [[Alarm Base on Timeout Feature>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]]
1.1	417
2.1	418	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110018-4.png?width=1159&height=291&rev=1.1\|\|alt="image-20220609110018-4.png" height="291" width="1159"]]
1.1	419
	420
	421	== 2.4 Payload Decoder file ==
	422
	423
	424	(((
	425	In TTN, use can add a custom payload so it shows friendly.
	426	)))
	427
	428	(((
	429	In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder to add the decoder from: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
	430	)))
	431
	432
	433	== 2.5 Datalog Feature ==
	434
	435
2.1	436	Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS03A-LB will store the reading for future retrieving purposes.
1.1	437
	438
	439	=== 2.5.1 Ways to get datalog via LoRaWAN ===
	440
	441
2.1	442	Set [[PNACKMD=1>>\|\|anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], DS03A-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DS03A-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
1.1	443
2.1	444	* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
	445	* b) DS03A-LB will send data in CONFIRMED Mode when PNACKMD=1, but DS03A-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DS03A-LB gets a ACK, DS03A-LB will consider there is a network connection and resend all NONE-ACK Message.
1.1	446
2.1	447	Below is the typical case for the Datalog Feature (Set PNACKMD=1)
1.1	448
	449	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1\|\|alt="image-20220703111700-2.png" height="381" width="1119"]]
	450
	451	=== 2.5.2 Unix TimeStamp ===
	452
	453
2.1	454	DS03A-LB uses Unix TimeStamp format based on
1.1	455
	456	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1\|\|alt="image-20220523001219-11.png" height="97" width="627"]]
	457
	458	User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
	459
	460	Below is the converter example
	461
	462	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1\|\|alt="image-20220523001219-12.png" height="298" width="720"]]
	463
	464	So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
	465
	466
	467	=== 2.5.3 Set Device Time ===
	468
	469
	470	User need to set (% style="color:blue" %)SYNCMOD=1(%%) to enable sync time via MAC command.
	471
2.1	472	Once DS03A-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS03A-LB. If DS03A-LB fails to get the time from the server, DS03A-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
1.1	473
2.1	474	(% style="color:red" %)Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN v3 and loriot support but TTN v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN v2 if SYNCMOD=1.
1.1	475
	476
2.1	477	== 2.6 Show Data in DataCake IoT Server ==
1.1	478
2.1	479	Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
1.1	480
	481
2.1	482	Step 1: Link TTNv3 to Datacake.[[https:~~/~~/docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti>>url:https://docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti]]
1.1	483
2.1	484	Step 2: Configure DS03A-LB in Datacake.
1.1	485
2.1	486	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746350207-427.png?rev=1.1\|\|alt="1654746350207-427.png"]]
1.1	487
2.1	488	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654747162439-840.png?rev=1.1\|\|alt="1654747162439-840.png"]]
1.1	489
2.1	490	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746405400-203.png?rev=1.1\|\|alt="1654746405400-203.png"]]
1.1	491
2.1	492	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746763908-732.png?rev=1.1\|\|alt="1654746763908-732.png"]]
1.1	493
2.1	494	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746716087-684.png?rev=1.1\|\|alt="1654746716087-684.png"]]
1.1	495
2.1	496	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746693868-718.png?rev=1.1\|\|alt="1654746693868-718.png"]]
1.1	497
2.1	498	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746674738-826.png?rev=1.1\|\|alt="1654746674738-826.png"]]
1.1	499
2.1	500	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746646379-591.png?rev=1.1\|\|alt="1654746646379-591.png"]]
1.1	501
2.1	502	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746549277-209.png?rev=1.1\|\|alt="1654746549277-209.png"]]
1.1	503
2.1	504	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654746593411-887.png?rev=1.1\|\|alt="1654746593411-887.png"]]
1.1	505
	506
	507	== 2.7 Frequency Plans ==
	508
	509
2.1	510	The DS03A-LB 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	511
	512	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
	513
	514
	515	== 2.8 Firmware Change Log ==
	516
	517
	518	Firmware download link:
	519
	520	[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
	521
	522
2.1	523	= 3. Configure DS03A-LB =
1.1	524
	525	== 3.1 Configure Methods: ==
	526
	527
2.1	528	DS03A-LB supports below configure method:
1.1	529
	530	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
	531	* AT Command via UART Connection : See [[Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
	532	* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
	533
	534
	535	== 3.2 General Commands ==
	536
	537	These commands are to configure:
	538
	539	* General system settings like: uplink interval.
	540	* LoRaWAN protocol & radio related command.
	541
	542	They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	543
	544	[[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/]]
	545
	546
2.1	547	== 3.3 Commands special design for DS03A-LB ==
1.1	548
	549
2.1	550	These commands only valid for DS03A-LB, as below:
1.1	551
	552
	553	=== 3.3.1 Set Transmit Interval Time ===
	554
	555
	556	Feature: Change LoRaWAN End Node Transmit Interval.
	557
	558	(% style="color:blue" %)AT Command: AT+TDC
	559
	560	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	561	\|=(% style="width: 156px;background-color:#D9E2F3" %)Command Example\|=(% style="width: 137px;background-color:#D9E2F3" %)Function\|=(% style="background-color:#D9E2F3" %)Response
	562	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	563	30000
	564	OK
	565	the interval is 30000ms = 30s
	566	)))
	567	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	568	OK
	569	Set transmit interval to 60000ms = 60 seconds
	570	)))
	571
	572	(% style="color:blue" %)Downlink Command: 0x01
	573
	574	Format: Command Code (0x01) followed by 3 bytes time value.
	575
	576	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
	577
	578	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	579	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
	580
	581	=== 3.3.2 Get Device Status ===
	582
	583
	584	Send a LoRaWAN downlink to ask device send Alarm settings.
	585
	586	* (% style="color:blue" %)Downlink Payload: (%%)0x26 01
	587
	588	Sensor will upload Device Status via FPORT=5. See payload section for detail.
	589
	590
2.1	591	=== 3.3.3 Enable / Disable Alarm ===
1.1	592
2.1	593	Feature: Enable/Disable Alarm for open/close event. Default value 0.
1.1	594
2.1	595	AT Command:
1.1	596
2.1	597	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609140712-1.png?rev=1.1\|\|alt="image-20220609140712-1.png"]]
1.1	598
2.1	599	Downlink Command:
1.1	600
2.1	601	0xA7 01 ~/~/ Same As AT+DISALARM=1
1.1	602
2.1	603	0xA7 00 ~/~/ Same As AT+DISALARM=0
1.1	604
	605
2.1	606	=== 3.3.4 Alarm Base on Timeout ===
1.1	607
2.1	608	DS03A-LB can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:
1.1	609
	610
2.1	611	* (((
	612	Keep Status: Status to be monitor
	613	)))
1.1	614
2.1	615	Keep Status = 1: Monitor Close to Open event
1.1	616
2.1	617	Keep Status = 0: Monitor Open to Close event
1.1	618
	619
2.1	620	* (((
	621	Keep Time: Timeout to send an Alarm
	622	)))
1.1	623
2.1	624	Range 0 ~~ 65535(0xFFFF) seconds.
1.1	625
2.1	626	If keep time = 0, Disable Alarm Base on Timeout feature.
1.1	627
2.1	628	If keep time > 0, device will monitor the keep status event and send an alarm when status doesn't change after timeout.
1.1	629
	630
2.1	631	AT Command to configure:
1.1	632
2.1	633	* (((
	634	AT+TTRIG=1,30 ~-~-> When the Keep Status change from close to open, and device remains in open status for more than 30 seconds. LDS03A will send an uplink packet, the [[Alarm bit>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
	635	)))
1.1	636
2.1	637	* (((
	638	AT+TTRIG=0,0 ~-~-> Default Value, disable timeout Alarm.
	639	)))
1.1	640
	641
2.1	642	Downlink Command to configure:
1.1	643
2.1	644	Command: 0xA9 aa bb cc
1.1	645
2.1	646	A9: Command Type Code
1.1	647
2.1	648	aa: status to be monitored
1.1	649
2.1	650	bb cc: timeout.
1.1	651
	652
2.1	653	If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
1.1	654
2.1	655	Or
1.1	656
2.1	657	0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
1.1	658
	659
2.1	660	=== 3.3.5 Count Mod ===
1.1	661
2.1	662	AT Command:
1.1	663
2.1	664	\|=Command Example\|=Function\|=Response
	665	\|(((
	666	AT+COUNTMOD=0
	667	)))\|(((
	668	the count value keeps accumulating mode
	669	)))\|(((
	670
1.1	671
2.1	672	OK
	673	)))
	674	\|(((
	675	AT+COUNTMOD=1
	676	)))\|(((
	677	the count value will be reset after each TDC time（Last Close Duration Reset after each uplink）
	678	)))\|(((
	679	OK
	680	)))
1.1	681
2.1	682	Downlink Command:
1.1	683
2.1	684	Example: 0B aa => AT+COUNTMOD = second byte
1.1	685
	686
2.1	687	=== 3.3.6 Interrupt Pin Channel Mod ===
1.1	688
2.1	689	AT Command:
1.1	690
2.1	691	\|=Command Example\|=Function\|=Response
	692	\|(((
	693	AT+TTRCHANNEL=1
	694	)))\|(((
	695	set as single channel, only use PB14 pin as interrupt pin.
	696	)))\|(((
	697
1.1	698
2.1	699	OK
	700	)))
	701	\|(((
	702	AT+TTRCHANNEL=2
	703	)))\|(((
	704	is set as dual channel, use PB14 pin and PB15 pin as interrupt pin.
	705	)))\|(((
	706	OK
	707	)))
1.1	708
2.1	709	Downlink Command:
1.1	710
2.1	711	Example: 0D aa => AT+TTRCHANNEL = second byte
	712
	713
	714	=== 3.3.7 Change the name of AT+TTRIG to AT+TTRIG1 ===
	715
	716	Downlink Command:
	717
	718	Example: A9 01 aa bb cc => AT+TTRIG1= third byte, 4th byte and 5th byte
	719
	720
	721	=== 3.3.8 Added AT+TTRIG2 for PB15 pin ===
	722
	723	Downlink Command:
	724
	725	Example: A9 02 aa bb cc => AT+TTRIG2= third byte, 4th byte and 5th byte
	726
	727
	728	=== 3.3.9 TTRIG1/2 timeout status alarm ===
	729
	730	It needs to be used with AT+TTRIG1 or AT+TTRIG2. When TTRIG1 or TTRIG2 times out and causes an alarm, and the status does not change subsequently, an alarm packet will be sent at the alarm interval.
	731
	732	AT Command:
	733
	734	\|=Command Example\|=Function\|=Response
	735	\|(((
	736	AT+TTRALARM=0
	737	)))\|(((
	738	disable continuous alarm
	739	)))\|(((
	740
	741
1.1	742	OK
	743	)))
2.1	744	\|(((
	745	AT+TTRALARM=60
	746	)))\|(((
	747	The alarm interval is 60 minutes (unit: minutes)
	748	)))\|(((
	749	OK
	750	)))
1.1	751
2.1	752	Downlink Command:
1.1	753
2.1	754	Example: 0C aa => AT+TTRALARM= aa
1.1	755
	756
2.1	757	=== 3.3.9 Select counting mode ===
1.1	758
2.1	759	AT+TTRMODx=a,b
1.1	760
2.1	761	When a=0, the door is opened to count, and when a=1,the closed door is counted.
	762
	763	When b=0, it is the last door open duration, and when b=1,the last door close duration.
	764
	765	AT Command:
	766
	767	\|=Command Example\|=Function\|=Response
	768	\|(((
	769	AT+TTRMODx=1,0
	770	)))\|Door closed count and record the last door opened duration\|(((
	771
	772
	773	OK
	774	)))
	775	\|(((
	776	AT+TTRMODx=0,1
	777	)))\|(((
	778	Door opened count and record the last door Door Door open closed duration
	779	)))\|(((
	780	OK
	781	)))
	782
	783
1.1	784	= 4. Battery & Power Consumption =
	785
	786
2.1	787	DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	788
	789	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	790
	791
	792	= 5. OTA firmware update =
	793
	794
2.1	795	User can change firmware DS03A-LB to:
1.1	796
	797	* Change Frequency band/ region.
	798	* Update with new features.
	799	* Fix bugs.
	800
	801	Firmware and changelog can be downloaded from : [[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
	802
	803
	804	Methods to Update Firmware:
	805
	806	* (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/]]
	807	* 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]].
	808
	809
	810	= 6. FAQ =
	811
	812
	813
	814	= 7. Order Info =
	815
	816
2.1	817	Part Number: (% style="color:blue" %)DS03A-LB-XX
1.1	818
	819	(% style="color:red" %)XX(%%): The default frequency band
	820
	821	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	822
	823	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	824
	825	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	826
	827	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	828
	829	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	830
	831	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
	832
	833	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	834
	835	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
	836
	837	= 8. Packing Info =
	838
	839
	840	(% style="color:#037691" %)Package Includes:
	841
2.1	842	* DS03A-LB LoRaWAN Temperature Sensor
1.1	843
	844	(% style="color:#037691" %)Dimension and weight:
	845
	846	* Device Size: cm
	847
	848	* Device Weight: g
	849
	850	* Package Size / pcs : cm
	851
	852	* Weight / pcs : g
	853
	854	= 9. Support =
	855
	856
	857	* 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.
	858
	859	* 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.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]

Wiki source code of DS03A-LB Outdoor LoRaWAN Door Sensor User Manual

Applications