Changes for page DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
Last modified by Mengting Qiu on 2025/07/03 16:36
Summary
-
Page properties (3 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 4 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -DS03A-LB /LS--Outdoor LoRaWAN Door Sensor User Manual1 +DS03A-LB Outdoor LoRaWAN Door Sensor User Manual - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Saxer - Content
-
... ... @@ -1,18 +3,9 @@ 1 -(% style="display:none" %) (%%) 2 - 3 3 (% style="text-align:center" %) 4 -[[image:image-202 40108161155-2.png]]2 +[[image:image-20230516085523-1.jpeg||height="491" width="491"]] 5 5 6 6 5 +**Table of Contents:** 7 7 8 - 9 - 10 - 11 - 12 - 13 - 14 -**Table of Contents:** 15 - 16 16 {{toc/}} 17 17 18 18 ... ... @@ -22,41 +22,41 @@ 22 22 23 23 = 1. Introduction = 24 24 25 -== 1.1 What is LoRaWAN Door Sensor == 16 +== 1.1 What is DS03A-LB LoRaWAN Door Sensor == 26 26 27 27 28 28 ((( 29 -The Dragino DS03A-LB /LSis 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.20 +The Dragino DS03A-LB is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server. 30 30 ))) 31 31 32 32 ((( 33 -The LoRa wireless technology used in DS03A-LB /LSallows 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.24 +The LoRa wireless technology used in DS03A-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. 34 34 ))) 35 35 36 36 ((( 37 -The DS03A-LB /LSwill 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/LScan count each open event and uplink periodically.28 +The DS03A-LB will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB can count each open event and uplink periodically. 38 38 ))) 39 39 40 40 ((( 41 -DS03A-LB /LSsupports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover.32 +DS03A-LB supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover. 42 42 ))) 43 43 44 44 ((( 45 -DS03A-LB /LShas the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time.36 +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 46 47 -DS03A-LB /LSis designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures38 +DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures 48 48 ))) 49 49 50 50 ((( 51 -DS03A-LB /LS(% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.42 +DS03A-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 /LSis powered by (% style="color:blue" %)**8500mAh Li-SOCI2 batteryor (% style="color:blue" %)**solar powered + li-on battery**(%%), it is designed for long term use up to 5 years.46 +DS03A-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 /LSis 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.50 +Each DS03A-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on. 60 60 ))) 61 61 62 62 ... ... @@ -76,19 +76,24 @@ 76 76 * Support wireless OTA update firmware 77 77 * Uplink on periodically 78 78 * Downlink to change configure 70 +* 8500mAh Battery for long term use 79 79 * Wall Mountable 80 80 * Outdoor Use 81 -* 8500mAh Li/SOCl2 Battery (DS03A-LB) 82 -* Solar panel + 3000mAh Li-on battery (DS03A-LS) 83 83 74 + 84 84 == 1.3 Specification == 85 85 86 86 87 87 (% style="color:#037691" %)**Common DC Characteristics:** 88 88 89 -* Supply Voltage: Built-inBattery , 2.5v ~~ 3.6v80 +* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v 90 90 * Operating Temperature: -40 ~~ 85°C 91 91 83 +(% style="color:#037691" %)**Sensor Detect Distance:** 84 + 85 +* Wood Door: 10mm ~~ 30mm 86 +* Iron Door: 30 ~~ 45mm 87 + 92 92 (% style="color:#037691" %)**LoRa Spec:** 93 93 94 94 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz ... ... @@ -109,6 +109,7 @@ 109 109 * Sleep Mode: 5uA @ 3.3v 110 110 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 111 111 108 + 112 112 == 1.4 Applications == 113 113 114 114 ... ... @@ -126,10 +126,11 @@ 126 126 == 1.6 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"]]126 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675071855856-879.png]] 130 130 128 + 131 131 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 132 -|=(% style="width: 167px;background-color:# 4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 226px;background-color:#4F81BD;color:white" %)**Action**130 +|=(% 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" %)((( 134 134 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 135 135 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -141,10 +141,11 @@ 141 141 ))) 142 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. 143 143 142 + 144 144 == 1.7 BLE connection == 145 145 146 146 147 -DS03A-LB /LSsupport BLE remote configure.146 +DS03A-LB support BLE remote configure. 148 148 149 149 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: ... ... @@ -156,44 +156,27 @@ 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==158 +== 1.8 Mechanical == 160 160 161 -[[image:image-20230630160843-7.png]] 162 162 163 - 164 -== 1.9 Mechanical == 165 - 166 -=== 1.9.1 for LB version === 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"]] 169 - 170 - 171 -**Probe Mechanical:** 172 - 173 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 174 175 175 164 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]] 176 176 177 -=== 1.9.2 for LS version === 178 178 167 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]] 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"]] 181 181 170 +[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]] 182 182 183 183 173 += 2. Configure DS03A-LB to connect to LoRaWAN network = 184 184 185 -== 1.10 Magnet Distance == 186 - 187 - 188 -* Wood Door: 10mm ~~ 30mm 189 -* Iron Door: 30 ~~ 45mm 190 - 191 -= 2. Configure DS03A-LB/LS to connect to LoRaWAN network = 192 - 193 193 == 2.1 How it works == 194 194 195 195 196 -The DS03A-LB /LSis configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours.178 +The DS03A-LB is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours. 197 197 198 198 199 199 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -206,9 +206,9 @@ 206 206 [[image:image-20230522092858-1.png||height="391" width="874"]] 207 207 208 208 209 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB /LS.191 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB. 210 210 211 -Each DS03A-LB /LSis shipped with a sticker with the default device EUI as below:193 +Each DS03A-LB is shipped with a sticker with the default device EUI as below: 212 212 213 213 [[image:image-20230426085205-1.png||height="238" width="512"]] 214 214 ... ... @@ -238,10 +238,10 @@ 238 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"]] 239 239 240 240 241 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB /LS223 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB 242 242 243 243 244 -Press the button for 5 seconds to activate the DS03A-LB /LS.226 +Press the button for 5 seconds to activate the DS03A-LB. 245 245 246 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 247 ... ... @@ -253,13 +253,11 @@ 253 253 === 2.3.1 Device Status, FPORT~=5 === 254 254 255 255 256 - Includedeviceconfigurestatus.OnceDS03A-LB/LSJoinedthenetwork,itwilluplink this messageto theserver.After that,DS03A-LB/LSwill uplinkDeviceStatusevery 12 hours.238 +Users can use the downlink command(**0x26 01**) to ask DS03A-LB to send device configure detail, include device configure status. DS03A-LB will uplink a payload via FPort=5 to server. 257 257 258 -Users can also use the downlink command**(0x26 01)** to ask DS03A-LB/LS to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time. 259 - 260 - 261 261 The Payload format is as below. 262 262 242 + 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** ... ... @@ -270,7 +270,7 @@ 270 270 [[image:image-20230630155406-1.png||height="190" width="873"]] 271 271 272 272 273 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB /LS, this value is 0x1B253 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B 274 274 275 275 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 276 276 ... ... @@ -323,271 +323,48 @@ 323 323 Ex2: 0x0B49 = 2889mV 324 324 325 325 326 -=== 2.3.2 SensorConfiguration,FPORT~=4===306 +=== 2.3.2 Real-Time Open/Close Status, Uplink FPORT~=2 === 327 327 328 328 329 -DS03A-LB /LSwillonlysend thiscommandaftergettingthedownlink command**(0x2602)**from the server.309 +DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 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 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) 342 -))) 343 - 344 -Example parse in TTNv3 345 - 346 -[[image:image-20230630155527-3.png||height="146" width="902"]] 347 - 348 - 349 -* ((( 350 -(% style="color:blue" %)**TDC: (default: 0x001C20)** 351 -))) 352 - 353 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 354 - 355 - 356 -* ((( 357 -(% style="color:blue" %)**Disalarm: (default: 0)** 358 -))) 359 - 360 - **If Disalarm = 1**, DS03A-LB/LS will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 361 - 362 - **If Disalarm = 0**, DS03A-LB/LS will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time. 363 - 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. ** 366 - 367 - 368 -* ((( 369 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2** 370 -))) 371 - 372 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 373 - 374 - 375 - 376 -* ((( 377 -(% style="color:blue" %)**Alarm interval(default: 0)** 378 -))) 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 - 382 - 383 -=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 384 - 385 - 386 -DS03A-LB/LS will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB/LS will send uplinks when: 387 - 388 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]]. 311 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 389 389 * There is an Open/Close event. (This info can be disabled by AT+DISALARM=1) 390 390 391 - **1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%),Uplink Payload totals(% style="color:blue" %)11 bytes.(Default mode)(%%)**314 +Uplink Payload totals 11 bytes. 392 392 393 393 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 394 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) 318 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4** 319 +|(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)((( 320 +The last door open duration (unit: min) 400 400 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 401 401 402 402 **Status & Alarm:** 403 403 404 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 -))) 326 +|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:59px" %)**[bit5:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:129px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit0** 327 +|(% style="width:76px" %)**Value**|(% style="width:79px" %)((( 328 +No ACK Message 329 +)))|(% style="width:84px" %)((( 330 +Poll Message Flag 331 +)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]] 332 +0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open 413 413 414 414 [[image:image-20230630155451-2.png||height="246" width="928"]] 415 415 416 - 417 -* ((( 418 -(% style="color:blue" %)**Count mod:Default=0** 419 -))) 420 - 421 -0: Uplink total open door times since factory 422 - 423 -1: Uplink total open door times since last FPORT=2 uplink. 424 - 425 - 426 -* (% style="color:blue" %)**TDC flag** 427 - 428 -When the flag is 1, it means sending packets at normal time intervals. 429 - 430 -Otherwise, it is a packet sent at non-TDC time. 431 - 432 - 433 -* ((( 434 -(% style="color:#0000ff" %)**Alarm** 435 -))) 436 - 437 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 438 - 439 - 440 -* ((( 441 -(% style="color:blue" %)**Status** 442 -))) 443 - 444 -This bit is 1 when the door sensor is open and 0 when it is close. 445 - 446 - 447 -* ((( 448 -(% style="color:blue" %)**Total open door events** 449 -))) 450 - 451 -Total pulse/counting base on open door. 452 - 453 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 454 - 455 - 456 -* ((( 457 -(% style="color:blue" %)**The last door open duration** 458 -))) 459 - 460 -Door sensor last open duration. 461 - 462 -Unit: sec. 463 - 464 -[[image:image-20230701094042-1.png||height="154" width="763"]] 465 - 466 - 467 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %). 468 - 469 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets) 470 - 471 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.** 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 - 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) 494 -))) 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) 504 -))) 505 - 506 506 [[image:image-20230630155908-6.png||height="295" width="927"]] 507 507 508 508 509 -* ((( 510 -(% style="color:blue" %)**Count mod:Default=0** 511 -))) 339 +=== 2.3.3 Historical Door Open/Close Event, FPORT~=3 === 512 512 513 -0: Uplink total open door times since factory 514 514 515 - 1:Uplinktotalopen door timessincelastFPORT=2uplink.342 +DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 516 516 517 - 518 -* (% style="color:blue" %)**TDC flag** 519 - 520 -When the flag is 1, it means sending packets at normal time intervals. 521 - 522 -Otherwise, it is a packet sent at non-TDC time. 523 - 524 - 525 -* ((( 526 -(% style="color:#0000ff" %)**Alarm1 or Alarm2** 527 -))) 528 - 529 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 530 - 531 - 532 -* ((( 533 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2** 534 -))) 535 - 536 -This bit is 1 when the door sensor is open and 0 when it is close. 537 - 538 - 539 -* ((( 540 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2** 541 -))) 542 - 543 -Total pulse/counting base on open door. 544 - 545 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 546 - 547 - 548 -* ((( 549 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2** 550 -))) 551 - 552 -Door sensor last open duration. 553 - 554 -Unit: sec. 555 - 556 -[[image:image-20230701094042-1.png||height="154" width="763"]] 557 - 558 - 559 -=== 2.3.4 Historical Door Open/Close Event, FPORT~=3 === 560 - 561 - 562 -DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 563 - 564 564 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 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"]] 574 - 575 -**Status & Alarm:** 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 -))) 588 - 589 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/LSwill send max bytes according to the current DR and Frequency bands.347 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands. 591 591 ))) 592 592 593 593 For example, in the US915 band, the max payload for different DR is: ... ... @@ -624,7 +624,7 @@ 624 624 625 625 **Parsed Value:** 626 626 627 -[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]384 +[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME] 628 628 629 629 630 630 [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20], ... ... @@ -641,9 +641,46 @@ 641 641 642 642 [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11], 643 643 644 -[[image:image-2023063017 2740-1.png||height="199" width="868"]]401 +[[image:image-20230630155751-5.png||height="188" width="809"]] 645 645 403 +=== 2.3.4 Sensor Configuration, FPORT~=4 === 646 646 405 + 406 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 407 + 408 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 409 +|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 410 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2** 411 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min) 412 + 413 +* ((( 414 +(% style="color:blue" %)**TDC: (default: 0x001C20)** 415 +))) 416 + 417 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 418 + 419 + 420 +* ((( 421 +(% style="color:blue" %)**Disalarm: (default: 0)** 422 +))) 423 + 424 + **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. 425 + 426 + **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. 427 + 428 + 429 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** 430 + 431 + 432 +* ((( 433 +(% style="color:blue" %)**Keep Status & Keep Time** 434 +))) 435 + 436 +Shows the configure value of [[Alarm Base on Timeout Feature>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/#H3.8A0AlarmBaseonTimeout]] 437 + 438 +[[image:image-20230630155527-3.png||height="146" width="902"]] 439 + 440 + 647 647 == 2.4 Payload Decoder file == 648 648 649 649 ... ... @@ -659,25 +659,26 @@ 659 659 == 2.5 Datalog Feature == 660 660 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 /LSwill store the reading for future retrieving purposes.456 +(% 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.** 665 665 666 - 667 667 === 2.5.1 Ways to get datalog via LoRaWAN === 668 668 669 669 670 -Set PNACKMD=1, DS03A-LB /LSwill wait for ACK for every uplink, when there is no LoRaWAN network,/LSwill mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.462 +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 671 672 -* a) DS03A-LB /LSwill do an ACK check for data records sending to make sure every data arrive server.673 -* b) DS03A-LB /LSwill send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-LB/LSwon'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/LSgets a ACK, DS03A-LB/LSwill consider there is a network connection and resend all NONE-ACK Message.464 +* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server. 465 +* 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 674 467 +Below is the typical case for the Datalog Feature (Set PNACKMD=1) 675 675 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"]] 676 676 471 + 677 677 === 2.5.2 Unix TimeStamp === 678 678 679 679 680 -DS03A-LB /LSuses Unix TimeStamp format based on475 +DS03A-LB uses Unix TimeStamp format based on 681 681 682 682 [[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"]] 683 683 ... ... @@ -695,7 +695,7 @@ 695 695 696 696 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 697 697 698 -Once DS03A-LB /LSJoined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS03A-LB/LS. If DS03A-LB/LSfails to get the time from the server, DS03A-LB/LSwill use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).493 +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). 699 699 700 700 (% 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.** 701 701 ... ... @@ -708,7 +708,7 @@ 708 708 709 709 (% 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]] 710 710 711 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB /LSin Datacake.**506 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.** 712 712 713 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/1654746350207-427.png?rev=1.1||alt="1654746350207-427.png"]] 714 714 ... ... @@ -743,7 +743,7 @@ 743 743 == 2.7 Frequency Plans == 744 744 745 745 746 -The DS03A-LB /LSuses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.541 +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. 747 747 748 748 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 749 749 ... ... @@ -754,17 +754,18 @@ 754 754 **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]] 755 755 756 756 757 -= 3. Configure DS03A-LB /LS=552 += 3. Configure DS03A-LB = 758 758 759 759 == 3.1 Configure Methods: == 760 760 761 761 762 -DS03A-LB /LSsupports below configure method:557 +DS03A-LB supports below configure method: 763 763 764 764 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 765 765 * 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]]. 766 766 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 767 767 563 + 768 768 == 3.2 General Commands == 769 769 770 770 ... ... @@ -778,13 +778,13 @@ 778 778 [[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/]] 779 779 780 780 781 -== 3.3 Commands special design for DS03A-LB /LS==577 +== 3.3 Commands special design for DS03A-LB == 782 782 783 783 784 -These commands only valid for DS03A-LB /LS, as below:580 +These commands only valid for DS03A-LB, as below: 785 785 786 786 787 -=== 3.3.1 583 +=== 3.3.1 Set Transmit Interval Time === 788 788 789 789 790 790 Feature: Change LoRaWAN End Node Transmit Interval. ... ... @@ -812,36 +812,17 @@ 812 812 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 813 813 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 814 814 815 -=== 3.3.2 Set Power Output Duration === 816 816 612 +=== 3.3.2 Get Device Status === 817 817 818 -Control the output duration 5V . Before each sampling, device will 819 819 820 - ~1. firstenablethepoweroutput to external sensor,615 +Send a LoRaWAN downlink to ask device send Alarm settings. 821 821 822 - 2.keepit on asper duration, read sensorvalueand construct uplinkpayload617 +* (% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 823 823 824 - 3.final,close the poweroutput.619 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 825 825 826 -(% style="color:blue" %)**AT Command: AT+5VT** 827 827 828 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 829 -|=(% 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** 830 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default) 831 -OK 832 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)((( 833 -OK 834 - 835 -))) 836 - 837 -(% style="color:blue" %)**Downlink Command: 0x07**(%%) 838 -Format: Command Code (0x07) followed by 2 bytes. 839 - 840 -The first and second bytes are the time to turn on. 841 - 842 -* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 843 -* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 844 - 845 845 === 3.3.3 Enable / Disable Alarm === 846 846 847 847 ... ... @@ -849,8 +849,8 @@ 849 849 850 850 (% style="color:blue" %)**AT Command: ** 851 851 852 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 15px" %)853 -|(% style="background-color:#d9e2f3; color:#0070c0; width:15 3px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:276px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:86px" %)**Response**629 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 630 +|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response** 854 854 |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 855 855 |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 856 856 ... ... @@ -864,8 +864,9 @@ 864 864 === 3.3.4 Alarm Base on Timeout === 865 865 866 866 867 -DS03A-LB /LScan monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are:644 +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: 868 868 646 + 869 869 * ((( 870 870 (% style="color:blue" %)**Keep Status: Status to be monitor** 871 871 ))) ... ... @@ -886,104 +886,42 @@ 886 886 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. 887 887 888 888 889 -* ((( 890 -(% style="color:blue" %)**Downlink Command** 891 -))) 892 - 893 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd** 894 - 895 -**A9:** Command Type Code 896 - 897 -**aa: **01:TTRIG1; 02:TTRIG2 898 - 899 -**bb:** status to be monitored 900 - 901 -**cc dd:** timeout. 902 - 903 - 904 -**1) AT+TTRIG1 : (PA8 of pin)** 905 - 906 906 (% style="color:blue" %)**AT Command to configure:** 907 907 908 908 * ((( 909 -(% style="color:#037691" %)**AT+TTRIG1=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm1 bit(the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 910 - 911 -(% 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/LS will send an uplink packet, the Alarm1 bit (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 670 +(% style="color:#037691" %)**AT+TTRIG=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. LDS03A will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 912 912 ))) 913 913 914 914 * ((( 915 -(% style="color:#037691" %)**AT+TTRIG1=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 916 - 917 - 918 - 674 +(% style="color:#037691" %)**AT+TTRIG=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 919 919 ))) 920 920 921 921 (% style="color:blue" %)**Downlink Command to configure:** 922 922 923 - Ifusersend0xA90101 00 1E: equal to AT+TTRIG1=1,30**or**0xA901 00 00 00: EqualtoAT+TTRIG1=0,0.679 +(% style="color:#037691" %)**Command: 0xA9 aa bb cc** 924 924 681 +**A9:** Command Type Code 925 925 926 -** 2) AT+TTRIG2:(PA4ofpin,needtouseAT+TTRCHANNEL=2)**683 +**aa:** status to be monitored 927 927 928 - (%style="color:blue" %)**ATCommandto configure:**685 +**bb cc:** timeout. 929 929 930 -* ((( 931 -(% style="color:#037691" %)**AT+TTRIG2=1,30** (%%) **~-~->** When the **Keep Status** change from close to open, and device remains in open status for more than 30 seconds. DS03A-LB/LS will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1. 932 932 933 -(% 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/LS will send an uplink packet, the Alarm2 bit (the second bit of 12^^st^^ byte of payload) on this uplink packet is set to 1. 934 -))) 688 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 935 935 936 -* ((( 937 -(% style="color:#037691" %)**AT+TTRIG2=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 690 +Or 938 938 692 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 939 939 940 - 941 -))) 942 942 943 - (% style="color:blue"%)**DownlinkCommandtoconfigure:**695 +=== 3.3.5 Count Mod === 944 944 945 -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. 946 946 947 - 948 -=== 3.3.5 TTRIG1 & TTRIG2 timeout status alarm === 949 - 950 - 951 -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. 952 - 953 953 (% style="color:blue" %)**AT Command:** 954 954 955 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 10px" %)956 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 27 9px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width:76px;background-color:#D9E2F3;color:#0070C0" %)**Response**700 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 701 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 277px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 88px;background-color:#D9E2F3;color:#0070C0" %)**Response** 957 957 |(% style="width:155px" %)((( 958 -AT+TTRALARM=0 959 -)))|(% style="width:279px" %)((( 960 -disable continuous alarm 961 -)))|(% style="width:84px" %)((( 962 -OK 963 -))) 964 -|(% style="width:155px" %)((( 965 -AT+TTRALARM=60 966 -)))|(% style="width:279px" %)((( 967 -The alarm interval is 60 minutes (unit: minutes) 968 -)))|(% style="width:84px" %)((( 969 -OK 970 -))) 971 - 972 -(% style="color:blue" %)**Downlink Command:** 973 - 974 -Example: 0C aa => AT+TTRALARM= aa 975 - 976 - 977 -=== 3.3.6 Count Mod === 978 - 979 - 980 -Feature: Manually set the count mode. 981 - 982 -(% style="color:blue" %)**AT Command:** 983 - 984 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 985 -|=(% 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** 986 -|(% style="width:155px" %)((( 987 987 AT+COUNTMOD=0 988 988 )))|(% style="width:277px" %)((( 989 989 the count value keeps accumulating mode ... ... @@ -993,7 +993,7 @@ 993 993 |(% style="width:155px" %)((( 994 994 AT+COUNTMOD=1 995 995 )))|(% style="width:277px" %)((( 996 -the count value will be reset after each TDC time (Last Close Duration Reset after each uplink)712 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink) 997 997 )))|(% style="width:86px" %)((( 998 998 OK 999 999 ))) ... ... @@ -1003,26 +1003,24 @@ 1003 1003 Example: 0B aa => AT+COUNTMOD = second byte 1004 1004 1005 1005 1006 -=== 3.3. 7Numberofchannel ofdoorsensors===722 +=== 3.3.6 Interrupt Pin Channel Mod === 1007 1007 1008 1008 1009 -Feature: Set the number of door sensor channels. 1010 - 1011 1011 (% style="color:blue" %)**AT Command:** 1012 1012 1013 1013 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 1014 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 288px; 728 +|=(% 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** 1015 1015 |(% style="width:155px" %)((( 1016 1016 AT+TTRCHANNEL=1 1017 -)))|(% style="width:2 59px" %)(((1018 - Set as single channel, only use PA8 pin as interrupt pin.731 +)))|(% style="width:288px" %)((( 732 +set as single channel, only use PA8 pin as interrupt pin. 1019 1019 )))|(% style="width:44px" %)((( 1020 1020 OK 1021 1021 ))) 1022 1022 |(% style="width:155px" %)((( 1023 1023 AT+TTRCHANNEL=2 1024 -)))|(% style="width:2 59px" %)(((1025 - Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.738 +)))|(% style="width:288px" %)((( 739 +is set as dual channel, use PA8 pin and PA4 pin as interrupt pin. 1026 1026 )))|(% style="width:44px" %)((( 1027 1027 OK 1028 1028 ))) ... ... @@ -1032,96 +1032,55 @@ 1032 1032 Example: 0D aa => AT+TTRCHANNEL = second byte 1033 1033 1034 1034 1035 -=== 3.3. 8SetTimeSyncMode===749 +=== 3.3.7 Change the name of AT+TTRIG to AT+TTRIG1 === 1036 1036 1037 1037 1038 -Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command. 1039 - 1040 -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. 1041 - 1042 -(% style="color:blue" %)**AT Command:** 1043 - 1044 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 1045 -|=(% 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** 1046 -|(% style="width:155px" %)((( 1047 -AT+SYNCMOD=1 1048 -)))|(% style="width:259px" %)((( 1049 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone. 1050 -)))|(% style="width:44px" %)((( 1051 -OK 1052 -))) 1053 -|(% style="width:155px" %)((( 1054 -AT+SYNCMOD=1,8 1055 -)))|(% style="width:259px" %)((( 1056 -Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone. 1057 -)))|(% style="width:44px" %)((( 1058 -OK 1059 -))) 1060 -|(% 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 1061 - 1062 1062 (% style="color:blue" %)**Downlink Command:** 1063 1063 1064 - 0x2801~/~/ SameAsAT+SYNCMOD=1754 +Example: A9 01 aa bb cc => AT+TTRIG1= third byte, 4th byte and 5th byte 1065 1065 1066 -0x28 01 08 ~/~/ Same As AT+SYNCMOD=1,8 1067 1067 1068 - 0x2801 F4~/~/ Same As AT+SYNCMOD=1,-12757 +=== 3.3.8 Added AT+TTRIG2 for PB15 pin === 1069 1069 1070 -0x28 00 ~/~/ Same As AT+SYNCMOD=0 1071 1071 760 +(% style="color:blue" %)**Downlink Command:** 1072 1072 1073 - ===3.3.9Cleartheopendoortimes and thedurationofthelastopen door ===762 +Example: A9 02 aa bb cc => AT+TTRIG2= third byte, 4th byte and 5th byte 1074 1074 1075 1075 1076 - (%style="color:blue"%)**ATCommand:**765 +=== 3.3.9 TTRIG1/2 timeout status alarm === 1077 1077 1078 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1079 -|=(% 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** 1080 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)((( 1081 -OK 1082 -))) 1083 1083 1084 - (%style="color:blue"%)**DownlinkCommand:**(%%)0xA601768 +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. 1085 1085 1086 -The sensor will clear the open door times and the duration of the last open door. 1087 - 1088 - 1089 -=== 3.3.10 Set the count value of the number of open door === 1090 - 1091 - 1092 1092 (% style="color:blue" %)**AT Command:** 1093 1093 1094 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:50 0px" %)1095 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 2 88px;57px;background-color:#D9E2F3;color:#0070C0" %)**Response**772 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 773 +|=(% 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** 1096 1096 |(% style="width:155px" %)((( 1097 -AT+ SETCNT=1,1001098 -)))|(% style="width:2 59px" %)(((1099 - Set the opendoor times of PA8 pin100 times.1100 -)))|(% style="width:4 4px" %)(((775 +AT+TTRALARM=0 776 +)))|(% style="width:279px" %)((( 777 +disable continuous alarm 778 +)))|(% style="width:84px" %)((( 1101 1101 OK 1102 1102 ))) 1103 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK 1104 1104 |(% style="width:155px" %)((( 1105 -AT+ SETCNT=2,501106 -)))|(% style="width:2 59px" %)(((1107 - Set theopen doortimesofPA4 pino100 times.1108 -)))|(% style="width:4 4px" %)(((782 +AT+TTRALARM=60 783 +)))|(% style="width:279px" %)((( 784 +The alarm interval is 60 minutes (unit: minutes) 785 +)))|(% style="width:84px" %)((( 1109 1109 OK 1110 1110 ))) 1111 1111 1112 1112 (% style="color:blue" %)**Downlink Command:** 1113 1113 1114 - 0xA60100 00 64=>SETCNT=1,100791 +Example: 0C aa => AT+TTRALARM= aa 1115 1115 1116 -0xA6 01 00 00 00 ==> AT+SETCNT=1,0 1117 1117 1118 -0xA6 02 00 00 32 ==> AT+SETCNT=2,50 1119 - 1120 - 1121 1121 = 4. Battery & Power Consumption = 1122 1122 1123 1123 1124 -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.797 +DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 1125 1125 1126 1126 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 1127 1127 ... ... @@ -1129,7 +1129,7 @@ 1129 1129 = 5. OTA firmware update = 1130 1130 1131 1131 1132 -User can change firmware DS03A-LB /LSto:805 +User can change firmware DS03A-LB to: 1133 1133 1134 1134 * Change Frequency band/ region. 1135 1135 * Update with new features. ... ... @@ -1137,11 +1137,13 @@ 1137 1137 1138 1138 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]** 1139 1139 1140 -Methods to Update Firmware: 1141 1141 814 +**Methods to Update Firmware:** 815 + 1142 1142 * (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/]]** 1143 1143 * 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]]**. 1144 1144 819 + 1145 1145 = 6. FAQ = 1146 1146 1147 1147 ... ... @@ -1149,7 +1149,7 @@ 1149 1149 = 7. Order Info = 1150 1150 1151 1151 1152 - **Part Number: (% style="color:blue" %)DS03A-LB-XX(%%)or (% style="color:blue" %)DS03A-LS-XX(%%)**827 +Part Number: (% style="color:blue" %)**DS03A-LB-XX** 1153 1153 1154 1154 (% style="color:red" %)**XX**(%%): The default frequency band 1155 1155 ... ... @@ -1169,12 +1169,13 @@ 1169 1169 1170 1170 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1171 1171 847 + 1172 1172 = 8. Packing Info = 1173 1173 1174 1174 1175 1175 (% style="color:#037691" %)**Package Includes**: 1176 1176 1177 -* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor853 +* DS03A-LB LoRaWAN Temperature Sensor 1178 1178 1179 1179 (% style="color:#037691" %)**Dimension and weight**: 1180 1180 ... ... @@ -1186,6 +1186,7 @@ 1186 1186 1187 1187 * Weight / pcs : g 1188 1188 865 + 1189 1189 = 9. Support = 1190 1190 1191 1191
- 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