Changes for page DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual

Last modified by Mengting Qiu on 2025/01/10 09:53

From version < 34.42 >

edited by Xiaoling
on 2023/07/01 15:12

To version < 38.4 >

edited by Xiaoling
on 2023/12/14 14:42

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -2,7 +2,7 @@
  [[image:image-20230516085523-1.jpeg||height="491" width="491"]]
--**Table of Contents：**
++**Table of Contents:**
  {{toc/}}
@@ -79,11 +79,6 @@
  * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
  * Operating Temperature: -40 ~~ 85°C
--(% style="color:#037691" %)**Sensor Detect Distance:**
--
--* Wood Door: 10mm ~~ 30mm
--* Iron Door: 30 ~~ 45mm
--
  (% style="color:#037691" %)**LoRa Spec:**
  * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
@@ -156,6 +156,7 @@
  [[image:image-20230630160843-7.png]]
++
  == 1.9 Mechanical ==
@@ -171,6 +171,13 @@
  [[image:Main.User Manual for LoRaWAN End Nodes.PS-LB -- LoRaWAN Pressure Sensor.WebHome@1675143909447-639.png]]
++== 1.10 Magnet Distance ==
++
++
++* Wood Door: 10mm ~~ 30mm
++* Iron Door: 30 ~~ 45mm
++
++
  = 2. Configure DS03A-LB to connect to LoRaWAN network =
  == 2.1 How it works ==
@@ -236,11 +236,13 @@
  === 2.3.1 Device Status, FPORT~=5 ===
--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.
++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.
--The Payload format is as below.
++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.
++The Payload format is as below.
++
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
  |(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
  |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
@@ -307,13 +307,14 @@
  === 2.3.2  Sensor Configuration, FPORT~=4 ===
--DS03A-LB will only send this command after getting the downlink command (0x26 02) from the server.
++DS03A-LB will only send this command after getting the downlink command **(0x26 02)** from the server.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
  |(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
  |**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**
  |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
--Keep status1)))|(% style="width:99px" %)(((
++Keep status1
++)))|(% style="width:99px" %)(((
  Keep time1(unit: sec)
  )))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
  Keep time2(unit: sec)
@@ -321,6 +321,11 @@
  Alarm interval(unit: min)
  )))
++Example parse in TTNv3
++
++[[image:image-20230630155527-3.png||height="146" width="902"]]
++
++
  * (((
  (% style="color:blue" %)**TDC: (default: 0x001C20)**
  )))
@@ -344,9 +344,8 @@
  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
  )))
--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]]
++Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
--[[image:image-20230630155527-3.png||height="146" width="902"]]
  * (((
@@ -361,16 +361,16 @@
  DS03A-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-LB will send uplinks when:
--* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
++* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
--1) When **AT+TTRCHANNEL=1**, Uplink Payload totals **11 bytes**. (**Default mode**)
++**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
  |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
--Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
++Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
  The last door open duration (unit: sec)
  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
@@ -394,9 +394,9 @@
  (% style="color:blue" %)**Count mod:Default=0**
  )))
--MOD=0 ~-~-> Uplink total open door times since factory
++0: Uplink total open door times since factory
--MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
++1: Uplink total open door times since last FPORT=2 uplink.
  * (% style="color:blue" %)**TDC flag**
@@ -410,7 +410,7 @@
  (% style="color:#0000ff" %)**Alarm**
  )))
--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]]
++See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
  * (((
@@ -440,7 +440,7 @@
  [[image:image-20230701094042-1.png||height="154" width="763"]]
--2) When **AT+TTRCHANNEL=2**, Uplink Payload totals **18 bytes**.
++**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
  (When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
@@ -450,11 +450,11 @@
  |=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
  |(% 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**
  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
--Status1 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]1
++Status1 & Alarm1
  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
  The last door open duration1 (unit: sec)
  )))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
--Status2 & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]2
++Status2 & Alarm2
  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
  **Status1 & Alarm1:**
@@ -483,12 +483,12 @@
  * (((
--(% id="cke_bm_695345S" style="color:blue; display:none" %)** **(% style="color:blue" %)**Count mod:Default=0**
++(% style="color:blue" %)**Count mod:Default=0**
  )))
--MOD=0 ~-~-> Uplink total open door times since factory
++0: Uplink total open door times since factory
--MOD=1 ~-~-> Uplink total open door times since last FPORT=2 uplink.
++1: Uplink total open door times since last FPORT=2 uplink.
  * (% style="color:blue" %)**TDC flag**
@@ -502,7 +502,7 @@
  (% style="color:#0000ff" %)**Alarm1 or Alarm2**
  )))
--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]]
++See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
  * (((
@@ -543,7 +543,7 @@
  |=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
  |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
--Status & [[Alarm>>||anchor="H3.3.4A0AlarmBaseonTimeout"]]
++Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
  The last door open duration (unit: sec)
  )))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
@@ -563,7 +563,7 @@
  )))
  * (((
--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.
++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.
  )))
  For example, in the US915 band, the max payload for different DR is:
