Changes for page wiki_test

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

From version 107.30
edited by Xiaoling
on 2023/10/12 16:20
Change comment: There is no comment for this version
To version 107.6
edited by Xiaoling
on 2023/10/11 11:08
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-NB 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-LB 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-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.
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.
28 28  
29 -DS03A-NB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
29 +DS03A-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures
30 30  
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.
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.
32 32  
33 -DS03A-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
33 +SW3L-NB (% style="color:blue" %)**supports BLE configure **(%%)and(% style="color:blue" %)** OTA update**(%%) which make user easy to use.
34 34  
35 -DS03A-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
35 +SW3L-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 -DS03A-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
37 +SW3L-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  
... ... @@ -138,13 +138,10 @@
138 138  )))
139 139  |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
140 140  
141 -(% style="color:red" %)**Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.**
142 -
143 -
144 144  == 1.7 BLE connection ==
145 145  
146 146  
147 -DS03A-NB support BLE remote configure and firmware update.
144 +SW3L-NB support BLE remote configure and firmware update.
148 148  
149 149  
150 150  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:
... ... @@ -207,23 +207,25 @@
207 207  * Wood Door: 10mm ~~ 30mm
208 208  * Iron Door: 30 ~~ 45mm
209 209  
210 -= 2. Use DS03A-NB to communicate with IoT Server =
211 211  
208 +
209 += 2. Use SW3L-NB to communicate with IoT Server =
210 +
212 212  == 2.1 Send data to IoT server via NB-IoT network ==
213 213  
214 214  
215 -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.
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.
216 216  
217 217  
218 218  Below shows the network structure:
219 219  
220 -[[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"]]
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"]]
221 221  
222 222  
223 -There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of DS03A-NB.
222 +There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of SW3L-NB.
224 224  
225 225  
226 -(% 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.
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.
227 227  
228 228  * 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]].
229 229  
... ... @@ -253,13 +253,13 @@
253 253  [[image:image-20230819113244-11.png||height="141" width="367"]]
254 254  )))|(% style="width:170px" %)
255 255  
256 -(% 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]].
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]].
257 257  
258 258  
259 259  == 2.2 ​Payload Types ==
260 260  
261 261  
262 -To meet different server requirement, DS03A-NB supports different payload type.
261 +To meet different server requirement, SW3L-NB supports different payload type.
263 263  
264 264  **Includes:**
265 265  
... ... @@ -285,7 +285,7 @@
285 285  
286 286  This is the General Json Format. As below:
287 287  
288 -(% 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}}**
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}}**
289 289  
290 290  
291 291  [[image:image-20230920175015-3.png||height="613" width="890"]]
... ... @@ -316,7 +316,7 @@
316 316  
317 317  These bytes include the hardware and software version.
318 318  
319 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x12 for DS03A-NB
318 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x11 for SW3L-NB
320 320  
321 321  (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0
322 322  
... ... @@ -355,11 +355,12 @@
355 355  
356 356  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
357 357  
358 -(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "DS03A","flow": 502,"battery": 3.57,"signal": 23}**
357 +(% style="color:#4472c4" %)** {"IMEI": "866207058378443","Model": "SW3L","flow": 502,"battery": 3.57,"signal": 23}**
359 359  
360 360  [[image:image-20230922094043-2.png||height="558" width="851"]]
361 361  
362 362  
362 +
363 363  === 2.2.4 ThingSpeak Payload(Type~=1) ===
364 364  
365 365  
... ... @@ -376,325 +376,326 @@
376 376  
377 377  == 2.3  ​Uplink Payload ==
378 378  
379 -=== 2.3.1  Sensor Configuration, FPORT~=4 ===
379 +=== 2.3.1 Sensor Configuration, FPORT~=4 ===
380 380  
381 381  
382 -DS03A-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
382 +SW3L-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:515px" %)
385 -|(% colspan="8" style="background-color:#4f81bd; color:white; 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 -)))
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
396 396  
397 397  Example parse in TTNv3
398 398  
399 -[[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"]]
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"]]
400 400  
401 401  
402 -* (((
403 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
404 -)))
393 +* (% style="color:blue" %)**TDC: (default: 0x0004B0)**
405 405  
406 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
395 +Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes.
407 407  
408 408  
409 -* (((
410 -(% style="color:blue" %)**Disalarm: (default: 0)**
411 -)))
398 +* (% style="color:blue" %)**STOP Duration & Alarm Timer**
412 412  
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.
400 +Shows the configure value of [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]
414 414  
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.
416 416  
417 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
403 +=== 2.3.2 Water Flow Value, Uplink FPORT~=2 ===
418 418  
419 419  
420 -* (((
421 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
406 +(((
407 +SW3L-NB will send this uplink **after** Device Status once join the NB-IoT network successfully. And SW3L-NB will:
422 422  )))
423 423  
424 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H2.9AlarmBaseonTimeout"]]
410 +(((
411 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H2.10SetTransmitIntervalTime"]].
412 +)))
425 425  
426 -
427 -* (((
428 -(% style="color:blue" %)**Alarm interval(default: 0)**
414 +(((
415 +Uplink Payload totals 11 bytes.
429 429  )))
430 430  
431 -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.
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
432 432  
427 +**Calculate Flag & Alarm:**
433 433  
434 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
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
435 435  
433 +**MOD & PA4_status & PB15_status:**
436 436  
437 -DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
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
438 438  
439 -* Every 2 hours, this interval [[can be changed>>||anchor="H2.7SetTransmitIntervalTime"]].
440 -* There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
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 441  
442 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
443 443  
444 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
445 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
446 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
447 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
448 -Status & [[Alarm>>||anchor="2.10TTRIG126TTRIG2timeoutstatusalarm"]]
449 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
450 -The last door open duration (unit: sec)
451 -)))|(% style="width:108px" %)Unix TimeStamp
442 +* (((
443 +(% style="color:blue" %)**Calculate Flag**
444 +)))
452 452  
453 -**Status & Alarm:**
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 +)))
454 454  
455 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
456 -|(% 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**
457 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
458 -Count mod
459 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
460 -Alarm 0: No Alarm; 1: Alarm
461 -)))|(% style="width:131px" %)(((
462 -Status 0: Close; 1: Open
450 +(((
451 +**Example: in the default payload:**
463 463  )))
464 464  
465 -[[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"]]
466 -
467 -
468 468  * (((
469 -(% style="color:blue" %)**Count mod:Default=0**
455 +calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L
470 470  )))
471 -
472 -0: Uplink total open door times since factory
473 -
474 -1: Uplink total open door times since last FPORT=2 uplink.
475 -
476 -
477 -* (% style="color:blue" %)**TDC flag**
478 -
479 -When the flag is 1, it means sending packets at normal time intervals.
480 -
481 -Otherwise, it is a packet sent at non-TDC time.
482 -
483 -
484 484  * (((
485 -(% style="color:#0000ff" %)**Alarm**
458 +calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L
486 486  )))
487 -
488 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
489 -
490 -
491 491  * (((
492 -(% style="color:blue" %)**Status**
461 +calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L
493 493  )))
494 494  
495 -This bit is 1 when the door sensor is open and 0 when it is close.
496 -
497 -
498 -* (((
499 -(% style="color:blue" %)**Total open door events**
464 +(((
465 +Default value: 0. 
500 500  )))
501 501  
502 -Total pulse/counting base on open door.
468 +(((
469 +Range (4 bits): (b)0000 ~~ (b) 1111
503 503  
504 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
471 +If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server,
505 505  
473 +1) User can set the Calculate Flag of this sensor to 3.
506 506  
507 -* (((
508 -(% style="color:blue" %)**The last door open duration**
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 509  )))
510 510  
511 -Door sensor last open duration.
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"]]
512 512  
513 -Unit: sec.
481 +(((
482 +
483 +)))
484 +)))
514 514  
515 -[[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"]]
516 516  
487 +* (((
488 +(% style="color:blue" %)**Alarm**
489 +)))
517 517  
518 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
491 +(((
492 +See [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]]
493 +)))
519 519  
520 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
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"]]
521 521  
522 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
523 523  
524 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
525 -|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
526 -|(% 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**
527 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
528 -Status1 & Alarm1
529 -)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
530 -The last door open duration1 (unit: sec)
531 -)))|(% style="width:100px" %)Unix TimeStamp|(% style="width:86px" %)(((
532 -Status2 & Alarm2
533 -)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
498 +(((
499 +* (% style="color:blue" %)**TDC flag**
534 534  
535 -**Status1 & Alarm1:**
501 +When the flag is 1, it means sending packets at normal time intervals.
536 536  
537 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
538 -|(% 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**
539 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
540 -Count mod
541 -)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
542 -Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
543 -)))|(% style="width:181px" %)(((
544 -Status1 0: Close; 1: Open (PA8 of pin)
503 +Otherwise, it is a packet sent at non-TDC time.
545 545  )))
546 546  
547 -**Status2 & Alarm2:**
506 +* (((
507 +(% style="color:blue" %)**Total pulse**
508 +)))
548 548  
549 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
550 -|(% 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**
551 -|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
552 -Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
553 -)))|(% style="width:181px" %)(((
554 -Status2 0: Close; 1: Open (PA4 of pin)
510 +(((
511 +Total pulse/counting since factory
555 555  )))
556 556  
557 -[[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"]]
514 +(((
515 +Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
558 558  
517 +
518 +)))
559 559  
560 560  * (((
561 -(% style="color:blue" %)**Count mod:Default=0**
521 +(% style="color:blue" %)**Last Pulse**
562 562  )))
563 563  
564 -0: Uplink total open door times since factory
524 +(((
525 +Total pulse since last FPORT=2 uplink. (Default 20 minutes)
526 +)))
565 565  
566 -1: Uplink total open door times since last FPORT=2 uplink.
528 +(((
529 +Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF .
567 567  
568 568  
569 -* (% style="color:blue" %)**TDC flag**
532 +* (((
533 +(% style="color:blue" %)**PA4_status: Support digital level input below 3.3V**
534 +)))
570 570  
571 -When the flag is 1, it means sending packets at normal time intervals.
536 +(((
537 +0 ~-~-> PA4 is at low level.
538 +)))
572 572  
573 -Otherwise, it is a packet sent at non-TDC time.
540 +(((
541 +1 ~-~-> PA4 is at high level.
574 574  
575 575  
576 576  * (((
577 -(% style="color:#0000ff" %)**Alarm1 or Alarm2**
545 +(% style="color:blue" %)**PB15_status: Support digital level input below 3.3V**
578 578  )))
579 579  
580 -See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]]
548 +(((
549 +0 ~-~-> PB15 is at low level.
550 +)))
581 581  
552 +(((
553 +1 ~-~-> PB15 is at high level..
554 +)))
555 +)))
556 +)))
582 582  
583 583  * (((
584 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
559 +(% style="color:blue" %)**MOD: Default =0**
585 585  )))
586 586  
587 -This bit is 1 when the door sensor is open and 0 when it is close.
562 +(((
563 +MOD=0 ~-~-> Uplink Total Pulse since factory
564 +)))
588 588  
566 +(((
567 +MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink.
589 589  
569 +
570 +)))
571 +
590 590  * (((
591 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
573 +(% style="color:blue" %)**Water Flow Value**
592 592  )))
593 593  
594 -Total pulse/counting base on open door.
576 +(((
577 +**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L**
578 +)))
595 595  
596 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
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"]]
597 597  
598 598  
599 -* (((
600 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
583 +(((
584 +**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L**
601 601  )))
602 602  
603 -Door sensor last open duration.
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"]] ** **
604 604  
605 -Unit: sec.
606 606  
607 -[[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"]]
590 +=== 2.3.3 Historical Water Flow Status, FPORT~=3 ===
608 608  
609 609  
610 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
593 +(((
594 +SW3L-NB stores sensor values and users can retrieve these history values via the downlink command.
595 +)))
611 611  
597 +(((
598 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
612 612  
613 -DS03A-NB stores sensor values and users can retrieve these history values via the downlink command.
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
614 614  
615 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
609 +**Calculate Flag & Alarm:**
616 616  
617 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
618 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
619 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
620 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
621 -Status & [[Alarm>>||anchor="H2.9A0AlarmBaseonTimeout"]]
622 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
623 -The last door open duration (unit: sec)
624 -)))|(% style="width:108px" %)Unix TimeStamp
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
625 625  
626 -**Status & Alarm:**
617 +**MOD & PA4_status & PB15_status:**
627 627  
628 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
629 -|(% 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**
630 -|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
631 -Count mod
632 -)))|(% style="width:95px" %)(((
633 -TDC flag 0:No; 1:Yes
634 -)))|(% style="width:116px" %)(((
635 -Alarm 0: No Alarm; 1: Alarm
636 -)))|(% style="width:112px" %)(((
637 -Status 0:Close; 1: Open
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
638 638  )))
639 639  
640 640  * (((
641 -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.
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.
642 642  )))
643 643  
628 +(((
644 644  For example, in the US915 band, the max payload for different DR is:
630 +)))
645 645  
646 646  (((
647 -**~1. DR0**: max is 11 bytes so one entry of data
633 +(% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data
648 648  )))
649 649  
650 650  (((
651 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
637 +(% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
652 652  )))
653 653  
654 654  (((
655 -**3. DR2**: total payload includes 11 entries of data
641 +(% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data
656 656  )))
657 657  
658 658  (((
659 -**4. DR3**: total payload includes 22 entries of data.
645 +(% style="color:blue" %)**d) DR3:**(%%) total payload includes 22 entries of data.
660 660  )))
661 661  
662 -If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
648 +(((
649 +If SW3L-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
663 663  
664 -[[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"]]
651 +
652 +)))
665 665  
666 -**Downlink:**
654 +(((
655 +(% style="color:#037691" %)**Downlink:**
656 +)))
667 667  
668 -0x31 64 9E 7D 34 64 9E 7E 9C 05
658 +(((
659 +0x31 64 92 C5 AC 64 92 C7 8C 05
660 +)))
669 669  
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"]]
670 670  
671 -**Uplink:**
672 672  
673 -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
665 +(((
666 +(% style="color:#037691" %)**Uplink:**
667 +)))
674 674  
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
675 675  
676 -**Parsed Value:**
672 +
673 +)))
677 677  
678 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
675 +(((
676 +(% style="color:#037691" %)**Parsed Value:**
677 +)))
679 679  
679 +(((
680 +[TDC_flag, Alarm, Calculate Flag, PA4_status, PB15_status, MOD, Total pulse or Last Pulse,** **Water Flow Value, TIME]
681 +)))
680 680  
681 -[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
682 682  
683 -[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
684 +(((
685 +[YES,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:41:56],
684 684  
685 -[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
687 +[NO,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:42:30],
686 686  
687 -[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
689 +[YES,FALSE,2,L,H,1,0, 0.0,2023-06-21 09:44:43],
688 688  
689 -[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
691 +[YES,FALSE,2,H,L,1,0, 0.0,2023-06-21 09:47:32],
690 690  
691 -[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
693 +[NO,TRUE ,2, L,L,1,45,0.7,2023-06-21 09:48:44],
694 +)))
692 692  
693 -[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
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"]]
694 694  
695 -[[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"]]
696 696  
697 -
698 698  == 2.4 Test Uplink and Change Update Interval ==
699 699  
700 700  
... ... @@ -710,7 +710,7 @@
710 710  == 2.5 Multi-Samplings and One uplink ==
711 711  
712 712  
713 -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:
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:
714 714  
715 715  * (% 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)
716 716  
... ... @@ -724,7 +724,7 @@
724 724  == 2.6 Trggier an uplink by external interrupt ==
725 725  
726 726  
727 -DS03A-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
728 +SW3L-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
728 728  
729 729  (% style="color:blue" %)**AT command:**
730 730  
... ... @@ -738,293 +738,167 @@
738 738  
739 739  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
740 740  
741 -== 2.7 Set Transmit Interval Time ==
742 +== 2.7 Alarm for continuously water flow ==
742 742  
743 743  
744 744  (((
745 -Feature: Change NB-IoT End Node Transmit Interval.
746 +This feature is to monitor and send Alarm for continuously water flow.
746 746  )))
747 747  
748 748  (((
749 -(% style="color:blue" %)**AT Command: AT+TDC**
750 +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.
750 750  )))
751 751  
752 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
753 -|=(% 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**
754 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
755 -30000
756 -OK
757 -the interval is 30000ms = 30s
753 +(((
754 +To monitor this faulty and send alarm, there are two settings:
758 758  )))
759 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
760 -OK
761 -Set transmit interval to 60000ms = 60 seconds
756 +
757 +* (((
758 +(% style="color:blue" %)**Stop Duration: Unit: Second**
762 762  )))
763 763  
764 764  (((
765 -(% style="color:blue" %)**Downlink Command: 0x01**
762 +Default: 15s, If SW3L-NB didn't see any water flow in 15s, SW3L-NB will consider stop of water flow event.
766 766  )))
767 767  
765 +* (((
766 +(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**
767 +)))
768 +
768 768  (((
769 -Format: Command Code (0x01) followed by 3 bytes time value.
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.
770 770  )))
771 771  
772 772  (((
773 -If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
774 +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.
774 774  )))
775 775  
776 -* (((
777 -Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
777 +(((
778 +(% 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.**
778 778  )))
779 -* (((
780 -Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
781 781  
782 -
783 -
781 +(((
782 +(% style="color:blue" %)**AT Command to configure:**
784 784  )))
785 785  
786 -== 2.8 Enable / Disable Alarm ==
787 -
788 -
789 -Feature: Enable/Disable Alarm for open/close event. Default value 0.
790 -
791 -(% style="color:blue" %)**AT Command: **
792 -
793 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
794 -|(% 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**
795 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
796 -|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
797 -
798 -(% style="color:blue" %)**Downlink Command: **
799 -
800 -0xA7 01  ~/~/ Same As AT+DISALARM=1
801 -
802 -0xA7 00  ~/~/ Same As AT+DISALARM=0
803 -
804 -
805 -== 2.9 Alarm Base on Timeout ==
806 -
807 -
808 -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:
809 -
810 810  * (((
811 -(% style="color:blue" %)**Keep Status: Status to be monitor**
786 +AT+PTRIG=15,3  ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
812 812  )))
813 813  
814 -(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
815 -
816 -(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
817 -
818 -
819 819  * (((
820 -(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
790 +AT+ PTRIG=15,0  ~-~-> Default Value, disable water waste Alarm.
821 821  )))
822 822  
823 -Range 0 ~~ 65535(0xFFFF) seconds.
793 +(((
794 +(% style="color:blue" %)**Downlink Command to configure:** 
795 +)))
824 824  
825 -If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
826 -
827 -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.
828 -
829 -
830 -* (((
831 -(% style="color:blue" %)**Downlink Command**
797 +(((
798 +Command: **0xAA aa bb cc**
832 832  )))
833 833  
834 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
835 -
836 -**A9:** Command Type Code
837 -
838 -**aa: **01:TTRIG1; 02:TTRIG2
839 -
840 -**bb:** status to be monitored
841 -
842 -**cc dd:** timeout.
843 -
844 -
845 -**1) AT+TTRIG1 : (PA8 of pin)**
846 -
847 -(% style="color:blue" %)**AT Command to configure:**
848 -
849 -* (((
850 -(% 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.
851 -
852 -(% 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.
801 +(((
802 +AA: Command Type Code
853 853  )))
854 854  
855 -* (((
856 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
857 -
858 -
805 +(((
806 +aa: Stop duration
859 859  )))
860 860  
861 -(% style="color:blue" %)**Downlink Command to configure:**
862 -
863 -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.
864 -
865 -
866 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
867 -
868 -(% style="color:blue" %)**AT Command to configure:**
869 -
870 -* (((
871 -(% 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.
872 -
873 -(% 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.
809 +(((
810 +bb cc: Alarm Timer
874 874  )))
875 875  
876 -* (((
877 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
878 -
879 -
813 +(((
814 +If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
880 880  )))
881 881  
882 -(% style="color:blue" %)**Downlink Command to configure:**
883 883  
884 -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.
818 +== 2.8 Set the calculate flag ==
885 885  
886 886  
887 -== 2.10 TTRIG1 & TTRIG2 timeout status alarm ==
821 +Feature: Set the calculate flag
888 888  
823 +(% style="color:blue" %)**AT Command: AT+CALCFLAG**
889 889  
890 -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.
825 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
826 +|=(% 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**
827 +|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK
828 +|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK
891 891  
892 -(% style="color:blue" %)**AT Command:**
893 -
894 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
895 -|=(% 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**
896 -|(% style="width:155px" %)(((
897 -AT+TTRALARM=0
898 -)))|(% style="width:279px" %)(((
899 -disable continuous alarm
900 -)))|(% style="width:84px" %)(((
901 -OK
902 -)))
903 -|(% style="width:155px" %)(((
904 -AT+TTRALARM=60
905 -)))|(% style="width:279px" %)(((
906 -The alarm interval is 60 minutes (unit: minutes)
907 -)))|(% style="width:84px" %)(((
908 -OK
909 -)))
910 -
911 911  (% style="color:blue" %)**Downlink Command:**
912 912  
913 -Example:  0C aa  => AT+TTRALARM= aa
832 +* **Example**: 0XA501  ~/~/  Same as AT+CALCFLAG =1
914 914  
834 +== 2.9 Set count number ==
915 915  
916 -== 2.11 Count Mod ==
917 917  
837 +Feature: Manually set the count number
918 918  
919 -Feature: Manually set the count mode.
839 +(% style="color:blue" %)**AT Command: AT+SETCNT**
920 920  
921 -(% style="color:blue" %)**AT Command:**
841 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
842 +|=(% 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**
843 +|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK
844 +|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK
922 922  
923 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
924 -|=(% 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**
925 -|(% style="width:155px" %)(((
926 -AT+COUNTMOD=0
927 -)))|(% style="width:277px" %)(((
928 -the count value keeps accumulating mode
929 -)))|(% style="width:86px" %)(((
930 -OK
931 -)))
932 -|(% style="width:155px" %)(((
933 -AT+COUNTMOD=1
934 -)))|(% style="width:277px" %)(((
935 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
936 -)))|(% style="width:86px" %)(((
937 -OK
938 -)))
939 -
940 940  (% style="color:blue" %)**Downlink Command:**
941 941  
942 -Example:  0B aa  => AT+COUNTMOD = second byte
848 +* **Example**: 0xA6000001  ~/~/  Same as AT+ SETCNT =1
943 943  
850 +* **Example**: 0xA6000064  ~/~/  Same as AT+ SETCNT =100
944 944  
945 -== 2.1 Number of channel of door sensors ==
852 +== 2.10 Set Transmit Interval Time ==
946 946  
947 947  
948 -Feature: Set the number of door sensor channels.
855 +(((
856 +Feature: Change NB-IoT End Node Transmit Interval.
857 +)))
949 949  
950 -(% style="color:blue" %)**AT Command:**
859 +(((
860 +(% style="color:blue" %)**AT Command: AT+TDC**
861 +)))
951 951  
952 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
953 -|=(% 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**
954 -|(% style="width:155px" %)(((
955 -AT+TTRCHANNEL=1
956 -)))|(% style="width:259px" %)(((
957 -Set as single channel, only use PA8 pin as interrupt pin.
958 -)))|(% style="width:44px" %)(((
863 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
864 +|=(% 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**
865 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
866 +30000
959 959  OK
868 +the interval is 30000ms = 30s
960 960  )))
961 -|(% style="width:155px" %)(((
962 -AT+TTRCHANNEL=2
963 -)))|(% style="width:259px" %)(((
964 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
965 -)))|(% style="width:44px" %)(((
870 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
966 966  OK
872 +Set transmit interval to 60000ms = 60 seconds
967 967  )))
968 968  
969 -(% style="color:blue" %)**Downlink Command:**
875 +(((
876 +(% style="color:blue" %)**Downlink Command: 0x01**
877 +)))
970 970  
971 -Example:  0D aa => AT+TTRCHANNEL = second byte
879 +(((
880 +Format: Command Code (0x01) followed by 3 bytes time value.
881 +)))
972 972  
883 +(((
884 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
885 +)))
973 973  
974 -== 2.13  Clear the open door times and the duration of the last open door ==
975 -
976 -
977 -(% style="color:blue" %)**AT Command:**
978 -
979 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
980 -|=(% 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**
981 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
982 -OK
887 +* (((
888 +Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
983 983  )))
890 +* (((
891 +Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
984 984  
985 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
986 986  
987 -The sensor will clear the open door times and the duration of the last open door.
988 -
989 -
990 -== 2.14  Set the count value of the number of open door ==
991 -
992 -
993 -(% style="color:blue" %)**AT Command:**
994 -
995 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
996 -|=(% 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**
997 -|(% style="width:155px" %)(((
998 -AT+SETCNT=1,100
999 -)))|(% style="width:259px" %)(((
1000 -Set the open door times of PA8 pin to 100 times.
1001 -)))|(% style="width:44px" %)(((
1002 -OK
894 +
1003 1003  )))
1004 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1005 -|(% style="width:155px" %)(((
1006 -AT+SETCNT=2,50
1007 -)))|(% style="width:259px" %)(((
1008 -Set the open door times of PA4 pin to 100 times.
1009 -)))|(% style="width:44px" %)(((
1010 -OK
1011 -)))
1012 1012  
1013 -(% style="color:blue" %)**Downlink Command:**
897 += 3. Configure SW3L-NB =
1014 1014  
1015 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1016 -
1017 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1018 -
1019 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1020 -
1021 -
1022 -= 3. Configure DS03A-NB =
1023 -
1024 1024  == 3.1 Configure Methods ==
1025 1025  
1026 1026  
1027 -DS03A-NB supports below configure method:
902 +SW3L-NB supports below configure method:
1028 1028  
1029 1029  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
1030 1030  
... ... @@ -1113,7 +1113,7 @@
1113 1113  = 4. Battery & Power Consumption =
1114 1114  
1115 1115  
1116 -DS03A-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
991 +SW3L-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1117 1117  
1118 1118  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1119 1119  
... ... @@ -1127,7 +1127,7 @@
1127 1127  
1128 1128  * Fix bugs.
1129 1129  
1130 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zbsm9p4coksqwd5/AADy2ZJc39KsvfbhTMCUGmz1a?dl=0]]**
1005 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/l0bszumyrmil3yv/AAAg8LYGeAgDsD_ycCnweD72a?dl=0]]**
1131 1131  
1132 1132  Methods to Update Firmware:
1133 1133  
... ... @@ -1148,7 +1148,7 @@
1148 1148  = 7. Order Info =
1149 1149  
1150 1150  
1151 -Part Number: (% style="color:blue" %)**DS03A-NB-XX**
1026 +Part Number: (% style="color:blue" %)**SW3L-NB-XX-YY**
1152 1152  
1153 1153  (% style="color:red" %)**XX**(%%):
1154 1154  
... ... @@ -1158,13 +1158,43 @@
1158 1158  
1159 1159  (% 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
1160 1160  
1036 +(((
1037 +(% style="color:blue" %)**YY**(%%): Flow Sensor Model:
1038 +)))
1161 1161  
1040 +(((
1041 + **004:** DW-004 Flow Sensor: diameter: G1/2” / DN15.  450 pulse = 1 L
1042 +)))
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 +
1162 1162  = 8. ​Packing Info =
1163 1163  
1164 1164  
1165 1165  (% style="color:#037691" %)**Package Includes**:
1166 1166  
1167 -* DS03A-NB NB-IoT Door sensor x 1
1072 +* SW3L-NB NB-IoT Distance Detection sensor x 1
1168 1168  
1169 1169  * External antenna x 1
1170 1170