Last modified by Mengting Qiu on 2025/07/03 16:36

From version 40.2
edited by Xiaoling
on 2024/01/08 16:12
Change comment: There is no comment for this version
To version 1.1
edited by Edwin Chen
on 2023/04/22 23:28
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 Outdoor LoRaWAN Door Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
Content
... ... @@ -1,18 +1,8 @@
1 -(% style="display:none" %) (%%)
1 +
2 2  
3 -(% style="text-align:center" %)
4 -[[image:image-20240108161155-2.png]]
5 5  
4 +**Table of Contents:**
6 6  
7 -
8 -
9 -
10 -
11 -
12 -
13 -
14 -**Table of Contents:**
15 -
16 16  {{toc/}}
17 17  
18 18  
... ... @@ -22,64 +22,57 @@
22 22  
23 23  = 1. Introduction =
24 24  
25 -== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==
15 +== 1.1 What is D2x-LB LoRaWAN Temperature Sensor ==
26 26  
27 27  
28 28  (((
29 -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.
19 +The Dragino D2x-LB is a (% style="color:blue" %)**LoRaWAN Temperature Sensor**(%%) for Internet of Things solution. D2x-LB has 1 ~~ 3 temperature probes. D2x-LB will convert the Temperature reading to LoRaWAN wireless data and send to IoT platform via LoRaWAN gateway.
30 30  )))
31 31  
32 32  (((
33 -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.
23 +The LoRa wireless technology used in D2x-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.
34 34  )))
35 35  
36 36  (((
37 -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.
27 +The temperature sensor used in D2x-LB can (% style="color:blue" %)**measure -55°C ~~ 125°C with accuracy ±0.5°C (max ±2.0 °C)**(%%).
38 38  )))
39 39  
40 40  (((
41 -DS03A-LB supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.
31 +D2x-LB supports (% style="color:blue" %)**temperature alarm feature,**(%%) user can set temperature alarm for instant notice. D2x-LB supports Datalog feature, it can save the data when there is no LoRaWAN network and uplink when network recover.
42 42  )))
43 43  
44 44  (((
45 -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.
46 -
47 -DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
35 +D2x-LB has max 3 probes which measure maximum 3 temperature points.
48 48  )))
49 49  
50 50  (((
51 -DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
39 +D2x-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
52 52  )))
53 53  
54 54  (((
55 -DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
43 +D2x-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
56 56  )))
57 57  
58 58  (((
59 -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.
47 +Each D2x-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.
60 60  )))
61 61  
62 62  
63 -[[image:image-20230522092934-2.png||height="346" width="774"]]
64 -
65 -
66 66  == 1.2 ​Features ==
67 67  
68 -
69 69  * LoRaWAN 1.0.3 Class A
70 70  * Ultra-low power consumption
55 +* 1 ~~ 3 External Temperature Probes
56 +* Measure range -55°C ~~ 125°C
57 +* Temperature alarm
71 71  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
72 -* Door Open/Close detect
73 -* Door open/close statistics
74 -* Datalog Feature, Open Alarm Feature
75 75  * Support Bluetooth v5.1 and LoRaWAN remote configure
76 76  * Support wireless OTA update firmware
77 77  * Uplink on periodically
78 78  * Downlink to change configure
79 79  * 8500mAh Battery for long term use
80 -* Wall Mountable
81 -* Outdoor Use
82 82  
65 +
83 83  == 1.3 Specification ==
84 84  
85 85  
... ... @@ -88,6 +88,12 @@
88 88  * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
89 89  * Operating Temperature: -40 ~~ 85°C
90 90  
74 +(% style="color:#037691" %)**Temperature Sensor:**
75 +
76 +* Dallas DS18B20
77 +* Range: -55 to + 125°C
78 +* Accuracy ±0.5°C (max ±2.0 °C).
79 +
91 91  (% style="color:#037691" %)**LoRa Spec:**
92 92  
93 93  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -108,24 +108,19 @@
108 108  * Sleep Mode: 5uA @ 3.3v
109 109  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
110 110  
111 -== 1.4 Applications ==
112 112  
101 +== 1.4 Sleep mode and working mode ==
113 113  
114 -[[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741400370-813.png]]
115 115  
116 -
117 -== 1.5 Sleep mode and working mode ==
118 -
119 -
120 120  (% 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.
121 121  
122 122  (% 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.
123 123  
124 124  
125 -== 1.6 Button & LEDs ==
109 +== 1.5 Button & LEDs ==
126 126  
127 127  
128 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]]
112 +[[image:1675071855856-879.png]]
129 129  
130 130  
131 131  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
... ... @@ -139,14 +139,15 @@
139 139  (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
140 140  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.
141 141  )))
142 -|(% 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.
126 +|(% 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 D2x-LB is in Deep Sleep Mode.
143 143  
144 -== 1.7 BLE connection ==
145 145  
129 +== 1.6 BLE connection ==
146 146  
147 -DS03A-LB support BLE remote configure.
148 148  
132 +D2x-LB support BLE remote configure.
149 149  
134 +
150 150  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:
151 151  
152 152  * Press button to send an uplink
... ... @@ -156,89 +156,112 @@
156 156  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
157 157  
158 158  
159 -== 1.8 Pin Definitions ==
144 +== 1. Hardware Variant ==
160 160  
161 -[[image:image-20230630160843-7.png]]
162 162  
147 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
148 +|=(% style="width: 102px;background-color:#D9E2F3;color:#0070C0" %)Model|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)Photo|=(% style="width: 218px;background-color:#D9E2F3;color:#0070C0" %)Probe Info
149 +|(% style="width:102px" %)D20-LB|(% style="width:190px" %) |(% style="width:297px" %)(((
150 +1 x DS28B20 Probe
163 163  
164 -== 1.9 Mechanical ==
152 +Cable Length : 2 meters
165 165  
154 +
155 +)))
156 +|(% style="width:102px" %)D22-LB|(% style="width:190px" %) |(% style="width:297px" %)(((
157 +2 x DS28B20 Probes
166 166  
167 -[[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
159 +Cable lengths total 1.5meters per probe
168 168  
161 +Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K21G-210811.pdf]]
162 +)))
163 +|(% style="width:102px" %)(((
164 +(((
165 +D23-LB
166 +)))
169 169  
170 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]]
168 +(((
169 +
170 +)))
171 +)))|(% style="width:190px" %) |(% style="width:297px" %)(((
172 +3 x DS28B20 Probes
171 171  
174 +Cable lengths total 1.5meters per probe
172 172  
173 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]]
176 +Cable Drawing: [[See This Link>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSN50v2-D20/Cable_Drawing/&file=CAB0-35IC-K31G-210811.pdf]]
177 +)))
174 174  
179 +(% style="display:none" %)
175 175  
176 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
177 177  
178 178  
179 -== 1.10 Magnet Distance ==
183 +== 1.8 Mechanical ==
180 180  
181 181  
182 -* Wood Door: 10mm ~~ 30mm
183 -* Iron Door: 30 ~~ 45mm
186 +[[image:1675143884058-338.png]]
184 184  
185 -= 2. Configure DS03A-LB to connect to LoRaWAN network =
186 186  
189 +[[image:1675143899218-599.png]]
190 +
191 +
192 +[[image:1675143909447-639.png]]
193 +
194 +
195 += 2. Configure D2x-LB to connect to LoRaWAN network =
196 +
187 187  == 2.1 How it works ==
188 188  
189 189  
190 -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 2 hours.
200 +The D2x-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 D2x-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
191 191  
192 192  
193 193  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
194 194  
195 195  
196 -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" %)
206 +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.
197 197  
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.
199 199  
200 -[[image:image-20230522092858-1.png||height="391" width="874"]]
209 +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.
201 201  
202 202  
203 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB.
212 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from D2x-LB.
204 204  
205 -Each DS03A-LB is shipped with a sticker with the default device EUI as below:
214 +Each D2x-LB is shipped with a sticker with the default device EUI as below:
206 206  
207 -[[image:image-20230426085205-1.png||height="238" width="512"]]
216 +[[image:image-20230131134744-2.jpeg]]
208 208  
209 209  
219 +
210 210  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
211 211  
212 -(% style="display:none" %) (%%)
213 213  
214 214  (% style="color:blue" %)**Register the device**
215 215  
225 +[[image:1675144099263-405.png]]
216 216  
217 -[[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" %)
218 218  
219 -
220 220  (% style="color:blue" %)**Add APP EUI and DEV EUI**
221 221  
222 -[[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"]]
230 +[[image:1675144117571-832.png]]
223 223  
224 224  
225 225  (% style="color:blue" %)**Add APP EUI in the application**
226 226  
227 -[[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 228  
236 +[[image:1675144143021-195.png]]
229 229  
238 +
230 230  (% style="color:blue" %)**Add APP KEY**
231 231  
232 -[[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"]]
241 +[[image:1675144157838-392.png]]
233 233  
243 +(% style="color:blue" %)**Step 2:**(%%) Activate on D2x-LB
234 234  
235 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
236 236  
246 +Press the button for 5 seconds to activate the D2x-LB.
237 237  
238 -Press the button for 5 seconds to activate the DS03A-LB.
248 +(% 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.
239 239  
240 -(% 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.
241 -
242 242  After join success, it will start to upload messages to TTN and you can see the messages in the panel.
243 243  
244 244  
... ... @@ -247,13 +247,11 @@
247 247  === 2.3.1 Device Status, FPORT~=5 ===
248 248  
249 249  
250 -Include device configure status. Once DS03A-LB Joined the network, it will uplink this message to the server. After that, DS03A-LB will uplink Device Status every 12 hours.
258 +Users can use the downlink command(**0x26 01**) to ask D2x-LB to send device configure detail, include device configure status. D2x-LB will uplink a payload via FPort=5 to server.
251 251  
252 -Users can also use the downlink command**(0x26 01)** to ask DS03A-LB to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
253 -
254 -
255 255  The Payload format is as below.
256 256  
262 +
257 257  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
258 258  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
259 259  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -261,42 +261,42 @@
261 261  
262 262  Example parse in TTNv3
263 263  
264 -[[image:image-20230630155406-1.png||height="190" width="873"]]
270 +[[image:image-20230415153147-2.png||height="220" width="1120"]]
265 265  
266 266  
267 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B
273 +(% style="color:#037691" %)**Sensor Model**(%%): For D2x-LB, this value is 0x19
268 268  
269 269  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
270 270  
271 271  (% style="color:#037691" %)**Frequency Band**:
272 272  
273 -0x01: EU868
279 +*0x01: EU868
274 274  
275 -0x02: US915
281 +*0x02: US915
276 276  
277 -0x03: IN865
283 +*0x03: IN865
278 278  
279 -0x04: AU915
285 +*0x04: AU915
280 280  
281 -0x05: KZ865
287 +*0x05: KZ865
282 282  
283 -0x06: RU864
289 +*0x06: RU864
284 284  
285 -0x07: AS923
291 +*0x07: AS923
286 286  
287 -0x08: AS923-1
293 +*0x08: AS923-1
288 288  
289 -0x09: AS923-2
295 +*0x09: AS923-2
290 290  
291 -0x0a: AS923-3
297 +*0x0a: AS923-3
292 292  
293 -0x0b: CN470
299 +*0x0b: CN470
294 294  
295 -0x0c: EU433
301 +*0x0c: EU433
296 296  
297 -0x0d: KR920
303 +*0x0d: KR920
298 298  
299 -0x0e: MA869
305 +*0x0e: MA869
300 300  
301 301  
302 302  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -317,430 +317,282 @@
317 317  Ex2: 0x0B49 = 2889mV
318 318  
319 319  
320 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
326 +=== 2.3.2  Sensor Data. FPORT~=2 ===
321 321  
322 322  
323 -DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
329 +D2x-LB will uplink below payload via FPORT=2 after Joined LoRaWAN Network.
324 324  
325 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
326 -|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
327 -|**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**
328 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
329 -Keep status1
331 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
332 +|=(% style="width: 62.5px;background-color:#D9E2F3" %)(((
333 +**Size(bytes)**
334 +)))|=(% style="width: 60px;background-color:#D9E2F3" %)2|=(% style="width: 120px;background-color:#D9E2F3" %)2|=(% style="width: 60px;background-color:#D9E2F3" %)2|=(% style="width: 65px;background-color:#D9E2F3" %)1|=(% style="width: 65px;background-color:#D9E2F3" %)**2**|=(% style="width: 65px;background-color:#D9E2F3" %)2
335 +|(% style="width:65px" %)**Value**|(((
336 +[[Battery>>||anchor="HBattery:"]]
337 +)))|(% style="width:91px" %)(((
338 +[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]
339 +)))|(% style="width:61px" %)(((
340 +ignore
341 +)))|(% style="width:91px" %)(((
342 +[[Alarm Flag>>||anchor="HAlarmFlag26MOD:"]]
330 330  )))|(% style="width:99px" %)(((
331 -Keep time1(unit: sec)
332 -)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
333 -Keep time2(unit: sec)
334 -)))|(% style="width:98px" %)(((
335 -Alarm interval(unit: min)
344 +[[Temp_White>>||anchor="HTemperatureWhite:"]]
345 +)))|(% style="width:97px" %)(((
346 +[[Temp_Black>>||anchor="HTemperatureBlack:"]]
347 +
348 +
336 336  )))
337 337  
338 -Example parse in TTNv3
351 +**Payload per each model.**
339 339  
340 -[[image:image-20230630155527-3.png||height="146" width="902"]]
353 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220916152530-2.png?rev=1.1||alt="image-20220916152530-2.png" height="240" width="901"]]
341 341  
342 342  
343 -* (((
344 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
345 -)))
356 +[[image:image-20230415154139-3.png||height="215" width="1179"]]
346 346  
347 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
348 348  
359 +==== (% style="color:#4472c4" %)**Decode corresponding probe color:**(%%) ====
349 349  
350 -* (((
351 -(% style="color:blue" %)**Disalarm: (default: 0)**
352 -)))
361 +**D20:**
353 353  
354 - **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.
363 +Red <~-~-> C1
355 355  
356 - **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.
365 +**D22:**
357 357  
367 +White <~-~-> C1 Red <~-~-> C2
358 358  
359 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
369 +**D23:**
360 360  
371 +White <~-~->C1 Red <~-~-> C2 Black <~-~-> C3
361 361  
362 -* (((
363 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
364 -)))
365 365  
366 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
367 367  
375 +==== (% style="color:#4472c4" %)**Battery:**(%%) ====
368 368  
377 +Sensor Battery Level.
369 369  
370 -* (((
371 -(% style="color:blue" %)**Alarm interval(default: 0)**
372 -)))
379 +Ex1: 0x0B45 = 2885mV
373 373  
374 -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.
381 +Ex2: 0x0B49 = 2889mV
375 375  
376 376  
377 -=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
378 378  
385 +==== (% style="color:#4472c4" %)**Temperature RED or Temperature White :**(%%) ====
379 379  
380 -DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
387 +**This point to the Red probe in D20-LB or the probe of D22-LB/D23-LB White**
381 381  
382 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
383 -* There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
389 +**Example**:
384 384  
385 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
391 +If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
386 386  
387 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
388 -|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
389 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
390 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
391 -Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
392 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
393 -The last door open duration (unit: sec)
394 -)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
393 +If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
395 395  
396 -**Status & Alarm:**
395 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
397 397  
398 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
399 -|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**bit0**
400 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
401 -Count mod
402 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
403 -Alarm 0: No Alarm; 1: Alarm
404 -)))|(% style="width:131px" %)(((
405 -Status 0: Close; 1: Open
406 -)))
407 407  
408 -[[image:image-20230630155451-2.png||height="246" width="928"]]
409 409  
399 +==== (% style="color:#4472c4" %)**Temperature White:**(%%) ====
410 410  
411 -* (((
412 -(% style="color:blue" %)**Count mod:Default=0**
413 -)))
414 414  
415 -0: Uplink total open door times since factory
402 +**This point to the Red probe in D22-LB/D23-LB**
416 416  
417 -1: Uplink total open door times since last FPORT=2 uplink.
418 418  
405 +**Example**:
419 419  
420 -* (% style="color:blue" %)**TDC flag**
407 +If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
421 421  
422 -When the flag is 1, it means sending packets at normal time intervals.
409 +If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
423 423  
424 -Otherwise, it is a packet sent at non-TDC time.
411 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
425 425  
426 426  
427 -* (((
428 -(% style="color:#0000ff" %)**Alarm**
429 -)))
430 430  
431 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
415 +==== (% style="color:#4472c4" %)**Temperature Black:**(%%) ====
432 432  
433 433  
434 -* (((
435 -(% style="color:blue" %)**Status**
436 -)))
418 +**This point to the BLACK probe in D23-LB**
437 437  
438 -This bit is 1 when the door sensor is open and 0 when it is close.
439 439  
421 +**Example**:
440 440  
441 -* (((
442 -(% style="color:blue" %)**Total open door events**
443 -)))
423 +If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
444 444  
445 -Total pulse/counting base on open door.
425 +If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
446 446  
447 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
427 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
448 448  
449 449  
450 -* (((
451 -(% style="color:blue" %)**The last door open duration**
452 -)))
453 453  
454 -Door sensor last open duration.
431 +==== (% style="color:#4472c4" %)**Alarm Flag& MOD:**(%%) ====
455 455  
456 -Unit: sec.
457 457  
458 -[[image:image-20230701094042-1.png||height="154" width="763"]]
434 +**Example:**
459 459  
436 +If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
460 460  
461 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
438 +If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm
462 462  
463 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
464 464  
465 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
441 +== 2.4 Payload Decoder file ==
466 466  
467 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
468 -|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
469 -|(% 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**
470 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
471 -Status1 & Alarm1
472 -)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
473 -The last door open duration1 (unit: sec)
474 -)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
475 -Status2 & Alarm2
476 -)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
477 477  
478 -**Status1 & Alarm1:**
479 -
480 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
481 -|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit0**
482 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
483 -Count mod
484 -)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
485 -Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
486 -)))|(% style="width:181px" %)(((
487 -Status1 0: Close; 1: Open (PA8 of pin)
444 +(((
445 +In TTN, use can add a custom payload so it shows friendly. 
488 488  )))
489 489  
490 -**Status2 & Alarm2:**
491 -
492 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
493 -|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit0**
494 -|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
495 -Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
496 -)))|(% style="width:181px" %)(((
497 -Status2 0: Close; 1: Open (PA4 of pin)
448 +(((
449 +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]]
498 498  )))
499 499  
500 -[[image:image-20230630155908-6.png||height="295" width="927"]]
501 501  
453 +== 2.5 Datalog Feature ==
502 502  
503 -* (((
504 -(% style="color:blue" %)**Count mod:Default=0**
505 -)))
506 506  
507 -0: Uplink total open door times since factory
456 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, D2x-LB will store the reading for future retrieving purposes.
508 508  
509 -1: Uplink total open door times since last FPORT=2 uplink.
510 510  
459 +=== 2.5.1 Ways to get datalog via LoRaWAN ===
511 511  
512 -* (% style="color:blue" %)**TDC flag**
513 513  
514 -When the flag is 1, it means sending packets at normal time intervals.
462 +Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayloadA028FPORT3D329"]], D2x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,D2x-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.
515 515  
516 -Otherwise, it is a packet sent at non-TDC time.
464 +* a) D2x-LB will do an ACK check for data records sending to make sure every data arrive server.
465 +* b) D2x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but D2x-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 D2x-LB gets a ACK, D2x-LB will consider there is a network connection and resend all NONE-ACK Message.
517 517  
467 +Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
518 518  
519 -* (((
520 -(% style="color:#0000ff" %)**Alarm1 or Alarm2**
521 -)))
469 +[[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"]]
522 522  
523 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
471 +=== 2.5.2 Unix TimeStamp ===
524 524  
525 525  
526 -* (((
527 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
528 -)))
474 +D2x-LB uses Unix TimeStamp format based on
529 529  
530 -This bit is 1 when the door sensor is open and 0 when it is close.
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"]]
531 531  
478 +User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
532 532  
533 -* (((
534 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
535 -)))
480 +Below is the converter example
536 536  
537 -Total pulse/counting base on open door.
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"]]
538 538  
539 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
484 +So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
540 540  
541 541  
542 -* (((
543 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
544 -)))
487 +=== 2.5.3 Set Device Time ===
545 545  
546 -Door sensor last open duration.
547 547  
548 -Unit: sec.
490 +User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
549 549  
550 -[[image:image-20230701094042-1.png||height="154" width="763"]]
492 +Once D2x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to D2x-LB. If D2x-LB fails to get the time from the server, D2x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
551 551  
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 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.**
552 552  
553 -=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
554 554  
497 +=== 2.5.4 Datalog Uplink payload  (FPORT~=3) ===
555 555  
556 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
557 557  
558 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
500 +The Datalog poll reply uplink will use below payload format.
559 559  
560 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
561 -|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
562 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
563 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
564 -Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
565 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
566 -The last door open duration (unit: sec)
567 -)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
502 +**Retrieval data payload:**
568 568  
569 -**Status & Alarm:**
504 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
505 +|=(% style="width: 90px;background-color:#D9E2F3" %)(((
506 +**Size(bytes)**
507 +)))|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 60px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 115px; background-color: rgb(217, 226, 243);" %)**2**|=(% style="width: 104px; background-color: rgb(217, 226, 243);" %)**1**|=(% style="width: 80px; background-color: rgb(217, 226, 243);" %)**4**
508 +|(% style="width:93px" %)**Value**|(% style="width:54px" %)(((
509 +[[Temp_Black>>||anchor="HTemperatureBlack:"]]
510 +)))|(% style="width:54px" %)[[Temp_White>>||anchor="HTemperatureWhite:"]]|(% style="width:87px" %)[[Temp_ Red or Temp _White>>||anchor="HTemperatureREDorTemperatureWhite:"]]|(% style="width:104px" %)Poll message flag & Ext|(% style="width:55px" %)[[Unix Time Stamp>>||anchor="H2.5.2UnixTimeStamp"]]
570 570  
571 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
572 -|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:65px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit0**
573 -|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
574 -Count mod
575 -)))|(% style="width:95px" %)(((
576 -TDC flag 0:No; 1:Yes
577 -)))|(% style="width:116px" %)(((
578 -Alarm 0: No Alarm; 1: Alarm
579 -)))|(% style="width:112px" %)(((
580 -Status 0:Close; 1: Open
581 -)))
512 +**Poll message flag & Ext:**
582 582  
583 -* (((
584 -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 will send max bytes according to the current DR and Frequency bands.
585 -)))
514 +[[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-20221006192726-1.png?width=754&height=112&rev=1.1||alt="image-20221006192726-1.png" height="112" width="754"]]
586 586  
587 -For example, in the US915 band, the max payload for different DR is:
516 +**No ACK Message**:  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
588 588  
589 -(((
590 -**~1. DR0**: max is 11 bytes so one entry of data
591 -)))
518 +**Poll Message Flag**: 1: This message is a poll message reply.
592 592  
593 -(((
594 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
595 -)))
520 +* Poll Message Flag is set to 1.
596 596  
597 -(((
598 -**3. DR2**: total payload includes 11 entries of data
599 -)))
522 +* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
600 600  
601 -(((
602 -**4. DR3**: total payload includes 22 entries of data.
603 -)))
524 +For example, in US915 band, the max payload for different DR is:
604 604  
605 -If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
526 +**a) DR0:** max is 11 bytes so one entry of data
606 606  
607 -[[image:image-20230630155556-4.png||height="146" width="938"]]
528 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
608 608  
609 -**Downlink:**
530 +**c) DR2:** total payload includes 11 entries of data
610 610  
611 -0x31 64 9E 7D 34 64 9E 7E 9C 05
532 +**d) DR3: **total payload includes 22 entries of data.
612 612  
534 +If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
613 613  
614 -**Uplink:**
615 615  
616 -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
537 +**Example:**
617 617  
539 +If D2x-LB has below data inside Flash:
618 618  
619 -**Parsed Value:**
541 +[[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-20220523144455-1.png?width=735&height=335&rev=1.1||alt="image-20220523144455-1.png" height="335" width="735"]]
620 620  
621 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
543 +If user sends below downlink command: 3160065F9760066DA705
622 622  
545 +Where : Start time: 60065F97 = time 21/1/19 04:27:03
623 623  
624 -[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
547 + Stop time: 60066DA7= time 21/1/19 05:27:03
625 625  
626 -[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
627 627  
628 -[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
550 +**D2x-LB will uplink this payload.**
629 629  
630 -[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
552 +[[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-13.png?width=727&height=421&rev=1.1||alt="image-20220523001219-13.png" height="421" width="727"]]
631 631  
632 -[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
554 +(((
555 +__**7FFF089801464160065F97**__ **__7FFF__ __088E__ __014B__ __41__ __60066009__** 7FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E
556 +)))
633 633  
634 -[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
558 +(((
559 +Where the first 11 bytes is for the first entry:
560 +)))
635 635  
636 -[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
562 +(((
563 +7FFF089801464160065F97
564 +)))
637 637  
638 -[[image:image-20230630172740-1.png||height="199" width="868"]]
566 +(((
567 +**Ext sensor data**=0x7FFF/100=327.67
568 +)))
639 639  
570 +(((
571 +**Temp**=0x088E/100=22.00
572 +)))
640 640  
641 -== 2.4 Payload Decoder file ==
574 +(((
575 +**Hum**=0x014B/10=32.6
576 +)))
642 642  
643 -
644 644  (((
645 -In TTN, use can add a custom payload so it shows friendly
579 +**poll message flag & Ext**=0x41,means reply data,Ext=1
646 646  )))
647 647  
648 648  (((
649 -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]]
583 +**Unix time** is 0x60066009=1611030423s=21/1/19 04:27:03
650 650  )))
651 651  
652 652  
653 -== 2.5 Datalog Feature ==
587 +(% aria-label="Data URI image image widget" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="Click and drag to resize" %)​(% aria-label="Data URI image image widget" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||data-widget="image" draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% aria-label="Data URI image image widget" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="Click and drag to resize" %)​
654 654  
589 +== 2.6 Temperature Alarm Feature ==
655 655  
656 -(% 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.
657 657  
658 -(% style="color:red" %)**Note:After the device is reset,in cumulative counting mode,the last stored count value will be read as the initial value.**
592 +D2x-LB work flow with Alarm feature.
659 659  
660 660  
661 -=== 2.5.1 Ways to get datalog via LoRaWAN ===
595 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/image-20220623090437-1.png?rev=1.1||alt="image-20220623090437-1.png"]]
662 662  
663 663  
664 -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.
665 -
666 -* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
667 -* 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.
668 -
669 -Below is the typical case for the Datalog Feature (Set PNACKMD=1)
670 -
671 -[[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"]]
672 -
673 -
674 -=== 2.5.2 Unix TimeStamp ===
675 -
676 -
677 -DS03A-LB uses Unix TimeStamp format based on
678 -
679 -[[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"]]
680 -
681 -User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
682 -
683 -Below is the converter example
684 -
685 -[[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"]]
686 -
687 -So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
688 -
689 -
690 -=== 2.5.3 Set Device Time ===
691 -
692 -
693 -User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
694 -
695 -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).
696 -
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 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.**
698 -
699 -
700 -== 2.6 ​Show Data in DataCake IoT Server ==
701 -
702 -
703 -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:
704 -
705 -
706 -(% 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]]
707 -
708 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
709 -
710 -[[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"]]
711 -
712 -
713 -[[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"]]
714 -
715 -
716 -[[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"]]
717 -
718 -
719 -[[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"]]
720 -
721 -
722 -[[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"]]
723 -
724 -
725 -[[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"]]
726 -
727 -
728 -[[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"]]
729 -
730 -
731 -[[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"]]
732 -
733 -
734 -[[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"]]
735 -
736 -
737 -[[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"]]
738 -
739 -
740 740  == 2.7 Frequency Plans ==
741 741  
742 742  
743 -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.
601 +The D2x-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.
744 744  
745 745  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
746 746  
... ... @@ -748,20 +748,23 @@
748 748  == 2.8 ​Firmware Change Log ==
749 749  
750 750  
751 -**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]]
609 +**Firmware download link:**
752 752  
611 +[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
753 753  
754 -= 3. Configure DS03A-LB =
755 755  
614 += 3. Configure D2x-LB =
615 +
756 756  == 3.1 Configure Methods: ==
757 757  
758 758  
759 -DS03A-LB supports below configure method:
619 +D2x-LB supports below configure method:
760 760  
761 761  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
762 762  * 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]].
763 763  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
764 764  
625 +
765 765  == 3.2 General Commands ==
766 766  
767 767  
... ... @@ -775,13 +775,13 @@
775 775  [[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/]]
776 776  
777 777  
778 -== 3.3 Commands special design for DS03A-LB ==
639 +== 3.3 Commands special design for D2x-LB ==
779 779  
780 780  
781 -These commands only valid for DS03A-LB, as below:
642 +These commands only valid for D2x-LB, as below:
782 782  
783 783  
784 -=== 3.3.1  Set Transmit Interval Time ===
645 +=== 3.3.1 Set Transmit Interval Time ===
785 785  
786 786  
787 787  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -789,7 +789,7 @@
789 789  (% style="color:blue" %)**AT Command: AT+TDC**
790 790  
791 791  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
792 -|=(% 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**
653 +|=(% style="width: 156px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3" %)**Function**|=(% style="background-color:#D9E2F3" %)**Response**
793 793  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
794 794  30000
795 795  OK
... ... @@ -809,316 +809,130 @@
809 809  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
810 810  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
811 811  
812 -=== 3.3.2  Set Power Output Duration ===
813 813  
674 +=== 3.3.2 Get Device Status ===
814 814  
815 -Control the output duration 5V . Before each sampling, device will
816 816  
817 -~1. first enable the power output to external sensor,
677 +Send a LoRaWAN downlink to ask device send Alarm settings.
818 818  
819 -2. keep it on as per duration, read sensor value and construct uplink payload
679 +* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
820 820  
821 -3. final, close the power output.
681 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
822 822  
823 -(% style="color:blue" %)**AT Command: AT+5VT**
824 824  
825 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
826 -|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 204px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Function**|=(% style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 149px;" %)**Response**
827 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
828 -OK
829 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
830 -OK
831 -
832 -)))
684 +=== 3.3.3 Set Alarm Thredhold ===
833 833  
834 -(% style="color:blue" %)**Downlink Command: 0x07**(%%)
835 -Format: Command Code (0x07) followed by 2 bytes.
836 836  
837 -The first and second bytes are the time to turn on.
687 +(% style="color:blue" %)**1.  Set for All Probes:**
838 838  
839 -* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
840 -* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
689 +(% style="color:#037691" %)**AT+18ALARM=min,max**
841 841  
842 -=== 3.3.3  Enable / Disable Alarm ===
691 +* When min=0, and max≠0, Alarm trigger when higher than max
692 +* When min≠0, and max=0, Alarm trigger when lower than min
693 +* When min≠0 and max≠0, Alarm trigger when higher than max or lower than min
843 843  
695 +**Example:**
844 844  
845 -Feature: Enable/Disable Alarm for open/close event. Default value 0.
697 + AT+18ALARM=-10,30  ~/~/ Alarm when < -10 or higher than 30.
846 846  
847 -(% style="color:blue" %)**AT Command: **
848 848  
849 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
850 -|(% style="background-color:#d9e2f3; color:#0070c0; width:153px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:276px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:86px" %)**Response**
851 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
852 -|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
700 +* (% style="color:blue" %)**Downlink Payload:**
853 853  
854 -(% style="color:blue" %)**Downlink Command: **
702 +0x(0B F6 1E)   ~/~/ Same as AT+18ALARM=-10,30
855 855  
856 -0xA7 0 ~/~/ Same As AT+DISALARM=1
704 +(note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
857 857  
858 -0xA7 00  ~/~/ Same As AT+DISALARM=0
859 859  
707 +(% style="color:blue" %)**2.  Set for Separate Probe:**
860 860  
861 -=== 3.3.4  Alarm Base on Timeout ===
709 +(% style="color:#037691" %)**AT+18ALARM=min,max,index**
862 862  
711 +Index:
863 863  
864 -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:
713 +* 1: Temperature_Red
714 +* 2: Temperature_White
715 +* 3: Temperature_Black
865 865  
866 -* (((
867 -(% style="color:blue" %)**Keep Status: Status to be monitor**
868 -)))
717 +**Example:**
869 869  
870 -(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
719 + AT+18ALARM=-10,30,1   ~/~/ Alarm when temperature_red < -10 or higher than 30.
871 871  
872 -(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
873 873  
722 +* (% style="color:blue" %)**Downlink Payload:**
874 874  
875 -* (((
876 -(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
877 -)))
724 +0x(0B F6 1E 01)   ~/~/ Same as AT+18ALARM=-10,30,1
878 878  
879 -Range 0 ~~ 65535(0xFFFF) seconds.
726 +(note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
880 880  
881 -If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
882 882  
883 -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.
729 +=== 3.3.4 Set Alarm Interval ===
884 884  
885 885  
886 -* (((
887 -(% style="color:blue" %)**Downlink Command**
888 -)))
732 +The shortest time of two Alarm packet. (unit: min)
889 889  
890 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
734 +* (% style="color:blue" %)**AT Command:**
891 891  
892 -**A9:** Command Type Code
736 +AT+ATDC=30  ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes.
893 893  
894 -**aa: **01:TTRIG1; 02:TTRIG2
895 895  
896 -**bb:** status to be monitored
739 +* (% style="color:blue" %)**Downlink Payload:**
897 897  
898 -**cc dd:** timeout.
741 +0x(0D 00 1E)     **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes
899 899  
900 900  
901 -**1) AT+TTRIG1 : (PA8 of pin)**
744 +=== 3.3.5 Get Alarm settings  (什么FPORT?) ===
902 902  
903 -(% style="color:blue" %)**AT Command to configure:**
904 904  
905 -* (((
906 -(% 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 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.
747 +Send a LoRaWAN downlink to ask device send Alarm settings.
907 907  
908 -(% style="color:#037691" %)**AT+TTRIG1=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-LB 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.
909 -)))
749 +* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
910 910  
911 -* (((
912 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
751 +**Example:**
913 913  
753 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-D20-D22-D23%20LoRaWAN%20Temperature%20Sensor%20User%20Manual/WebHome/1655948182791-225.png?rev=1.1||alt="1655948182791-225.png"]]
914 914  
915 -
916 -)))
917 917  
918 -(% style="color:blue" %)**Downlink Command to configure:**
756 +**Explain:**
919 919  
920 -If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 **or** 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
758 +* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
921 921  
922 922  
923 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
761 +=== 3.3.6 Set Interrupt Mode ===
924 924  
925 -(% style="color:blue" %)**AT Command to configure:**
926 926  
927 -* (((
928 -(% 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 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.
764 +Feature, Set Interrupt mode for GPIO_EXIT.
929 929  
930 -(% style="color:#037691" %)**AT+TTRIG2=0,30** (%%) **~-~->** When the **Keep Status** change from open to close, and device remains in open status for more than 30 seconds. DS03A-LB 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.
931 -)))
766 +(% style="color:blue" %)**AT Command: AT+INTMOD**
932 932  
933 -* (((
934 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
935 -
936 -
937 -
938 -)))
939 -
940 -(% style="color:blue" %)**Downlink Command to configure:**
941 -
942 -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.
943 -
944 -
945 -=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
946 -
947 -
948 -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.
949 -
950 -(% style="color:blue" %)**AT Command:**
951 -
952 952  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
953 -|=(% 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**
954 -|(% style="width:155px" %)(((
955 -AT+TTRALARM=0
956 -)))|(% style="width:279px" %)(((
957 -disable continuous alarm
958 -)))|(% style="width:84px" %)(((
769 +|=(% style="width: 154px;background-color:#D9E2F3" %)**Command Example**|=(% style="width: 196px;background-color:#D9E2F3" %)**Function**|=(% style="width: 157px;background-color:#D9E2F3" %)**Response**
770 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
771 +0
959 959  OK
773 +the mode is 0 =Disable Interrupt
960 960  )))
961 -|(% style="width:155px" %)(((
962 -AT+TTRALARM=60
963 -)))|(% style="width:279px" %)(((
964 -The alarm interval is 60 minutes (unit: minutes)
965 -)))|(% style="width:84px" %)(((
966 -OK
967 -)))
775 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
776 +Set Transmit Interval
777 +0. (Disable Interrupt),
778 +~1. (Trigger by rising and falling edge)
779 +2. (Trigger by falling edge)
780 +3. (Trigger by rising edge)
781 +)))|(% style="width:157px" %)OK
968 968  
969 -(% style="color:blue" %)**Downlink Command:**
783 +(% style="color:blue" %)**Downlink Command: 0x06**
970 970  
971 -Example 0C aa  => AT+TTRALARM= aa
785 +Format: Command Code (0x06) followed by 3 bytes.
972 972  
787 +This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
973 973  
974 -=== 3.3.6  Count Mod ===
789 +* Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
790 +* Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
975 975  
976 976  
977 -Feature: Manually set the count mode.
978 -
979 -(% style="color:blue" %)**AT Command:**
980 -
981 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
982 -|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 275px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)**Response**
983 -|(% style="width:155px" %)(((
984 -AT+COUNTMOD=0
985 -)))|(% style="width:277px" %)(((
986 -the count value keeps accumulating mode
987 -)))|(% style="width:86px" %)(((
988 -OK
989 -)))
990 -|(% style="width:155px" %)(((
991 -AT+COUNTMOD=1
992 -)))|(% style="width:277px" %)(((
993 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
994 -)))|(% style="width:86px" %)(((
995 -OK
996 -)))
997 -
998 -(% style="color:blue" %)**Downlink Command:**
999 -
1000 -Example:  0B aa  => AT+COUNTMOD = second byte
1001 -
1002 -
1003 -=== 3.3.7  Number of channel of door sensors ===
1004 -
1005 -
1006 -Feature: Set the number of door sensor channels.
1007 -
1008 -(% style="color:blue" %)**AT Command:**
1009 -
1010 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1011 -|=(% 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**
1012 -|(% style="width:155px" %)(((
1013 -AT+TTRCHANNEL=1
1014 -)))|(% style="width:259px" %)(((
1015 -Set as single channel, only use PA8 pin as interrupt pin.
1016 -)))|(% style="width:44px" %)(((
1017 -OK
1018 -)))
1019 -|(% style="width:155px" %)(((
1020 -AT+TTRCHANNEL=2
1021 -)))|(% style="width:259px" %)(((
1022 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1023 -)))|(% style="width:44px" %)(((
1024 -OK
1025 -)))
1026 -
1027 -(% style="color:blue" %)**Downlink Command:**
1028 -
1029 -Example:  0D aa => AT+TTRCHANNEL = second byte
1030 -
1031 -
1032 -=== 3.3.8  Set Time Sync Mode ===
1033 -
1034 -
1035 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1036 -
1037 -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.
1038 -
1039 -(% style="color:blue" %)**AT Command:**
1040 -
1041 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1042 -|=(% 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**
1043 -|(% style="width:155px" %)(((
1044 -AT+SYNCMOD=1
1045 -)))|(% style="width:259px" %)(((
1046 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1047 -)))|(% style="width:44px" %)(((
1048 -OK
1049 -)))
1050 -|(% style="width:155px" %)(((
1051 -AT+SYNCMOD=1,8
1052 -)))|(% style="width:259px" %)(((
1053 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1054 -)))|(% style="width:44px" %)(((
1055 -OK
1056 -)))
1057 -|(% 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
1058 -
1059 -(% style="color:blue" %)**Downlink Command:**
1060 -
1061 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
1062 -
1063 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1064 -
1065 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
1066 -
1067 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1068 -
1069 -
1070 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
1071 -
1072 -
1073 -(% style="color:blue" %)**AT Command:**
1074 -
1075 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1076 -|=(% style="width: 163px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 290px; background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 57px;background-color:#D9E2F3;color:#0070C0" %)**Response**
1077 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1078 -OK
1079 -)))
1080 -
1081 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1082 -
1083 -The sensor will clear the open door times and the duration of the last open door.
1084 -
1085 -
1086 -=== 3.3.10  Set the count value of the number of open door ===
1087 -
1088 -
1089 -(% style="color:blue" %)**AT Command:**
1090 -
1091 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1092 -|=(% 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**
1093 -|(% style="width:155px" %)(((
1094 -AT+SETCNT=1,100
1095 -)))|(% style="width:259px" %)(((
1096 -Set the open door times of PA8 pin to 100 times.
1097 -)))|(% style="width:44px" %)(((
1098 -OK
1099 -)))
1100 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1101 -|(% style="width:155px" %)(((
1102 -AT+SETCNT=2,50
1103 -)))|(% style="width:259px" %)(((
1104 -Set the open door times of PA4 pin to 100 times.
1105 -)))|(% style="width:44px" %)(((
1106 -OK
1107 -)))
1108 -
1109 -(% style="color:blue" %)**Downlink Command:**
1110 -
1111 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1112 -
1113 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1114 -
1115 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1116 -
1117 -
1118 1118  = 4. Battery & Power Consumption =
1119 1119  
1120 1120  
1121 -DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
796 +D2x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1122 1122  
1123 1123  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1124 1124  
... ... @@ -1126,7 +1126,7 @@
1126 1126  = 5. OTA firmware update =
1127 1127  
1128 1128  
1129 -User can change firmware DS03A-LB to:
804 +User can change firmware S31x-LB to:
1130 1130  
1131 1131  * Change Frequency band/ region.
1132 1132  * Update with new features.
... ... @@ -1134,11 +1134,13 @@
1134 1134  
1135 1135  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1136 1136  
812 +
1137 1137  Methods to Update Firmware:
1138 1138  
1139 -* (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/]]**
1140 -* 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]]**.
815 +* (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/]]
816 +* 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]]**.
1141 1141  
818 +
1142 1142  = 6. FAQ =
1143 1143  
1144 1144  
... ... @@ -1146,7 +1146,7 @@
1146 1146  = 7. Order Info =
1147 1147  
1148 1148  
1149 -Part Number: (% style="color:blue" %)**DS03A-LB-XX**
826 +Part Number: (% style="color:blue" %)**D20-LB-XX  / D22-LB-XX / D23-LB-XX**
1150 1150  
1151 1151  (% style="color:red" %)**XX**(%%): The default frequency band
1152 1152  
... ... @@ -1166,12 +1166,13 @@
1166 1166  
1167 1167  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1168 1168  
846 +
1169 1169  = 8. ​Packing Info =
1170 1170  
1171 1171  
1172 1172  (% style="color:#037691" %)**Package Includes**:
1173 1173  
1174 -* DS03A-LB LoRaWAN Temperature Sensor
852 +* D2x-LB LoRaWAN Temperature Sensor
1175 1175  
1176 1176  (% style="color:#037691" %)**Dimension and weight**:
1177 1177  
... ... @@ -1183,9 +1183,10 @@
1183 1183  
1184 1184  * Weight / pcs : g
1185 1185  
864 +
1186 1186  = 9. Support =
1187 1187  
1188 1188  
1189 1189  * 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.
1190 1190  
1191 -* 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]].
870 +* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
image-20230426085205-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -190.0 KB
Content
image-20230516085523-1.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -1.3 MB
Content
image-20230522092858-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -156.5 KB
Content
image-20230522092934-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -156.5 KB
Content
image-20230522093256-3.jpeg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -34.5 KB
Content
image-20230630155406-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -41.8 KB
Content
image-20230630155451-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -77.2 KB
Content
image-20230630155527-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -39.2 KB
Content
image-20230630155556-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -38.4 KB
Content
image-20230630155751-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -37.1 KB
Content
image-20230630155908-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -90.8 KB
Content
image-20230630160843-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -511.7 KB
Content
image-20230630172740-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -37.1 KB
Content
image-20230701094042-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Saxer
Size
... ... @@ -1,1 +1,0 @@
1 -34.5 KB
Content
image-20240108160443-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -500.2 KB
Content
image-20240108161155-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -265.7 KB
Content