Changes for page wiki_test

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

From 107.9 to 107.8 From 107.20 to 107.19

From version 107.19

edited by Xiaoling
on 2023/10/11 14:49

Change comment: There is no comment for this version

To version 107.9

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -22,19 +22,19 @@
  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.
--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.
++DS03A-LB supports (% style="color:blue" %)**Datalog Feature,** (%%)it can save the data when there is no NB-IoT network and uplink when network recover.
--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.
++DS03A-LB has the (% style="color:blue" %)**Open Alarm Feature**,(%%) user can set this feature so the device will send an alarm if the door has been open for a certain time.
--DS03A-NB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
++DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
--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 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 (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
++SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
--DS03A-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
++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 has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
++SW3L-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"]]
@@ -141,7 +141,7 @@
  == 1.7 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:
@@ -205,12 +205,13 @@
  * Iron Door: 30 ~~ 45mm
++
  = 2. Use DS03A-NB to communicate with IoT Server =
  == 2.1 Send data to IoT server via NB-IoT network ==
--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.
++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.
  Below shows the network structure:
@@ -218,10 +218,10 @@
  [[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 DS03A-NB.
++There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of SW3L-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 DS03A-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 SW3L-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]].
@@ -251,13 +251,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 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]].
++(% 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]].
  == 2.2 Payload Types ==
--To meet different server requirement, DS03A-NB supports different payload type.
++To meet different server requirement, SW3L-NB supports different payload type.
  **Includes:**
@@ -283,7 +283,7 @@
  This is the General Json Format. As below:
--(% 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}}**
++(% 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}}**
  [[image:image-20230920175015-3.png||height="613" width="890"]]
@@ -314,7 +314,7 @@
  These bytes include the hardware and software version.
--(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x12 for DS03A-NB
++(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x11 for SW3L-NB
  (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
@@ -353,7 +353,7 @@
  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
--(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DS03A","flow": 502,"battery": 3.57,"signal": 23}**
++(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "SW3L","flow": 502,"battery": 3.57,"signal": 23}**
  [[image:image-20230922094043-2.png||height="558" width="851"]]
@@ -375,13 +375,13 @@
  == 2.3  Uplink Payload ==
--=== 2.3.1  Sensor Configuration, FPORT~=4 ===
++=== 2.3.2  Sensor Configuration, FPORT~=4 ===
--DS03A-NB 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:#4f81bd; color:white; width:515px" %)**Sensor Configuration FPORT=4**
++|(% 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
@@ -395,7 +395,7 @@
  Example parse in TTNv3
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/WebHome/image-20230630155527-3.png?width=902&height=146&rev=1.1||alt="image-20230630155527-3.png"]]
++[[image:image-20230630155527-3.png||height="146" width="902"]]
  * (((
@@ -409,9 +409,9 @@
  (% style="color:blue" %)**Disalarm: (default: 0)**
  )))
-- **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 = 1**, DS03A-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse.
-- **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.
++ **If Disalarm = 0**, DS03A-LB will send uplink at every TDC periodically and send data on each open/close event. This is useful for the application user need to monitor the open/close event in real-time.
  (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
@@ -421,7 +421,7 @@
  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
  )))
--Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H2.9A0AlarmBaseonTimeout"]]
++Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
@@ -432,29 +432,29 @@
  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.
--=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
++=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
--DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
++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="H2.7A0SetTransmitIntervalTime"]].
++* 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)(%%)**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
++|=(% 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
++)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
  **Status & Alarm:**
  (% 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:60px" %)**[bit7:bit4]**|(% style="background-color:#4f81bd; color:white; width:80px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:105px" %)**bit0**
++|(% 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" %)(((
@@ -463,7 +463,7 @@
  Status 0: Close; 1: Open
  )))
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/WebHome/image-20230630155451-2.png?width=928&height=246&rev=1.1||alt="image-20230630155451-2.png"]]
++[[image:image-20230630155451-2.png||height="246" width="928"]]
  * (((
@@ -513,7 +513,7 @@
  Unit: sec.
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/WebHome/image-20230701094042-1.png?width=763&height=154&rev=1.1||alt="image-20230701094042-1.png"]]
++[[image:image-20230701094042-1.png||height="154" width="763"]]
  **2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
@@ -523,13 +523,13 @@
  (% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
--|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
++|=(% 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|(% style="width:86px" %)(((
++)))|(% 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)
@@ -536,7 +536,7 @@
  **Status1 & Alarm1:**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
--|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit4]**|(% style="background-color:#4f81bd; color:white; width:70px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:117px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:117px" %)**bit0**
++|(% 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" %)(((
@@ -548,7 +548,7 @@
  **Status2 & Alarm2:**
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit2]**|(% style="background-color:#4f81bd; color:white; width:200px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:200px" %)**bit0**
++|(% 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" %)(((
@@ -555,7 +555,7 @@
  Status2 0: Close; 1: Open (PA4 of pin)
  )))
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/WebHome/image-20230630155908-6.png?width=927&height=295&rev=1.1||alt="image-20230630155908-6.png"]]
++[[image:image-20230630155908-6.png||height="295" width="927"]]
  * (((
@@ -578,7 +578,7 @@
  (% style="color:#0000ff" %)**Alarm1 or Alarm2**
  )))
