Last modified by Mengting Qiu on 2025/01/10 09:53
<
From version < 38.8 >
edited by Xiaoling
on 2023/12/14 14:44
To version < 34.48 >
edited by Xiaoling
on 2023/07/01 15:27
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,7 @@
2 2  [[image:image-20230516085523-1.jpeg||height="491" width="491"]]
3 3  
4 4  
5 -**Table of Contents:**
5 +**Table of Contents：**
6 6  
7 7  {{toc/}}
8 8  
... ... @@ -79,6 +79,11 @@
79 79  * Supply Voltage: built in 8500mAh Li-SOCI2 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 +
82 82  (% style="color:#037691" %)**LoRa Spec:**
83 83  
84 84  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -151,7 +151,6 @@
151 151  
152 152  [[image:image-20230630160843-7.png]]
153 153  
154 -
155 155  == 1.9 Mechanical ==
156 156  
157 157  
... ... @@ -167,13 +167,6 @@
167 167  [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
168 168  
169 169  
170 -== 1.10 Magnet Distance ==
171 -
172 -
173 -* Wood Door: 10mm ~~ 30mm
174 -* Iron Door: 30 ~~ 45mm
175 -
176 -
177 177  = 2. Configure DS03A-LB to connect to LoRaWAN network =
178 178  
179 179  == 2.1 How it works ==
... ... @@ -239,13 +239,11 @@
239 239  === 2.3.1 Device Status, FPORT~=5 ===
240 240  
241 241  
242 -Include device configure status. Once DS03A-LB Joined the network, it will uplink this message to the server. After that, DS03A-LB will uplink Device Status every 12 hours.
239 +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.
243 243  
244 -Users can also use the downlink command**(0x26 01)** to ask DS03A-LB to resend this uplink. This uplink payload also includes the DeviceTimeReq to get time.
245 -
246 -
247 247  The Payload format is as below.
248 248  
243 +
249 249  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
250 250  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
251 251  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
... ... @@ -312,7 +312,7 @@
312 312  === 2.3.2  Sensor Configuration, FPORT~=4 ===
313 313  
314 314  
315 -DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
310 +DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
316 316  
317 317  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
318 318  |(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
... ... @@ -327,11 +327,6 @@
327 327  Alarm interval(unit: min)
328 328  )))
329 329  
330 -Example parse in TTNv3
331 -
332 -[[image:image-20230630155527-3.png||height="146" width="902"]]
333 -
334 -
335 335  * (((
336 336  (% style="color:blue" %)**TDC: (default: 0x001C20)**
337 337  )))
... ... @@ -357,6 +357,7 @@
357 357  
358 358  Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
359 359  
350 +[[image:image-20230630155527-3.png||height="146" width="902"]]
360 360  
361 361  
362 362  * (((
... ... @@ -374,7 +374,7 @@
374 374  * Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
375 375  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
376 376  
377 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
368 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)**
378 378  
379 379  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
380 380  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
... ... @@ -389,7 +389,7 @@
389 389  
390 390  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
391 391  |(% 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**
392 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
383 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
393 393  Count mod
394 394  )))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
395 395  Alarm 0: No Alarm; 1: Alarm
... ... @@ -404,9 +404,9 @@
404 404  (% style="color:blue" %)**Count mod:Default=0**
405 405  )))
406 406  
407 -0: Uplink total open door times since factory
398 +MOD=0 ~-~-> Uplink total open door times since factory
408 408  
409 -1: Uplink total open door times since last FPORT=2 uplink.
400 +MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
410 410  
411 411  
412 412  * (% style="color:blue" %)**TDC flag**
... ... @@ -450,7 +450,7 @@
450 450  [[image:image-20230701094042-1.png||height="154" width="763"]]
451 451  
452 452  
453 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
444 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes**.
454 454  
455 455  (When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
456 456  
... ... @@ -460,11 +460,11 @@
460 460  |=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
461 461  |(% 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**
462 462  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
463 -Status1 & Alarm1
454 +Status1 & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]1
464 464  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
465 465  The last door open duration1 (unit: sec)
466 466  )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
467 -Status2 & Alarm2
458 +Status2 & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]2
468 468  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
469 469  
470 470  **Status1 & Alarm1:**
... ... @@ -471,7 +471,7 @@
471 471  
472 472  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
473 473  |(% 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**
474 -|(% style="width:76px" %)Value|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
465 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
475 475  Count mod
476 476  )))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
477 477  Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
... ... @@ -483,7 +483,7 @@
483 483  
484 484  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
485 485  |(% 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**
486 -|(% style="width:76px" %)Value|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
477 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
487 487  Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
488 488  )))|(% style="width:181px" %)(((
489 489  Status2 0: Close; 1: Open (PA4 of pin)
... ... @@ -493,12 +493,12 @@
493 493  
494 494  
495 495  * (((
496 -(% style="color:blue" %)**Count mod:Default=0**
487 +(% id="cke_bm_695345S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Count mod:Default=0**
497 497  )))
498 498  
499 -0: Uplink total open door times since factory
490 +MOD=0 ~-~-> Uplink total open door times since factory
500 500  
501 -1: Uplink total open door times since last FPORT=2 uplink.
492 +MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
502 502  
503 503  
504 504  * (% style="color:blue" %)**TDC flag**
... ... @@ -512,7 +512,7 @@
512 512  (% style="color:#0000ff" %)**Alarm1 or Alarm2**
513 513  )))
514 514  
515 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
506 +See [[Alarm Base on Timeout>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/#H3.3.3A0AlarmBaseonTimeout]]
516 516  
517 517  
518 518  * (((
... ... @@ -553,7 +553,7 @@
553 553  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
554 554  |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
555 555  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
556 -Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
547 +Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
557 557  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
558 558  The last door open duration (unit: sec)
559 559  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
... ... @@ -562,7 +562,7 @@
562 562  
563 563  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
564 564  |(% 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**
565 -|(% style="width:76px" %)Value|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
556 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
566 566  Count mod
567 567  )))|(% style="width:95px" %)(((
568 568  TDC flag 0:No; 1:Yes
... ... @@ -573,7 +573,7 @@
573 573  )))
574 574  
575 575  * (((
576 -Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-LB will send max bytes according to the current DR and Frequency bands.
567 +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.
577 577  )))
578 578  
579 579  For example, in the US915 band, the max payload for different DR is:
... ... @@ -801,39 +801,9 @@
801 801  * Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
802 802  * Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
803 803  
804 -=== 3.3.2  Set Power Output Duration ===
795 +=== 3.3.2  Enable / Disable Alarm ===
805 805  
806 806  
807 -Control the output duration 5V . Before each sampling, device will
808 -
809 -~1. first enable the power output to external sensor,
810 -
811 -2. keep it on as per duration, read sensor value and construct uplink payload
812 -
813 -3. final, close the power output.
814 -
815 -(% style="color:blue" %)**AT Command: AT+5VT**
816 -
817 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
818 -|=(% 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**
819 -|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
820 -OK
821 -|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
822 -OK
823 -
824 -)))
825 -
826 -(% style="color:blue" %)**Downlink Command: 0x07**(%%)
827 -Format: Command Code (0x07) followed by 2 bytes.
828 -
829 -The first and second bytes are the time to turn on.
830 -
831 -* Example 1: Downlink Payload: 070000  **~-~-->**  AT+5VT=0
832 -* Example 2: Downlink Payload: 0701F4  **~-~-->**  AT+5VT=500
833 -
834 -=== 3.3.3  Enable / Disable Alarm ===
835 -
836 -
837 837  Feature: Enable/Disable Alarm for open/close event. Default value 0.
838 838  
839 839  (% style="color:blue" %)**AT Command: **
... ... @@ -850,11 +850,12 @@
850 850  0xA7 00  ~/~/ Same As AT+DISALARM=0
851 851  
852 852  
853 -=== 3.3.4  Alarm Base on Timeout ===
814 +=== 3.3.3  Alarm Base on Timeout ===
854 854  
855 855  
856 856  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:
857 857  
819 +
858 858  * (((
859 859  (% style="color:blue" %)**Keep Status: Status to be monitor**
860 860  )))
... ... @@ -890,7 +890,7 @@
890 890  **cc dd:** timeout.
891 891  
892 892  
893 -**1) AT+TTRIG1 : (PA8 of pin)**
855 +1)**AT+TTRIG1**:(PA8 of pin)
894 894  
895 895  (% style="color:blue" %)**AT Command to configure:**
896 896  
... ... @@ -909,11 +909,13 @@
909 909  
910 910  (% style="color:blue" %)**Downlink Command to configure:**
911 911  
912 -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.
874 +If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
913 913  
876 + 0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
914 914  
915 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
916 916  
879 +2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2)
880 +
917 917  (% style="color:blue" %)**AT Command to configure:**
918 918  
919 919  * (((
... ... @@ -931,12 +931,14 @@
931 931  
932 932  (% style="color:blue" %)**Downlink Command to configure:**
933 933  
934 -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.
898 +If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
935 935  
900 + 0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
936 936  
937 -=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
938 938  
903 +=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
939 939  
905 +
940 940  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.
941 941  
942 942  (% style="color:blue" %)**AT Command:**
... ... @@ -963,7 +963,7 @@
963 963  Example:  0C aa  => AT+TTRALARM= aa
964 964  
965 965  
966 -=== 3.3.6  Count Mod ===
932 +=== 3.3.5  Count Mod ===
967 967  
968 968  
969 969  Feature: Manually set the count mode.
... ... @@ -992,7 +992,7 @@
992 992  Example:  0B aa  => AT+COUNTMOD = second byte
993 993  
994 994  
995 -=== 3.3.7  Number of channel of door sensors ===
961 +=== 3.3.6  Number of channel of door sensors ===
996 996  
997 997  
998 998  Feature: Set the number of door sensor channels.
... ... @@ -1021,7 +1021,7 @@
1021 1021  Example:  0D aa => AT+TTRCHANNEL = second byte
1022 1022  
1023 1023  
1024 -=== 3.3.8  Set Time Sync Mode ===
990 +=== 3.3.7  Set Time Sync Mode ===
1025 1025  
1026 1026  
1027 1027  Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
... ... @@ -1059,13 +1059,13 @@
1059 1059  0x28 00  ~/~/ Same As AT+SYNCMOD=0
1060 1060  
1061 1061  
1062 -=== 3.3.9  Clear the open door times and the duration of the last open door ===
1028 +=== 3.3.8  Clear the open door times and the duration of the last open door ===
1063 1063  
1064 1064  
1065 1065  (% style="color:blue" %)**AT Command:**
1066 1066  
1067 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1068 -|=(% 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**
1033 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1034 +|=(% 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**
1069 1069  |(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
1070 1070  OK
1071 1071  )))
... ... @@ -1075,7 +1075,7 @@
1075 1075  The sensor will clear the open door times and the duration of the last open door.
1076 1076  
1077 1077  
1078 -=== 3.3.10  Set the count value of the number of open door ===
1044 +=== 3.3.9  Set the count value of the number of open door ===
1079 1079  
1080 1080  
1081 1081  (% style="color:blue" %)**AT Command:**
... ... @@ -1126,8 +1126,9 @@
1126 1126  
1127 1127  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1128 1128  
1129 -Methods to Update Firmware:
1130 1130  
1096 +**Methods to Update Firmware:**
1097 +
1131 1131  * (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/]]**
1132 1132  * 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]]**.
1133 1133  

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0