Version 4.18 by Xiaoling on 2023/05/16 10:17

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