Changes for page wiki_test
Last modified by Mengting Qiu on 2024/09/05 17:35
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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 temperatures29 +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 ... ... @@ -56,7 +56,6 @@ 56 56 * 8500mAh Battery for long term use 57 57 * Nano SIM card slot for NB-IoT SIM 58 58 59 - 60 60 == 1.3 Specification == 61 61 62 62 ... ... @@ -139,13 +139,10 @@ 139 139 ))) 140 140 |(% 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. 141 141 142 -(% 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.** 143 - 144 - 145 145 == 1.7 BLE connection == 146 146 147 147 148 - DS03A-NB support BLE remote configure and firmware update.144 +SW3L-NB support BLE remote configure and firmware update. 149 149 150 150 151 151 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: ... ... @@ -209,23 +209,24 @@ 209 209 * Iron Door: 30 ~~ 45mm 210 210 211 211 208 + 212 212 = 2. Use DS03A-NB to communicate with IoT Server = 213 213 214 214 == 2.1 Send data to IoT server via NB-IoT network == 215 215 216 216 217 -The DS03A-NB is equipped with a NB-IoT module, the pre-loaded firmware inDS03A-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 byDS03A-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. 218 218 219 219 220 220 Below shows the network structure: 221 221 222 -[[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"]] 223 223 224 224 225 -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. 226 226 227 227 228 -(% 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. 229 229 230 230 * 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]]. 231 231 ... ... @@ -255,13 +255,13 @@ 255 255 [[image:image-20230819113244-11.png||height="141" width="367"]] 256 256 )))|(% style="width:170px" %) 257 257 258 -(% 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]]. 259 259 260 260 261 261 == 2.2 Payload Types == 262 262 263 263 264 -To meet different server requirement, DS03A-NB supports different payload type.261 +To meet different server requirement, SW3L-NB supports different payload type. 265 265 266 266 **Includes:** 267 267 ... ... @@ -287,7 +287,7 @@ 287 287 288 288 This is the General Json Format. As below: 289 289 290 -(% 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}}** 291 291 292 292 293 293 [[image:image-20230920175015-3.png||height="613" width="890"]] ... ... @@ -299,7 +299,6 @@ 299 299 300 300 * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Water Flow, Sampling time. 301 301 302 - 303 303 === 2.2.2 HEX format Payload(Type~=0) === 304 304 305 305 ... ... @@ -319,7 +319,7 @@ 319 319 320 320 These bytes include the hardware and software version. 321 321 322 -(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x1 2forDS03A-NB318 +(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x11 for SW3L-NB 323 323 324 324 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 1.0.0 325 325 ... ... @@ -358,11 +358,12 @@ 358 358 359 359 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard. 360 360 361 -(% 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}** 362 362 363 363 [[image:image-20230922094043-2.png||height="558" width="851"]] 364 364 365 365 362 + 366 366 === 2.2.4 ThingSpeak Payload(Type~=1) === 367 367 368 368 ... ... @@ -379,325 +379,326 @@ 379 379 380 380 == 2.3 Uplink Payload == 381 381 382 -=== 2.3.1 379 +=== 2.3.1 Sensor Configuration, FPORT~=4 === 383 383 384 384 385 - 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. 386 386 387 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 388 -|(% colspan="8" style="background-color:#4f81bd; color:white; width:515px" %)**Sensor Configuration FPORT=4** 389 -|**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** 390 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)((( 391 -Keep status1 392 -)))|(% style="width:99px" %)((( 393 -Keep time1(unit: sec) 394 -)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)((( 395 -Keep time2(unit: sec) 396 -)))|(% style="width:98px" %)((( 397 -Alarm interval(unit: min) 398 -))) 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 399 399 400 400 Example parse in TTNv3 401 401 402 -[[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"]] 403 403 404 404 405 -* ((( 406 -(% style="color:blue" %)**TDC: (default: 0x001C20)** 407 -))) 393 +* (% style="color:blue" %)**TDC: (default: 0x0004B0)** 408 408 409 -Uplink interval for the Open/CloseEvent, default value is 0x001C20 which is7200 seconds = 2hours.395 +Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes. 410 410 411 411 412 -* ((( 413 -(% style="color:blue" %)**Disalarm: (default: 0)** 414 -))) 398 +* (% style="color:blue" %)**STOP Duration & Alarm Timer** 415 415 416 - **If Disalarm = 1**, DS03A-NB willonlysenduplink atveryTDC periodically. This is normallyuseforpulsemeterapplication, inthis application, thereare many open/close event,and platformonlycare aboutthetotal numberofpulse.400 +Shows the configure value of [[Alarm for continuously water flow>>||anchor="H2.7Alarmforcontinuouslywaterflow"]] 417 417 418 - **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. 419 419 420 - (% style="color:red"%)** Note:When Disalarm=0,a high frequentlyopen/close eventwillcauselots of uplinkanddrain battery very fast. **403 +=== 2.3.2 Water Flow Value, Uplink FPORT~=2 === 421 421 422 422 423 - *(((424 - (%style="color:blue" %)**KeepStatus1& KeepTime1&Keep Status2&KeepTime2**406 +((( 407 +SW3L-NB will send this uplink **after** Device Status once join the NB-IoT network successfully. And SW3L-NB will: 425 425 ))) 426 426 427 -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 +))) 428 428 429 - 430 -* ((( 431 -(% style="color:blue" %)**Alarm interval(default: 0)** 414 +((( 415 +Uplink Payload totals 11 bytes. 432 432 ))) 433 433 434 -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 435 435 427 +**Calculate Flag & Alarm:** 436 436 437 -=== 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 438 438 433 +**MOD & PA4_status & PB15_status:** 439 439 440 -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 441 441 442 -* Every 2 hours, this interval [[can be changed>>||anchor="H2.7SetTransmitIntervalTime"]]. 443 -* 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"]] 444 444 445 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)** 446 446 447 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 448 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2** 449 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4** 450 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 451 -Status & [[Alarm>>||anchor="2.10TTRIG126TTRIG2timeoutstatusalarm"]] 452 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 453 -The last door open duration (unit: sec) 454 -)))|(% style="width:108px" %)Unix TimeStamp 442 +* ((( 443 +(% style="color:blue" %)**Calculate Flag** 444 +))) 455 455 456 -**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 +))) 457 457 458 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 459 -|(% 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** 460 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)((( 461 -Count mod 462 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)((( 463 -Alarm 0: No Alarm; 1: Alarm 464 -)))|(% style="width:131px" %)((( 465 -Status 0: Close; 1: Open 450 +((( 451 +**Example: in the default payload:** 466 466 ))) 467 467 468 -[[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"]] 469 - 470 - 471 471 * ((( 472 - (% style="color:blue"%)**Countmod:Default=0**455 +calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L 473 473 ))) 474 - 475 -0: Uplink total open door times since factory 476 - 477 -1: Uplink total open door times since last FPORT=2 uplink. 478 - 479 - 480 -* (% style="color:blue" %)**TDC flag** 481 - 482 -When the flag is 1, it means sending packets at normal time intervals. 483 - 484 -Otherwise, it is a packet sent at non-TDC time. 485 - 486 - 487 487 * ((( 488 - (% style="color:#0000ff"%)**Alarm**458 +calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L 489 489 ))) 490 - 491 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 492 - 493 - 494 494 * ((( 495 - (% style="color:blue"%)**Status**461 +calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L 496 496 ))) 497 497 498 -This bit is 1 when the door sensor is open and 0 when it is close. 499 - 500 - 501 -* ((( 502 -(% style="color:blue" %)**Total open door events** 464 +((( 465 +Default value: 0. 503 503 ))) 504 504 505 -Total pulse/counting base on open door. 468 +((( 469 +Range (4 bits): (b)0000 ~~ (b) 1111 506 506 507 - Range(3Bytes):0x000000~~0xFFFFFF.Max:16777215471 +If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server, 508 508 473 +1) User can set the Calculate Flag of this sensor to 3. 509 509 510 -* ((( 511 -(% 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. 512 512 ))) 513 513 514 -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"]] 515 515 516 -Unit: sec. 481 +((( 482 + 483 +))) 484 +))) 517 517 518 -[[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"]] 519 519 487 +* ((( 488 +(% style="color:blue" %)**Alarm** 489 +))) 520 520 521 -**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 +))) 522 522 523 - (When the maximum DRof some frequenciesis 11bytes,itwill causetheerver toceive 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"]] 524 524 525 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.** 526 526 527 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 528 -|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2** 529 -|(% 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** 530 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 531 -Status1 & Alarm1 532 -)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)((( 533 -The last door open duration1 (unit: sec) 534 -)))|(% style="width:100px" %)Unix TimeStamp|(% style="width:86px" %)((( 535 -Status2 & Alarm2 536 -)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec) 498 +((( 499 +* (% style="color:blue" %)**TDC flag** 537 537 538 - **Status1&Alarm1:**501 +When the flag is 1, it means sending packets at normal time intervals. 539 539 540 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %) 541 -|(% 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** 542 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)((( 543 -Count mod 544 -)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)((( 545 -Alarm1 0: No Alarm; 1: Alarm (PA8 of pin) 546 -)))|(% style="width:181px" %)((( 547 -Status1 0: Close; 1: Open (PA8 of pin) 503 +Otherwise, it is a packet sent at non-TDC time. 548 548 ))) 549 549 550 -**Status2 & Alarm2:** 506 +* ((( 507 +(% style="color:blue" %)**Total pulse** 508 +))) 551 551 552 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 553 -|(% 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** 554 -|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)((( 555 -Alarm2 0: No Alarm; 1: Alarm (PA4 of pin) 556 -)))|(% style="width:181px" %)((( 557 -Status2 0: Close; 1: Open (PA4 of pin) 510 +((( 511 +Total pulse/counting since factory 558 558 ))) 559 559 560 -[[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 . 561 561 517 + 518 +))) 562 562 563 563 * ((( 564 -(% style="color:blue" %)** Countmod:Default=0**521 +(% style="color:blue" %)**Last Pulse** 565 565 ))) 566 566 567 -0: Uplink total open door times since factory 524 +((( 525 +Total pulse since last FPORT=2 uplink. (Default 20 minutes) 526 +))) 568 568 569 -1: Uplink total open door times since last FPORT=2 uplink. 528 +((( 529 +Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 570 570 571 571 572 -* (% style="color:blue" %)**TDC flag** 532 +* ((( 533 +(% style="color:blue" %)**PA4_status: Support digital level input below 3.3V** 534 +))) 573 573 574 -When the flag is 1, it means sending packets at normal time intervals. 536 +((( 537 +0 ~-~-> PA4 is at low level. 538 +))) 575 575 576 -Otherwise, it is a packet sent at non-TDC time. 540 +((( 541 +1 ~-~-> PA4 is at high level. 577 577 578 578 579 579 * ((( 580 -(% style="color: #0000ff" %)**Alarm1Alarm2**545 +(% style="color:blue" %)**PB15_status: Support digital level input below 3.3V** 581 581 ))) 582 582 583 -See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]] 548 +((( 549 +0 ~-~-> PB15 is at low level. 550 +))) 584 584 552 +((( 553 +1 ~-~-> PB15 is at high level.. 554 +))) 555 +))) 556 +))) 585 585 586 586 * ((( 587 -(% style="color:blue" %)** Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**559 +(% style="color:blue" %)**MOD: Default =0** 588 588 ))) 589 589 590 -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 +))) 591 591 566 +((( 567 +MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink. 592 592 569 + 570 +))) 571 + 593 593 * ((( 594 -(% style="color:blue" %)** Total open door events1 **(% style="color:#0000ff"%)**or**(% style="color:blue"%)** Totalopen door events2**573 +(% style="color:blue" %)**Water Flow Value** 595 595 ))) 596 596 597 -Total pulse/counting base on open door. 576 +((( 577 +**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L** 578 +))) 598 598 599 - Range(3 Bytes):0x000000~~0xFFFFFF . Max:16777215580 +[[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"]] 600 600 601 601 602 - *(((603 - (% style="color:blue" %)**Thelastdoor openduration1**(%style="color:#0000ff"%)**or**(%style="color:blue"%)** Thelastdoor open duration2**583 +((( 584 +**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L** 604 604 ))) 605 605 606 - Doorsensorlastpenuration.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"]] ** ** 607 607 608 -Unit: sec. 609 609 610 - [[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 === 611 611 612 612 613 -=== 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 +))) 614 614 597 +((( 598 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status. 615 615 616 -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 617 617 618 - The historicalpayload includes one or multiplies entriesand every entry has thesame payloadasReal-Time open/close status.609 +**Calculate Flag & Alarm:** 619 619 620 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 621 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3** 622 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4** 623 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)((( 624 -Status & [[Alarm>>||anchor="H2.9A0AlarmBaseonTimeout"]] 625 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)((( 626 -The last door open duration (unit: sec) 627 -)))|(% 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 628 628 629 -** Status &Alarm:**617 +**MOD & PA4_status & PB15_status:** 630 630 631 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 632 -|(% 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** 633 -|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)((( 634 -Count mod 635 -)))|(% style="width:95px" %)((( 636 -TDC flag 0:No; 1:Yes 637 -)))|(% style="width:116px" %)((( 638 -Alarm 0: No Alarm; 1: Alarm 639 -)))|(% style="width:112px" %)((( 640 -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 641 641 ))) 642 642 643 643 * ((( 644 -Each data entry is 11 bytes and has the same structure as [[ Real-Timeopen/closestatus>>||anchor="H2.3.2A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery,DS03A-NBwill 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. 645 645 ))) 646 646 628 +((( 647 647 For example, in the US915 band, the max payload for different DR is: 630 +))) 648 648 649 649 ((( 650 -** ~1.DR0**:max is 11 bytes so one entry of data633 +(% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data 651 651 ))) 652 652 653 653 ((( 654 -** 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) 655 655 ))) 656 656 657 657 ((( 658 -** 3.DR2**:total payload includes 11 entries of data641 +(% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data 659 659 ))) 660 660 661 661 ((( 662 -** 4.DR3**:total payload includes 22 entries of data.645 +(% style="color:blue" %)**d) DR3:**(%%) total payload includes 22 entries of data. 663 663 ))) 664 664 665 -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 666 666 667 -[[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 +))) 668 668 669 -**Downlink:** 654 +((( 655 +(% style="color:#037691" %)**Downlink:** 656 +))) 670 670 671 -0x31 64 9E 7D 34 64 9E 7E 9C 05 658 +((( 659 +0x31 64 92 C5 AC 64 92 C7 8C 05 660 +))) 672 672 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"]] 673 673 674 -**Uplink:** 675 675 676 -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 +))) 677 677 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 678 678 679 -**Parsed Value:** 672 + 673 +))) 680 680 681 -[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME] 675 +((( 676 +(% style="color:#037691" %)**Parsed Value:** 677 +))) 682 682 679 +((( 680 +[TDC_flag, Alarm, Calculate Flag, PA4_status, PB15_status, MOD, Total pulse or Last Pulse,** **Water Flow Value, TIME] 681 +))) 683 683 684 -[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20], 685 685 686 -[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], 687 687 688 -[ SUM,NO,FALSE,OPEN,1,99,2023-06-3007:00:52],687 +[NO,FALSE,0,L,L, 0,8, 0.0,2023-06-21 09:42:30], 689 689 690 -[S UM,NO,FALSE,CLOSE,1,141,2023-06-3007:03:13],689 +[YES,FALSE,2,L,H,1,0, 0.0,2023-06-21 09:44:43], 691 691 692 -[S UM,NO,TRUE,OPEN,2,141,2023-06-3007:03:32],691 +[YES,FALSE,2,H,L,1,0, 0.0,2023-06-21 09:47:32], 693 693 694 -[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 +))) 695 695 696 -[ PART,NO,TRUE,OPEN,3,31,2023-06-3007: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"]] 697 697 698 -[[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"]] 699 699 700 - 701 701 == 2.4 Test Uplink and Change Update Interval == 702 702 703 703 ... ... @@ -713,7 +713,7 @@ 713 713 == 2.5 Multi-Samplings and One uplink == 714 714 715 715 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: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: 717 717 718 718 * (% 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) 719 719 ... ... @@ -727,7 +727,7 @@ 727 727 == 2.6 Trggier an uplink by external interrupt == 728 728 729 729 730 - 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. 731 731 732 732 (% style="color:blue" %)**AT command:** 733 733 ... ... @@ -741,300 +741,172 @@ 741 741 742 742 * (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 743 743 742 +== 2.7 Alarm for continuously water flow == 744 744 745 -== 2.7 Set Transmit Interval Time == 746 746 745 +((( 746 +This feature is to monitor and send Alarm for continuously water flow. 747 +))) 747 747 748 748 ((( 749 - Feature:ChangeNB-IoTEndNodeTransmitInterval.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 752 ((( 753 - (%style="color:blue"%)**ATCommand:AT+TDC**754 +To monitor this faulty and send alarm, there are two settings: 754 754 ))) 755 755 756 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 757 -|=(% 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** 758 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 759 -30000 760 -OK 761 -the interval is 30000ms = 30s 757 +* ((( 758 +(% style="color:blue" %)**Stop Duration: Unit: Second** 762 762 ))) 763 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 764 -OK 765 -Set transmit interval to 60000ms = 60 seconds 766 -))) 767 767 768 768 ((( 769 - (%style="color:blue"%)**DownlinkCommand:0x01**762 +Default: 15s, If SW3L-NB didn't see any water flow in 15s, SW3L-NB will consider stop of water flow event. 770 770 ))) 771 771 765 +* ((( 766 +(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)** 767 +))) 768 + 772 772 ((( 773 - Format:CommandCode(0x01)followedby3 bytes timevalue.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. 774 774 ))) 775 775 776 776 ((( 777 -If the downlinkpayload=0100003C,itmeansset theENDNode'sTransmit Intervalto0x00003C=60(S),whiletypecodeis01.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. 778 778 ))) 779 779 780 - *(((781 - Example1:DownlinkPayload: 0100001E~/~/SetTransmitInterval(TDC)=30seconds777 +((( 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.** 782 782 ))) 783 -* ((( 784 -Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 785 785 786 - 787 - 781 +((( 782 +(% style="color:blue" %)**AT Command to configure:** 788 788 ))) 789 789 790 -== 2.8 Enable / Disable Alarm == 791 - 792 - 793 -Feature: Enable/Disable Alarm for open/close event. Default value 0. 794 - 795 -(% style="color:blue" %)**AT Command: ** 796 - 797 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 798 -|(% 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** 799 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 800 -|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 801 - 802 -(% style="color:blue" %)**Downlink Command: ** 803 - 804 -0xA7 01 ~/~/ Same As AT+DISALARM=1 805 - 806 -0xA7 00 ~/~/ Same As AT+DISALARM=0 807 - 808 - 809 -== 2.9 Alarm Base on Timeout == 810 - 811 - 812 -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: 813 - 814 814 * ((( 815 - (% style="color:blue"%)**KeepStatus:Statustobe monitor**786 +AT+PTRIG=15,3 ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes. 816 816 ))) 817 817 818 -(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event 819 - 820 -(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event 821 - 822 - 823 823 * ((( 824 - (%style="color:blue"%)**Keep Time:TimeouttosendanAlarm**790 +AT+ PTRIG=15,0 ~-~-> Default Value, disable water waste Alarm. 825 825 ))) 826 826 827 -Range 0 ~~ 65535(0xFFFF) seconds. 793 +((( 794 +(% style="color:blue" %)**Downlink Command to configure:** 795 +))) 828 828 829 -If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature. 830 - 831 -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. 832 - 833 - 834 -* ((( 835 -(% style="color:blue" %)**Downlink Command** 797 +((( 798 +Command: **0xAA aa bb cc** 836 836 ))) 837 837 838 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd** 839 - 840 -**A9:** Command Type Code 841 - 842 -**aa: **01:TTRIG1; 02:TTRIG2 843 - 844 -**bb:** status to be monitored 845 - 846 -**cc dd:** timeout. 847 - 848 - 849 -**1) AT+TTRIG1 : (PA8 of pin)** 850 - 851 -(% style="color:blue" %)**AT Command to configure:** 852 - 853 -* ((( 854 -(% 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. 855 - 856 -(% 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 857 857 ))) 858 858 859 -* ((( 860 -(% style="color:#037691" %)**AT+TTRIG1=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 861 - 862 - 805 +((( 806 +aa: Stop duration 863 863 ))) 864 864 865 -(% style="color:blue" %)**Downlink Command to configure:** 866 - 867 -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. 868 - 869 - 870 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)** 871 - 872 -(% style="color:blue" %)**AT Command to configure:** 873 - 874 -* ((( 875 -(% 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. 876 - 877 -(% 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 878 878 ))) 879 879 880 -* ((( 881 -(% style="color:#037691" %)**AT+TTRIG2=0,0** (%%) **~-~-> ** Default Value, disable timeout Alarm. 882 - 883 - 813 +((( 814 +If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3 884 884 ))) 885 885 886 -(% style="color:blue" %)**Downlink Command to configure:** 887 887 888 - Ifuser send 0xA9 0200 00 1E:equaltoAT+TTRIG2=0,30 **or** 0xA9 02 00 00 00: EqualoAT+TTRIG2=0,0.818 +== 2.8 Set the calculate flag == 889 889 890 890 891 - == 2.10 TTRIG1 & TTRIG2 timeoutstatusalarm==821 +Feature: Set the calculate flag 892 892 823 +(% style="color:blue" %)**AT Command: AT+CALCFLAG** 893 893 894 -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 895 895 896 -(% style="color:blue" %)**AT Command:** 897 - 898 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 899 -|=(% 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** 900 -|(% style="width:155px" %)((( 901 -AT+TTRALARM=0 902 -)))|(% style="width:279px" %)((( 903 -disable continuous alarm 904 -)))|(% style="width:84px" %)((( 905 -OK 906 -))) 907 -|(% style="width:155px" %)((( 908 -AT+TTRALARM=60 909 -)))|(% style="width:279px" %)((( 910 -The alarm interval is 60 minutes (unit: minutes) 911 -)))|(% style="width:84px" %)((( 912 -OK 913 -))) 914 - 915 915 (% style="color:blue" %)**Downlink Command:** 916 916 917 -Example: Caa=>AT+TTRALARM=aa832 +* **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 918 918 834 +== 2.9 Set count number == 919 919 920 -== 2.11 Count Mod == 921 921 837 +Feature: Manually set the count number 922 922 923 - Feature:Manuallysetthentmode.839 +(% style="color:blue" %)**AT Command: AT+SETCNT** 924 924 925 -(% 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 926 926 927 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %) 928 -|=(% 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** 929 -|(% style="width:155px" %)((( 930 -AT+COUNTMOD=0 931 -)))|(% style="width:277px" %)((( 932 -the count value keeps accumulating mode 933 -)))|(% style="width:86px" %)((( 934 -OK 935 -))) 936 -|(% style="width:155px" %)((( 937 -AT+COUNTMOD=1 938 -)))|(% style="width:277px" %)((( 939 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink) 940 -)))|(% style="width:86px" %)((( 941 -OK 942 -))) 943 - 944 944 (% style="color:blue" %)**Downlink Command:** 945 945 946 -Example: Baa=>AT+COUNTMOD=second byte848 +* **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1 947 947 850 +* **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 948 948 949 -== 2.1 2Numberof channelof door sensors==852 +== 2.10 Set Transmit Interval Time == 950 950 951 951 952 -Feature: Set the number of door sensor channels. 855 +((( 856 +Feature: Change NB-IoT End Node Transmit Interval. 857 +))) 953 953 954 -(% style="color:blue" %)**AT Command:** 859 +((( 860 +(% style="color:blue" %)**AT Command: AT+TDC** 861 +))) 955 955 956 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 957 -|=(% 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** 958 -|(% style="width:155px" %)((( 959 -AT+TTRCHANNEL=1 960 -)))|(% style="width:259px" %)((( 961 -Set as single channel, only use PA8 pin as interrupt pin. 962 -)))|(% 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 963 963 OK 868 +the interval is 30000ms = 30s 964 964 ))) 965 -|(% style="width:155px" %)((( 966 -AT+TTRCHANNEL=2 967 -)))|(% style="width:259px" %)((( 968 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin. 969 -)))|(% style="width:44px" %)((( 870 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|((( 970 970 OK 872 +Set transmit interval to 60000ms = 60 seconds 971 971 ))) 972 972 973 -(% style="color:blue" %)**Downlink Command:** 875 +((( 876 +(% style="color:blue" %)**Downlink Command: 0x01** 877 +))) 974 974 975 -Example: 0D aa => AT+TTRCHANNEL = second byte 879 +((( 880 +Format: Command Code (0x01) followed by 3 bytes time value. 881 +))) 976 976 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 +))) 977 977 978 -== 2.13 Clear the open door times and the duration of the last open door == 979 - 980 - 981 -(% style="color:blue" %)**AT Command:** 982 - 983 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 984 -|=(% 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** 985 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)((( 986 -OK 887 +* ((( 888 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 987 987 ))) 890 +* ((( 891 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 988 988 989 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01 990 990 991 -The sensor will clear the open door times and the duration of the last open door. 992 - 993 - 994 -== 2.14 Set the count value of the number of open door == 995 - 996 - 997 -(% style="color:blue" %)**AT Command:** 998 - 999 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %) 1000 -|=(% 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** 1001 -|(% style="width:155px" %)((( 1002 -AT+SETCNT=1,100 1003 -)))|(% style="width:259px" %)((( 1004 -Set the open door times of PA8 pin to 100 times. 1005 -)))|(% style="width:44px" %)((( 1006 -OK 894 + 1007 1007 ))) 1008 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK 1009 -|(% style="width:155px" %)((( 1010 -AT+SETCNT=2,50 1011 -)))|(% style="width:259px" %)((( 1012 -Set the open door times of PA4 pin to 100 times. 1013 -)))|(% style="width:44px" %)((( 1014 -OK 1015 -))) 1016 1016 1017 - (% style="color:blue"%)**DownlinkCommand:**897 += 3. Configure SW3L-NB = 1018 1018 1019 -0xA6 01 00 00 64 ==> AT+SETCNT=1,100 1020 - 1021 -0xA6 01 00 00 00 ==> AT+SETCNT=1,0 1022 - 1023 -0xA6 02 00 00 32 ==> AT+SETCNT=2,50 1024 - 1025 - 1026 -= 3. Configure DS03A-NB = 1027 - 1028 1028 == 3.1 Configure Methods == 1029 1029 1030 1030 1031 - DS03A-NB supports below configure method:902 +SW3L-NB supports below configure method: 1032 1032 1033 1033 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 1034 1034 1035 1035 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]]. 1036 1036 1037 - 1038 1038 == 3.2 AT Commands Set == 1039 1039 1040 1040 ... ... @@ -1118,7 +1118,7 @@ 1118 1118 = 4. Battery & Power Consumption = 1119 1119 1120 1120 1121 - 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. 1122 1122 1123 1123 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 1124 1124 ... ... @@ -1132,7 +1132,7 @@ 1132 1132 1133 1133 * Fix bugs. 1134 1134 1135 -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]]** 1136 1136 1137 1137 Methods to Update Firmware: 1138 1138 ... ... @@ -1140,7 +1140,6 @@ 1140 1140 1141 1141 * Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**. 1142 1142 1143 - 1144 1144 = 6. FAQ = 1145 1145 1146 1146 == 6.1 How can I access t BC660K-GL AT Commands? == ... ... @@ -1154,7 +1154,7 @@ 1154 1154 = 7. Order Info = 1155 1155 1156 1156 1157 -Part Number: (% style="color:blue" %)** DS03A-NB-XX**1026 +Part Number: (% style="color:blue" %)**SW3L-NB-XX-YY** 1158 1158 1159 1159 (% style="color:red" %)**XX**(%%): 1160 1160 ... ... @@ -1164,13 +1164,43 @@ 1164 1164 1165 1165 (% 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 1166 1166 1036 +((( 1037 +(% style="color:blue" %)**YY**(%%): Flow Sensor Model: 1038 +))) 1167 1167 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 + 1168 1168 = 8. Packing Info = 1169 1169 1170 1170 1171 1171 (% style="color:#037691" %)**Package Includes**: 1172 1172 1173 -* DS03A-NB NB-IoT Doorsensor x 11072 +* SW3L-NB NB-IoT Distance Detection sensor x 1 1174 1174 1175 1175 * External antenna x 1 1176 1176 ... ... @@ -1184,7 +1184,6 @@ 1184 1184 1185 1185 * Weight / pcs : 180g 1186 1186 1187 - 1188 1188 = 9. Support = 1189 1189 1190 1190