@@ -791,9 +791,39 @@
  * Example 1: Downlink Payload: 0100001E       ~/~/  Set Transmit Interval (TDC) = 30 seconds
  * Example 2: Downlink Payload: 0100003C       ~/~/  Set Transmit Interval (TDC) = 60 seconds
--=== 3.3.2  Enable / Disable Alarm ===
++=== 3.3.2  Set Power Output Duration ===
++Control the output duration 5V . Before each sampling, device will
++
++~1. first enable the power output to external sensor,
++
++2. keep it on as per duration, read sensor value and construct uplink payload
++
++3. final, close the power output.
++
++(% style="color:blue" %)**AT Command: AT+5VT**
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% 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**
++|(% style="width:156px" %)AT+5VT=?|(% style="width:204px" %)Show 5V open time.|(% style="width:149px" %)0 (default)
++OK
++|(% style="width:156px" %)AT+5VT=500|(% style="width:204px" %)Close after a delay of 500 milliseconds.|(% style="width:149px" %)(((
++OK
++
++)))
++
++(% style="color:blue" %)**Downlink Command: 0x07**(%%)
++Format: Command Code (0x07) followed by 2 bytes.
++
++The first and second bytes are the time to turn on.
++
++* Example 1: Downlink Payload: 070000     **~-~-->**   AT+5VT=0
++* Example 2: Downlink Payload: 0701F4      **~-~-->**  AT+5VT=500
++
++=== 3.3.3  Enable / Disable Alarm ===
++
++
  Feature: Enable/Disable Alarm for open/close event. Default value 0.
  (% style="color:blue" %)**AT Command: **
@@ -810,12 +810,11 @@
 xA7 00     ~/~/ Same As AT+DISALARM=0
--=== 3.3.3  Alarm Base on Timeout ===
++=== 3.3.4  Alarm Base on Timeout ===
  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:
--
  * (((
  (% style="color:blue" %)**Keep Status: Status to be monitor**
  )))
@@ -851,7 +851,7 @@
  **cc dd:** timeout.
--1)**AT+TTRIG1**:(PA8 of pin)
++**1) AT+TTRIG1 : (PA8 of pin)**
  (% style="color:blue" %)**AT Command to configure:**
@@ -870,13 +870,11 @@
  (% style="color:blue" %)**Downlink Command to configure:**
--If user send 0xA9 01 01 00 1E: equal to AT+TTRIG1=1,30 or
++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.
--                    0xA9 01 00 00 00: Equal to AT+TTRIG1=0,0.
++**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
--2)**AT+TTRIG2**:(PA4 of pin,need to use AT+TTRCHANNEL=2)
--
  (% style="color:blue" %)**AT Command to configure:**
  * (((
@@ -894,14 +894,12 @@
  (% style="color:blue" %)**Downlink Command to configure:**
--If user send 0xA9 02 00 00 1E: equal to AT+TTRIG2=0,30 or
++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.
--                    0xA9 02 00 00 00: Equal to AT+TTRIG2=0,0.
++=== 3.3.5  TTRIG1 & TTRIG2 timeout status alarm ===
--=== 3.3.4  TTRIG1 & TTRIG2 timeout status alarm ===
--
  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.
  (% style="color:blue" %)**AT Command:**
@@ -928,7 +928,7 @@
  Example:  0C aa  => AT+TTRALARM= aa
--=== 3.3.5  Count Mod ===
++=== 3.3.6  Count Mod ===
  Feature: Manually set the count mode.
@@ -957,7 +957,7 @@
  Example:  0B aa  => AT+COUNTMOD = second byte
--=== 3.3.6  Number of channel of door sensors ===
++=== 3.3.7  Number of channel of door sensors ===
  Feature: Set the number of door sensor channels.
@@ -986,7 +986,7 @@
  Example:  0D aa => AT+TTRCHANNEL = second byte
--=== 3.3.7  Set Time Sync Mode ===
++=== 3.3.8  Set Time Sync Mode ===
  Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
@@ -1024,13 +1024,13 @@
 x28 00           ~/~/ Same As AT+SYNCMOD=0
--=== 3.3.8  Clear the open door times and the duration of the last open door ===
++=== 3.3.9  Clear the open door times and the duration of the last open door ===
  (% style="color:blue" %)**AT Command:**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
--|=(% 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**
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% 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**
  |(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
  OK
  )))
@@ -1040,7 +1040,7 @@
  The sensor will clear the open door times and the duration of the last open door.
--=== 3.3.9  Set the count value of the number of open door ===
++=== 3.3.10  Set the count value of the number of open door ===
  (% style="color:blue" %)**AT Command:**
@@ -1091,9 +1091,8 @@
  Firmware and changelog can be downloaded from : **[[Firmware download link>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
++Methods to Update Firmware:
--**Methods to Update Firmware:**
--
  * (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/]]**
  * 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]]**.

Changes for page DS03A-LB/LS -- Outdoor LoRaWAN Door Sensor User Manual

Summary

Details

Applications

Navigation