Changes for page wiki_test

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

From 132.1 to 131.3 From 133.2 to 133.1

From version 133.1

edited by Mengting Qiu
on 2023/11/15 17:57

Change comment: There is no comment for this version

To version 132.1

edited by Mengting Qiu
on 2023/11/15 16:54

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -291,7 +291,7 @@
  [[image:image-20231115162221-7.png]]
--**The General Json format payload for the double-channel mode is as follows:**
++**The General Json format payload for the single-channel mode is as follows:**
  (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DS03A-NB","level status":1,"alarm status":0,"door open num":2,"last open time":0,"level status2":1,"alarm status2":0,"door open num2":3,"last open time2":0,"battery":3.39,"signal":25,"1":{1,4,0,1,3,0,2023/11/15 07:54:30},"2":{1,3,0,1,6,1,2023/11/15 07:10:04},"3":{0,0,0,1,1,0,2023/11/15 06:55:04},"4":{0,0,0,1,0,0,2023/11/15 06:40:04},"5":{0,0,0,1,0,0,2023/11/15 03:50:36},"6":{0,0,0,1,4,11,2023/11/15 03:28:16},"7":{0,0,0,1,4,11,2023/11/15 03:13:16},"8":{0,0,0,1,3,11,2023/11/15 02:58:25}}**
@@ -418,10 +418,330 @@
  [[image:image-20231115154821-3.png||height="695" width="1119"]]
++== 2.3  Uplink Payload ==
--== 2.3 Test Uplink and Change Update Interval ==
++=== 2.3.1  Sensor Configuration, FPORT~=4 ===
++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:515px" %)
++|(% colspan="8" style="background-color:#4f81bd; color:white; 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/DS03A-LB/WebHome/image-20230630155527-3.png?width=902&height=146&rev=1.1||alt="image-20230630155527-3.png"]]
++
++
++* (((
++(% style="color:blue" %)**TDC: (default: 0x001C20)**
++)))
++
++Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
++
++
++* (((
++(% 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 = 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.
++
++(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
++
++
++* (((
++(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
++)))
++
++Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H2.9AlarmBaseonTimeout"]]
++
++
++* (((
++(% style="color:blue" %)**Alarm interval(default: 0)**
++)))
++
++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 ===
++
++
++DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
++
++* Every 2 hours, this interval [[can be changed>>||anchor="H2.7SetTransmitIntervalTime"]].
++* 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**
++|(% 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="H2.10TTRIG126TTRIG2timeoutstatusalarm"]]
++)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
++The last door open duration (unit: sec)
++)))|(% style="width:108px" %)Unix TimeStamp
++
++**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="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: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"]]
++
++
++* (((
++(% 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.
++
++
++* (((
++(% style="color:#0000ff" %)**Alarm**
++)))
++
++See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]]
++
++
++* (((
++(% style="color:blue" %)**Status**
++)))
++
++This bit is 1 when the door sensor is open and 0 when it is close.
++
++
++* (((
++(% style="color:blue" %)**Total open door events**
++)))
++
++Total pulse/counting base on open door.
++
++Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
++
++
++* (((
++(% style="color:blue" %)**The last door open duration**
++)))
++
++Door sensor last open duration.
++
++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"]]
++
++
++**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
++
++(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
++
++(% 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**
++|(% 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" %)(((
++Status2 & Alarm2
++)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
++
++**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="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)
++)))
++
++**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="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)
++)))
++
++[[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"]]
++
++
++* (((
++(% 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.
++
++
++* (((
++(% style="color:#0000ff" %)**Alarm1 or Alarm2**
++)))
++
++See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]]
++
++
++* (((
++(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
++)))
++
++This bit is 1 when the door sensor is open and 0 when it is close.
++
++
++* (((
++(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
++)))
++
++Total pulse/counting base on open door.
++
++Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
++
++
++* (((
++(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
++)))
++
++Door sensor last open duration.
++
++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"]]
++
++
++=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
++
++
++DS03A-NB stores sensor values and users can retrieve these history values via the downlink command.
++
++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**
++|(% 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="2.9AlarmBaseonTimeout"]]
++)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
++The last door open duration (unit: sec)
++)))|(% style="width:108px" %)Unix TimeStamp
++
++**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="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 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.
++)))
++
++For example, in the US915 band, the max payload for different DR is:
++
++(((
++**~1. DR0**: max is 11 bytes so one entry of data
++)))
++
++(((
++**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
++)))
++
++(((
++**3. DR2**: total payload includes 11 entries of data
++)))
++
++(((
++**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
++
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/WebHome/image-20230630155556-4.png?width=938&height=146&rev=1.1||alt="image-20230630155556-4.png"]]
++
++**Downlink:**
++
++0x31 64 9E 7D 34 64 9E 7E 9C 05
++
++
++**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
++
++
++**Parsed Value:**
++
++[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
++
++
++[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
++
++[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
++
++[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
++
++[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
++
++[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
++
++[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
++
++[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
++
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DS03A-LB/WebHome/image-20230630172740-1.png?width=868&height=199&rev=1.1||alt="image-20230630172740-1.png"]]
++
++
++== 2.4 Test Uplink and Change Update Interval ==
++
++
  By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
  User can use below commands to change the (% style="color:blue" %)**uplink interval**.
@@ -431,7 +431,7 @@
  User can also push the button for more than 1 seconds to activate an uplink.
--== 2.4 Multi-Samplings and One uplink ==
++== 2.5 Multi-Samplings and One uplink ==
  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:
@@ -445,7 +445,7 @@
  [[image:1692424376354-959.png]]
--== 2.5 Trggier an uplink by external interrupt ==
++== 2.6 Trggier an uplink by external interrupt ==
  DS03A-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
@@ -463,7 +463,7 @@
  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%)  ~/~/ Trigger by rising edge
  (% style="display:none" %) (%%)
--== 2.5 Set Transmit Interval Time ==
++== 2.7 Set Transmit Interval Time ==
  (((
@@ -505,7 +505,7 @@
  Example 2: Downlink Payload: 0100003C      ~/~/ Set Transmit Interval (TDC) = 60 seconds
  )))(% style="display:none" %) (%%)
--== 2.7 Enable / Disable Alarm ==
++== 2.8 Enable / Disable Alarm ==
  Feature: Enable/Disable Alarm for open/close event. Default value 0.
@@ -524,7 +524,7 @@
 xA7 00     ~/~/ Same As AT+DISALARM=0
--== 2.8 Alarm Base on Timeout ==
++== 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:
@@ -606,7 +606,7 @@
  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.9 TTRIG1 & TTRIG2 timeout status alarm ==
++== 2.10 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.
@@ -635,7 +635,7 @@
  Example:  0C aa  => AT+TTRALARM= aa
--== 2.10 Count Mod ==
++== 2.11 Count Mod ==
  Feature: Manually set the count mode.
@@ -664,7 +664,7 @@
  Example:  0B aa  => AT+COUNTMOD = second byte
--== 2.11 Number of channel of door sensors ==
++== 2.12 Number of channel of door sensors ==
  Feature: Set the number of door sensor channels.
@@ -693,7 +693,7 @@
  Example:  0D aa => AT+TTRCHANNEL = second byte
--== 2.12 Clear the open door times and the duration of the last open door ==
++== 2.13 Clear the open door times and the duration of the last open door ==
  (% style="color:blue" %)**AT Command:**
@@ -709,7 +709,7 @@
  The sensor will clear the open door times and the duration of the last open door.
--== 2.13 Set the count value of the number of open door ==
++== 2.14 Set the count value of the number of open door ==
  (% style="color:blue" %)**AT Command:**

Changes for page wiki_test

Summary

Details

Applications

Navigation