--See [[Alarm Base on Timeout>>||anchor="H2.9A0AlarmBaseonTimeout"]]
++See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
  * (((
@@ -608,26 +608,26 @@
  [[image:image-20230701094042-1.png||height="154" width="763"]]
--=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
++=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
--DS03A-NB stores sensor values and users can retrieve these history values via the downlink command.
++DS03A-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
  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:510px" %)
--|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
++|=(% 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="H2.9A0AlarmBaseonTimeout"]]
++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
++)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
  **Status & Alarm:**
  (% 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:75px" %)**bit7**|(% style="background-color:#4f81bd; color:white; width:65px" %)**bit6**|(% style="background-color:#4f81bd; color:white; width:50px" %)**[bit5:bit4]**|(% style="background-color:#4f81bd; color:white; width:50px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:70px" %)**bit2**|(% style="background-color:#4f81bd; color:white; width:80px" %)**bit1**|(% style="background-color:#4f81bd; color:white; width:75px" %)**bit0**
++|(% 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" %)(((
@@ -639,7 +639,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-NB 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:
@@ -660,7 +660,7 @@
  **4. DR3**: total payload includes 22 entries of data.
  )))
--If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
++If DS03A-LB 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"]]
@@ -740,325 +740,161 @@
  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%)  ~/~/ Trigger by rising edge
++== 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 DS03A-NB didn't see any water flow in 15s, DS03A-NB will consider stop of water flow event.
  )))
