Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35

From 103.1 to 104.1 From 107.11 to 107.12

From version 104.1

edited by Xiaoling
on 2023/10/11 09:27

Change comment: Uploaded new attachment "image-20231011092728-3.png", version {1}

To version 107.11

edited by Xiaoling
on 2023/10/11 11:50

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 3 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--DS03A-NB_NB-IoT_Door_Sensor_User_Manual
++DS03A-NB -- NB-IoT Door Sensor User Manual

Content

@@ -1,13 +1,9 @@
  (% style="text-align:center" %)
--[[image:image-20231010090810-1.png||height="518" width="839"]]
++[[image:image-20231011093014-5.png]]
--
--
--
--
  **Table of Contents:**
  {{toc/}}
@@ -19,26 +19,30 @@
  = 1. Introduction =
--== 1.1 What is SW3L-NB NB-IoT Flow Sensor ==
++== 1.1 What is DS03A-NB NB-IoT Door Sensor ==
--The Dragino SW3L-NB is a (% style="color:blue" %)**NB-IoT Flow Sensor**(%%). It detects water flow volume and uplink to IoT server via NB-IoT network. User can use this to (% style="color:blue" %)**monitor the water usage for buildings**.
++The Dragino DS03A-NB is a (% style="color:blue" %) **NB-IoT Door Sensor**(%%) for Internet of Things solution. It (% style="color:blue" %)**detects door open/close status**(%%) and uplinks to IoT server via NB-IoT network. user can see the door status, open duration, open counts in the IoT Server.
--The SW3L-NB will send water flow volume every 20 minutes. It can also detect the (% style="color:blue" %)**water flow status and send Alarm**(%%), to avoid the waste for water usage such as broken toilet case.
++The DS03A-NB 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-NB can count each open event and uplink periodically.
--SW3L-NB is designed for both indoor and outdoor use. It has a weatherproof enclosure and industrial level battery to (% style="color:blue" %)**work in low to high temperatures**.
++DS03A-NB supports (% style="color:blue" %)**Datalog Feature,** (%%)it can save the data when there is no NB-IoT network and uplink when network recover.
--SW3L-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
++DS03A-NB 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.
--SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
++DS03A-NB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
--SW3L-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
++DS03A-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
--SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
++DS03A-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
--[[image:image-20231010091546-2.png||height="348" width="909"]]
++DS03A-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
++DS03A-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
++[[image:image-20231011093807-6.png||height="278" width="879"]]
++
++
  == 1.2 Features ==
@@ -45,7 +45,10 @@
  * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
  * Ultra-low power consumption
  * Upload water flow volume
--* Monitor water waste
++* Door Open/Close detect
++* Door open/close statistics
++* Datalog Feature
++* Open Alarm Feature
  * Multiply Sampling and one uplink
  * Support Bluetooth v5.1 remote configure and update firmware
  * Uplink on periodically
@@ -53,8 +53,6 @@
  * 8500mAh Battery for long term use
  * Nano SIM card slot for NB-IoT SIM
--
--
  == 1.3 Specification ==
@@ -104,38 +104,21 @@
  (% style="display:none" %) (%%)
--== 1.4 Flow Sensor Spec ==
++== 1.4 Applications ==
--(((
--(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Model**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Probe**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Diameter**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Range**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Max Pressure**|=(% style="width: 110px;background-color:#4F81BD;color:white" %)**Measure**
--|(% style="width:88px" %)SW3L-004|(% style="width:75px" %)DW-004|(% style="width:107px" %)G1/2" /DN15|(% style="width:101px" %)1~~30L/min|(% style="width:116px" %)≤ 2.0Mpa|(% style="width:124px" %)450 pulse = 1 L
--|(% style="width:88px" %)SW3L-006|(% style="width:75px" %)DW-006|(% style="width:107px" %)G3/4" /DN20|(% style="width:101px" %)1~~60L/min|(% style="width:116px" %)≤ 1.2Mpa|(% style="width:124px" %)390 pulse = 1 L
--|(% style="width:88px" %)SW3L-010|(% style="width:75px" %)DW-010|(% style="width:107px" %)G 1" /DN25|(% style="width:101px" %)2~~100L/min|(% style="width:116px" %)≤ 2.0Mpa|(% style="width:124px" %)64 pulse = 1 L
--)))
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654741400370-813.png?rev=1.1||alt="1654741400370-813.png"]]
++== 1.5 Sleep mode and working mode ==
--== 1.5 Applications ==
--
--* Flow Sensor application
--* Water Control
--* Toilet Flow Sensor
--* Monitor Waste water
--
--
--
--== 1.6 Sleep mode and working mode ==
--
--
  (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
  (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
--== 1.7 Button & LEDs ==
++== 1.6 Button & LEDs ==
  [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
@@ -154,14 +154,12 @@
  )))
  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
