Skip to Content
Last modified by Mengting Qiu on 2025/07/03 16:36
From version 7.5
edited by Xiaoling
on 2023/05/22 10:41
Change comment: There is no comment for this version
To version 72.1
edited by Mengting Qiu
on 2025/07/03 16:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -DS03A-LB Outdoor LoRaWAN Door Sensor User Manual
1 +DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.ting
Content
... ... @@ -1,9 +1,17 @@
1 -(% style="text-align:center" %)
2 -[[image:image-20230516085523-1.jpeg||height="491" width="491"]]
1 +(% style="display:none" %) (%%)
3 3  
3 +[[image:image-20240108161155-2.png||data-xwiki-image-style-alignment="center"]]
4 4  
5 -**Table of Contents：**
6 6  
6 +
7 +
8 +
9 +
10 +
11 +
12 +
13 +**Table of Contents:**
14 +
7 7  {{toc/}}
8 8  
9 9  
... ... @@ -13,47 +13,44 @@
13 13  
14 14  = 1. Introduction =
15 15  
16 -== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
24 +== 1.1 What is LoRaWAN Door Sensor ==
17 17  
18 18  
19 19  (((
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.
28 +The Dragino DS03A-LB/LS 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.
21 21  )))
22 22  
23 23  (((
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.
32 +The LoRa wireless technology used in DS03A-LB/LS 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.
25 25  )))
26 26  
27 27  (((
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.
36 +The DS03A-LB/LS 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/LS can count each open event and uplink periodically.
29 29  )))
30 30  
31 31  (((
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.
40 +DS03A-LB/LS supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.
33 33  )))
34 34  
35 35  (((
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.
44 +DS03A-LB/LS 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 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
46 +DS03A-LB/LS is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
39 39  )))
40 40  
41 41  (((
42 -DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
50 +DS03A-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
43 43  )))
44 44  
45 45  (((
46 -DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
54 +DS03A-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + Li-ion battery**(%%), it is designed for long term use up to 5 years.
47 47  )))
48 48  
49 49  (((
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.
58 +Each DS03A-LB/LS 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.
51 51  )))
52 52  
53 53  
54 -[[image:image-20230522092934-2.png||height="346" width="774"]]
55 -
56 -
57 57  == 1.2 ​Features ==
58 58  
59 59  
... ... @@ -63,28 +63,24 @@
63 63  * Door Open/Close detect
64 64  * Door open/close statistics
65 65  * Datalog Feature, Open Alarm Feature
71 +* Probe length: 40cm
66 66  * Support Bluetooth v5.1 and LoRaWAN remote configure
67 67  * Support wireless OTA update firmware
68 68  * Uplink on periodically
69 69  * Downlink to change configure
70 -* 8500mAh Battery for long term use
71 71  * Wall Mountable
72 72  * Outdoor Use
78 +* 8500mAh Li/SOCl2 Battery (DS03A-LB)
79 +* Solar panel + 3000mAh Li-ion battery (DS03A-LS)
73 73  
74 -
75 75  == 1.3 Specification ==
76 76  
77 77  
78 78  (% style="color:#037691" %)**Common DC Characteristics:**
79 79  
80 -* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
86 +* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
81 81  * Operating Temperature: -40 ~~ 85°C
82 82  
83 -(% style="color:#037691" %)**Sensor Detect Distance:**
84 -
85 -* Wood Door: 10mm ~~ 30mm
86 -* Iron Door: 30 ~~ 45mm
87 -
88 88  (% style="color:#037691" %)**LoRa Spec:**
89 89  
90 90  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -105,7 +105,6 @@
105 105  * Sleep Mode: 5uA @ 3.3v
106 106  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
107 107  
108 -
109 109  == 1.4 Applications ==
110 110  
111 111  
... ... @@ -123,27 +123,25 @@
123 123  == 1.6 Button & LEDs ==
124 124  
125 125  
126 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
126 +[[image:image-20250417152253-1.jpeg]]
127 127  
128 -
129 129  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
130 -|=(% 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**
131 -|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
129 +|=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 226px;background-color:#4F81BD;color:white" %)**Action**
130 +|[[image:1749536870332-565.png]] 1~~3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
132 132  If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
133 133  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
134 134  )))
135 -|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
134 +|[[image:1749536872361-767.png]] >3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
136 136  (% 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.
137 137  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
138 138  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.
139 139  )))
140 -|(% 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.
139 +|[[image:1749536881052-376.png]] x5|(% 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.
141 141  
142 -
143 143  == 1.7 BLE connection ==
144 144  
145 145  
146 -D2x-LB support BLE remote configure.
144 +DS03A-LB/LS support BLE remote configure.
147 147  
148 148  
149 149  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:
... ... @@ -155,27 +155,41 @@
155 155  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
156 156  
157 157  
158 -== 1.8 Mechanical ==
156 +== 1.8 Pin Definitions ==
159 159  
158 +[[image:image-20230630160843-7.png]]
160 160  
160 +
161 +== 1.9 Mechanical ==
162 +
163 +=== 1.9.1 for LB version ===
164 +
165 +[[image:image-20250331163305-1.jpeg]]
166 +
167 +
168 +(% style="color:blue" %)**Probe Mechanical:**
169 +
161 161  [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
162 162  
163 163  
164 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
173 +=== 1.9.2 for LS version ===
165 165  
166 166  
167 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
176 +[[image:image-20250331163324-2.jpeg]]
168 168  
169 169  
170 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
179 +== 1.10 Magnet Distance ==
171 171  
172 172  
173 -= 2. Configure DS03A-LB to connect to LoRaWAN network =
182 +* Wood Door: 10mm ~~ 30mm
183 +* Iron Door: 30 ~~ 45mm
174 174  
185 += 2. Configure DS03A-LB/LS to connect to LoRaWAN network =
186 +
175 175  == 2.1 How it works ==
176 176  
177 177  
178 -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.
190 +The DS03A-LB/LS 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/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours.
179 179  
180 180  
181 181  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
... ... @@ -183,14 +183,14 @@
183 183  
184 184  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" %)
185 185  
186 -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.
198 +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.
187 187  
188 -[[image:image-20230522092858-1.png||height="391" width="874"]]
200 +[[image:image-20250417152741-2.png]]
189 189  
190 190  
191 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
203 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB/LS.
192 192  
193 -Each DS03A-LB is shipped with a sticker with the default device EUI as below:
205 +Each DS03A-LB/LS is shipped with a sticker with the default device EUI as below:
194 194  
195 195  [[image:image-20230426085205-1.png||height="238" width="512"]]
196 196  
... ... @@ -197,34 +197,47 @@
197 197  
198 198  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
199 199  
200 -(% style="display:none" %) (%%)
212 +**Create the application.**
201 201  
202 -(% style="color:blue" %)**Register the device**
214 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]
203 203  
216 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]
204 204  
205 -[[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" %)
206 206  
219 +**Add devices to the created Application.**
207 207  
208 -(% style="color:blue" %)**Add APP EUI and DEV EUI**
221 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]
209 209  
210 -[[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"]]
223 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]
211 211  
212 212  
213 -(% style="color:blue" %)**Add APP EUI in the application**
226 +**Enter end device specifics manually.**
214 214  
215 -[[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"]]
228 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]
216 216  
217 217  
218 -(% style="color:blue" %)**Add APP KEY**
231 +**Add DevEUI and AppKey. Customize a platform ID for the device.**
219 219  
220 -[[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"]]
233 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]
221 221  
222 222  
223 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
236 +(% style="color:blue" %)**Step 2:**(%%) Add decoder.
224 224  
238 +In TTN, user can add a custom payload so it shows friendly reading.
225 225  
226 -Press the button for 5 seconds to activate the DS03A-LB.
240 +Click this link to get the decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/]]
227 227  
242 +Below is TTN screen shot:
243 +
244 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140556-1.png?width=1184&height=488&rev=1.1||alt="image-20241009140556-1.png" height="488" width="1184"]]
245 +
246 +[[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140603-2.png?width=1168&height=562&rev=1.1||alt="image-20241009140603-2.png" height="562" width="1168"]]
247 +
248 +
249 +(% style="color:blue" %)**Step 3:**(%%) Activate on DS03A-LB/LS
250 +
251 +Press the button for 5 seconds to activate the DS03A-LB/LS.
252 +
228 228  (% 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.
229 229  
230 230  After join success, it will start to upload messages to TTN and you can see the messages in the panel.
... ... @@ -235,54 +235,56 @@
235 235  === 2.3.1 Device Status, FPORT~=5 ===
236 236  
237 237  
238 -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.
263 +Include device configure status. Once DS03A-LB/LS Joined the network, it will uplink this message to the server. After that, DS03A-LB/LS will uplink Device Status every 12 hours.
239 239  
240 -The Payload format is as below.
265 +Users can also use the downlink command**(0x26 01)** to ask DS03A-LB/LS to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
241 241  
242 242  
268 +The Payload format is as below.
269 +
243 243  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
244 -|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
271 +|(% colspan="6" style="background-color:#4f81bd; color:white" %)**Device Status (FPORT=5)**
245 245  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
246 -|(% 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
273 +|(% 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
247 247  
248 248  Example parse in TTNv3
249 249  
250 -[[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-20220609104802-1.png?rev=1.1||alt="image-20220609104802-1.png" height="393" width="1195"]]
277 +[[image:image-20230630155406-1.png||height="190" width="873"]]
251 251  
252 252  
253 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x0B
280 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB/LS, this value is 0x1B
254 254  
255 255  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
256 256  
257 257  (% style="color:#037691" %)**Frequency Band**:
258 258  
259 -*0x01: EU868
286 +0x01: EU868
260 260  
261 -*0x02: US915
288 +0x02: US915
262 262  
263 -*0x03: IN865
290 +0x03: IN865
264 264  
265 -*0x04: AU915
292 +0x04: AU915
266 266  
267 -*0x05: KZ865
294 +0x05: KZ865
268 268  
269 -*0x06: RU864
296 +0x06: RU864
270 270  
271 -*0x07: AS923
298 +0x07: AS923
272 272  
273 -*0x08: AS923-1
300 +0x08: AS923-1
274 274  
275 -*0x09: AS923-2
302 +0x09: AS923-2
276 276  
277 -*0x0a: AS923-3
304 +0x0a: AS923-3
278 278  
279 -*0x0b: CN470
306 +0x0b: CN470
280 280  
281 -*0x0c: EU433
308 +0x0c: EU433
282 282  
283 -*0x0d: KR920
310 +0x0d: KR920
284 284  
285 -*0x0e: MA869
312 +0x0e: MA869
286 286  
287 287  
288 288  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -303,140 +303,327 @@
303 303  Ex2: 0x0B49 = 2889mV
304 304  
305 305  
306 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
333 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
307 307  
308 308  
309 -DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
336 +DS03A-LB/LS will only send this command after getting the downlink command **(0x26 02)** from the server.
310 310  
311 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
338 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
339 +|(% colspan="8" style="background-color:#4f81bd; color:white; width:515px" %)**Sensor Configuration FPORT=4**
340 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:50px" %)**1**|(% style="width:100px" %)**1**|(% style="width:90px" %)**2**|(% style="width:100px" %)**1**|(% style="width:100px" %)**2**|(% style="width:98px" %)**1**
341 +|Value|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
342 +Keep status1
343 +)))|(% style="width:99px" %)(((
344 +Keep time1(unit: sec)
345 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
346 +Keep time2(unit: sec)
347 +)))|(% style="width:98px" %)(((
348 +Alarm interval(unit: min)
349 +)))
350 +
351 +Example parse in TTNv3
352 +
353 +[[image:image-20230630155527-3.png||height="146" width="902"]]
354 +
355 +
356 +* (((
357 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
358 +)))
359 +
360 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
361 +
362 +
363 +* (((
364 +(% style="color:blue" %)**Disalarm: (default: 0)**
365 +)))
366 +
367 + **If Disalarm = 1**, DS03A-LB/LS 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.
368 +
369 + **If Disalarm = 0**, DS03A-LB/LS 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.
370 +
371 +
372 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
373 +
374 +
375 +* (((
376 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
377 +)))
378 +
379 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
380 +
381 +
382 +
383 +* (((
384 +(% style="color:blue" %)**Alarm interval(default: 0)**
385 +)))
386 +
387 +When the state of the door sensor has not been changed after the timeout alarm, the device will send a uplink every alarm interval. It will stop the alarm until the state of the door sensor is changed after the timeout alarm.
388 +
389 +
390 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
391 +
392 +
393 +DS03A-LB/LS will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB/LS will send uplinks when:
394 +
395 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
312 312  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
313 313  
314 -Uplink Payload totals 11 bytes.
398 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
315 315  
316 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
317 -|=(% colspan="5" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 522px;" %)**Real-Time Open/Close Status, FPORT=2**
318 -|(% style="width:95px" %)**Size(bytes)**|(% style="width:78px" %)**1**|(% style="width:98px" %)**3**|(% style="width:144px" %)**3**|(% style="width:108px" %)**4**
319 -|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)(((
320 -The last door open duration (unit: min)
400 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
401 +|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
402 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
403 +|(% style="width:95px" %)Value|(% style="width:97px" %)(((
404 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
405 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
406 +The last door open duration (unit: sec)
321 321  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
322 322  
323 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:518.818px" %)
324 -|=(% colspan="4" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 516px;" %)**Status & Alarm field**
325 -|(% style="width:76px" %)**Size(bit)**|(% style="width:70px" %)**6**|(% style="width:240px" %)**1**|(% style="width:130px" %)**1**
326 -|(% style="width:76px" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:240px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]]
327 -0: No Alarm; 1: Alarm|(% style="width:130px" %)Status
328 -0: Close, 1: Open
409 +**Status & Alarm:**
329 329  
330 -[[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"]]
411 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
412 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit4]**|(% style="background-color:#4f81bd; color:white; width:80px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:105px" %)**bit0**
413 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
414 +Count mod
415 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
416 +Alarm 0: No Alarm; 1: Alarm
417 +)))|(% style="width:131px" %)(((
418 +Status 0: Close; 1: Open
419 +)))
331 331  
421 +[[image:image-20230630155451-2.png||height="246" width="928"]]
332 332  
333 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
334 334  
424 +* (((
425 +(% style="color:blue" %)**Count mod:Default=0**
426 +)))
335 335  
336 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
428 +0: Uplink total open door times since factory
337 337  
338 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
430 +1: Uplink total open door times since last FPORT=2 uplink.
339 339  
432 +
433 +* (% style="color:blue" %)**TDC flag**
434 +
435 +When the flag is 1, it means sending packets at normal time intervals.
436 +
437 +Otherwise, it is a packet sent at non-TDC time.
438 +
439 +
340 340  * (((
341 -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.
441 +(% style="color:#0000ff" %)**Alarm**
342 342  )))
343 343  
344 -For example, in the US915 band, the max payload for different DR is:
444 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
345 345  
346 -(((
347 -**~1. DR0**: max is 11 bytes so one entry of data
348 -)))
349 349  
350 -(((
351 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
447 +* (((
448 +(% style="color:blue" %)**Status**
352 352  )))
353 353  
354 -(((
355 -**3. DR2**: total payload includes 11 entries of data
451 +This bit is 1 when the door sensor is open and 0 when it is close.
452 +
453 +
454 +* (((
455 +(% style="color:blue" %)**Total open door events**
356 356  )))
357 357  
358 -(((
359 -**4. DR3**: total payload includes 22 entries of data.
458 +Total pulse/counting base on open door.
459 +
460 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
461 +
462 +
463 +* (((
464 +(% style="color:blue" %)**The last door open duration**
360 360  )))
361 361  
362 -If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
467 +Door sensor last open duration.
363 363  
364 -[[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"]]
469 +Unit: sec.
365 365  
366 -**Downlink:**
471 +[[image:image-20230701094042-1.png||height="154" width="763"]]
367 367  
368 -0x31 61 8E 57 40 61 8E 81 70 05
369 369  
474 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
370 370  
371 -**Uplink:**
476 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
372 372  
373 -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
478 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
374 374  
480 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
481 +|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
482 +|(% style="width:50px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:125px" %)**3**|(% style="width:100px" %)**4**|(% style="width:86px" %)**1**|(% style="width:96px" %)**3**|(% style="width:126px" %)**3**
483 +|(% style="width:95px" %)Value|(% style="width:97px" %)(((
484 +Status1 & Alarm1
485 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
486 +The last door open duration1 (unit: sec)
487 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
488 +Status2 & Alarm2
489 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
375 375  
376 -**Parsed Value:**
491 +**Status1 & Alarm1:**
377 377  
378 -[ALARM, DOOR_OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]
493 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
494 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit4]**|(% style="background-color:#4f81bd; color:white; width:70px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:117px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:117px" %)**bit0**
495 +|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
496 +Count mod
497 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
498 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
499 +)))|(% style="width:181px" %)(((
500 +Status1 0: Close; 1: Open (PA8 of pin)
501 +)))
379 379  
503 +**Status2 & Alarm2:**
380 380  
381 -[FALSE, CLOSE, 0, 0, 2021-11-12 12:35:27],
505 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
506 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit2]**|(% style="background-color:#4f81bd; color:white; width:200px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:200px" %)**bit0**
507 +|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
508 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
509 +)))|(% style="width:181px" %)(((
510 +Status2 0: Close; 1: Open (PA4 of pin)
511 +)))
382 382  
383 -[FALSE, OPEN,  1, 0, 2021-11-12 12:36:34],
513 +[[image:image-20230630155908-6.png||height="295" width="927"]]
384 384  
385 -[FALSE, CLOSE, 1, 2, 2021-11-12 12:39:00],
386 386  
387 -[FALSE, OPEN,  2, 2, 2021-11-12 12:39:17],
516 +* (((
517 +(% style="color:blue" %)**Count mod:Default=0**
518 +)))
388 388  
389 -[FALSE, CLOSE, 2, 1, 2021-11-12 12:40:38],
520 +0: Uplink total open door times since factory
390 390  
391 -[FALSE, CLOSE, 2, 1, 2021-11-12 14:35:19],
522 +1: Uplink total open door times since last FPORT=2 uplink.
392 392  
393 -[FALSE, OPEN,  3, 1, 2021-11-12 14:50:32],
394 394  
395 -[FALSE, CLOSE, 3, 2, 2021-11-12 14:53:02],
525 +* (% style="color:blue" %)**TDC flag**
396 396  
397 -[FALSE, OPEN,  4, 2, 2021-11-12 14:58:35],
527 +When the flag is 1, it means sending packets at normal time intervals.
398 398  
399 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28],
529 +Otherwise, it is a packet sent at non-TDC time.
400 400  
401 401  
402 -=== 2.3.4  Sensor Configuration, FPORT~=4 ===
532 +* (((
533 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
534 +)))
403 403  
536 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
404 404  
405 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
406 406  
407 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
408 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4**
409 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**
410 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min)
539 +* (((
540 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
541 +)))
411 411  
543 +This bit is 1 when the door sensor is open and 0 when it is close.
544 +
545 +
412 412  * (((
413 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
547 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
414 414  )))
415 415  
416 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
550 +Total pulse/counting base on open door.
417 417  
552 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
418 418  
554 +
419 419  * (((
420 -(% style="color:blue" %)**Disalarm: (default: 0)**
556 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
421 421  )))
422 422  
423 - **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.
559 +Door sensor last open duration.
424 424  
425 - **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.
561 +Unit: sec.
426 426  
563 +[[image:image-20230701094042-1.png||height="154" width="763"]]
427 427  
428 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
429 429  
566 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
430 430  
568 +
569 +DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
570 +
571 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
572 +
573 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
574 +|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
575 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
576 +|(% style="width:95px" %)Value|(% style="width:97px" %)(((
577 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
578 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
579 +The last door open duration (unit: sec)
580 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
581 +
582 +**Status & Alarm:**
583 +
584 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
585 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:75px" %)**bit7**|(% style="background-color:#4f81bd; color:white; width:65px" %)**bit6**|(% style="background-color:#4f81bd; color:white; width:50px" %)**[bit5:bit4]**|(% style="background-color:#4f81bd; color:white; width:50px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:70px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:80px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:75px" %)**bit0**
586 +|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
587 +Count mod
588 +)))|(% style="width:95px" %)(((
589 +TDC flag 0:No; 1:Yes
590 +)))|(% style="width:116px" %)(((
591 +Alarm 0: No Alarm; 1: Alarm
592 +)))|(% style="width:112px" %)(((
593 +Status 0:Close; 1: Open
594 +)))
595 +
431 431  * (((
432 -(% style="color:blue" %)**Keep Status & Keep Time**
597 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB/LS will send max bytes according to the current DR and Frequency bands.
433 433  )))
434 434  
435 -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]]
600 +For example, in the US915 band, the max payload for different DR is:
436 436  
437 -[[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"]]
602 +(((
603 +**~1. DR0**: max is 11 bytes so one entry of data
604 +)))
438 438  
606 +(((
607 +**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
608 +)))
439 439  
610 +(((
611 +**3. DR2**: total payload includes 11 entries of data
612 +)))
613 +
614 +(((
615 +**4. DR3**: total payload includes 22 entries of data.
616 +)))
617 +
618 +If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
619 +
620 +[[image:image-20230630155556-4.png||height="146" width="938"]]
621 +
622 +**Downlink:**
623 +
624 +0x31 64 9E 7D 34 64 9E 7E 9C 05
625 +
626 +
627 +**Uplink:**
628 +
629 +45 00 00 00 00 00 00 64 9E 7D 48 40 00 00 00 00 00 63 64 9E 7D 9C 41 00 00 01 00 00 63 64 9E 7D A4 40 00 00 01 00 00 8D 64 9E 7E 31 43 00 00 02 00 00 8D 64 9E 7E 44 48 00 00 02 00 00 1F 64 9E 7E 59 4B 00 00 03 00 00 1F 64 9E 7E 6B
630 +
631 +
632 +**Parsed Value:**
633 +
634 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
635 +
636 +
637 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
638 +
639 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
640 +
641 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
642 +
643 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
644 +
645 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
646 +
647 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
648 +
649 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
650 +
651 +[[image:image-20230630172740-1.png||height="199" width="868"]]
652 +
653 +
440 440  == 2.4 Payload Decoder file ==
441 441  
442 442  
... ... @@ -451,47 +451,52 @@
451 451  
452 452  == 2.5 Datalog Feature ==
453 453  
668 + 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/LS will store the reading for future retrieving purposes.
454 454  
455 -(% 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.
456 456  
671 +=== 2.5.1 How datalog works ===
457 457  
458 -=== 2.5.1 Ways to get datalog via LoRaWAN ===
459 459  
674 +DS03A-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network,DS03A-LB/LS 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.
460 460  
461 -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.
676 +* (((
677 +a) DS03A-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
678 +)))
679 +* (((
680 +b) DS03A-LB/LS will send data in **CONFIRMED Mode**, but DS03A-LB/LS 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/LS gets a ACK, DS03A-LB/LS will consider there is a network connection and resend all NONE-ACK messages.
462 462  
463 -* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
464 -* 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.
682 +
683 +)))
465 465  
466 -Below is the typical case for the Datalog Feature (Set PNACKMD=1)
685 +=== 2.5.2 Enable Datalog ===
467 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-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="image-20220703111700-2.png" height="381" width="1119"]]
469 469  
688 +User need to make sure below two settings are enable to use datalog;
470 470  
471 -=== 2.5.2 Unix TimeStamp ===
690 +* (% style="color:blue" %)**SYNCMOD=1(Default)**(%%) to enable sync time via LoRaWAN MAC command, click here ([[AT+SYNCMOD>>https://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.6Settimesynchronizationmethod28ThenetworkservermustsupportLoRaWANv1.0.329]]) for detailed instructions.
691 +* (% style="color:blue" %)**PNACKMD=1**(%%)** **to enable datalog feature, click here ([[AT+PNACKMD>>https://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.26RequesttheservertosendanACK]]) for detailed instructions.
472 472  
473 473  
474 -DS03A-LB uses Unix TimeStamp format based on
475 475  
476 -[[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"]]
695 +Once DS03A-LB/LS 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/LS. If DS03A-LB/LS fails to get the time from the server, DS03A-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
477 477  
478 -User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
697 +(% 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 v3 and loriot support but TTN V3 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 V3 v2 if SYNCMOD=1.**
479 479  
480 -Below is the converter example
481 481  
482 -[[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"]]
700 +=== 2.5.3 Unix TimeStamp ===
483 483  
484 -So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
485 485  
703 +DS03A-LB/LS uses Unix TimeStamp format based on
486 486  
487 -=== 2.5.3 Set Device Time ===
705 +[[image:image-20250331163638-7.jpeg]]
488 488  
707 +User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
489 489  
490 -User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
709 +Below is the converter example
491 491  
492 -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).
711 +[[image:image-20250331163648-8.jpeg]]
493 493  
494 -(% 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.**
713 +So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
495 495  
496 496  
497 497  == 2.6 ​Show Data in DataCake IoT Server ==
... ... @@ -502,42 +502,41 @@
502 502  
503 503  (% 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]]
504 504  
505 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
724 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB/LS in Datacake.**
506 506  
507 -[[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"]]
726 +[[image:image-20250331163745-9.jpeg]]
508 508  
509 509  
510 -[[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"]]
511 511  
730 +[[image:image-20250331163816-10.jpeg]]
512 512  
513 -[[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"]]
514 514  
733 +[[image:image-20250331163900-11.jpeg]]
515 515  
516 -[[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"]]
735 +[[image:image-20250331163939-12.jpeg]]
517 517  
737 +[[image:image-20250331163958-13.jpeg]]
518 518  
519 -[[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"]]
520 520  
740 +[[image:image-20250331164026-14.jpeg]]
521 521  
522 -[[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"]]
523 523  
743 +[[image:image-20250331164049-15.jpeg]]
524 524  
525 -[[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"]]
526 526  
746 +[[image:image-20250331164119-16.jpeg]]
527 527  
528 -[[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"]]
529 529  
749 +[[image:image-20250331164144-17.jpeg]]
530 530  
531 -[[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"]]
532 532  
752 +[[image:image-20250331164208-18.jpeg]]
533 533  
534 -[[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"]]
535 535  
536 -
537 537  == 2.7 Frequency Plans ==
538 538  
539 539  
540 -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.
758 +The DS03A-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
541 541  
542 542  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
543 543  
... ... @@ -548,18 +548,17 @@
548 548  **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
549 549  
550 550  
551 -= 3. Configure DS03A-LB =
769 += 3. Configure DS03A-LB/LS =
552 552  
553 553  == 3.1 Configure Methods: ==
554 554  
555 555  
556 -DS03A-LB supports below configure method:
774 +DS03A-LB/LS supports below configure method:
557 557  
558 558  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
559 559  * 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]].
560 560  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
561 561  
562 -
563 563  == 3.2 General Commands ==
564 564  
565 565  
... ... @@ -573,13 +573,13 @@
573 573  [[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/]]
574 574  
575 575  
576 -== 3.3 Commands special design for DS03A-LB ==
793 +== 3.3 Commands special design for DS03A-LB/LS ==
577 577  
578 578  
579 -These commands only valid for DS03A-LB, as below:
796 +These commands only valid for DS03A-LB/LS, as below:
580 580  
581 581  
582 -=== 3.3.1 Set Transmit Interval Time ===
799 +=== 3.3.1  Set Transmit Interval Time ===
583 583  
584 584  
585 585  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -587,7 +587,7 @@
587 587  (% style="color:blue" %)**AT Command: AT+TDC**
588 588  
589 589  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
590 -|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3; color:#0070c0" %)**Function**|=(% style="background-color:#D9E2F3; color:#0070c0" %)**Response**
807 +|=(% 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**
591 591  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
592 592  30000
593 593  OK
... ... @@ -607,17 +607,36 @@
607 607  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
608 608  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
609 609  
827 +=== 3.3.2  Set Power Output Duration ===
610 610  
611 -=== 3.3.2 Get Device Status ===
612 612  
830 +Control the output duration 5V . Before each sampling, device will
613 613  
614 -Send a LoRaWAN downlink to ask device send Alarm settings.
832 +~1. first enable the power output to external sensor,
615 615  
616 -* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
834 +2. keep it on as per duration, read sensor value and construct uplink payload
617 617  
618 -Sensor will upload Device Status via FPORT=5. See payload section for detail.
836 +3. final, close the power output.
619 619  
838 +(% style="color:blue" %)**AT Command: AT+5VT**
620 620  
840 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
841 +|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 204px; background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color: #4F81BD;color:white; width: 149px;" %)**Response**
842 +|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
843 +OK
844 +|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
845 +OK
846 +
847 +)))
848 +
849 +(% style="color:blue" %)**Downlink Command: 0x07**(%%)
850 +Format: Command Code (0x07) followed by 2 bytes.
851 +
852 +The first and second bytes are the time to turn on.
853 +
854 +* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
855 +* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
856 +
621 621  === 3.3.3  Enable / Disable Alarm ===
622 622  
623 623  
... ... @@ -625,8 +625,8 @@
625 625  
626 626  (% style="color:blue" %)**AT Command: **
627 627  
628 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
629 -|(% 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**
864 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
865 +|(% style="background-color:#4f81bd; color:white; width:153px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:276px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:86px" %)**Response**
630 630  |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
631 631  |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
632 632  
... ... @@ -640,9 +640,8 @@
640 640  === 3.3.4  Alarm Base on Timeout ===
641 641  
642 642  
643 -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:
879 +DS03A-LB/LS 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:
644 644  
645 -
646 646  * (((
647 647  (% style="color:blue" %)**Keep Status: Status to be monitor**
648 648  )))
... ... @@ -663,42 +663,106 @@
663 663  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.
664 664  
665 665  
901 +* (((
902 +(% style="color:blue" %)**Downlink Command**
903 +)))
904 +
905 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
906 +
907 +**A9:** Command Type Code
908 +
909 +**aa: **01:TTRIG1; 02:TTRIG2
910 +
911 +**bb:** status to be monitored
912 +
913 +**cc dd:** timeout.
914 +
915 +
916 +**1) AT+TTRIG1 : (PA8 of pin)**
917 +
666 666  (% style="color:blue" %)**AT Command to configure:**
667 667  
668 668  * (((
669 -(% 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.
921 +(% style="color:#037691" %)**AT+TTRIG1=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm1 bit(the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
922 +
923 +(% style="color:#037691" %)**AT+TTRIG1=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in close status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm1 bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1.
670 670  )))
671 671  
672 672  * (((
673 -(% style="color:#037691" %)**AT+TTRIG=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
927 +(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
928 +
929 +
930 +
674 674  )))
675 675  
676 676  (% style="color:blue" %)**Downlink Command to configure:**
677 677  
678 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc**
935 +If user send 0xA9 01 00 00 1E: equal to AT+TTRIG1=1,30 **or** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
679 679  
680 -**A9:** Command Type Code
681 681  
682 -**aa:** status to be monitored
938 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
683 683  
684 -**bb cc:** timeout.
940 +(% style="color:blue" %)**AT Command to configure:**
685 685  
942 +* (((
943 +(% style="color:#037691" %)**AT+TTRIG2=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
686 686  
687 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30
945 +(% style="color:#037691" %)**AT+TTRIG2=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in close status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1.
946 +)))
688 688  
689 -Or
948 +* (((
949 +(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
690 690  
691 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm.
692 692  
952 +
953 +)))
693 693  
694 -=== 3.3.5  Count Mod ===
955 +(% style="color:blue" %)**Downlink Command to configure:**
695 695  
957 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30  **or**  0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
696 696  
959 +
960 +=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
961 +
962 +
963 +It needs to be used with AT+TTRIG1 or AT+TTRIG2.
964 +
965 +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. (Max. 255 minutes）
966 +
697 697  (% style="color:blue" %)**AT Command:**
698 698  
699 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
700 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 277px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 88px;background-color:#D9E2F3;color:#0070C0" %)**Response**
969 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
970 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 279px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 76px;background-color:#4F81BD;color:white" %)**Response**
701 701  |(% style="width:155px" %)(((
972 +AT+TTRALARM=0
973 +)))|(% style="width:279px" %)(((
974 +disable continuous alarm
975 +)))|(% style="width:84px" %)(((
976 +OK
977 +)))
978 +|(% style="width:155px" %)(((
979 +AT+TTRALARM=60
980 +)))|(% style="width:279px" %)(((
981 +The alarm interval is 60 minutes (unit: minutes)
982 +)))|(% style="width:84px" %)(((
983 +OK
984 +)))
985 +
986 +(% style="color:blue" %)**Downlink Command:**
987 +
988 +Example:  0C aa  => AT+TTRALARM= aa
989 +
990 +
991 +=== 3.3.6  Count Mod ===
992 +
993 +
994 +Feature: Manually set the count mode.
995 +
996 +(% style="color:blue" %)**AT Command:**
997 +
998 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
999 +|=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 275px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 86px;background-color:#4F81BD;color:white" %)**Response**
1000 +|(% style="width:155px" %)(((
702 702  AT+COUNTMOD=0
703 703  )))|(% style="width:277px" %)(((
704 704  the count value keeps accumulating mode
... ... @@ -708,7 +708,7 @@
708 708  |(% style="width:155px" %)(((
709 709  AT+COUNTMOD=1
710 710  )))|(% style="width:277px" %)(((
711 -the count value will be reset after each TDC time（Last Close Duration Reset after each uplink）
1010 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
712 712  )))|(% style="width:86px" %)(((
713 713  OK
714 714  )))
... ... @@ -718,24 +718,26 @@
718 718  Example:  0B aa  => AT+COUNTMOD = second byte
719 719  
720 720  
721 -=== 3.3.6  Interrupt Pin Channel Mod ===
1020 +=== 3.3.7  Number of channel of door sensors ===
722 722  
723 723  
1023 +Feature: Set the number of door sensor channels.
1024 +
724 724  (% style="color:blue" %)**AT Command:**
725 725  
726 726  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
727 -|=(% 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**
1028 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
728 728  |(% style="width:155px" %)(((
729 729  AT+TTRCHANNEL=1
730 -)))|(% style="width:288px" %)(((
731 -set as single channel, only use PB14 pin as interrupt pin.
1031 +)))|(% style="width:259px" %)(((
1032 +Set as single channel, only use PA8 pin as interrupt pin.
732 732  )))|(% style="width:44px" %)(((
733 733  OK
734 734  )))
735 735  |(% style="width:155px" %)(((
736 736  AT+TTRCHANNEL=2
737 -)))|(% style="width:288px" %)(((
738 -is set as dual channel, use PB14 pin and PB15 pin as interrupt pin.
1038 +)))|(% style="width:259px" %)(((
1039 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
739 739  )))|(% style="width:44px" %)(((
740 740  OK
741 741  )))
... ... @@ -745,82 +745,96 @@
745 745  Example:  0D aa => AT+TTRCHANNEL = second byte
746 746  
747 747  
748 -=== 3.3.7  Change the name of AT+TTRIG to AT+TTRIG1 ===
1049 +=== 3.3.8  Set Time Sync Mode ===
749 749  
750 750  
751 -(% style="color:blue" %)**Downlink Command:**
1052 +Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
752 752  
753 -Example:  A9 01 aa bb cc  => AT+TTRIG1= third byte, 4th byte and 5th byte
1054 +SYNCMOD is set to 1 by default. If user wants to set a different time from the LoRaWAN server, the user needs to set this to 0.
754 754  
1056 +(% style="color:blue" %)**AT Command:**
755 755  
756 -=== 3.3.8  Added AT+TTRIG2 for PB15 pin ===
1058 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1059 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
1060 +|(% style="width:155px" %)(((
1061 +AT+SYNCMOD=1
1062 +)))|(% style="width:259px" %)(((
1063 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1064 +)))|(% style="width:44px" %)(((
1065 +OK
1066 +)))
1067 +|(% style="width:155px" %)(((
1068 +AT+SYNCMOD=1,8
1069 +)))|(% style="width:259px" %)(((
1070 +Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1071 +)))|(% style="width:44px" %)(((
1072 +OK
1073 +)))
1074 +|(% style="width:155px" %)AT+SYNCMOD=1,-12|(% style="width:259px" %)Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to West Twelve Time Zone.|(% style="width:44px" %)OK
757 757  
758 -
759 759  (% style="color:blue" %)**Downlink Command:**
760 760  
761 -Example: A9 02 aa bb cc  => AT+TTRIG2= third byte, 4th byte and 5th byte
1078 +0x28 01  ~/~/ Same As AT+SYNCMOD=1
762 762  
1080 +0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
763 763  
764 -=== 3.3.9  TTRIG1/2 timeout status alarm ===
1082 +0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
765 765  
1084 +0x28 00  ~/~/ Same As AT+SYNCMOD=0
766 766  
767 -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.
768 768  
1087 +=== 3.3.9  Clear the open door times and the duration of the last open door ===
1088 +
1089 +
769 769  (% style="color:blue" %)**AT Command:**
770 770  
771 771  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
772 -|=(% 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**
773 -|(% style="width:155px" %)(((
774 -AT+TTRALARM=0
775 -)))|(% style="width:279px" %)(((
776 -disable continuous alarm
777 -)))|(% style="width:84px" %)(((
1093 +|=(% style="width: 163px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 290px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
1094 +|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
778 778  OK
779 779  )))
780 -|(% style="width:155px" %)(((
781 -AT+TTRALARM=60
782 -)))|(% style="width:279px" %)(((
783 -The alarm interval is 60 minutes (unit: minutes)
784 -)))|(% style="width:84px" %)(((
785 -OK
786 -)))
787 787  
788 -(% style="color:blue" %)**Downlink Command:**
1098 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
789 789  
790 -Example:  0C aa  => AT+TTRALARM= aa
1100 +The sensor will clear the open door times and the duration of the last open door.
791 791  
792 792  
793 -=== 3.3.10  Select counting mode ===
1103 +=== 3.3.10  Set the count value of the number of open door ===
794 794  
795 795  
796 -(% style="color:blue" %)**AT+TTRMODx=a,b**
797 -
798 -When (% style="color:#037691" %)**a=0**(%%), the door is opened to count, and when (% style="color:#037691" %)**a=1**(%%),the closed door is counted.
799 -
800 -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.
801 -
802 802  (% style="color:blue" %)**AT Command:**
803 803  
804 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
805 -|=(% 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**
1108 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1109 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
806 806  |(% style="width:155px" %)(((
807 -AT+TTRMODx=1,0
808 -)))|(% style="width:278px" %)Door closed count and record the last door opened duration|(% style="width:85px" %)(((
1111 +AT+SETCNT=1,100
1112 +)))|(% style="width:259px" %)(((
1113 +Set the open door times of PA8 pin to 100 times.
1114 +)))|(% style="width:44px" %)(((
809 809  OK
810 810  )))
1117 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
811 811  |(% style="width:155px" %)(((
812 -AT+TTRMODx=0,1
813 -)))|(% style="width:278px" %)(((
814 -Door opened count and record the last door Door Door open closed duration
815 -)))|(% style="width:85px" %)(((
1119 +AT+SETCNT=2,50
1120 +)))|(% style="width:259px" %)(((
1121 +Set the open door times of PA4 pin to 100 times.
1122 +)))|(% style="width:44px" %)(((
816 816  OK
817 817  )))
818 818  
1126 +(% style="color:blue" %)**Downlink Command:**
819 819  
1128 +0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1129 +
1130 +0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1131 +
1132 +0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1133 +
1134 +
820 820  = 4. Battery & Power Consumption =
821 821  
822 822  
823 -DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1138 +DS03A-LB use ER26500 + SPC1520 battery pack and DS03A-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
824 824  
825 825  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
826 826  
... ... @@ -828,21 +828,19 @@
828 828  = 5. OTA firmware update =
829 829  
830 830  
831 -User can change firmware DS03A-LB to:
1146 +User can change firmware DS03A-LB/LS to:
832 832  
833 833  * Change Frequency band/ region.
834 834  * Update with new features.
835 835  * Fix bugs.
836 836  
837 -Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1152 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/scl/fo/ztlw35a9xbkomu71u31im/AHx26Z9LCICx1Glt64ufq6o/LoRaWAN%20End%20Node/DS03A-LB?rlkey=ojjcsw927eaow01dgooldq3nu&subfolder_nav_tracking=1&dl=0]]**
838 838  
839 -
840 840  Methods to Update Firmware:
841 841  
842 -* (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/]]
843 -* 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]]**.
1156 +* (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/]]**
1157 +* 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]]**.
844 844  
845 -
846 846  = 6. FAQ =
847 847  
848 848  
... ... @@ -850,7 +850,7 @@
850 850  = 7. Order Info =
851 851  
852 852  
853 -Part Number: (% style="color:blue" %)**DS03A-LB-XX**
1166 +**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**
854 854  
855 855  (% style="color:red" %)**XX**(%%): The default frequency band
856 856  
... ... @@ -870,13 +870,12 @@
870 870  
871 871  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
872 872  
873 -
874 874  = 8. ​Packing Info =
875 875  
876 876  
877 877  (% style="color:#037691" %)**Package Includes**:
878 878  
879 -* DS03A-LB LoRaWAN Temperature Sensor
1191 +* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor
880 880  
881 881  (% style="color:#037691" %)**Dimension and weight**:
882 882  
... ... @@ -888,7 +888,6 @@
888 888  
889 889  * Weight / pcs : g
890 890  
891 -
892 892  = 9. Support =
893 893  
894 894  
1749536870332-565.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +1.9 KB
Content
1749536872361-767.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +1.9 KB
Content
1749536881052-376.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +1.4 KB
Content
image-20230630155406-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +41.8 KB
Content
image-20230630155451-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +77.2 KB
Content
image-20230630155527-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +39.2 KB
Content
image-20230630155556-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +38.4 KB
Content
image-20230630155751-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230630155908-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +90.8 KB
Content
image-20230630160843-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +511.7 KB
Content
image-20230630172740-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Saxer
Size
... ... @@ -1,0 +1,1 @@
1 +34.5 KB
Content
image-20240108160443-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +500.2 KB
Content
image-20240108161155-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +265.7 KB
Content
image-20240115094003-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +12.7 KB
Content
image-20250331163305-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +43.0 KB
Content
image-20250331163324-2.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +31.1 KB
Content
image-20250331163451-3.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +59.0 KB
Content
image-20250331163509-4.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +52.9 KB
Content
image-20250331163528-5.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +82.0 KB
Content
image-20250331163545-6.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +64.0 KB
Content
image-20250331163638-7.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +18.9 KB
Content
image-20250331163648-8.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +67.2 KB
Content
image-20250331163745-9.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +90.5 KB
Content
image-20250331163816-10.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +58.9 KB
Content
image-20250331163900-11.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +59.0 KB
Content
image-20250331163939-12.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +33.5 KB
Content
image-20250331163958-13.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +67.1 KB
Content
image-20250331164026-14.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +46.5 KB
Content
image-20250331164049-15.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +37.9 KB
Content
image-20250331164119-16.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +31.5 KB
Content
image-20250331164144-17.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +33.4 KB
Content
image-20250331164208-18.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +79.7 KB
Content
image-20250417152253-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +47.6 KB
Content
image-20250417152741-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +165.2 KB
Content