Changes for page DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual
Last modified by Mengting Qiu on 2025/01/10 09:53
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Saxer - Content
-
... ... @@ -140,7 +140,7 @@ 140 140 == 1.7 BLE connection == 141 141 142 142 143 -D 2x-LB support BLE remote configure.143 +DS03A-LB 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: ... ... @@ -152,9 +152,13 @@ 152 152 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 153 153 154 154 155 -== 1.8 Mechanical==155 +== 1.8 Pin Definitions == 156 156 157 +[[image:image-20230630160843-7.png]] 157 157 159 +== 1.9 Mechanical == 160 + 161 + 158 158 [[image:Main.User Manual for LoRaWAN End Nodes.LDS03A - Outdoor LoRaWAN OpenClose Door Sensor Manual.WebHome@1654741444887-479.png||height="399" width="513"]] 159 159 160 160 ... ... @@ -172,7 +172,7 @@ 172 172 == 2.1 How it works == 173 173 174 174 175 -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 0minutes.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. 176 176 177 177 178 178 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == ... ... @@ -180,7 +180,7 @@ 180 180 181 181 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example. (% style="display:none" %) 182 182 183 -The LPS8 V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.187 +The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server. 184 184 185 185 [[image:image-20230522092858-1.png||height="391" width="874"]] 186 186 ... ... @@ -244,42 +244,42 @@ 244 244 245 245 Example parse in TTNv3 246 246 247 -[[image: http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609104802-1.png?rev=1.1||alt="image-20220609104802-1.png"height="393" width="1195"]]251 +[[image:image-20230630155406-1.png||height="190" width="873"]] 248 248 249 249 250 -(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x 0B254 +(% style="color:#037691" %)**Sensor Model**(%%): For DS03A-LB, this value is 0x1B 251 251 252 252 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 253 253 254 254 (% style="color:#037691" %)**Frequency Band**: 255 255 256 - *0x01: EU868260 +0x01: EU868 257 257 258 - *0x02: US915262 +0x02: US915 259 259 260 - *0x03: IN865264 +0x03: IN865 261 261 262 - *0x04: AU915266 +0x04: AU915 263 263 264 - *0x05: KZ865268 +0x05: KZ865 265 265 266 - *0x06: RU864270 +0x06: RU864 267 267 268 - *0x07: AS923272 +0x07: AS923 269 269 270 - *0x08: AS923-1274 +0x08: AS923-1 271 271 272 - *0x09: AS923-2276 +0x09: AS923-2 273 273 274 - *0x0a: AS923-3278 +0x0a: AS923-3 275 275 276 - *0x0b: CN470280 +0x0b: CN470 277 277 278 - *0x0c: EU433282 +0x0c: EU433 279 279 280 - *0x0d: KR920284 +0x0d: KR920 281 281 282 - *0x0e: MA869286 +0x0e: MA869 283 283 284 284 285 285 (% style="color:#037691" %)**Sub-Band**: ... ... @@ -300,9 +300,47 @@ 300 300 Ex2: 0x0B49 = 2889mV 301 301 302 302 303 -=== 2.3.2 Real-Time Open/CloseStatus, UplinkFPORT~=2===307 +=== (% id="cke_bm_182700S" style="display:none" %) (%%)2.3.2 Sensor Configuration, FPORT~=4 === 304 304 305 305 310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 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) 316 + 317 +* ((( 318 +(% style="color:blue" %)**TDC: (default: 0x001C20)** 319 +))) 320 + 321 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 322 + 323 + 324 +* ((( 325 +(% style="color:blue" %)**Disalarm: (default: 0)** 326 +))) 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. 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. 331 + 332 + 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 + 335 + 336 +* ((( 337 +(% style="color:blue" %)**Keep Status & Keep Time** 338 +))) 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]] 341 + 342 +[[image:image-20230630155527-3.png||height="146" width="902"]] 343 + 344 + 345 +=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 346 + 347 + 306 306 DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when: 307 307 308 308 * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. ... ... @@ -310,26 +310,32 @@ 310 310 311 311 Uplink Payload totals 11 bytes. 312 312 313 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 20px" %)314 -|=(% colspan="5" style="background-color: rgb(217, 226, 243);rgb(0, 112, 192);22px;" %)**Real-Time Open/Close Status, FPORT=2**315 -|(% style="width:9 5px" %)**Size(bytes)**|(% style="width:78px" %)**1**|(% style="width:98px" %)**3**|(% style="width:144px" %)**3**|(% style="width:108px" %)**4**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** 357 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:77px" %)**1**|(% style="width:97px" %)**3**|(% style="width:143px" %)**3**|(% style="width:107px" %)**4** 316 316 |(% style="width:95px" %)**Value**|(% style="width:78px" %)Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]|(% style="width:98px" %)Total open door events|(% style="width:144px" %)((( 317 317 The last door open duration (unit: min) 318 318 )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 319 319 320 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:518.818px" %) 321 -|=(% colspan="4" style="background-color: rgb(217, 226, 243); color: rgb(0, 112, 192); width: 516px;" %)**Status & Alarm field** 322 -|(% style="width:76px" %)**Size(bit)**|(% style="width:70px" %)**6**|(% style="width:240px" %)**1**|(% style="width:130px" %)**1** 323 -|(% style="width:76px" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:240px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]] 324 -0: No Alarm; 1: Alarm|(% style="width:130px" %)Status 325 -0: Close, 1: Open 362 +**Status & Alarm:** 326 326 327 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110547-6.png?width=1191&height=337&rev=1.1||alt="image-20220609110547-6.png" height="337" width="1191"]] 364 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 365 +|(% 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** 366 +|(% style="width:76px" %)**Value**|(% style="width:79px" %)((( 367 +No ACK Message 368 +)))|(% style="width:84px" %)((( 369 +Poll Message Flag 370 +)))|(% style="width:96px" %)Reserve|(% style="width:197px" %)[[Enable/disable Timeout Alarm>>||anchor="H3.3.3A0Enable2FDisableAlarm"]] 371 +0: No Alarm; 1: Alarm|(% style="width:104px" %)Status 0: Close, 1: Open 328 328 373 +[[image:image-20230630155451-2.png||height="246" width="928"]] 329 329 330 - === 2.3.3 Historical Door Open/CloseEvent, FPORT~=3===375 +[[image:image-20230630155908-6.png||height="295" width="927"]] 331 331 332 332 378 +=== 2.3.4 Historical Door Open/Close Event, FPORT~=3 === 379 + 380 + 333 333 DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 334 334 335 335 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. ... ... @@ -358,82 +358,40 @@ 358 358 359 359 If DS03A-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 360 360 361 -[[image: http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609112215-7.png?width=1250&height=277&rev=1.1||alt="image-20220609112215-7.png"height="277" width="1250"]]409 +[[image:image-20230630155556-4.png||height="146" width="938"]] 362 362 363 363 **Downlink:** 364 364 365 -0x31 6 18E57 40618E817005413 +0x31 64 9E 7D 34 64 9E 7E 9C 05 366 366 367 367 368 368 **Uplink:** 369 369 370 - 0000 00 00 00 00 00 618E5F8F0100 00 010000 00 618E5FD20000 00 01 00 0002618E6064 0100 00 0200 0002618E60750000 00 02 00 0001618E60C60000 00 02 00 0001 618E 7BA70100 00 03 00 000161 8E 7F38 00 00 00 03 00 00 02618E 7F CE01 00 00 04 00 00 0261 8E 81 1B00 00 00 04 00 00 00 61 8E 81 50418 +45 00 00 00 00 00 00 64 9E 7D 48 40 00 00 00 00 00 63 64 9E 7D 9C 41 00 00 01 00 00 63 64 9E 7D A4 40 00 00 01 00 00 8D 64 9E 7E 31 43 00 00 02 00 00 8D 64 9E 7E 44 48 00 00 02 00 00 1F 64 9E 7E 59 4B 00 00 03 00 00 1F 64 9E 7E 6B 371 371 372 372 373 373 **Parsed Value:** 374 374 375 -[ALARM, DOOR_ OPEN_STATUS, DOOR_OPEN_TIMES,LAST_DOOR_OPEN_DURATION, TIME]423 +[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, DOOR_OPEN_TIMES, LAST_DOOR_OPEN_DURATION, TIME] 376 376 377 377 378 -[FALSE, CLOSE,1-11-1212:35:27],426 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20], 379 379 380 -[FALSE, PEN,1,0,1-11-1212:36:34],428 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44], 381 381 382 -[FALSE, CLOSE, 1,2,1-11-1212:39:00],430 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52], 383 383 384 -[FALSE, PEN,2,2,1-11-1212:39:17],432 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13], 385 385 386 -[ FALSE,CLOSE, 2,1-11-1212:40:38],434 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32], 387 387 388 -[FALSE, 1-11-1214:35:19],436 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53], 389 389 390 -[ FALSE,1-11-1214:50:32],438 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11], 391 391 392 -[ FALSE, CLOSE, 3,2, 2021-11-1214:53:02],440 +[[image:image-20230630155751-5.png||height="188" width="809"]] 393 393 394 -[FALSE, OPEN, 4, 2, 2021-11-12 14:58:35], 395 395 396 -[FALSE, CLOSE, 4, 0, 2021-11-12 14:59:28], 397 - 398 - 399 -=== 2.3.4 Sensor Configuration, FPORT~=4 === 400 - 401 - 402 -DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server. 403 - 404 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 405 -|(% colspan="5" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 406 -|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2** 407 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: min) 408 - 409 -* ((( 410 -(% style="color:blue" %)**TDC: (default: 0x001C20)** 411 -))) 412 - 413 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 414 - 415 - 416 -* ((( 417 -(% style="color:blue" %)**Disalarm: (default: 0)** 418 -))) 419 - 420 - **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. 421 - 422 - **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. 423 - 424 - 425 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** 426 - 427 - 428 -* ((( 429 -(% style="color:blue" %)**Keep Status & Keep Time** 430 -))) 431 - 432 -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]] 433 - 434 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/image-20220609110018-4.png?width=1159&height=291&rev=1.1||alt="image-20220609110018-4.png" height="291" width="1159"]] 435 - 436 - 437 437 == 2.4 Payload Decoder file == 438 438 439 439 ... ... @@ -723,7 +723,7 @@ 723 723 |(% style="width:155px" %)((( 724 724 AT+TTRCHANNEL=1 725 725 )))|(% style="width:288px" %)((( 726 -set as single channel, only use P B14pin as interrupt pin.732 +set as single channel, only use PA8 pin as interrupt pin. 727 727 )))|(% style="width:44px" %)((( 728 728 OK 729 729 ))) ... ... @@ -730,7 +730,7 @@ 730 730 |(% style="width:155px" %)((( 731 731 AT+TTRCHANNEL=2 732 732 )))|(% style="width:288px" %)((( 733 -is set as dual channel, use P B14pin and PB15pin as interrupt pin.739 +is set as dual channel, use PA8 pin and PA4 pin as interrupt pin. 734 734 )))|(% style="width:44px" %)((( 735 735 OK 736 736 ))) ... ... @@ -785,32 +785,6 @@ 785 785 Example: 0C aa => AT+TTRALARM= aa 786 786 787 787 788 -=== 3.3.10 Select counting mode === 789 - 790 - 791 -(% style="color:blue" %)**AT+TTRMODx=a,b** 792 - 793 -When (% style="color:#037691" %)**a=0**(%%), the door is opened to count, and when (% style="color:#037691" %)**a=1**(%%),the closed door is counted. 794 - 795 -When (% style="color:#037691" %)**b=0**(%%), it is the last door open duration, and when (% style="color:#037691" %)**b=1**(%%),the last door close duration. 796 - 797 -(% style="color:blue" %)**AT Command:** 798 - 799 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 800 -|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 278px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 77px;background-color:#D9E2F3;color:#0070C0" %)**Response** 801 -|(% style="width:155px" %)((( 802 -AT+TTRMODx=1,0 803 -)))|(% style="width:278px" %)Door closed count and record the last door opened duration|(% style="width:85px" %)((( 804 -OK 805 -))) 806 -|(% style="width:155px" %)((( 807 -AT+TTRMODx=0,1 808 -)))|(% style="width:278px" %)((( 809 -Door opened count and record the last door Door Door open closed duration 810 -)))|(% style="width:85px" %)((( 811 -OK 812 -))) 813 - 814 814 = 4. Battery & Power Consumption = 815 815 816 816 ... ... @@ -831,10 +831,10 @@ 831 831 Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]** 832 832 833 833 834 -Methods to Update Firmware: 814 +**Methods to Update Firmware:** 835 835 836 -* (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/]] 837 -* 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]]**.816 +* (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/]]** 817 +* 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]]**. 838 838 839 839 = 6. FAQ = 840 840
- image-20230630155406-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +41.8 KB - Content
- image-20230630155451-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +77.2 KB - Content
- image-20230630155527-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +39.2 KB - Content
- image-20230630155556-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +38.4 KB - Content
- image-20230630155751-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +37.1 KB - Content
- image-20230630155908-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +90.8 KB - Content
- image-20230630160843-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Saxer - Size
-
... ... @@ -1,0 +1,1 @@ 1 +511.7 KB - Content