++== 1.7 BLE connection ==
--== 1.8 BLE connection ==
++DS03A-NB support BLE remote configure and firmware update.
--SW3L-NB support BLE remote configure and firmware update.
--
--
  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:
  * Press button to send an uplink
@@ -171,19 +171,19 @@
  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
--== 1.9 Pin Definitions & Switch ==
++== 1.8 Pin Definitions & Switch ==
  [[image:image-20230819104805-5.png]]
--=== 1.9.1 Jumper JP2 ===
++=== 1.8.1 Jumper JP2 ===
  Power on Device when put this jumper.
--=== 1.9.2 BOOT MODE / SW1 ===
++=== 1.8.2 BOOT MODE / SW1 ===
  **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
@@ -191,7 +191,7 @@
  **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
--=== 1.9.3 Reset Button ===
++=== 1.8.3 Reset Button ===
  Press to reboot the device.
@@ -199,7 +199,7 @@
  (% style="display:none" %)
--== 1.10 Mechanical ==
++== 1.9 Mechanical ==
  [[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/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]]
@@ -212,38 +212,35 @@
  **Probe Mechanical:**
--(% style="color:blue" %)**DW-004 Flow Sensor: diameter: G1/2” / DN15.  450 pulse = 1 L**
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS03A%20-%20Outdoor%20LoRaWAN%20OpenClose%20Door%20Sensor%20Manual/WebHome/1654741444887-479.png?width=513&height=399&rev=1.1||alt="1654741444887-479.png"]]
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091350-1.png?width=722&height=385&rev=1.1||alt="image-20220519091350-1.png"]]
--(% style="color:blue" %)**006: DW-006 Flow Sensor: diameter: G3/4” / DN20.  390 pulse = 1 L**
++== 1.10 Magnet Distance ==
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091423-2.png?width=723&height=258&rev=1.1||alt="image-20220519091423-2.png"]]
++* Wood Door: 10mm ~~ 30mm
++* Iron Door: 30 ~~ 45mm
--(% style="color:blue" %)**010: DW-010 Flow Sensor: diameter: G 1” / DN25.   64 pulse = 1 L**
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091423-3.png?width=724&height=448&rev=1.1||alt="image-20220519091423-3.png"]]
++= 2. Use DS03A-NB to communicate with IoT Server =
--= 2. Use SW3L-NB to communicate with IoT Server =
--
  == 2.1 Send data to IoT server via NB-IoT network ==
--The SW3L-NB is equipped with a NB-IoT module, the pre-loaded firmware in SW3L-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by SW3L-NB.
++The DS03A-NB is equipped with a NB-IoT module, the pre-loaded firmware in DS03A-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by DS03A-NB.
  Below shows the network structure:
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-NB_NB-IoT_Flow_Sensor_User_Manual/WebHome/image-20231010091546-2.png?width=909&height=348&rev=1.1||alt="image-20231010091546-2.png"]]
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-NB_NB-IoT_Door_Sensor_User_Manual/WebHome/image-20231011093807-6.png?width=879&height=278&rev=1.1||alt="image-20231011093807-6.png"]]
--There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of SW3L-NB.
++There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DS03A-NB.
--(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set SW3L-NB send data to IoT server.
++(% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set DS03A-NB send data to IoT server.
  * Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
@@ -273,13 +273,13 @@
  [[image:image-20230819113244-11.png||height="141" width="367"]]
  )))|(% style="width:170px" %)
