Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 107.6
edited by Xiaoling
on 2023/10/11 11:08
Change comment: There is no comment for this version
To version 107.10
edited by Xiaoling
on 2023/10/11 11:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -22,19 +22,19 @@
22 22  
23 23  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.
24 24  
25 -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.
25 +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.
26 26  
27 -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.
27 +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.
28 28  
29 -DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
29 +DS03A-NB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
30 30  
31 -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.
31 +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.
32 32  
33 -SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
33 +DS03A-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
34 34  
35 -SW3L-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
35 +DS03A-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
36 36  
37 -SW3L-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
37 +DS03A-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
38 38  
39 39  [[image:image-20231011093807-6.png||height="278" width="879"]]
40 40  
... ... @@ -141,7 +141,7 @@
141 141  == 1.7 BLE connection ==
142 142  
143 143  
144 -SW3L-NB support BLE remote configure and firmware update.
144 +DS03A-NB support BLE remote configure and firmware update.
145 145  
146 146  
147 147  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:
... ... @@ -206,23 +206,23 @@
206 206  
207 207  
208 208  
209 -= 2. Use SW3L-NB to communicate with IoT Server =
209 += 2. Use DS03A-NB to communicate with IoT Server =
210 210  
211 211  == 2.1 Send data to IoT server via NB-IoT network ==
212 212  
213 213  
214 -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.
214 +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.
215 215  
216 216  
217 217  Below shows the network structure:
218 218  
219 -[[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"]]
219 +[[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"]]
220 220  
221 221  
222 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of SW3L-NB.
222 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DS03A-NB.
223 223  
224 224  
225 -(% 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.
225 +(% 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.
226 226  
227 227  * 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]].
228 228  
... ... @@ -252,13 +252,13 @@
252 252  [[image:image-20230819113244-11.png||height="141" width="367"]]
253 253  )))|(% style="width:170px" %)
254 254  
255 -(% 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]].
255 +(% 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]].
256 256  
257 257  
258 258  == 2.2 ​Payload Types ==
259 259  
260 260  
261 -To meet different server requirement, SW3L-NB supports different payload type.
261 +To meet different server requirement, DS03A-NB supports different payload type.
262 262  
263 263  **Includes:**
264 264  
... ... @@ -284,7 +284,7 @@
284 284  
285 285  This is the General Json Format. As below:
286 286  
287 -(% 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}}**
287 +(% 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}}**
288 288  
289 289  
290 290  [[image:image-20230920175015-3.png||height="613" width="890"]]
... ... @@ -315,7 +315,7 @@
315 315  
316 316  These bytes include the hardware and software version.
317 317  
318 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x11 for SW3L-NB
318 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x12 for DS03A-NB
319 319  
320 320  (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
321 321  
... ... @@ -354,7 +354,7 @@
354 354  
355 355  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
356 356  
357 -(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "SW3L","flow": 502,"battery": 3.57,"signal": 23}**
357 +(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DS03A","flow": 502,"battery": 3.57,"signal": 23}**
358 358  
359 359  [[image:image-20230922094043-2.png||height="558" width="851"]]
360 360  
... ... @@ -376,326 +376,328 @@
376 376  
377 377  == 2.3  ​Uplink Payload ==
378 378  
379 -=== 2.3.1 Sensor Configuration, FPORT~=4 ===
379 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
380 380  
381 381  
382 -SW3L-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
382 +DS03A-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
383 383  
384 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
385 -|(% 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**
386 -|**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
384 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
385 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
386 +|**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**
387 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
388 +Keep status1
389 +)))|(% style="width:99px" %)(((
390 +Keep time1(unit: sec)
391 +)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
392 +Keep time2(unit: sec)
393 +)))|(% style="width:98px" %)(((
394 +Alarm interval(unit: min)
395 +)))
387 387  
388 388  Example parse in TTNv3
389 389  
390 -[[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"]]
399 +[[image:image-20230630155527-3.png||height="146" width="902"]]
391 391  
392 392  
393 -* (% style="color:blue" %)**TDC: (default: 0x0004B0)**
402 +* (((
403 +(% style="color:blue" %)**TDC: (default: 0x001C20)**
404 +)))
394 394  
395 -Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes.
406 +Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
396 396  
397 397  
398 -* (% style="color:blue" %)**STOP Duration & Alarm Timer**
409 +* (((
410 +(% style="color:blue" %)**Disalarm: (default: 0)**
411 +)))
399 399  
400 -Shows the configure value of [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]
413 + **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.
401 401  
415 + **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.
402 402  
403 -=== 2.3.2 Water Flow Value, Uplink FPORT~=2 ===
404 404  
418 +(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
405 405  
406 -(((
407 -SW3L-NB will send this uplink **after** Device Status once join the NB-IoT network successfully. And SW3L-NB will:
408 -)))
409 409  
410 -(((
411 -periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H2.10SetTransmitIntervalTime"]].
421 +* (((
422 +(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
412 412  )))
413 413  
414 -(((
415 -Uplink Payload totals 11 bytes.
425 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
426 +
427 +
428 +
429 +* (((
430 +(% style="color:blue" %)**Alarm interval(default: 0)**
416 416  )))
417 417  
418 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
419 -|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)**Water Flow Value,  FPORT=2**
420 -|(% 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**
421 -|(% style="width:110px" %)**Value**|(% style="width:81px" %)Calculate Flag & [[Alarm>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]|(% style="width:95px" %)(((
422 -Total pulse Or Last Pulse
423 -)))|(% style="width:78px" %)(((
424 -MOD & PA4_status & PB15_status
425 -)))|(% style="width:92px" %)Reserve(0x01)|(% style="width:134px" %)Unix TimeStamp
433 +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.
426 426  
427 -**Calculate Flag & Alarm:**
428 428  
429 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
430 -|(% 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**
431 -|(% 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
436 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
432 432  
433 -**MOD & PA4_status & PB15_status:**
434 434  
435 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:230px" %)
436 -|(% 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]**
437 -|(% style="width:88px" %)**Value**|(% style="width:117px" %)PA4_status|(% style="width:117px" %)PB15_status|(% style="width:118px" %)MOD
439 +DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
438 438  
439 -(% 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"]]
441 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
442 +* There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
440 440  
444 +**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
441 441  
442 -* (((
443 -(% style="color:blue" %)**Calculate Flag**
444 -)))
446 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
447 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
448 +|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
449 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
450 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
451 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
452 +The last door open duration (unit: sec)
453 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
445 445  
446 -(((
447 -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.
448 -)))
455 +**Status & Alarm:**
449 449  
450 -(((
451 -**Example: in the default payload:**
457 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
458 +|(% 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**
459 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
460 +Count mod
461 +)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
462 +Alarm 0: No Alarm; 1: Alarm
463 +)))|(% style="width:131px" %)(((
464 +Status 0: Close; 1: Open
452 452  )))
453 453  
467 +[[image:image-20230630155451-2.png||height="246" width="928"]]
468 +
469 +
454 454  * (((
455 -calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
471 +(% style="color:blue" %)**Count mod:Default=0**
456 456  )))
473 +
474 +0: Uplink total open door times since factory
475 +
476 +1: Uplink total open door times since last FPORT=2 uplink.
477 +
478 +
479 +* (% style="color:blue" %)**TDC flag**
480 +
481 +When the flag is 1, it means sending packets at normal time intervals.
482 +
483 +Otherwise, it is a packet sent at non-TDC time.
484 +
485 +
457 457  * (((
458 -calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
487 +(% style="color:#0000ff" %)**Alarm**
459 459  )))
489 +
490 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
491 +
492 +
460 460  * (((
461 -calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L
494 +(% style="color:blue" %)**Status**
462 462  )))
463 463  
464 -(((
465 -Default value: 0. 
497 +This bit is 1 when the door sensor is open and 0 when it is close.
498 +
499 +
500 +* (((
501 +(% style="color:blue" %)**Total open door events**
466 466  )))
467 467  
468 -(((
469 -Range (4 bits): (b)0000 ~~ (b) 1111
504 +Total pulse/counting base on open door.
470 470  
471 -If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server,
506 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
472 472  
473 -1) User can set the Calculate Flag of this sensor to 3.
474 474  
475 -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.
509 +* (((
510 +(% style="color:blue" %)**The last door open duration**
476 476  )))
477 477  
478 -(((
479 -(% 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"]]
513 +Door sensor last open duration.
480 480  
481 -(((
482 -
483 -)))
484 -)))
515 +Unit: sec.
485 485  
517 +[[image:image-20230701094042-1.png||height="154" width="763"]]
486 486  
487 -* (((
488 -(% style="color:blue" %)**Alarm**
489 -)))
490 490  
491 -(((
492 -See [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]
493 -)))
520 +**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
494 494  
495 -[[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"]]
522 +(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
496 496  
524 +(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
497 497  
498 -(((
499 -* (% style="color:blue" %)**TDC flag**
526 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
527 +|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
528 +|(% 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**
529 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
530 +Status1 & Alarm1
531 +)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
532 +The last door open duration1 (unit: sec)
533 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
534 +Status2 & Alarm2
535 +)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
500 500  
501 -When the flag is 1, it means sending packets at normal time intervals.
537 +**Status1 & Alarm1:**
502 502  
503 -Otherwise, it is a packet sent at non-TDC time.
539 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
540 +|(% 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**
541 +|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
542 +Count mod
543 +)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
544 +Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
545 +)))|(% style="width:181px" %)(((
546 +Status1 0: Close; 1: Open (PA8 of pin)
504 504  )))
505 505  
506 -* (((
507 -(% style="color:blue" %)**Total pulse**
508 -)))
549 +**Status2 & Alarm2:**
509 509  
510 -(((
511 -Total pulse/counting since factory
551 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
552 +|(% 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**
553 +|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
554 +Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
555 +)))|(% style="width:181px" %)(((
556 +Status2 0: Close; 1: Open (PA4 of pin)
512 512  )))
513 513  
514 -(((
515 -Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
559 +[[image:image-20230630155908-6.png||height="295" width="927"]]
516 516  
517 -
518 -)))
519 519  
520 520  * (((
521 -(% style="color:blue" %)**Last Pulse**
563 +(% style="color:blue" %)**Count mod:Default=0**
522 522  )))
523 523  
524 -(((
525 -Total pulse since last FPORT=2 uplink. (Default 20 minutes)
526 -)))
566 +0: Uplink total open door times since factory
527 527  
528 -(((
529 -Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
568 +1: Uplink total open door times since last FPORT=2 uplink.
530 530  
531 531  
532 -* (((
533 -(% style="color:blue" %)**PA4_status: Support digital level input below 3.3V**
534 -)))
571 +* (% style="color:blue" %)**TDC flag**
535 535  
536 -(((
537 -0 ~-~-> PA4 is at low level.
538 -)))
573 +When the flag is 1, it means sending packets at normal time intervals.
539 539  
540 -(((
541 -1 ~-~-> PA4 is at high level.
575 +Otherwise, it is a packet sent at non-TDC time.
542 542  
543 543  
544 544  * (((
545 -(% style="color:blue" %)**PB15_status: Support digital level input below 3.3V**
579 +(% style="color:#0000ff" %)**Alarm1 or Alarm2**
546 546  )))
547 547  
548 -(((
549 -0 ~-~-> PB15 is at low level.
550 -)))
582 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
551 551  
552 -(((
553 -1 ~-~-> PB15 is at high level..
554 -)))
555 -)))
556 -)))
557 557  
558 558  * (((
559 -(% style="color:blue" %)**MOD: Default =0**
586 +(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
560 560  )))
561 561  
562 -(((
563 -MOD=0 ~-~-> Uplink Total Pulse since factory
564 -)))
589 +This bit is 1 when the door sensor is open and 0 when it is close.
565 565  
566 -(((
567 -MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink.
568 568  
569 -
570 -)))
571 -
572 572  * (((
573 -(% style="color:blue" %)**Water Flow Value**
593 +(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
574 574  )))
575 575  
576 -(((
577 -**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L**
578 -)))
596 +Total pulse/counting base on open door.
579 579  
580 -[[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"]]
598 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
581 581  
582 582  
583 -(((
584 -**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L**
601 +* (((
602 +(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
585 585  )))
586 586  
587 -[[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"]] ** **
605 +Door sensor last open duration.
588 588  
607 +Unit: sec.
589 589  
590 -=== 2.3.3 Historical Water Flow Status, FPORT~=3 ===
609 +[[image:image-20230701094042-1.png||height="154" width="763"]]
591 591  
592 592  
593 -(((
594 -SW3L-NB stores sensor values and users can retrieve these history values via the downlink command.
595 -)))
612 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
596 596  
597 -(((
598 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
599 599  
600 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
601 -|=(% colspan="6" style="width: 515px; background-color:#4F81BD;color:white" %)**Water Flow Value,  FPORT=3**
602 -|(% 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**
603 -|(% style="width:110px" %)**Value**|(% style="width:81px" %)Calculate Flag & [[Alarm>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]|(% style="width:95px" %)(((
604 -Total pulse Or Last Pulse
605 -)))|(% style="width:78px" %)(((
606 -MOD & PA4_status & PB15_status
607 -)))|(% style="width:92px" %)Reserve(0x01)|(% style="width:134px" %)Unix TimeStamp
615 +DS03A-NB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
608 608  
609 -**Calculate Flag & Alarm:**
617 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
610 610  
611 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
612 -|(% 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**
613 -|(% style="width:88px" %)**Value**|(% style="width:96px" %)(((
614 -No ACK message
615 -)))|(% 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
619 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
620 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
621 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
622 +|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
623 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
624 +)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
625 +The last door open duration (unit: sec)
626 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
616 616  
617 -**MOD & PA4_status & PB15_status:**
628 +**Status & Alarm:**
618 618  
619 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:240px" %)
620 -|(% 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]**
621 -|(% style="width:88px" %)**Value**|(% style="width:117px" %)PA4_status|(% style="width:117px" %)PB15_status|(% style="width:118px" %)MOD
630 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
631 +|(% 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**
632 +|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
633 +Count mod
634 +)))|(% style="width:95px" %)(((
635 +TDC flag 0:No; 1:Yes
636 +)))|(% style="width:116px" %)(((
637 +Alarm 0: No Alarm; 1: Alarm
638 +)))|(% style="width:112px" %)(((
639 +Status 0:Close; 1: Open
622 622  )))
623 623  
624 624  * (((
625 -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.
643 +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.
626 626  )))
627 627  
628 -(((
629 629  For example, in the US915 band, the max payload for different DR is:
630 -)))
631 631  
632 632  (((
633 -(% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data
649 +**~1. DR0**: max is 11 bytes so one entry of data
634 634  )))
635 635  
636 636  (((
637 -(% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
653 +**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
638 638  )))
639 639  
640 640  (((
641 -(% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data
657 +**3. DR2**: total payload includes 11 entries of data
642 642  )))
643 643  
644 644  (((
645 -(% style="color:blue" %)**d) DR3:**(%%) total payload includes 22 entries of data.
661 +**4. DR3**: total payload includes 22 entries of data.
646 646  )))
647 647  
648 -(((
649 -If SW3L-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
664 +If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
650 650  
651 -
652 -)))
666 +[[image:image-20230630155556-4.png||height="146" width="938"]]
653 653  
654 -(((
655 -(% style="color:#037691" %)**Downlink:**
656 -)))
668 +**Downlink:**
657 657  
658 -(((
659 -0x31 64 92 C5 AC 64 92 C7 8C 05
660 -)))
670 +0x31 64 9E 7D 34 64 9E 7E 9C 05
661 661  
662 -[[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"]]
663 663  
673 +**Uplink:**
664 664  
665 -(((
666 -(% style="color:#037691" %)**Uplink:**
667 -)))
675 +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
668 668  
669 -(((
670 -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
671 671  
672 -
673 -)))
678 +**Parsed Value:**
674 674  
675 -(((
676 -(% style="color:#037691" %)**Parsed Value:**
677 -)))
680 +[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
678 678  
679 -(((
680 -[TDC_flag, Alarm, Calculate Flag, PA4_status, PB15_status, MOD, Total pulse or Last Pulse,** **Water Flow Value, TIME]
681 -)))
682 682  
683 +[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
683 683  
684 -(((
685 -[YES,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:41:56],
685 +[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
686 686  
687 -[NO,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:42:30],
687 +[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
688 688  
689 -[YES,FALSE,2,L,H,1,0, 0.0,2023-06-21 09:44:43],
689 +[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
690 690  
691 -[YES,FALSE,2,H,L,1,0, 0.0,2023-06-21 09:47:32],
691 +[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
692 692  
693 -[NO,TRUE ,2, L,L,1,45,0.7,2023-06-21 09:48:44],
694 -)))
693 +[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
695 695  
696 -[[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"]]
695 +[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
697 697  
697 +[[image:image-20230630172740-1.png||height="199" width="868"]]
698 698  
699 +
700 +
699 699  == 2.4 Test Uplink and Change Update Interval ==
700 700  
701 701  
... ... @@ -711,7 +711,7 @@
711 711  == 2.5 Multi-Samplings and One uplink ==
712 712  
713 713  
714 -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:
716 +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:
715 715  
716 716  * (% 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)
717 717  
... ... @@ -725,7 +725,7 @@
725 725  == 2.6 Trggier an uplink by external interrupt ==
726 726  
727 727  
728 -SW3L-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
730 +DS03A-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
729 729  
730 730  (% style="color:blue" %)**AT command:**
731 731  
... ... @@ -759,7 +759,7 @@
759 759  )))
760 760  
761 761  (((
762 -Default: 15s, If SW3L-NB didn't see any water flow in 15s, SW3L-NB will consider stop of water flow event.
764 +Default: 15s, If DS03A-NB didn't see any water flow in 15s, DS03A-NB will consider stop of water flow event.
763 763  )))
764 764  
765 765  * (((
... ... @@ -767,7 +767,7 @@
767 767  )))
768 768  
769 769  (((
770 -**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.
772 +**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.
771 771  )))
772 772  
773 773  (((
... ... @@ -894,12 +894,12 @@
894 894  
895 895  )))
896 896  
897 -= 3. Configure SW3L-NB =
899 += 3. Configure DS03A-NB =
898 898  
899 899  == 3.1 Configure Methods ==
900 900  
901 901  
902 -SW3L-NB supports below configure method:
904 +DS03A-NB supports below configure method:
903 903  
904 904  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
905 905  
... ... @@ -988,7 +988,7 @@
988 988  = 4. Battery & Power Consumption =
989 989  
990 990  
991 -SW3L-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
993 +DS03A-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
992 992  
993 993  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
994 994  
... ... @@ -1023,7 +1023,7 @@
1023 1023  = 7. Order Info =
1024 1024  
1025 1025  
1026 -Part Number: (% style="color:blue" %)**SW3L-NB-XX-YY**
1028 +Part Number: (% style="color:blue" %)**DS03A-NB-XX**
1027 1027  
1028 1028  (% style="color:red" %)**XX**(%%):
1029 1029  
... ... @@ -1033,43 +1033,14 @@
1033 1033  
1034 1034  (% 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
1035 1035  
1036 -(((
1037 -(% style="color:blue" %)**YY**(%%): Flow Sensor Model:
1038 -)))
1039 1039  
1040 -(((
1041 - **004:** DW-004 Flow Sensor: diameter: G1/2” / DN15.  450 pulse = 1 L
1042 -)))
1043 1043  
1044 -(((
1045 - **006:** DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L
1046 -)))
1047 -
1048 -(((
1049 - **010:** DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L
1050 -)))
1051 -
1052 -* (((
1053 -calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
1054 -)))
1055 -
1056 -* (((
1057 -calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
1058 -)))
1059 -
1060 -* (((
1061 -calculate flag=2: for SW3L-010 Flow Sensor: 64  pulse = 1 L
1062 -
1063 -
1064 -
1065 -)))
1066 -
1067 1067  = 8. ​Packing Info =
1068 1068  
1069 1069  
1070 1070  (% style="color:#037691" %)**Package Includes**:
1071 1071  
1072 -* SW3L-NB NB-IoT Distance Detection sensor x 1
1045 +* DS03A-NB NB-IoT Door sensor x 1
1073 1073  
1074 1074  * External antenna x 1
1075 1075