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

From version 40.6
edited by Xiaoling
on 2024/01/08 16:23
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/LS -- 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,73 +22,71 @@
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 **(%%)or **solar powered + li-on 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 -* Wall Mountable
80 -* Outdoor Use
81 -* 8500mAh Li/SOCl2 Battery (DS03A-LB)
82 -* Solar panel + 3000mAh Li-on battery (DS03A-LS)
63 +* 8500mAh Battery for long term use
83 83  
65 +
84 84  == 1.3 Specification ==
85 85  
86 86  
87 87  (% style="color:#037691" %)**Common DC Characteristics:**
88 88  
89 -* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
71 +* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
90 90  * Operating Temperature: -40 ~~ 85°C
91 91  
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 +
92 92  (% style="color:#037691" %)**LoRa Spec:**
93 93  
94 94  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -109,25 +109,21 @@
109 109  * Sleep Mode: 5uA @ 3.3v
110 110  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
111 111  
112 -== 1.4 Applications ==
113 113  
101 +== 1.4 Sleep mode and working mode ==
114 114  
115 -[[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741400370-813.png]]
116 116  
117 -
118 -== 1.5 Sleep mode and working mode ==
119 -
120 -
121 121  (% 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.
122 122  
123 123  (% 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.
124 124  
125 125  
126 -== 1.6 Button & LEDs ==
109 +== 1.5 Button & LEDs ==
127 127  
128 128  
129 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1||alt="image-20240103160425-4.png"]]
112 +[[image:1675071855856-879.png]]
130 130  
114 +
131 131  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
132 132  |=(% 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**
133 133  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
... ... @@ -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,95 +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  
166 -=== 1.9.1 for LB version ===
154 +
155 +)))
156 +|(% style="width:102px" %)D22-LB|(% style="width:190px" %) |(% style="width:297px" %)(((
157 +2 x DS28B20 Probes
167 167  
168 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS75-LB_LoRaWAN_Distance_Detection_Sensor_User_Manual/WebHome/image-20240105152536-3.png?rev=1.1||alt="image-20240105152536-3.png"]]
159 +Cable lengths total 1.5meters per probe
169 169  
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 +)))
170 170  
171 -**Probe Mechanical:**
168 +(((
169 +
170 +)))
171 +)))|(% style="width:190px" %) |(% style="width:297px" %)(((
172 +3 x DS28B20 Probes
172 172  
173 -[[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]]
174 +Cable lengths total 1.5meters per probe
174 174  
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 +)))
175 175  
179 +(% style="display:none" %)
176 176  
177 -=== 1.9.2 for LS version ===
178 178  
179 179  
180 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20231231203439-3.png?width=886&height=385&rev=1.1||alt="image-20231231203439-3.png"]]
183 +== 1.8 Mechanical ==
181 181  
182 182  
186 +[[image:1675143884058-338.png]]
183 183  
184 184  
185 -== 1.10 Magnet Distance ==
189 +[[image:1675143899218-599.png]]
186 186  
187 187  
188 -* Wood Door: 10mm ~~ 30mm
189 -* Iron Door: 30 ~~ 45mm
192 +[[image:1675143909447-639.png]]
190 190  
191 -= 2. Configure DS03A-LB to connect to LoRaWAN network =
192 192  
195 += 2. Configure D2x-LB to connect to LoRaWAN network =
196 +
193 193  == 2.1 How it works ==
194 194  
195 195  
196 -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.
197 197  
198 198  
199 199  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
200 200  
201 201  
202 -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.
203 203  
204 -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.
205 205  
206 -[[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.
207 207  
208 208  
209 -(% 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.
210 210  
211 -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:
212 212  
213 -[[image:image-20230426085205-1.png||height="238" width="512"]]
216 +[[image:image-20230131134744-2.jpeg]]
214 214  
215 215  
219 +
216 216  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
217 217  
218 -(% style="display:none" %) (%%)
219 219  
220 220  (% style="color:blue" %)**Register the device**
221 221  
225 +[[image:1675144099263-405.png]]
222 222  
223 -[[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" %)
224 224  
225 -
226 226  (% style="color:blue" %)**Add APP EUI and DEV EUI**
227 227  
228 -[[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]]
229 229  
230 230  
231 231  (% style="color:blue" %)**Add APP EUI in the application**
232 232  
233 -[[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"]]
234 234  
236 +[[image:1675144143021-195.png]]
235 235  
238 +
236 236  (% style="color:blue" %)**Add APP KEY**
237 237  
238 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675144157838-392.png?rev=1.1||alt="1675144157838-392.png"]]
241 +[[image:1675144157838-392.png]]
239 239  
243 +(% style="color:blue" %)**Step 2:**(%%) Activate on D2x-LB
240 240  
241 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB
242 242  
246 +Press the button for 5 seconds to activate the D2x-LB.
243 243  
244 -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.
245 245  
246 -(% 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.
247 -
248 248  After join success, it will start to upload messages to TTN and you can see the messages in the panel.
249 249  
250 250  
... ... @@ -253,13 +253,11 @@
253 253  === 2.3.1 Device Status, FPORT~=5 ===
254 254  
255 255  
256 -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.
257 257  
258 -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.
259 -
260 -
261 261  The Payload format is as below.
262 262  
262 +
263 263  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
264 264  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
265 265  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -267,42 +267,42 @@
267 267  
268 268  Example parse in TTNv3
269 269  
270 -[[image:image-20230630155406-1.png||height="190" width="873"]]
270 +[[image:image-20230415153147-2.png||height="220" width="1120"]]
271 271  
272 272  
273 -(% 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
274 274  
275 275  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
276 276  
277 277  (% style="color:#037691" %)**Frequency Band**:
278 278  
279 -0x01: EU868
279 +*0x01: EU868
280 280  
281 -0x02: US915
281 +*0x02: US915
282 282  
283 -0x03: IN865
283 +*0x03: IN865
284 284  
285 -0x04: AU915
285 +*0x04: AU915
286 286  
287 -0x05: KZ865
287 +*0x05: KZ865
288 288  
289 -0x06: RU864
289 +*0x06: RU864
290 290  
291 -0x07: AS923
291 +*0x07: AS923
292 292  
293 -0x08: AS923-1
293 +*0x08: AS923-1
294 294  
295 -0x09: AS923-2
295 +*0x09: AS923-2
296 296  
297 -0x0a: AS923-3
297 +*0x0a: AS923-3
298 298  
299 -0x0b: CN470
299 +*0x0b: CN470
300 300  
301 -0x0c: EU433
301 +*0x0c: EU433
302 302  
303 -0x0d: KR920
303 +*0x0d: KR920
304 304  
305 -0x0e: MA869
305 +*0x0e: MA869
306 306  
307 307  
308 308  (% style="color:#037691" %)**Sub-Band**:
... ... @@ -323,430 +323,282 @@
323 323  Ex2: 0x0B49 = 2889mV
324 324  
325 325  
326 -=== 2.3.2  Sensor Configuration, FPORT~=4 ===
326 +=== 2.3.2  Sensor Data. FPORT~=2 ===
327 327  
328 328  
329 -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.
330 330  
331 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
332 -|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
333 -|**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**
334 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
335 -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:"]]
336 336  )))|(% style="width:99px" %)(((
337 -Keep time1(unit: sec)
338 -)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
339 -Keep time2(unit: sec)
340 -)))|(% style="width:98px" %)(((
341 -Alarm interval(unit: min)
344 +[[Temp_White>>||anchor="HTemperatureWhite:"]]
345 +)))|(% style="width:97px" %)(((
346 +[[Temp_Black>>||anchor="HTemperatureBlack:"]]
347 +
348 +
342 342  )))
343 343  
344 -Example parse in TTNv3
351 +**Payload per each model.**
345 345  
346 -[[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"]]
347 347  
348 348  
349 -* (((
350 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
351 -)))
356 +[[image:image-20230415154139-3.png||height="215" width="1179"]]
352 352  
353 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
354 354  
359 +==== (% style="color:#4472c4" %)**Decode corresponding probe color:**(%%) ====
355 355  
356 -* (((
357 -(% style="color:blue" %)**Disalarm: (default: 0)**
358 -)))
361 +**D20:**
359 359  
360 - **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
361 361  
362 - **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:**
363 363  
367 +White <~-~-> C1 Red <~-~-> C2
364 364  
365 -(% 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:**
366 366  
371 +White <~-~->C1 Red <~-~-> C2 Black <~-~-> C3
367 367  
368 -* (((
369 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
370 -)))
371 371  
372 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
373 373  
375 +==== (% style="color:#4472c4" %)**Battery:**(%%) ====
374 374  
377 +Sensor Battery Level.
375 375  
376 -* (((
377 -(% style="color:blue" %)**Alarm interval(default: 0)**
378 -)))
379 +Ex1: 0x0B45 = 2885mV
379 379  
380 -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
381 381  
382 382  
383 -=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
384 384  
385 +==== (% style="color:#4472c4" %)**Temperature RED or Temperature White :**(%%) ====
385 385  
386 -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**
387 387  
388 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
389 -* There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
389 +**Example**:
390 390  
391 -**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
392 392  
393 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
394 -|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
395 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
396 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
397 -Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
398 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
399 -The last door open duration (unit: sec)
400 -)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
393 +If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
401 401  
402 -**Status & Alarm:**
395 +(FF3F & 8000:Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
403 403  
404 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
405 -|(% 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**
406 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
407 -Count mod
408 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
409 -Alarm 0: No Alarm; 1: Alarm
410 -)))|(% style="width:131px" %)(((
411 -Status 0: Close; 1: Open
412 -)))
413 413  
414 -[[image:image-20230630155451-2.png||height="246" width="928"]]
415 415  
399 +==== (% style="color:#4472c4" %)**Temperature White:**(%%) ====
416 416  
417 -* (((
418 -(% style="color:blue" %)**Count mod:Default=0**
419 -)))
420 420  
421 -0: Uplink total open door times since factory
402 +**This point to the Red probe in D22-LB/D23-LB**
422 422  
423 -1: Uplink total open door times since last FPORT=2 uplink.
424 424  
405 +**Example**:
425 425  
426 -* (% style="color:blue" %)**TDC flag**
407 +If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
427 427  
428 -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.
429 429  
430 -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)
431 431  
432 432  
433 -* (((
434 -(% style="color:#0000ff" %)**Alarm**
435 -)))
436 436  
437 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
415 +==== (% style="color:#4472c4" %)**Temperature Black:**(%%) ====
438 438  
439 439  
440 -* (((
441 -(% style="color:blue" %)**Status**
442 -)))
418 +**This point to the BLACK probe in D23-LB**
443 443  
444 -This bit is 1 when the door sensor is open and 0 when it is close.
445 445  
421 +**Example**:
446 446  
447 -* (((
448 -(% style="color:blue" %)**Total open door events**
449 -)))
423 +If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
450 450  
451 -Total pulse/counting base on open door.
425 +If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
452 452  
453 -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)
454 454  
455 455  
456 -* (((
457 -(% style="color:blue" %)**The last door open duration**
458 -)))
459 459  
460 -Door sensor last open duration.
431 +==== (% style="color:#4472c4" %)**Alarm Flag& MOD:**(%%) ====
461 461  
462 -Unit: sec.
463 463  
464 -[[image:image-20230701094042-1.png||height="154" width="763"]]
434 +**Example:**
465 465  
436 +If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message
466 466  
467 -**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
468 468  
469 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
470 470  
471 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
441 +== 2.4 Payload Decoder file ==
472 472  
473 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
474 -|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
475 -|(% 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**
476 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
477 -Status1 & Alarm1
478 -)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
479 -The last door open duration1 (unit: sec)
480 -)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
481 -Status2 & Alarm2
482 -)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
483 483  
484 -**Status1 & Alarm1:**
485 -
486 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
487 -|(% 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**
488 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
489 -Count mod
490 -)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
491 -Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
492 -)))|(% style="width:181px" %)(((
493 -Status1 0: Close; 1: Open (PA8 of pin)
444 +(((
445 +In TTN, use can add a custom payload so it shows friendly. 
494 494  )))
495 495  
496 -**Status2 & Alarm2:**
497 -
498 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
499 -|(% 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**
500 -|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
501 -Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
502 -)))|(% style="width:181px" %)(((
503 -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]]
504 504  )))
505 505  
506 -[[image:image-20230630155908-6.png||height="295" width="927"]]
507 507  
453 +== 2.5 Datalog Feature ==
508 508  
509 -* (((
510 -(% style="color:blue" %)**Count mod:Default=0**
511 -)))
512 512  
513 -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.
514 514  
515 -1: Uplink total open door times since last FPORT=2 uplink.
516 516  
459 +=== 2.5.1 Ways to get datalog via LoRaWAN ===
517 517  
518 -* (% style="color:blue" %)**TDC flag**
519 519  
520 -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.
521 521  
522 -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.
523 523  
467 +Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
524 524  
525 -* (((
526 -(% style="color:#0000ff" %)**Alarm1 or Alarm2**
527 -)))
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"]]
528 528  
529 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
471 +=== 2.5.2 Unix TimeStamp ===
530 530  
531 531  
532 -* (((
533 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
534 -)))
474 +D2x-LB uses Unix TimeStamp format based on
535 535  
536 -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"]]
537 537  
478 +User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
538 538  
539 -* (((
540 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
541 -)))
480 +Below is the converter example
542 542  
543 -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"]]
544 544  
545 -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
546 546  
547 547  
548 -* (((
549 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
550 -)))
487 +=== 2.5.3 Set Device Time ===
551 551  
552 -Door sensor last open duration.
553 553  
554 -Unit: sec.
490 +User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
555 555  
556 -[[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).
557 557  
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.**
558 558  
559 -=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
560 560  
497 +=== 2.5.4 Datalog Uplink payload  (FPORT~=3) ===
561 561  
562 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
563 563  
564 -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.
565 565  
566 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
567 -|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
568 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
569 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
570 -Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
571 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
572 -The last door open duration (unit: sec)
573 -)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
502 +**Retrieval data payload:**
574 574  
575 -**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"]]
576 576  
577 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
578 -|(% 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**
579 -|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
580 -Count mod
581 -)))|(% style="width:95px" %)(((
582 -TDC flag 0:No; 1:Yes
583 -)))|(% style="width:116px" %)(((
584 -Alarm 0: No Alarm; 1: Alarm
585 -)))|(% style="width:112px" %)(((
586 -Status 0:Close; 1: Open
587 -)))
512 +**Poll message flag & Ext:**
588 588  
589 -* (((
590 -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.
591 -)))
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"]]
592 592  
593 -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)
594 594  
595 -(((
596 -**~1. DR0**: max is 11 bytes so one entry of data
597 -)))
518 +**Poll Message Flag**: 1: This message is a poll message reply.
598 598  
599 -(((
600 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
601 -)))
520 +* Poll Message Flag is set to 1.
602 602  
603 -(((
604 -**3. DR2**: total payload includes 11 entries of data
605 -)))
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.
606 606  
607 -(((
608 -**4. DR3**: total payload includes 22 entries of data.
609 -)))
524 +For example, in US915 band, the max payload for different DR is:
610 610  
611 -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
612 612  
613 -[[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)
614 614  
615 -**Downlink:**
530 +**c) DR2:** total payload includes 11 entries of data
616 616  
617 -0x31 64 9E 7D 34 64 9E 7E 9C 05
532 +**d) DR3: **total payload includes 22 entries of data.
618 618  
534 +If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0   
619 619  
620 -**Uplink:**
621 621  
622 -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:**
623 623  
539 +If D2x-LB has below data inside Flash:
624 624  
625 -**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"]]
626 626  
627 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
543 +If user sends below downlink command: 3160065F9760066DA705
628 628  
545 +Where : Start time: 60065F97 = time 21/1/19 04:27:03
629 629  
630 -[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
547 + Stop time: 60066DA7= time 21/1/19 05:27:03
631 631  
632 -[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
633 633  
634 -[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
550 +**D2x-LB will uplink this payload.**
635 635  
636 -[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"]]
637 637  
638 -[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
554 +(((
555 +__**7FFF089801464160065F97**__ **__7FFF__ __088E__ __014B__ __41__ __60066009__** 7FFF0885014E41600660667FFF0875015141600662BE7FFF086B015541600665167FFF08660155416006676E7FFF085F015A41600669C67FFF0857015D4160066C1E
556 +)))
639 639  
640 -[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 +)))
641 641  
642 -[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
562 +(((
563 +7FFF089801464160065F97
564 +)))
643 643  
644 -[[image:image-20230630172740-1.png||height="199" width="868"]]
566 +(((
567 +**Ext sensor data**=0x7FFF/100=327.67
568 +)))
645 645  
570 +(((
571 +**Temp**=0x088E/100=22.00
572 +)))
646 646  
647 -== 2.4 Payload Decoder file ==
574 +(((
575 +**Hum**=0x014B/10=32.6
576 +)))
648 648  
649 -
650 650  (((
651 -In TTN, use can add a custom payload so it shows friendly
579 +**poll message flag & Ext**=0x41,means reply data,Ext=1
652 652  )))
653 653  
654 654  (((
655 -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
656 656  )))
657 657  
658 658  
659 -== 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" %)​
660 660  
589 +== 2.6 Temperature Alarm Feature ==
661 661  
662 -(% 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.
663 663  
664 -(% 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.
665 665  
666 666  
667 -=== 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"]]
668 668  
669 669  
670 -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.
671 -
672 -* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server.
673 -* 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.
674 -
675 -Below is the typical case for the Datalog Feature (Set PNACKMD=1)
676 -
677 -[[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"]]
678 -
679 -
680 -=== 2.5.2 Unix TimeStamp ===
681 -
682 -
683 -DS03A-LB uses Unix TimeStamp format based on
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-11.png?width=627&height=97&rev=1.1||alt="image-20220523001219-11.png" height="97" width="627"]]
686 -
687 -User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
688 -
689 -Below is the converter example
690 -
691 -[[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"]]
692 -
693 -So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
694 -
695 -
696 -=== 2.5.3 Set Device Time ===
697 -
698 -
699 -User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
700 -
701 -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).
702 -
703 -(% 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.**
704 -
705 -
706 -== 2.6 ​Show Data in DataCake IoT Server ==
707 -
708 -
709 -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:
710 -
711 -
712 -(% 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]]
713 -
714 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.**
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/1654746350207-427.png?rev=1.1||alt="1654746350207-427.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/1654747162439-840.png?rev=1.1||alt="1654747162439-840.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/1654746405400-203.png?rev=1.1||alt="1654746405400-203.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/1654746763908-732.png?rev=1.1||alt="1654746763908-732.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/1654746716087-684.png?rev=1.1||alt="1654746716087-684.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/1654746693868-718.png?rev=1.1||alt="1654746693868-718.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/1654746674738-826.png?rev=1.1||alt="1654746674738-826.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/1654746646379-591.png?rev=1.1||alt="1654746646379-591.png"]]
738 -
739 -
740 -[[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"]]
741 -
742 -
743 -[[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"]]
744 -
745 -
746 746  == 2.7 Frequency Plans ==
747 747  
748 748  
749 -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.
750 750  
751 751  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
752 752  
... ... @@ -754,20 +754,23 @@
754 754  == 2.8 ​Firmware Change Log ==
755 755  
756 756  
757 -**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:**
758 758  
611 +[[https:~~/~~/www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0>>url:https://www.dropbox.com/sh/gf1glloczbzz19h/AABbuYI4WY6VdAmpXo6o1V2Ka?dl=0]]
759 759  
760 -= 3. Configure DS03A-LB =
761 761  
614 += 3. Configure D2x-LB =
615 +
762 762  == 3.1 Configure Methods: ==
763 763  
764 764  
765 -DS03A-LB supports below configure method:
619 +D2x-LB supports below configure method:
766 766  
767 767  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
768 768  * 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]].
769 769  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
770 770  
625 +
771 771  == 3.2 General Commands ==
772 772  
773 773  
... ... @@ -781,13 +781,13 @@
781 781  [[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/]]
782 782  
783 783  
784 -== 3.3 Commands special design for DS03A-LB ==
639 +== 3.3 Commands special design for D2x-LB ==
785 785  
786 786  
787 -These commands only valid for DS03A-LB, as below:
642 +These commands only valid for D2x-LB, as below:
788 788  
789 789  
790 -=== 3.3.1  Set Transmit Interval Time ===
645 +=== 3.3.1 Set Transmit Interval Time ===
791 791  
792 792  
793 793  Feature: Change LoRaWAN End Node Transmit Interval.
... ... @@ -795,7 +795,7 @@
795 795  (% style="color:blue" %)**AT Command: AT+TDC**
796 796  
797 797  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
798 -|=(% 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**
799 799  |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
800 800  30000
801 801  OK
... ... @@ -815,316 +815,130 @@
815 815  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
816 816  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
817 817  
818 -=== 3.3.2  Set Power Output Duration ===
819 819  
674 +=== 3.3.2 Get Device Status ===
820 820  
821 -Control the output duration 5V . Before each sampling, device will
822 822  
823 -~1. first enable the power output to external sensor,
677 +Send a LoRaWAN downlink to ask device send Alarm settings.
824 824  
825 -2. keep it on as per duration, read sensor value and construct uplink payload
679 +* (% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
826 826  
827 -3. final, close the power output.
681 +Sensor will upload Device Status via FPORT=5. See payload section for detail.
828 828  
829 -(% style="color:blue" %)**AT Command: AT+5VT**
830 830  
831 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
832 -|=(% 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**
833 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
834 -OK
835 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
836 -OK
837 -
838 -)))
684 +=== 3.3.3 Set Alarm Thredhold ===
839 839  
840 -(% style="color:blue" %)**Downlink Command: 0x07**(%%)
841 -Format: Command Code (0x07) followed by 2 bytes.
842 842  
843 -The first and second bytes are the time to turn on.
687 +(% style="color:blue" %)**1.  Set for All Probes:**
844 844  
845 -* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
846 -* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
689 +(% style="color:#037691" %)**AT+18ALARM=min,max**
847 847  
848 -=== 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
849 849  
695 +**Example:**
850 850  
851 -Feature: Enable/Disable Alarm for open/close event. Default value 0.
697 + AT+18ALARM=-10,30  ~/~/ Alarm when < -10 or higher than 30.
852 852  
853 -(% style="color:blue" %)**AT Command: **
854 854  
855 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
856 -|(% 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**
857 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
858 -|(% 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:**
859 859  
860 -(% style="color:blue" %)**Downlink Command: **
702 +0x(0B F6 1E)   ~/~/ Same as AT+18ALARM=-10,30
861 861  
862 -0xA7 0 ~/~/ Same As AT+DISALARM=1
704 +(note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
863 863  
864 -0xA7 00  ~/~/ Same As AT+DISALARM=0
865 865  
707 +(% style="color:blue" %)**2.  Set for Separate Probe:**
866 866  
867 -=== 3.3.4  Alarm Base on Timeout ===
709 +(% style="color:#037691" %)**AT+18ALARM=min,max,index**
868 868  
711 +Index:
869 869  
870 -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
871 871  
872 -* (((
873 -(% style="color:blue" %)**Keep Status: Status to be monitor**
874 -)))
717 +**Example:**
875 875  
876 -(% 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.
877 877  
878 -(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
879 879  
722 +* (% style="color:blue" %)**Downlink Payload:**
880 880  
881 -* (((
882 -(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
883 -)))
724 +0x(0B F6 1E 01)   ~/~/ Same as AT+18ALARM=-10,30,1
884 884  
885 -Range 0 ~~ 65535(0xFFFF) seconds.
726 +(note: 0x1E= 30, 0xF6 means: 0xF6-0x100 = -10)
886 886  
887 -If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
888 888  
889 -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 ===
890 890  
891 891  
892 -* (((
893 -(% style="color:blue" %)**Downlink Command**
894 -)))
732 +The shortest time of two Alarm packet. (unit: min)
895 895  
896 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
734 +* (% style="color:blue" %)**AT Command:**
897 897  
898 -**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.
899 899  
900 -**aa: **01:TTRIG1; 02:TTRIG2
901 901  
902 -**bb:** status to be monitored
739 +* (% style="color:blue" %)**Downlink Payload:**
903 903  
904 -**cc dd:** timeout.
741 +0x(0D 00 1E)     **~-~-->** Set AT+ATDC=0x 00 1E = 30 minutes
905 905  
906 906  
907 -**1) AT+TTRIG1 : (PA8 of pin)**
744 +=== 3.3.5 Get Alarm settings  (什么FPORT?) ===
908 908  
909 -(% style="color:blue" %)**AT Command to configure:**
910 910  
911 -* (((
912 -(% 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.
913 913  
914 -(% 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.
915 -)))
749 +* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
916 916  
917 -* (((
918 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
751 +**Example:**
919 919  
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"]]
920 920  
921 -
922 -)))
923 923  
924 -(% style="color:blue" %)**Downlink Command to configure:**
756 +**Explain:**
925 925  
926 -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.
927 927  
928 928  
929 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
761 +=== 3.3.6 Set Interrupt Mode ===
930 930  
931 -(% style="color:blue" %)**AT Command to configure:**
932 932  
933 -* (((
934 -(% 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.
935 935  
936 -(% 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.
937 -)))
766 +(% style="color:blue" %)**AT Command: AT+INTMOD**
938 938  
939 -* (((
940 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
941 -
942 -
943 -
944 -)))
945 -
946 -(% style="color:blue" %)**Downlink Command to configure:**
947 -
948 -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.
949 -
950 -
951 -=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
952 -
953 -
954 -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.
955 -
956 -(% style="color:blue" %)**AT Command:**
957 -
958 958  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
959 -|=(% 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**
960 -|(% style="width:155px" %)(((
961 -AT+TTRALARM=0
962 -)))|(% style="width:279px" %)(((
963 -disable continuous alarm
964 -)))|(% 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
965 965  OK
773 +the mode is 0 =Disable Interrupt
966 966  )))
967 -|(% style="width:155px" %)(((
968 -AT+TTRALARM=60
969 -)))|(% style="width:279px" %)(((
970 -The alarm interval is 60 minutes (unit: minutes)
971 -)))|(% style="width:84px" %)(((
972 -OK
973 -)))
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
974 974  
975 -(% style="color:blue" %)**Downlink Command:**
783 +(% style="color:blue" %)**Downlink Command: 0x06**
976 976  
977 -Example 0C aa  => AT+TTRALARM= aa
785 +Format: Command Code (0x06) followed by 3 bytes.
978 978  
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.
979 979  
980 -=== 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
981 981  
982 982  
983 -Feature: Manually set the count mode.
984 -
985 -(% style="color:blue" %)**AT Command:**
986 -
987 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
988 -|=(% 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**
989 -|(% style="width:155px" %)(((
990 -AT+COUNTMOD=0
991 -)))|(% style="width:277px" %)(((
992 -the count value keeps accumulating mode
993 -)))|(% style="width:86px" %)(((
994 -OK
995 -)))
996 -|(% style="width:155px" %)(((
997 -AT+COUNTMOD=1
998 -)))|(% style="width:277px" %)(((
999 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
1000 -)))|(% style="width:86px" %)(((
1001 -OK
1002 -)))
1003 -
1004 -(% style="color:blue" %)**Downlink Command:**
1005 -
1006 -Example:  0B aa  => AT+COUNTMOD = second byte
1007 -
1008 -
1009 -=== 3.3.7  Number of channel of door sensors ===
1010 -
1011 -
1012 -Feature: Set the number of door sensor channels.
1013 -
1014 -(% style="color:blue" %)**AT Command:**
1015 -
1016 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1017 -|=(% 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**
1018 -|(% style="width:155px" %)(((
1019 -AT+TTRCHANNEL=1
1020 -)))|(% style="width:259px" %)(((
1021 -Set as single channel, only use PA8 pin as interrupt pin.
1022 -)))|(% style="width:44px" %)(((
1023 -OK
1024 -)))
1025 -|(% style="width:155px" %)(((
1026 -AT+TTRCHANNEL=2
1027 -)))|(% style="width:259px" %)(((
1028 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
1029 -)))|(% style="width:44px" %)(((
1030 -OK
1031 -)))
1032 -
1033 -(% style="color:blue" %)**Downlink Command:**
1034 -
1035 -Example:  0D aa => AT+TTRCHANNEL = second byte
1036 -
1037 -
1038 -=== 3.3.8  Set Time Sync Mode ===
1039 -
1040 -
1041 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
1042 -
1043 -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.
1044 -
1045 -(% style="color:blue" %)**AT Command:**
1046 -
1047 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1048 -|=(% 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**
1049 -|(% style="width:155px" %)(((
1050 -AT+SYNCMOD=1
1051 -)))|(% style="width:259px" %)(((
1052 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
1053 -)))|(% style="width:44px" %)(((
1054 -OK
1055 -)))
1056 -|(% style="width:155px" %)(((
1057 -AT+SYNCMOD=1,8
1058 -)))|(% style="width:259px" %)(((
1059 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
1060 -)))|(% style="width:44px" %)(((
1061 -OK
1062 -)))
1063 -|(% 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
1064 -
1065 -(% style="color:blue" %)**Downlink Command:**
1066 -
1067 -0x28 01  ~/~/ Same As AT+SYNCMOD=1
1068 -
1069 -0x28 01 08  ~/~/ Same As AT+SYNCMOD=1,8
1070 -
1071 -0x28 01 F4  ~/~/ Same As AT+SYNCMOD=1,-12
1072 -
1073 -0x28 00  ~/~/ Same As AT+SYNCMOD=0
1074 -
1075 -
1076 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
1077 -
1078 -
1079 -(% style="color:blue" %)**AT Command:**
1080 -
1081 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1082 -|=(% 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**
1083 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1084 -OK
1085 -)))
1086 -
1087 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1088 -
1089 -The sensor will clear the open door times and the duration of the last open door.
1090 -
1091 -
1092 -=== 3.3.10  Set the count value of the number of open door ===
1093 -
1094 -
1095 -(% style="color:blue" %)**AT Command:**
1096 -
1097 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1098 -|=(% 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**
1099 -|(% style="width:155px" %)(((
1100 -AT+SETCNT=1,100
1101 -)))|(% style="width:259px" %)(((
1102 -Set the open door times of PA8 pin to 100 times.
1103 -)))|(% style="width:44px" %)(((
1104 -OK
1105 -)))
1106 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1107 -|(% style="width:155px" %)(((
1108 -AT+SETCNT=2,50
1109 -)))|(% style="width:259px" %)(((
1110 -Set the open door times of PA4 pin to 100 times.
1111 -)))|(% style="width:44px" %)(((
1112 -OK
1113 -)))
1114 -
1115 -(% style="color:blue" %)**Downlink Command:**
1116 -
1117 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1118 -
1119 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1120 -
1121 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1122 -
1123 -
1124 1124  = 4. Battery & Power Consumption =
1125 1125  
1126 1126  
1127 -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.
796 +D2x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1128 1128  
1129 1129  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1130 1130  
... ... @@ -1132,7 +1132,7 @@
1132 1132  = 5. OTA firmware update =
1133 1133  
1134 1134  
1135 -User can change firmware DS03A-LB to:
804 +User can change firmware S31x-LB to:
1136 1136  
1137 1137  * Change Frequency band/ region.
1138 1138  * Update with new features.
... ... @@ -1140,11 +1140,13 @@
1140 1140  
1141 1141  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1142 1142  
812 +
1143 1143  Methods to Update Firmware:
1144 1144  
1145 -* (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/]]**
1146 -* 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]]**.
1147 1147  
818 +
1148 1148  = 6. FAQ =
1149 1149  
1150 1150  
... ... @@ -1152,7 +1152,7 @@
1152 1152  = 7. Order Info =
1153 1153  
1154 1154  
1155 -Part Number: (% style="color:blue" %)**DS03A-LB-XX**
826 +Part Number: (% style="color:blue" %)**D20-LB-XX  / D22-LB-XX / D23-LB-XX**
1156 1156  
1157 1157  (% style="color:red" %)**XX**(%%): The default frequency band
1158 1158  
... ... @@ -1172,12 +1172,13 @@
1172 1172  
1173 1173  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1174 1174  
846 +
1175 1175  = 8. ​Packing Info =
1176 1176  
1177 1177  
1178 1178  (% style="color:#037691" %)**Package Includes**:
1179 1179  
1180 -* DS03A-LB LoRaWAN Temperature Sensor
852 +* D2x-LB LoRaWAN Temperature Sensor
1181 1181  
1182 1182  (% style="color:#037691" %)**Dimension and weight**:
1183 1183  
... ... @@ -1189,9 +1189,10 @@
1189 1189  
1190 1190  * Weight / pcs : g
1191 1191  
864 +
1192 1192  = 9. Support =
1193 1193  
1194 1194  
1195 1195  * 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.
1196 1196  
1197 -* 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