++* (((
++(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**
++)))
++
  (((
--(% style="color:blue" %)**Downlink Command: 0x01**
++**Example:** 3 minutes, if DS03A-NB detect a start of water flow event and didn't detect a stop event within Alarm timer, DS03A-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
++(((
++(% style="color:blue" %)**AT Command to configure:**
  )))
++
  * (((
--Example 2: Downlink Payload: 0100003C      ~/~/ Set Transmit Interval (TDC) = 60 seconds
++AT+PTRIG=15,3   ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
  )))
--== 2.8 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:#4f81bd; color:white; width:153px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:276px" %)**Function**|(% style="background-color:#4f81bd; color:white; 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
--
--
--== 2.9  Alarm Base on Timeout ==
--
--
--DS03A-NB 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**
++AT+ PTRIG=15,0  ~-~-> Default Value, disable water waste Alarm.
  )))
--(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
--
--(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
--
--
--* (((
--(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
++(((
++(% style="color:blue" %)**Downlink Command to configure:**
  )))
--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.
--
--
--* (((
--(% style="color:blue" %)**Downlink Command**
++(((
++Command: **0xAA aa bb cc**
  )))
--(% 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-NB 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-NB 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.
++(((
++AA: Command Type Code
  )))
--* (((
--(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%)  **~-~-> ** Default Value, disable timeout Alarm.
--
--
--
++(((
++aa: Stop duration
  )))
--(% 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-NB 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-NB 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.
++(((
++bb cc: Alarm Timer
  )))
--* (((
--(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%)  **~-~-> ** Default Value, disable timeout Alarm.
--
--
--
++(((
++If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
  )))
--(% 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.
++== 2.8 Set the calculate flag ==
--== 2.10 TTRIG1 & TTRIG2 timeout status alarm ==
++Feature: Set the calculate flag
++(% style="color:blue" %)**AT Command: AT+CALCFLAG**
--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.
++(% 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
--(% style="color:blue" %)**AT Command:**
--
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 279px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 76px;background-color:#4F81BD;color:white" %)**Response**
--|(% 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
--)))
--
  (% style="color:blue" %)**Downlink Command:**
--Example:  0C aa  => AT+TTRALARM= aa
++* **Example**: 0XA501         ~/~/  Same as AT+CALCFLAG =1
++== 2.9 Set count number ==
--== 2.11 Count Mod ==
++Feature: Manually set the count number
--Feature: Manually set the count mode.
++(% 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:515px" %)
--|=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 275px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 86px;background-color:#4F81BD;color:white" %)**Response**
--|(% 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:**
--Example:  0B aa  => AT+COUNTMOD = second byte
++* **Example**: 0xA6000001      ~/~/  Same as AT+ SETCNT =1
++* **Example**: 0xA6000064      ~/~/  Same as AT+ SETCNT =100
--== 2.12  Number of channel of door sensors ==
++== 2.10 Set Transmit Interval Time ==
--Feature: Set the number of door sensor channels.
++(((
++Feature: Change NB-IoT End Node Transmit Interval.
++)))
--(% style="color:blue" %)**AT Command:**
++(((
++(% style="color:blue" %)**AT Command: AT+TDC**
++)))
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
--|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
--|(% style="width:155px" %)(((
--AT+TTRCHANNEL=1
--)))|(% style="width:259px" %)(((
--Set as single channel, only use PA8 pin as interrupt pin.
--)))|(% style="width:44px" %)(((
++(% 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="width:155px" %)(((
--AT+TTRCHANNEL=2
--)))|(% style="width:259px" %)(((
--Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
--)))|(% style="width:44px" %)(((
++|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
  OK
++Set transmit interval to 60000ms = 60 seconds
  )))
--(% style="color:blue" %)**Downlink Command:**
++(((
++(% style="color:blue" %)**Downlink Command: 0x01**
++)))
--Example:  0D aa => AT+TTRCHANNEL = second byte
++(((
++Format: Command Code (0x01) followed by 3 bytes time value.
++)))
--
--== 2.13 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.
--
--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:**
--
--(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
--|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
--|(% 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
++(((
++If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
  )))
--|(% 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:**
--
--0x28 01           ~/~/ Same As AT+SYNCMOD=1
--
--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.14  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:510px" %)
--|=(% style="width: 163px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 290px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**Response**
--|(% 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
++* (((
++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" %)**Downlink Command:**(%%)0xA6 01
--The sensor will clear the open door times and the duration of the last open door.
--
--
--== 2.15  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:#4F81BD;color:white" %)**Command Example**|=(% style="width: 288px; background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 57px;background-color:#4F81BD;color:white" %)**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
++
  )))
--|(% 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
--)))
--(% style="color:blue" %)**Downlink Command:**
--
--0xA6 01 00 00 64    ==>   AT+SETCNT=1,100
--
--0xA6 01 00 00 00    ==>   AT+SETCNT=1,0
--
--0xA6 02 00 00 32    ==>   AT+SETCNT=2,50
--
--
  = 3. Configure DS03A-NB =
  == 3.1 Configure Methods ==

Changes for page wiki_test

Summary

Details

Applications

Navigation