--(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate SW3L-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
++(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate DS03A-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
  == 2.2 Payload Types ==
--To meet different server requirement, SW3L-NB supports different payload type.
++To meet different server requirement, DS03A-NB supports different payload type.
  **Includes:**
@@ -305,7 +305,7 @@
  This is the General Json Format. As below:
--(% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"SW3L-NB","flow":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}**
++(% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DS03A-NB","flow":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}**
  [[image:image-20230920175015-3.png||height="613" width="890"]]
@@ -317,8 +317,6 @@
  * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Water Flow, Sampling time.
--
--
  === 2.2.2 HEX format Payload(Type~=0) ===
@@ -338,7 +338,7 @@
  These bytes include the hardware and software version.
--(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x11 for SW3L-NB
++(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x12 for DS03A-NB
  (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
@@ -377,7 +377,7 @@
  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
--(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "SW3L","flow": 502,"battery": 3.57,"signal": 23}**
++(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DS03A","flow": 502,"battery": 3.57,"signal": 23}**
  [[image:image-20230922094043-2.png||height="558" width="851"]]
@@ -399,326 +399,328 @@
  == 2.3  Uplink Payload ==
--=== 2.3.1 Sensor Configuration, FPORT~=4 ===
++=== 2.3.2  Sensor Configuration, FPORT~=4 ===
--SW3L-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
++DS03A-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|(% style="background-color:#4f81bd; color:white; width:70px" %) **Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:105px" %)**3**|(% style="background-color:#4f81bd; color:white; width:60px" %)**1**|(% style="background-color:#4f81bd; color:white; width:96px" %)**1**|(% style="background-color:#4f81bd; color:white; width:105px" %)**2**|(% style="background-color:#4f81bd; color:white; width:74px" %)**1**
--|**Value**|(% style="width:104px" %)TDC(unit:sec)|(% style="width:43px" %)N/A|(% style="width:91px" %)Stop Timer|(% style="width:100px" %)Alarm Timer|(% style="width:69px" %)Reserve
++(% 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 time1(unit: sec)
++)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
++Keep time2(unit: sec)
++)))|(% style="width:98px" %)(((
++Alarm interval(unit: min)
++)))
  Example parse in TTNv3
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230614172555-4.png?width=853&height=151&rev=1.1||alt="image-20230614172555-4.png"]]
++[[image:image-20230630155527-3.png||height="146" width="902"]]
--* (% style="color:blue" %)**TDC: (default: 0x0004B0)**
++* (((
++(% style="color:blue" %)**TDC: (default: 0x001C20)**
++)))
--Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes.
++Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
--* (% style="color:blue" %)**STOP Duration & Alarm Timer**
++* (((
++(% style="color:blue" %)**Disalarm: (default: 0)**
++)))
--Shows the configure value of [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]
++ **If Disalarm = 1**, DS03A-NB 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.
++ **If Disalarm = 0**, DS03A-NB 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.
--=== 2.3.2 Water Flow Value, Uplink FPORT~=2 ===
++(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
--(((
--SW3L-NB will send this uplink **after** Device Status once join the NB-IoT network successfully. And SW3L-NB will:
--)))
--(((
--periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H2.10SetTransmitIntervalTime"]].
++* (((
++(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
  )))
--(((
--Uplink Payload totals 11 bytes.
++Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
++
++
++
++* (((
++(% style="color:blue" %)**Alarm interval(default: 0)**
  )))
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)**Water Flow Value,  FPORT=2**
--|(% style="width:50px" %)**Size(bytes)**|(% style="width:110px" %)**1**|(% style="width:120px" %)**4**|(% style="width:110px" %)**1**|(% style="width:55px" %)**1**|(% style="width:70px" %)**4**
--|(% style="width:110px" %)**Value**|(% style="width:81px" %)Calculate Flag  & [[Alarm>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]|(% style="width:95px" %)(((
--Total pulse Or Last Pulse
--)))|(% style="width:78px" %)(((
--MOD & PA4_status & PB15_status
--)))|(% style="width:92px" %)Reserve(0x01)|(% style="width:134px" %)Unix TimeStamp
++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.
--**Calculate Flag & Alarm:**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
--|(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:70px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**[bit5:bit2]**|(% style="background-color:#4f81bd; color:white; width:140px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**bit0**
--|(% style="width:88px" %)**Value**|(% style="width:117px" %)Reserve|(% style="width:117px" %)Calculate Flag|(% style="width:169px" %)Alarm: 0: No Alarm; 1: Alarm|(% style="width:150px" %)TDC flag 0:No;1:Yes
++=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
--**MOD & PA4_status & PB15_status:**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:230px" %)
--|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**bit7**|(% style="background-color:#4f81bd; color:white; width:60px" %)**bit6**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit5:bit0]**
--|(% style="width:88px" %)**Value**|(% style="width:117px" %)PA4_status|(% style="width:117px" %)PB15_status|(% style="width:118px" %)MOD
++DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
--(% style="color:#037691" %)**  **[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230626093242-1.png?width=892&height=276&rev=1.1||alt="image-20230626093242-1.png"]]
++* 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 (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
--* (((
--(% style="color:blue" %)**Calculate Flag**
--)))
++(% 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.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"]]
--(((
--The calculate flag is a user defined field, IoT server can use this flag to handle different meters with different pulse factors. For example, if there are 100 Flow Sensors, meters 1 ~~50 are 1 liter/pulse and meters 51 ~~ 100 has 1.5 liter/pulse.
--)))
++**Status & Alarm:**
--(((
--**Example: in the default payload:**
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
++|(% 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**
++|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
++Count mod
++)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
++Alarm 0: No Alarm; 1: Alarm
++)))|(% style="width:131px" %)(((
++Status 0: Close; 1: Open
  )))
++[[image:image-20230630155451-2.png||height="246" width="928"]]
++
++
  * (((
--calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
++(% style="color:blue" %)**Count mod:Default=0**
  )))
++
++0: Uplink total open door times since factory
++
++1: Uplink total open door times since last FPORT=2 uplink.
++
++
++* (% style="color:blue" %)**TDC flag**
++
++When the flag is 1, it means sending packets at normal time intervals.
++
++Otherwise, it is a packet sent at non-TDC time.
++
++
  * (((
--calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
++(% style="color:#0000ff" %)**Alarm**
  )))
++
++See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
++
++
  * (((
--calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L
++(% style="color:blue" %)**Status**
  )))
--(((
--Default value: 0.
++This bit is 1 when the door sensor is open and 0 when it is close.
++
++
++* (((
++(% style="color:blue" %)**Total open door events**
  )))
--(((
--Range (4 bits): (b)0000 ~~ (b) 1111
++Total pulse/counting base on open door.
--If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server,
++Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
--1) User can set the Calculate Flag of this sensor to 3.
--2) In server side, when a sensor data arrive, the decoder will check the value of Calculate Flag, It the value is 3, the total volume = 0.02 x Pulse Count.
++* (((
++(% style="color:blue" %)**The last door open duration**
  )))
--(((
--(% style="color:red" %)**NOTE: User need to set Calculate Flag to proper value before use Flow Sensor. Downlink or AT Command see: **(%%)Refer: [[Set Calculate Flag>>||anchor="H2.8Setthecalculateflag"]]
++Door sensor last open duration.
--(((
--
--)))
--)))
++Unit: sec.
++[[image:image-20230701094042-1.png||height="154" width="763"]]
--* (((
--(% style="color:blue" %)**Alarm**
--)))
--(((
--See [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]
--)))
++**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-4.png?width=724&height=65&rev=1.1||alt="image-20220519095946-4.png"]]
++(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
++(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
--(((
--* (% style="color:blue" %)**TDC flag**
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
++|=(% 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 & 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 & Alarm2
++)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
--When the flag is 1, it means sending packets at normal time intervals.
++**Status1 & Alarm1:**
--Otherwise, it is a packet sent at non-TDC time.
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
++|(% 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**
++|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
++Count mod
++)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
++Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
++)))|(% style="width:181px" %)(((
++Status1 0: Close; 1: Open (PA8 of pin)
  )))
--* (((
--(% style="color:blue" %)**Total pulse**
--)))
++**Status2 & Alarm2:**
--(((
--Total pulse/counting since factory
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|(% 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**
++|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
++Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
++)))|(% style="width:181px" %)(((
++Status2 0: Close; 1: Open (PA4 of pin)
  )))
--(((
--Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
++[[image:image-20230630155908-6.png||height="295" width="927"]]
--
--)))
  * (((
--(% style="color:blue" %)**Last Pulse**
++(% style="color:blue" %)**Count mod:Default=0**
  )))
--(((
--Total pulse since last FPORT=2 uplink. (Default 20 minutes)
--)))
++0: Uplink total open door times since factory
--(((
--Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
++1: Uplink total open door times since last FPORT=2 uplink.
--* (((
--(% style="color:blue" %)**PA4_status: Support digital level input below 3.3V**
--)))
++* (% style="color:blue" %)**TDC flag**
--(((
--0 ~-~-> PA4 is at low level.
--)))
++When the flag is 1, it means sending packets at normal time intervals.
--(((
--1 ~-~-> PA4 is at high level.
++Otherwise, it is a packet sent at non-TDC time.
  * (((
--(% style="color:blue" %)**PB15_status: Support digital level input below 3.3V**
++(% style="color:#0000ff" %)**Alarm1 or Alarm2**
  )))
--(((
--0 ~-~-> PB15 is at low level.
--)))
++See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
--(((
--1 ~-~-> PB15 is at high level..
--)))
--)))
--)))
  * (((
--(% style="color:blue" %)**MOD: Default =0**
++(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
  )))
--(((
--MOD=0 ~-~-> Uplink Total Pulse since factory
--)))
++This bit is 1 when the door sensor is open and 0 when it is close.
--(((
--MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink.
--
--)))
--
  * (((
--(% style="color:blue" %)**Water Flow Value**
++(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
  )))
--(((
--**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L**
--)))
++Total pulse/counting base on open door.
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-5.png?width=727&height=50&rev=1.1||alt="image-20220519095946-5.png"]]
++Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
--(((
--**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L**
++* (((
++(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
  )))
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-6.png?width=733&height=43&rev=1.1||alt="image-20220519095946-6.png"]] **    **
++Door sensor last open duration.
++Unit: sec.
--=== 2.3.3 Historical Water Flow Status, FPORT~=3 ===
++[[image:image-20230701094042-1.png||height="154" width="763"]]
--(((
--SW3L-NB stores sensor values and users can retrieve these history values via the downlink command.
--)))
++=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
--(((
--The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)**Water Flow Value,  FPORT=3**
--|(% style="width:50px" %)**Size(bytes)**|(% style="width:110px" %)**1**|(% style="width:120px" %)**4**|(% style="width:110px" %)**1**|(% style="width:55px" %)**1**|(% style="width:70px" %)**4**
--|(% style="width:110px" %)**Value**|(% style="width:81px" %)Calculate Flag  & [[Alarm>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]|(% style="width:95px" %)(((
--Total pulse Or Last Pulse
--)))|(% style="width:78px" %)(((
--MOD & PA4_status & PB15_status
--)))|(% style="width:92px" %)Reserve(0x01)|(% style="width:134px" %)Unix TimeStamp
++DS03A-NB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
--**Calculate Flag & Alarm:**
++The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:89px" %)**bit7**|(% style="background-color:#4f81bd; color:white; width:89px" %)**bit6**|(% style="background-color:#4f81bd; color:white; width:69px" %)**[bit5:bit2]**|(% style="background-color:#4f81bd; color:white; width:129px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:89px" %)**bit0**
--|(% style="width:88px" %)**Value**|(% style="width:96px" %)(((
--No ACK message
--)))|(% style="width:94px" %)Poll Message Flag|(% style="width:115px" %)Calculate Flag|(% style="width:136px" %)Alarm: 0: No Alarm; 1: Alarm|(% style="width:120px" %)TDC flag 0:No;1:Yes
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% 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.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"]]
--**MOD & PA4_status & PB15_status:**
++**Status & Alarm:**
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:240px" %)
--|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**bit7**|(% style="background-color:#4f81bd; color:white; width:60px" %)**bit6**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit5:bit0]**
--|(% style="width:88px" %)**Value**|(% style="width:117px" %)PA4_status|(% style="width:117px" %)PB15_status|(% style="width:118px" %)MOD
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
++|(% 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**
++|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
++Count mod
++)))|(% style="width:95px" %)(((
++TDC flag 0:No; 1:Yes
++)))|(% style="width:116px" %)(((
++Alarm 0: No Alarm; 1: Alarm
++)))|(% style="width:112px" %)(((
++Status 0:Close; 1: Open
  )))
  * (((
--Each data entry is 11 bytes and has the same structure as [[real time water flow status>>||anchor="H2.3.2A0WaterFlowValue2CUplinkFPORT3D2"]], to save airtime and battery, SW3L 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-NB 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:
--)))
  (((
--(% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data
++**~1. DR0**: max is 11 bytes so one entry of data
  )))
  (((
--(% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
++**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
  )))
  (((
--(% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data
++**3. DR2**: total payload includes 11 entries of data
  )))
  (((
--(% style="color:blue" %)**d) DR3:**(%%) total payload includes 22 entries of data.
++**4. DR3**: total payload includes 22 entries of data.
  )))
--(((
--If SW3L-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
++If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
--
--)))
++[[image:image-20230630155556-4.png||height="146" width="938"]]
--(((
--(% style="color:#037691" %)**Downlink:**
--)))
++**Downlink:**
--(((
--0x31 64 92 C5 AC 64 92 C7 8C 05
--)))
++0x31 64 9E 7D 34 64 9E 7E 9C 05
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230626093440-2.png?width=890&height=160&rev=1.1||alt="image-20230626093440-2.png"]]
++**Uplink:**
--(((
--(% style="color:#037691" %)**Uplink:**
--)))
++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
--(((
--41 00 01 00 00 00 08 64 92 C5 E4 40 00 01 00 00 00 08 64 92 C6 06 49 41 01 00 00 00 00 64 92 C6 8B 49 81 01 00 00 00 00 64 92 C7 34 4A 01 01 00 00 00 2D 64 92 C7 7C
--
--)))
++**Parsed Value:**
--(((
--(% style="color:#037691" %)**Parsed Value:**
--)))
++[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
--(((
--[TDC_flag, Alarm, Calculate Flag, PA4_status, PB15_status, MOD, Total pulse or Last Pulse,** **Water Flow Value, TIME]
--)))
++[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
--(((
--[YES,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:41:56],
++[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
--[NO,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:42:30],
++[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
--[YES,FALSE,2,L,H,1,0, 0.0,2023-06-21 09:44:43],
++[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
--[YES,FALSE,2,H,L,1,0, 0.0,2023-06-21 09:47:32],
++[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
--[NO,TRUE ,2, L,L,1,45,0.7,2023-06-21 09:48:44],
--)))
++[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/WebHome/image-20230626093703-3.png?width=894&height=156&rev=1.1||alt="image-20230626093703-3.png"]]
++[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
++[[image:image-20230630172740-1.png||height="199" width="868"]]
++
++
  == 2.4 Test Uplink and Change Update Interval ==
@@ -734,7 +734,7 @@
  == 2.5 Multi-Samplings and One uplink ==
--To save battery life, SW3L-NB will sample Water Flow data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
++To save battery life, DS03A-NB will sample Water Flow data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
  * (% style="color:#037691" %)**AT+TR=900**   (%%)     ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
@@ -748,7 +748,7 @@
  == 2.6 Trggier an uplink by external interrupt ==
--SW3L-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
++DS03A-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
  (% style="color:blue" %)**AT command:**
@@ -764,178 +764,336 @@
--== 2.7 Alarm for continuously water flow ==
++== 2.7 Set Transmit Interval Time ==
  (((
--This feature is to monitor and send Alarm for continuously water flow.
++Feature: Change NB-IoT End Node Transmit Interval.
  )))
  (((
--Example case is for Toilet water monitoring, if some one push toilet button, the toilet will have water flow. If the toilet button has broken and can't returned to original state, the water flow will keep for hours or days which cause huge waste for water.
++(% style="color:blue" %)**AT Command: AT+TDC**
  )))
--(((
--To monitor this faulty and send alarm, there are two settings:
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
++|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
++30000
++OK
++the interval is 30000ms = 30s
  )))
--
--* (((
--(% style="color:blue" %)**Stop Duration: Unit: Second**
++|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
++OK
++Set transmit interval to 60000ms = 60 seconds
  )))
  (((
--Default: 15s, If SW3L-NB didn't see any water flow in 15s, SW3L-NB will consider stop of water flow event.
++(% style="color:blue" %)**Downlink Command: 0x01**
  )))
--* (((
--(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**
--)))
--
  (((
--**Example:** 3 minutes, if SW3L-NB detect a start of water flow event and didn't detect a stop event within Alarm timer, SW3L-NB will send an Alarm to indicate a water flow abnormal alarm.
++Format: Command Code (0x01) followed by 3 bytes time value.
  )))
  (((
--So for example, If we set stop duration=15s and Alarm Timer=3minutes. If the toilet water flow continuously for more than 3 minutes, Sensor will send an alarm (in Confirmed MODE) to platform.
++If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
  )))
--(((
--(% style="color:red" %)**Note:** **After this alarm is send, sensor will consider a stop of water flow and count for another new event. So if water flow waste last for 1 hour, Sensor will keep sending alarm every 3 minutes.**
++* (((
++Example 1: Downlink Payload: 0100001E       ~/~/ Set Transmit Interval (TDC) = 30 seconds
  )))
++* (((
++Example 2: Downlink Payload: 0100003C      ~/~/ Set Transmit Interval (TDC) = 60 seconds
++)))
--(((
--(% style="color:blue" %)**AT Command to configure:**
++
++=== 3.3.3  Enable / Disable Alarm ===
++
++
++Feature: Enable/Disable Alarm for open/close event. Default value 0.
++
++(% style="color:blue" %)**AT Command: **
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
++|(% 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**
++|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
++|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
++
++(% style="color:blue" %)**Downlink Command: **
++
++0xA7 01     ~/~/ Same As AT+DISALARM=1
++
++0xA7 00     ~/~/ Same As AT+DISALARM=0
++
++
++=== 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**
  )))
++(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
++
++(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
++
++
  * (((
--AT+PTRIG=15,3   ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
++(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
  )))
++Range 0 ~~ 65535(0xFFFF) seconds.
++
++If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
++
++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.
++
++
  * (((
--AT+ PTRIG=15,0  ~-~-> Default Value, disable water waste Alarm.
++(% style="color:blue" %)**Downlink Command**
  )))
--(((
--(% style="color:blue" %)**Downlink Command to configure:**
++(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
++
++**A9:** Command Type Code
++
++**aa: **01:TTRIG1; 02:TTRIG2
++
++**bb:** status to be monitored
++
++**cc dd:** timeout.
++
++
++**1) AT+TTRIG1 : (PA8 of pin)**
++
++(% style="color:blue" %)**AT Command to configure:**
++
++* (((
++(% 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 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.
++
++(% 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 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.
  )))
--(((
--Command: **0xAA aa bb cc**
++* (((
++(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%)  **~-~-> ** Default Value, disable timeout Alarm.
++
++
++
  )))
--(((
--AA: Command Type Code
++(% style="color:blue" %)**Downlink Command to configure:**
++
++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.
++
++
++**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
++
++(% style="color:blue" %)**AT Command to configure:**
++
++* (((
++(% 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 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.
++
++(% 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 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.
  )))
--(((
--aa: Stop duration
++* (((
++(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%)  **~-~-> ** Default Value, disable timeout Alarm.
++
++
++
  )))
--(((
--bb cc: Alarm Timer
++(% style="color:blue" %)**Downlink Command to configure:**
++
++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.
++
++
++=== 3.3.5  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:**
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% 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**
++|(% style="width:155px" %)(((
++AT+TTRALARM=0
++)))|(% style="width:279px" %)(((
++disable continuous alarm
++)))|(% style="width:84px" %)(((
++OK
  )))
++|(% style="width:155px" %)(((
++AT+TTRALARM=60
++)))|(% style="width:279px" %)(((
++The alarm interval is 60 minutes (unit: minutes)
++)))|(% style="width:84px" %)(((
++OK
++)))
--(((
--If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
++(% style="color:blue" %)**Downlink Command:**
++
++Example:  0C aa  => AT+TTRALARM= aa
++
++
++=== 3.3.6  Count Mod ===
++
++
++Feature: Manually set the count mode.
++
++(% style="color:blue" %)**AT Command:**
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
++|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 275px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++|(% style="width:155px" %)(((
++AT+COUNTMOD=0
++)))|(% style="width:277px" %)(((
++the count value keeps accumulating mode
++)))|(% style="width:86px" %)(((
++OK
  )))
++|(% style="width:155px" %)(((
++AT+COUNTMOD=1
++)))|(% style="width:277px" %)(((
++the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
++)))|(% style="width:86px" %)(((
++OK
++)))
++(% style="color:blue" %)**Downlink Command:**
--== 2.8 Set the calculate flag ==
++Example:  0B aa  => AT+COUNTMOD = second byte
--Feature: Set the calculate flag
++=== 3.3.7  Number of channel of door sensors ===
--(% style="color:blue" %)**AT Command: AT+CALCFLAG**
--(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
--|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 110px;background-color:#4F81BD;color:white" %)**Response**
--|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK
--|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK
++Feature: Set the number of door sensor channels.
++(% 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**
++|(% style="width:155px" %)(((
++AT+TTRCHANNEL=1
++)))|(% style="width:259px" %)(((
++Set as single channel, only use PA8 pin as interrupt pin.
++)))|(% style="width:44px" %)(((
++OK
++)))
++|(% style="width:155px" %)(((
++AT+TTRCHANNEL=2
++)))|(% style="width:259px" %)(((
++Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
++)))|(% style="width:44px" %)(((
++OK
++)))
++
  (% style="color:blue" %)**Downlink Command:**
--* **Example**: 0XA501         ~/~/  Same as AT+CALCFLAG =1
++Example:  0D aa => AT+TTRCHANNEL = second byte
++=== 3.3.8  Set Time Sync Mode ===
--== 2.9 Set count number ==
++Feature: Enable/Disable Sync system time via LoRaWAN MAC Command (DeviceTimeReq), LoRaWAN server must support v1.0.3 protocol to reply to this command.
--Feature: Manually set the count number
++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.
--(% style="color:blue" %)**AT Command: AT+SETCNT**
++(% style="color:blue" %)**AT Command:**
--(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
--|=(% style="width: 160px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 223px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 96px;background-color:#4F81BD;color:white" %)**Response**
--|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK
--|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK
++(% 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**
++|(% style="width:155px" %)(((
++AT+SYNCMOD=1
++)))|(% style="width:259px" %)(((
++Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) The default is zero time zone.
++)))|(% style="width:44px" %)(((
++OK
++)))
++|(% style="width:155px" %)(((
++AT+SYNCMOD=1,8
++)))|(% style="width:259px" %)(((
++Enable Sync system time via LoRaWAN MAC Command (DeviceTimeReq) Set to East eight time zone.
++)))|(% style="width:44px" %)(((
++OK
++)))
++|(% 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
  (% style="color:blue" %)**Downlink Command:**
--* **Example**: 0xA6000001      ~/~/  Same as AT+ SETCNT =1
++0x28 01           ~/~/ Same As AT+SYNCMOD=1
--* **Example**: 0xA6000064      ~/~/  Same as AT+ SETCNT =100
++0x28 01 08      ~/~/ Same As AT+SYNCMOD=1,8
++0x28 01 F4      ~/~/ Same As AT+SYNCMOD=1,-12
++0x28 00           ~/~/ Same As AT+SYNCMOD=0
--== 2.10 Set Transmit Interval Time ==
++=== 3.3.9  Clear the open door times and the duration of the last open door ===
--(((
--Feature: Change NB-IoT End Node Transmit Interval.
--)))
--(((
--(% style="color:blue" %)**AT Command: AT+TDC**
--)))
++(% style="color:blue" %)**AT Command:**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
--|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
--30000
++|=(% 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
--the interval is 30000ms = 30s
  )))
--|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
++
++(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
++
++The sensor will clear the open door times and the duration of the last open door.
++
++
++=== 3.3.10  Set the count value of the number of 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**
++|(% style="width:155px" %)(((
++AT+SETCNT=1,100
++)))|(% style="width:259px" %)(((
++Set the open door times of PA8 pin to 100 times.
++)))|(% style="width:44px" %)(((
  OK
--Set transmit interval to 60000ms = 60 seconds
  )))
--
--(((
--(% style="color:blue" %)**Downlink Command: 0x01**
++|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
++|(% style="width:155px" %)(((
++AT+SETCNT=2,50
++)))|(% style="width:259px" %)(((
++Set the open door times of PA4 pin to 100 times.
++)))|(% style="width:44px" %)(((
++OK
  )))
--(((
--Format: Command Code (0x01) followed by 3 bytes time value.
--)))
++(% style="color:blue" %)**Downlink Command:**
--(((
--If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
--)))
++0xA6 01 00 00 64    ==>   AT+SETCNT=1,100
--* (((
--Example 1: Downlink Payload: 0100001E       ~/~/ Set Transmit Interval (TDC) = 30 seconds
--)))
--* (((
--Example 2: Downlink Payload: 0100003C      ~/~/ Set Transmit Interval (TDC) = 60 seconds
++0xA6 01 00 00 00    ==>   AT+SETCNT=1,0
++0xA6 02 00 00 32    ==>   AT+SETCNT=2,50
--
--)))
--= 3. Configure SW3L-NB =
++= 3. Configure DS03A-NB =
  == 3.1 Configure Methods ==
--SW3L-NB supports below configure method:
++DS03A-NB supports below configure method:
  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
  * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
--
--
  == 3.2 AT Commands Set ==
@@ -1019,7 +1019,7 @@
  = 4. Battery & Power Consumption =
--SW3L-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
++DS03A-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
@@ -1041,8 +1041,6 @@
  * 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]]**.
--
--
  = 6. FAQ =
  == 6.1 How can I access t BC660K-GL AT Commands? ==
@@ -1056,7 +1056,7 @@
  = 7. Order Info =
--Part Number: (% style="color:blue" %)**SW3L-NB-XX-YY**
++Part Number: (% style="color:blue" %)**DS03A-NB-XX**
  (% style="color:red" %)**XX**(%%):
@@ -1066,43 +1066,14 @@
  (% style="color:#037691" %)**1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
--(((
--(% style="color:blue" %)**YY**(%%): Flow Sensor Model:
--)))
--(((
--  **004:** DW-004 Flow Sensor: diameter: G1/2” / DN15.  450 pulse = 1 L
--)))
--(((
--  **006:** DW-006 Flow Sensor: diameter: G3/4” / DN20.  390 pulse = 1 L
--)))
--
--(((
--  **010:** DW-010 Flow Sensor: diameter: G 1” / DN25.   64 pulse = 1 L
--)))
--
--* (((
--calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
--)))
--
--* (((
--calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
--)))
--
--* (((
--calculate flag=2: for SW3L-010 Flow Sensor: 64   pulse = 1 L
--
--
--
--)))
--
  = 8. Packing Info =
  (% style="color:#037691" %)**Package Includes**:
--* SW3L-NB NB-IoT Distance Detection sensor x 1
++* DS03A-NB NB-IoT Door sensor x 1
  * External antenna x 1
@@ -1116,8 +1116,6 @@
  * Weight / pcs : 180g
--
--
  = 9. Support =

image-20231011092834-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+550.2 KB

Content

image-20231011093014-5.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+249.4 KB

Content

image-20231011093807-6.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+196.7 KB

Content