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, 4 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -DS03A-LB Outdoor LoRaWAN Door Sensor User Manual 1 +DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Saxer1 +XWiki.Xiaoling - Content
-
... ... @@ -1,9 +1,18 @@ 1 +(% style="display:none" %) (%%) 2 + 1 1 (% style="text-align:center" %) 2 -[[image:image-202 30516085523-1.jpeg||height="491" width="491"]]4 +[[image:image-20240108161155-2.png]] 3 3 4 4 5 -**Table of Contents:** 6 6 8 + 9 + 10 + 11 + 12 + 13 + 14 +**Table of Contents:** 15 + 7 7 {{toc/}} 8 8 9 9 ... ... @@ -13,41 +13,41 @@ 13 13 14 14 = 1. Introduction = 15 15 16 -== 1.1 What is DS03A-LB LoRaWAN Door Sensor ==25 +== 1.1 What is LoRaWAN Door Sensor == 17 17 18 18 19 19 ((( 20 -The Dragino DS03A-LB is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server. 29 +The Dragino DS03A-LB/LS is a (% style="color:blue" %)**LoRaWAN Door Sensor**(%%) for Internet of Things solution. It detects door open/close status and uplinks to IoT server via LoRaWAN network. user can see the door status, open duration, open counts in the IoT Server. 21 21 ))) 22 22 23 23 ((( 24 -The LoRa wireless technology used in DS03A-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. 33 +The LoRa wireless technology used in DS03A-LB/LS allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. 25 25 ))) 26 26 27 27 ((( 28 -The DS03A-LB will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB can count each open event and uplink periodically. 37 +The DS03A-LB/LS will send periodically data every 2 hours as well as for each door open/close action. It also counts the door open times and calculates the last door open duration. Users can also disable the uplink for each open/close event, instead, DS03A-LB/LS can count each open event and uplink periodically. 29 29 ))) 30 30 31 31 ((( 32 -DS03A-LB supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover. 41 +DS03A-LB/LS supports (% style="color:blue" %)**Datalog Feature,**(%%) it can save the data when there is no LoRaWAN network and uplink when network recover. 33 33 ))) 34 34 35 35 ((( 36 -DS03A-LB has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time. 45 +DS03A-LB/LS has the (% style="color:blue" %)**Open Alarm Feature**(%%), user can set this feature so the device will send an alarm if the door has been open for a certain time. 37 37 38 -DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures 47 +DS03A-LB/LS is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures 39 39 ))) 40 40 41 41 ((( 42 -DS03A-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 51 +DS03A-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 43 43 ))) 44 44 45 45 ((( 46 -DS03A-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 55 +DS03A-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + li-on battery**(%%), it is designed for long term use up to 5 years. 47 47 ))) 48 48 49 49 ((( 50 -Each DS03A-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on. 59 +Each DS03A-LB/LS is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on. 51 51 ))) 52 52 53 53 ... ... @@ -67,9 +67,10 @@ 67 67 * Support wireless OTA update firmware 68 68 * Uplink on periodically 69 69 * Downlink to change configure 70 -* 8500mAh Battery for long term use 71 71 * Wall Mountable 72 72 * Outdoor Use 81 +* 8500mAh Li/SOCl2 Battery (DS03A-LB) 82 +* Solar panel + 3000mAh Li-on battery (DS03A-LS) 73 73 74 74 == 1.3 Specification == 75 75 ... ... @@ -76,14 +76,9 @@ 76 76 77 77 (% style="color:#037691" %)**Common DC Characteristics:** 78 78 79 -* Supply Voltage: built8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v89 +* Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v 80 80 * Operating Temperature: -40 ~~ 85°C 81 81 82 -(% style="color:#037691" %)**Sensor Detect Distance:** 83 - 84 -* Wood Door: 10mm ~~ 30mm 85 -* Iron Door: 30 ~~ 45mm 86 - 87 87 (% style="color:#037691" %)**LoRa Spec:** 88 88 89 89 * Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz ... ... @@ -121,11 +121,10 @@ 121 121 == 1.6 Button & LEDs == 122 122 123 123 124 -[[image: Main.User.PS-LB--LoRaWANPressureSensor.WebHome@1675071855856-879.png]]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"]] 125 125 126 - 127 127 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 128 -|=(% 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**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** 129 129 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 130 130 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 131 131 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -140,7 +140,7 @@ 140 140 == 1.7 BLE connection == 141 141 142 142 143 -DS03A-LB support BLE remote configure. 147 +DS03A-LB/LS support BLE remote configure. 144 144 145 145 146 146 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,27 +156,40 @@ 156 156 157 157 [[image:image-20230630160843-7.png]] 158 158 163 + 159 159 == 1.9 Mechanical == 160 160 166 +=== 1.9.1 for LB version === 161 161 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 +(% style="color:blue" %)**Probe Mechanical:** 172 + 162 162 [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]] 163 163 164 164 165 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143884058-338.png]] 166 166 177 +=== 1.9.2 for LS version === 167 167 168 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143899218-599.png]] 169 169 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"]] 170 170 171 -[[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]] 172 172 173 173 174 -= 2. Configure DS03A-LB to connect to LoRaWAN network = 175 175 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 + 176 176 == 2.1 How it works == 177 177 178 178 179 -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. 196 +The DS03A-LB/LS is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS03A-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 2 hours. 180 180 181 181 182 182 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -189,9 +189,9 @@ 189 189 [[image:image-20230522092858-1.png||height="391" width="874"]] 190 190 191 191 192 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB. 209 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS03A-LB/LS. 193 193 194 -Each DS03A-LB is shipped with a sticker with the default device EUI as below: 211 +Each DS03A-LB/LS is shipped with a sticker with the default device EUI as below: 195 195 196 196 [[image:image-20230426085205-1.png||height="238" width="512"]] 197 197 ... ... @@ -221,10 +221,10 @@ 221 221 [[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"]] 222 222 223 223 224 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB 241 +(% style="color:blue" %)**Step 2:**(%%) Activate on DS03A-LB/LS 225 225 226 226 227 -Press the button for 5 seconds to activate the DS03A-LB. 244 +Press the button for 5 seconds to activate the DS03A-LB/LS. 228 228 229 229 (% 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. 230 230 ... ... @@ -236,13 +236,15 @@ 236 236 === 2.3.1 Device Status, FPORT~=5 === 237 237 238 238 239 - Users cansethedownlinkcommand(**0x2601**)toaskDS03A-LBtosenddeviceconfiguredetail,includedeviceconfigurestatus.DS03A-LB will uplinka payloadviaFPort=5toserver.256 +Include device configure status. Once DS03A-LB/LS Joined the network, it will uplink this message to the server. After that, DS03A-LB/LS will uplink Device Status every 12 hours. 240 240 241 - ThePayloadformat is asbelow.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. 242 242 243 243 261 +The Payload format is as below. 262 + 244 244 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 245 -|(% colspan="6" style="background-color:# d9e2f3;#0070c0" %)**Device Status (FPORT=5)**264 +|(% colspan="6" style="background-color:#4F81BD;color:white" %)**Device Status (FPORT=5)** 246 246 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** 247 247 |(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT 248 248 ... ... @@ -251,7 +251,7 @@ 251 251 [[image:image-20230630155406-1.png||height="190" width="873"]] 252 252 253 253 254 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B 273 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB/LS, this value is 0x1B 255 255 256 256 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 257 257 ... ... @@ -304,16 +304,29 @@ 304 304 Ex2: 0x0B49 = 2889mV 305 305 306 306 307 -=== (% style="color:inherit; font-family:inherit; font-size:23px" %)2.3.2 Sensor Configuration, FPORT~=4(%%)===326 +=== 2.3.2 Sensor Configuration, FPORT~=4 === 308 308 309 309 310 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 329 +DS03A-LB/LS will only send this command after getting the downlink command **(0x26 02)** from the server. 311 311 312 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 313 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 314 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2** 315 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min) 331 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 332 +|(% colspan="8" style="background-color:#4F81BD;color:white; 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 +))) 316 316 344 +Example parse in TTNv3 345 + 346 +[[image:image-20230630155527-3.png||height="146" width="902"]] 347 + 348 + 317 317 * ((( 318 318 (% style="color:blue" %)**TDC: (default: 0x001C20)** 319 319 ))) ... ... @@ -325,9 +325,9 @@ 325 325 (% style="color:blue" %)**Disalarm: (default: 0)** 326 326 ))) 327 327 328 - **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. 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. 329 329 330 - **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. 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. 331 331 332 332 333 333 (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** ... ... @@ -334,31 +334,35 @@ 334 334 335 335 336 336 * ((( 337 -(% style="color:blue" %)**Keep Status & Keep Time** 369 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2** 338 338 ))) 339 339 340 -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]]372 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 341 341 342 -[[image:image-20230630155527-3.png||height="146" width="902"]] 343 343 344 344 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 + 345 345 === 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 346 346 347 347 348 -DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 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: 349 349 350 -* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 388 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]]. 351 351 * There is an Open/Close event. (This info can be disabled by AT+DISALARM=1) 352 352 353 -Uplink Payload totals 11 bytes. 391 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)** 354 354 355 355 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 356 -|=(% colspan="5" style="background-color:# D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**394 +|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2** 357 357 |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4** 358 358 |(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 359 -Status 360 - 361 -&[[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]] 397 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]] 362 362 )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 363 363 The last door open duration (unit: sec) 364 364 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] ... ... @@ -365,27 +365,193 @@ 365 365 366 366 **Status & Alarm:** 367 367 368 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width: 680px" %)369 -|(% style="background-color:#d9e2f3; color:#0070c0; width:5 9px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:79px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:110px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:106px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:167px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:122px" %)**bit0**370 -|(% style="width:76px" %) **Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((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" %)((( 371 371 Count mod 372 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:167px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]] 373 -0: No Alarm; 1: Alarm|(% style="width:122px" %)Status 0: Close, 1: Open 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 +))) 374 374 375 375 [[image:image-20230630155451-2.png||height="246" width="928"]] 376 376 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:#4F81BD;color:white; 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 + 377 377 [[image:image-20230630155908-6.png||height="295" width="927"]] 378 378 379 379 509 +* ((( 510 +(% style="color:blue" %)**Count mod:Default=0** 511 +))) 512 + 513 +0: Uplink total open door times since factory 514 + 515 +1: Uplink total open door times since last FPORT=2 uplink. 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 + 380 380 === 2.3.4 Historical Door Open/Close Event, FPORT~=3 === 381 381 382 382 383 -DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 562 +DS03A-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 384 384 385 385 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 386 386 566 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 567 +|=(% colspan="5" style="background-color:#4F81BD;color:white;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 + 387 387 * ((( 388 -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.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/LS will send max bytes according to the current DR and Frequency bands. 389 389 ))) 390 390 391 391 For example, in the US915 band, the max payload for different DR is: ... ... @@ -422,7 +422,7 @@ 422 422 423 423 **Parsed Value:** 424 424 425 -[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME]627 +[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME] 426 426 427 427 428 428 [SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20], ... ... @@ -439,7 +439,7 @@ 439 439 440 440 [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11], 441 441 442 -[[image:image-202306301 55751-5.png||height="188" width="809"]]644 +[[image:image-20230630172740-1.png||height="199" width="868"]] 443 443 444 444 445 445 == 2.4 Payload Decoder file == ... ... @@ -457,26 +457,25 @@ 457 457 == 2.5 Datalog Feature == 458 458 459 459 460 -(% 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. 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/LS will store the reading for future retrieving purposes. 461 461 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.** 462 462 666 + 463 463 === 2.5.1 Ways to get datalog via LoRaWAN === 464 464 465 465 466 -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. 670 +Set PNACKMD=1, DS03A-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, DS03A-LB/LS will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery. 467 467 468 -* a) DS03A-LB will do an ACK check for data records sending to make sure every data arrive server. 469 -* 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. 672 +* a) DS03A-LB/LS will do an ACK check for data records sending to make sure every data arrive server. 673 +* b) DS03A-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but DS03A-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DS03A-LB/LS gets a ACK, DS03A-LB/LS will consider there is a network connection and resend all NONE-ACK Message. 470 470 471 -Below is the typical case for the Datalog Feature (Set PNACKMD=1) 472 472 473 -[[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"]] 474 474 475 - 476 476 === 2.5.2 Unix TimeStamp === 477 477 478 478 479 -DS03A-LB uses Unix TimeStamp format based on 680 +DS03A-LB/LS uses Unix TimeStamp format based on 480 480 481 481 [[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"]] 482 482 ... ... @@ -494,7 +494,7 @@ 494 494 495 495 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 496 496 497 -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). 698 +Once DS03A-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS03A-LB/LS. If DS03A-LB/LS fails to get the time from the server, DS03A-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 498 498 499 499 (% 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.** 500 500 ... ... @@ -507,7 +507,7 @@ 507 507 508 508 (% 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]] 509 509 510 -(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB in Datacake.** 711 +(% style="color:blue" %)**Step 2:**(%%)** Configure DS03A-LB/LS in Datacake.** 511 511 512 512 [[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"]] 513 513 ... ... @@ -542,7 +542,7 @@ 542 542 == 2.7 Frequency Plans == 543 543 544 544 545 -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. 746 +The DS03A-LB/LS 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. 546 546 547 547 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 548 548 ... ... @@ -553,12 +553,12 @@ 553 553 **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0>>https://www.dropbox.com/sh/b0uwyzjs4px4eao/AADvI7fPRwsFKTglEmaRRuaaa?dl=0]] 554 554 555 555 556 -= 3. Configure DS03A-LB = 757 += 3. Configure DS03A-LB/LS = 557 557 558 558 == 3.1 Configure Methods: == 559 559 560 560 561 -DS03A-LB supports below configure method: 762 +DS03A-LB/LS supports below configure method: 562 562 563 563 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 564 564 * 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]]. ... ... @@ -577,13 +577,13 @@ 577 577 [[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/]] 578 578 579 579 580 -== 3.3 Commands special design for DS03A-LB == 781 +== 3.3 Commands special design for DS03A-LB/LS == 581 581 582 582 583 -These commands only valid for DS03A-LB, as below: 784 +These commands only valid for DS03A-LB/LS, as below: 584 584 585 585 586 -=== 3.3.1 Set Transmit Interval Time === 787 +=== 3.3.1 Set Transmit Interval Time === 587 587 588 588 589 589 Feature: Change LoRaWAN End Node Transmit Interval. ... ... @@ -611,16 +611,36 @@ 611 611 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 612 612 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 613 613 614 -=== 3.3.2 GetDeviceStatus===815 +=== 3.3.2 Set Power Output Duration === 615 615 616 616 617 - SendaLoRaWANdownlinkto askdevicesend Alarm settings.818 +Control the output duration 5V . Before each sampling, device will 618 618 619 - *(%style="color:blue"%)**DownlinkPayload:**(%%)0x2601820 +~1. first enable the power output to external sensor, 620 620 621 - SensorwilluploadDeviceStatus viaFPORT=5. Seepayload sectionfor detail.822 +2. keep it on as per duration, read sensor value and construct uplink payload 622 622 824 +3. final, close the power output. 623 623 826 +(% style="color:blue" %)**AT Command: AT+5VT** 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 + 624 624 === 3.3.3 Enable / Disable Alarm === 625 625 626 626 ... ... @@ -628,8 +628,8 @@ 628 628 629 629 (% style="color:blue" %)**AT Command: ** 630 630 631 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 20px" %)632 -|(% style="background-color:#d9e2f3; color:#0070c0; width:15 4px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response**852 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 853 +|(% 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** 633 633 |(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 634 634 |(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 635 635 ... ... @@ -643,9 +643,8 @@ 643 643 === 3.3.4 Alarm Base on Timeout === 644 644 645 645 646 -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: 867 +DS03A-LB/LS can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are: 647 647 648 - 649 649 * ((( 650 650 (% style="color:blue" %)**Keep Status: Status to be monitor** 651 651 ))) ... ... @@ -666,42 +666,104 @@ 666 666 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. 667 667 668 668 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 + 669 669 (% style="color:blue" %)**AT Command to configure:** 670 670 671 671 * ((( 672 -(% 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. 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. 673 673 ))) 674 674 675 675 * ((( 676 -(% style="color:#037691" %)**AT+TTRIG=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 915 +(% style="color:#037691" %)**AT+TTRIG1=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 916 + 917 + 918 + 677 677 ))) 678 678 679 679 (% style="color:blue" %)**Downlink Command to configure:** 680 680 681 - (%style="color:#037691"%)**Command:0xA9 aabbcc**923 +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. 682 682 683 -**A9:** Command Type Code 684 684 685 -** aa:**statustobemonitored926 +**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)** 686 686 687 - **bbcc:**timeout.928 +(% style="color:blue" %)**AT Command to configure:** 688 688 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. 689 689 690 -If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 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 +))) 691 691 692 -Or 936 +* ((( 937 +(% style="color:#037691" %)**AT+TTRIG2=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 693 693 694 -0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 695 695 940 + 941 +))) 696 696 697 -= ==3.3.5CountMod===943 +(% style="color:blue" %)**Downlink Command to configure:** 698 698 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. 699 699 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 + 700 700 (% style="color:blue" %)**AT Command:** 701 701 702 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 20px" %)703 -|=(% 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**955 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 956 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 279px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 76px;background-color:#4F81BD;color:white" %)**Response** 704 704 |(% 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:#4F81BD;color:white" %)**Command Example**|=(% style="width: 275px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 86px;background-color:#4F81BD;color:white" %)**Response** 986 +|(% style="width:155px" %)((( 705 705 AT+COUNTMOD=0 706 706 )))|(% style="width:277px" %)((( 707 707 the count value keeps accumulating mode ... ... @@ -711,7 +711,7 @@ 711 711 |(% style="width:155px" %)((( 712 712 AT+COUNTMOD=1 713 713 )))|(% style="width:277px" %)((( 714 -the count value will be reset after each TDC time (Last Close Duration Reset after each uplink)996 +the count value will be reset after each TDC time(Last Close Duration Reset after each uplink) 715 715 )))|(% style="width:86px" %)((( 716 716 OK 717 717 ))) ... ... @@ -721,24 +721,26 @@ 721 721 Example: 0B aa => AT+COUNTMOD = second byte 722 722 723 723 724 -=== 3.3. 6InterruptPinChannelMod ===1006 +=== 3.3.7 Number of channel of door sensors === 725 725 726 726 1009 +Feature: Set the number of door sensor channels. 1010 + 727 727 (% style="color:blue" %)**AT Command:** 728 728 729 729 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 730 -|=(% 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**1014 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response** 731 731 |(% style="width:155px" %)((( 732 732 AT+TTRCHANNEL=1 733 -)))|(% style="width:2 88px" %)(((734 - set as single channel, only use PA8 pin as interrupt pin.1017 +)))|(% style="width:259px" %)((( 1018 +Set as single channel, only use PA8 pin as interrupt pin. 735 735 )))|(% style="width:44px" %)((( 736 736 OK 737 737 ))) 738 738 |(% style="width:155px" %)((( 739 739 AT+TTRCHANNEL=2 740 -)))|(% style="width:2 88px" %)(((741 - is set as dual channel, use PA8 pin and PA4 pin as interrupt pin.1024 +)))|(% style="width:259px" %)((( 1025 +Set as dual channel, use PA8 pin and PA4 pin as interrupt pin. 742 742 )))|(% style="width:44px" %)((( 743 743 OK 744 744 ))) ... ... @@ -748,55 +748,96 @@ 748 748 Example: 0D aa => AT+TTRCHANNEL = second byte 749 749 750 750 751 -=== 3.3. 7ChangehenameofAT+TTRIG toAT+TTRIG1===1035 +=== 3.3.8 Set Time Sync Mode === 752 752 753 753 754 - (%style="color:blue"%)**DownlinkCommand:**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. 755 755 756 - Example:A901 aabbcc=> AT+TTRIG1=thirdbyte,4thbyteand5thbyte1040 +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. 757 757 1042 +(% style="color:blue" %)**AT Command:** 758 758 759 -=== 3.3.8 Added AT+TTRIG2 for PB15 pin === 1044 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 1045 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response** 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 760 760 761 - 762 762 (% style="color:blue" %)**Downlink Command:** 763 763 764 - Example:A902aabbcc=> AT+TTRIG2= thirdbyte, 4thbyteand5thbyte1064 +0x28 01 ~/~/ Same As AT+SYNCMOD=1 765 765 1066 +0x28 01 08 ~/~/ Same As AT+SYNCMOD=1,8 766 766 767 - ===3.3.9TTRIG1/2timeoutstatusalarm===1068 +0x28 01 F4 ~/~/ Same As AT+SYNCMOD=1,-12 768 768 1070 +0x28 00 ~/~/ Same As AT+SYNCMOD=0 769 769 770 -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. 771 771 1073 +=== 3.3.9 Clear the open door times and the duration of the last open door === 1074 + 1075 + 772 772 (% style="color:blue" %)**AT Command:** 773 773 774 774 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 775 -|=(% 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** 1079 +|=(% style="width: 163px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 290px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response** 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 + 1084 +(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01 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 +(% style="color:blue" %)**AT Command:** 1093 + 1094 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 1095 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response** 776 776 |(% style="width:155px" %)((( 777 -AT+TT RALARM=0778 -)))|(% style="width:2 79px" %)(((779 - disablecontinuousalarm780 -)))|(% style="width: 84px" %)(((1097 +AT+SETCNT=1,100 1098 +)))|(% style="width:259px" %)((( 1099 +Set the open door times of PA8 pin to 100 times. 1100 +)))|(% style="width:44px" %)((( 781 781 OK 782 782 ))) 1103 +|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK 783 783 |(% style="width:155px" %)((( 784 -AT+TT RALARM=60785 -)))|(% style="width:2 79px" %)(((786 - Thealarm intervalis60minutes(unit:minutes)787 -)))|(% style="width: 84px" %)(((1105 +AT+SETCNT=2,50 1106 +)))|(% style="width:259px" %)((( 1107 +Set the open door times of PA4 pin to 100 times. 1108 +)))|(% style="width:44px" %)((( 788 788 OK 789 789 ))) 790 790 791 791 (% style="color:blue" %)**Downlink Command:** 792 792 793 - Example:0Caa=> AT+TTRALARM=aa1114 +0xA6 01 00 00 64 ==> AT+SETCNT=1,100 794 794 1116 +0xA6 01 00 00 00 ==> AT+SETCNT=1,0 795 795 1118 +0xA6 02 00 00 32 ==> AT+SETCNT=2,50 1119 + 1120 + 796 796 = 4. Battery & Power Consumption = 797 797 798 798 799 -DS03A-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 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. 800 800 801 801 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 802 802 ... ... @@ -804,7 +804,7 @@ 804 804 = 5. OTA firmware update = 805 805 806 806 807 -User can change firmware DS03A-LB to: 1132 +User can change firmware DS03A-LB/LS to: 808 808 809 809 * Change Frequency band/ region. 810 810 * Update with new features. ... ... @@ -812,9 +812,8 @@ 812 812 813 813 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]** 814 814 1140 +Methods to Update Firmware: 815 815 816 -**Methods to Update Firmware:** 817 - 818 818 * (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/]]** 819 819 * 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]]**. 820 820 ... ... @@ -825,7 +825,7 @@ 825 825 = 7. Order Info = 826 826 827 827 828 -Part Number: (% style="color:blue" %) **DS03A-LB-XX**1152 +**Part Number: (% style="color:blue" %)DS03A-LB-XX (%%)or (% style="color:blue" %)DS03A-LS-XX(%%)** 829 829 830 830 (% style="color:red" %)**XX**(%%): The default frequency band 831 831 ... ... @@ -850,7 +850,7 @@ 850 850 851 851 (% style="color:#037691" %)**Package Includes**: 852 852 853 -* DS03A-LB LoRaWAN Temperature Sensor 1177 +* DS03A-LB or DS03A-LS LoRaWAN Temperature Sensor 854 854 855 855 (% style="color:#037691" %)**Dimension and weight**: 856 856
- image-20230630172740-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +37.1 KB - Content
- image-20230701094042-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +34.5 KB - Content
- image-20240108160443-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +500.2 KB - Content
- image-20240108161155-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +265.7 KB - Content