Changes for page wiki_test

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

From version 123.1
edited by Mengting Qiu
on 2023/11/14 16:50
Change comment: There is no comment for this version
To version 107.10
edited by Xiaoling
on 2023/10/11 11:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ting
1 +XWiki.Xiaoling
Content
... ... @@ -44,6 +44,7 @@
44 44  
45 45  * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
46 46  * Ultra-low power consumption
47 +* Upload water flow volume
47 47  * Door Open/Close detect
48 48  * Door open/close statistics
49 49  * Datalog Feature
... ... @@ -137,9 +137,6 @@
137 137  )))
138 138  |(% 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.
139 139  
140 -(% 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.**
141 -
142 -
143 143  == 1.7 BLE connection ==
144 144  
145 145  
... ... @@ -206,6 +206,8 @@
206 206  * Wood Door: 10mm ~~ 30mm
207 207  * Iron Door: 30 ~~ 45mm
208 208  
207 +
208 +
209 209  = 2. Use DS03A-NB to communicate with IoT Server =
210 210  
211 211  == 2.1 Send data to IoT server via NB-IoT network ==
... ... @@ -284,10 +284,10 @@
284 284  
285 285  This is the General Json Format. As below:
286 286  
287 -(% style="color:#4472c4" %)**{"IMEI":"866207052559857","Model":"DS03A-NB","level status":1,"alarm status":0,"door open num":0,"last open time":0,"level status2":1,"alarm status2":0,"door open num2":0,"last open time2":0,"battery":3.48,"signal":24,"1":{1,0,0,2023/11/13 09:59:01},"2":{0,0,261,2023/11/13 03:20:00},"3":{237,9896971,263,2023/11/13 03:05:00},"4":{0,29,263,2023/11/13 02:20:12},"5":{215,9897015,268,2023/11/13 01:58:16},"6":{0,79,261,2023/11/13 01:43:16},"7":{227,9896991,5368540,2023/11/13 01:18:46},"8":{0,19,5367640,2023/11/11 08:53:57}}**
287 +(% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DS03A-NB","flow":217,"battery":3.54,"signal":24,"1":{221,2023/09/20 09:47:01},"2":{0,2023/09/20 09:15:04},"3":{0,2023/09/20 09:00:04},"4":{0,2023/09/20 08:45:03},"5":{0,2023/09/20 08:30:03},"6":{0,2023/09/20 08:15:03},"7":{0,2023/09/20 08:00:04},"8":{0,2023/09/20 07:45:04}}**
288 288  
289 289  
290 -[[image:image-20231113180055-1.png]]
290 +[[image:image-20230920175015-3.png||height="613" width="890"]]
291 291  
292 292  
293 293  (% style="color:red" %)**Notice, from above payload:**
... ... @@ -299,34 +299,18 @@
299 299  === 2.2.2 HEX format Payload(Type~=0) ===
300 300  
301 301  
302 -This is the HEX Format. HEX format Payload Single-channel and double-channel payload have different byte lengths.w
302 +This is the HEX Format. As below:
303 303  
304 +(% style="color:#4472c4" %)**f8662070583784430b640dda15010003a4650abc400000650ab8180000650ab4940000650ab10f0000650aad8b0000650aaa070000650aa6840000650aa3000000650a9308**
304 304  
305 -**The HEX format payload for the single-channel mode is as follows:**
306 +[[image:image-20230920172200-1.png||height="191" width="1047"]]
306 306  
307 -(% style="color:#4472c4" %)**f86620705255985712640d9c180101000000000000006551f424010000000000006551f36500000000000105655195e0ed97040b0001076551925c0000001d000107655187dcd797043700010c655182b80000004f00010565517f34e397041f51eadc655179760000001351e758654f4125**
308 308  
309 -[[image:image-20231114091247-2.png||height="186" width="1363"]]
310 -
311 -
312 312  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
313 313  
314 -[[image:image-20231114094432-3.png]]
311 +[[image:image-20230920173352-2.png||height="636" width="919"]]
315 315  
316 316  
317 -
318 -**The HEX format payload for the double-channel mode is as follows:**
319 -
320 -(% style="color:#4472c4" %)**f86620705255985712640db71701010000000000000001000000000000006552d13401000000000000000000000000006551f365000000000001050000005f00005f655195e0ed97040b0001070000005c00005c6551925c0000001d00010700000033000033655187dcd797043700010c00000033000033655182b80000004f0001050000003300003365517f34e397041f51eadc00000000000000655179760000001351e75800000000000000654f4125**
321 -
322 -[[image:image-20231114091229-1.png||height="180" width="1584"]]
323 -
324 -
325 -If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
326 -
327 -[[image:image-20231114094838-5.png]]
328 -
329 -
330 330  (% style="color:blue" %)**Version:**
331 331  
332 332  These bytes include the hardware and software version.
... ... @@ -375,6 +375,7 @@
375 375  [[image:image-20230922094043-2.png||height="558" width="851"]]
376 376  
377 377  
362 +
378 378  === 2.2.4 ThingSpeak Payload(Type~=1) ===
379 379  
380 380  
... ... @@ -384,22 +384,20 @@
384 384  
385 385  As below:
386 386  
387 -(% style="color:#4472c4" %)**field1=Flow value&field2=Battery value&field3=signal value**
372 +(% style="color:#4472c4" %)**field1=Flow value&field2=Battery value&field3=Singal value**
388 388  
389 -[[image:image-20231114165017-6.png]]
374 +[[image:image-20230921104741-1.png||height="565" width="826"]]
390 390  
391 -[[image:image-20231114165035-7.png||height="674" width="1036"]]
392 392  
393 -
394 394  == 2.3  ​Uplink Payload ==
395 395  
396 -=== 2.3.1  Sensor Configuration, FPORT~=4 ===
379 +=== 2.3.2  Sensor Configuration, FPORT~=4 ===
397 397  
398 398  
399 399  DS03A-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
400 400  
401 401  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
402 -|(% colspan="8" style="background-color:#4f81bd; color:white; width:515px" %)**Sensor Configuration FPORT=4**
385 +|(% colspan="8" style="background-color:#d9e2f3; color:#0070c0; width:515px" %)**Sensor Configuration FPORT=4**
403 403  |**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**
404 404  |**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
405 405  Keep status1
... ... @@ -413,7 +413,7 @@
413 413  
414 414  Example parse in TTNv3
415 415  
416 -[[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"]]
399 +[[image:image-20230630155527-3.png||height="146" width="902"]]
417 417  
418 418  
419 419  * (((
... ... @@ -431,6 +431,7 @@
431 431  
432 432   **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.
433 433  
417 +
434 434  (% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
435 435  
436 436  
... ... @@ -438,9 +438,10 @@
438 438  (% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
439 439  )))
440 440  
441 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H2.9AlarmBaseonTimeout"]]
425 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
442 442  
443 443  
428 +
444 444  * (((
445 445  (% style="color:blue" %)**Alarm interval(default: 0)**
446 446  )))
... ... @@ -448,29 +448,29 @@
448 448  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.
449 449  
450 450  
451 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
436 +=== 2.3.3  Real-Time Open/Close Status, Uplink FPORT~=2 ===
452 452  
453 453  
454 454  DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
455 455  
456 -* Every 2 hours, this interval [[can be changed>>||anchor="H2.7SetTransmitIntervalTime"]].
441 +* Every 2 hours, this interval [[can be changed>>||anchor="H3.3.1A0SetTransmitIntervalTime"]].
457 457  * There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
458 458  
459 459  **1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
460 460  
461 461  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
462 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
447 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
463 463  |(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
464 464  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
465 -Status & [[Alarm>>||anchor="2.10TTRIG126TTRIG2timeoutstatusalarm"]]
450 +Status & [[Alarm>>||anchor="H3.3.4A0TTRIG126TTRIG2timeoutstatusalarm"]]
466 466  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
467 467  The last door open duration (unit: sec)
468 -)))|(% style="width:108px" %)Unix TimeStamp
453 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
469 469  
470 470  **Status & Alarm:**
471 471  
472 472  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
473 -|(% 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**
458 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:120px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**bit0**
474 474  |(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
475 475  Count mod
476 476  )))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
... ... @@ -479,7 +479,7 @@
479 479  Status 0: Close; 1: Open
480 480  )))
481 481  
482 -[[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"]]
467 +[[image:image-20230630155451-2.png||height="246" width="928"]]
483 483  
484 484  
485 485  * (((
... ... @@ -529,7 +529,7 @@
529 529  
530 530  Unit: sec.
531 531  
532 -[[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"]]
517 +[[image:image-20230701094042-1.png||height="154" width="763"]]
533 533  
534 534  
535 535  **2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
... ... @@ -539,13 +539,13 @@
539 539  (% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
540 540  
541 541  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
542 -|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
527 +|=(% colspan="8" style="background-color:#D9E2F3;color:#0070C0; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
543 543  |(% 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**
544 544  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
545 545  Status1 & Alarm1
546 546  )))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
547 547  The last door open duration1 (unit: sec)
548 -)))|(% style="width:100px" %)Unix TimeStamp|(% style="width:86px" %)(((
533 +)))|(% style="width:100px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]|(% style="width:86px" %)(((
549 549  Status2 & Alarm2
550 550  )))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
551 551  
... ... @@ -552,7 +552,7 @@
552 552  **Status1 & Alarm1:**
553 553  
554 554  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
555 -|(% 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**
540 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:100px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:117px" %)**bit0**
556 556  |(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
557 557  Count mod
558 558  )))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
... ... @@ -564,7 +564,7 @@
564 564  **Status2 & Alarm2:**
565 565  
566 566  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
567 -|(% 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**
552 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**[bit7:bit2]**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:200px" %)**bit0**
568 568  |(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
569 569  Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
570 570  )))|(% style="width:181px" %)(((
... ... @@ -571,7 +571,7 @@
571 571  Status2 0: Close; 1: Open (PA4 of pin)
572 572  )))
573 573  
574 -[[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"]]
559 +[[image:image-20230630155908-6.png||height="295" width="927"]]
575 575  
576 576  
577 577  * (((
... ... @@ -594,7 +594,7 @@
594 594  (% style="color:#0000ff" %)**Alarm1 or Alarm2**
595 595  )))
596 596  
597 -See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]]
582 +See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
598 598  
599 599  
600 600  * (((
... ... @@ -621,29 +621,29 @@
621 621  
622 622  Unit: sec.
623 623  
624 -[[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"]]
609 +[[image:image-20230701094042-1.png||height="154" width="763"]]
625 625  
626 626  
627 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
612 +=== 2.3.4  Historical Door Open/Close Event, FPORT~=3 ===
628 628  
629 629  
630 -DS03A-NB stores sensor values and users can retrieve these history values via the downlink command.
615 +DS03A-NB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].
631 631  
632 632  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
633 633  
634 634  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
635 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
620 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
636 636  |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
637 637  |(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
638 -Status & [[Alarm>>||anchor="H2.9A0AlarmBaseonTimeout"]]
623 +Status & [[Alarm>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
639 639  )))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
640 640  The last door open duration (unit: sec)
641 -)))|(% style="width:108px" %)Unix TimeStamp
626 +)))|(% style="width:108px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]]
642 642  
643 643  **Status & Alarm:**
644 644  
645 645  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
646 -|(% 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**
631 +|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit7**|(% style="background-color:#d9e2f3; color:#0070c0; width:65px" %)**bit6**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**[bit5:bit4]**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**bit3**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**bit2**|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)**bit1**|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**bit0**
647 647  |(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
648 648  Count mod
649 649  )))|(% style="width:95px" %)(((
... ... @@ -655,7 +655,7 @@
655 655  )))
656 656  
657 657  * (((
658 -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.
643 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3A0Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, DS03A-NB will send max bytes according to the current DR and Frequency bands.
659 659  )))
660 660  
661 661  For example, in the US915 band, the max payload for different DR is:
... ... @@ -678,7 +678,7 @@
678 678  
679 679  If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
680 680  
681 -[[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"]]
666 +[[image:image-20230630155556-4.png||height="146" width="938"]]
682 682  
683 683  **Downlink:**
684 684  
... ... @@ -709,9 +709,10 @@
709 709  
710 710  [PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
711 711  
712 -[[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"]]
697 +[[image:image-20230630172740-1.png||height="199" width="868"]]
713 713  
714 714  
700 +
715 715  == 2.4 Test Uplink and Change Update Interval ==
716 716  
717 717  
... ... @@ -755,287 +755,161 @@
755 755  
756 756  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
757 757  
758 -== 2.7 Set Transmit Interval Time ==
744 +== 2.7 Alarm for continuously water flow ==
759 759  
760 760  
761 761  (((
762 -Feature: Change NB-IoT End Node Transmit Interval.
748 +This feature is to monitor and send Alarm for continuously water flow.
763 763  )))
764 764  
765 765  (((
766 -(% style="color:blue" %)**AT Command: AT+TDC**
752 +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.
767 767  )))
768 768  
769 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
770 -|=(% 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**
771 -|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
772 -30000
773 -OK
774 -the interval is 30000ms = 30s
755 +(((
756 +To monitor this faulty and send alarm, there are two settings:
775 775  )))
776 -|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
777 -OK
778 -Set transmit interval to 60000ms = 60 seconds
758 +
759 +* (((
760 +(% style="color:blue" %)**Stop Duration: Unit: Second**
779 779  )))
780 780  
781 781  (((
782 -(% style="color:blue" %)**Downlink Command: 0x01**
764 +Default: 15s, If DS03A-NB didn't see any water flow in 15s, DS03A-NB will consider stop of water flow event.
783 783  )))
784 784  
767 +* (((
768 +(% style="color:blue" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)**
769 +)))
770 +
785 785  (((
786 -Format: Command Code (0x01) followed by 3 bytes time value.
772 +**Example:** 3 minutes, if DS03A-NB detect a start of water flow event and didn't detect a stop event within Alarm timer, DS03A-NB will send an Alarm to indicate a water flow abnormal alarm.
787 787  )))
788 788  
789 789  (((
790 -If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
776 +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.
791 791  )))
792 792  
793 -* (((
794 -Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
779 +(((
780 +(% 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.**
795 795  )))
796 -* (((
797 -Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
798 798  
799 -
800 -
783 +(((
784 +(% style="color:blue" %)**AT Command to configure:**
801 801  )))
802 802  
803 -== 2.8 Enable / Disable Alarm ==
804 -
805 -
806 -Feature: Enable/Disable Alarm for open/close event. Default value 0.
807 -
808 -(% style="color:blue" %)**AT Command: **
809 -
810 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
811 -|(% 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**
812 -|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK
813 -|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK
814 -
815 -(% style="color:blue" %)**Downlink Command: **
816 -
817 -0xA7 01  ~/~/ Same As AT+DISALARM=1
818 -
819 -0xA7 00  ~/~/ Same As AT+DISALARM=0
820 -
821 -
822 -== 2.9 Alarm Base on Timeout ==
823 -
824 -
825 -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:
826 -
827 827  * (((
828 -(% style="color:blue" %)**Keep Status: Status to be monitor**
788 +AT+PTRIG=15,3  ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes.
829 829  )))
830 830  
831 -(% style="color:#037691" %)**Keep Status = 1**(%%): Monitor Close to Open event
832 -
833 -(% style="color:#037691" %)**Keep Status = 0**(%%): Monitor Open to Close event
834 -
835 -
836 836  * (((
837 -(% style="color:blue" %)**Keep Time: Timeout to send an Alarm**
792 +AT+ PTRIG=15,0  ~-~-> Default Value, disable water waste Alarm.
838 838  )))
839 839  
840 -Range 0 ~~ 65535(0xFFFF) seconds.
795 +(((
796 +(% style="color:blue" %)**Downlink Command to configure:** 
797 +)))
841 841  
842 -If (% style="color:#037691" %)**keep time = 0**(%%), Disable Alarm Base on Timeout feature.
843 -
844 -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.
845 -
846 -
847 -* (((
848 -(% style="color:blue" %)**Downlink Command**
799 +(((
800 +Command: **0xAA aa bb cc**
849 849  )))
850 850  
851 -(% style="color:#037691" %)**Command: 0xA9 aa bb cc dd**
852 -
853 -**A9:** Command Type Code
854 -
855 -**aa: **01:TTRIG1; 02:TTRIG2
856 -
857 -**bb:** status to be monitored
858 -
859 -**cc dd:** timeout.
860 -
861 -
862 -**1) AT+TTRIG1 : (PA8 of pin)**
863 -
864 -(% style="color:blue" %)**AT Command to configure:**
865 -
866 -* (((
867 -(% 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.
868 -
869 -(% 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.
803 +(((
804 +AA: Command Type Code
870 870  )))
871 871  
872 -* (((
873 -(% style="color:#037691" %)**AT+TTRIG1=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
874 -
875 -
807 +(((
808 +aa: Stop duration
876 876  )))
877 877  
878 -(% style="color:blue" %)**Downlink Command to configure:**
879 -
880 -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.
881 -
882 -
883 -**2) AT+TTRIG2 : (PA4 of pin,need to use AT+TTRCHANNEL=2)**
884 -
885 -(% style="color:blue" %)**AT Command to configure:**
886 -
887 -* (((
888 -(% 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.
889 -
890 -(% 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.
811 +(((
812 +bb cc: Alarm Timer
891 891  )))
892 892  
893 -* (((
894 -(% style="color:#037691" %)**AT+TTRIG2=0,0**  (%%) **~-~-> ** Default Value, disable timeout Alarm.
895 -
896 -
815 +(((
816 +If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3
897 897  )))
898 898  
899 -(% style="color:blue" %)**Downlink Command to configure:**
900 900  
901 -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.
820 +== 2.8 Set the calculate flag ==
902 902  
903 903  
904 -== 2.10 TTRIG1 & TTRIG2 timeout status alarm ==
823 +Feature: Set the calculate flag
905 905  
825 +(% style="color:blue" %)**AT Command: AT+CALCFLAG**
906 906  
907 -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.
827 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %)
828 +|=(% 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**
829 +|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK
830 +|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK
908 908  
909 -(% style="color:blue" %)**AT Command:**
910 -
911 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
912 -|=(% 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**
913 -|(% style="width:155px" %)(((
914 -AT+TTRALARM=0
915 -)))|(% style="width:279px" %)(((
916 -disable continuous alarm
917 -)))|(% style="width:84px" %)(((
918 -OK
919 -)))
920 -|(% style="width:155px" %)(((
921 -AT+TTRALARM=60
922 -)))|(% style="width:279px" %)(((
923 -The alarm interval is 60 minutes (unit: minutes)
924 -)))|(% style="width:84px" %)(((
925 -OK
926 -)))
927 -
928 928  (% style="color:blue" %)**Downlink Command:**
929 929  
930 -Example:  0C aa  => AT+TTRALARM= aa
834 +* **Example**: 0XA501  ~/~/  Same as AT+CALCFLAG =1
931 931  
836 +== 2.9 Set count number ==
932 932  
933 -== 2.11 Count Mod ==
934 934  
839 +Feature: Manually set the count number
935 935  
936 -Feature: Manually set the count mode.
841 +(% style="color:blue" %)**AT Command: AT+SETCNT**
937 937  
938 -(% style="color:blue" %)**AT Command:**
843 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %)
844 +|=(% 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**
845 +|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK
846 +|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK
939 939  
940 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
941 -|=(% 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**
942 -|(% style="width:155px" %)(((
943 -AT+COUNTMOD=0
944 -)))|(% style="width:277px" %)(((
945 -the count value keeps accumulating mode
946 -)))|(% style="width:86px" %)(((
947 -OK
948 -)))
949 -|(% style="width:155px" %)(((
950 -AT+COUNTMOD=1
951 -)))|(% style="width:277px" %)(((
952 -the count value will be reset after each TDC time(Last Close Duration Reset after each uplink)
953 -)))|(% style="width:86px" %)(((
954 -OK
955 -)))
956 -
957 957  (% style="color:blue" %)**Downlink Command:**
958 958  
959 -Example:  0B aa  => AT+COUNTMOD = second byte
850 +* **Example**: 0xA6000001  ~/~/  Same as AT+ SETCNT =1
960 960  
852 +* **Example**: 0xA6000064  ~/~/  Same as AT+ SETCNT =100
961 961  
962 -== 2.1 Number of channel of door sensors ==
854 +== 2.10 Set Transmit Interval Time ==
963 963  
964 964  
965 -Feature: Set the number of door sensor channels.
857 +(((
858 +Feature: Change NB-IoT End Node Transmit Interval.
859 +)))
966 966  
967 -(% style="color:blue" %)**AT Command:**
861 +(((
862 +(% style="color:blue" %)**AT Command: AT+TDC**
863 +)))
968 968  
969 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
970 -|=(% 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**
971 -|(% style="width:155px" %)(((
972 -AT+TTRCHANNEL=1
973 -)))|(% style="width:259px" %)(((
974 -Set as single channel, only use PA8 pin as interrupt pin.
975 -)))|(% style="width:44px" %)(((
865 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
866 +|=(% 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**
867 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
868 +30000
976 976  OK
870 +the interval is 30000ms = 30s
977 977  )))
978 -|(% style="width:155px" %)(((
979 -AT+TTRCHANNEL=2
980 -)))|(% style="width:259px" %)(((
981 -Set as dual channel, use PA8 pin and PA4 pin as interrupt pin.
982 -)))|(% style="width:44px" %)(((
872 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
983 983  OK
874 +Set transmit interval to 60000ms = 60 seconds
984 984  )))
985 985  
986 -(% style="color:blue" %)**Downlink Command:**
877 +(((
878 +(% style="color:blue" %)**Downlink Command: 0x01**
879 +)))
987 987  
988 -Example:  0D aa => AT+TTRCHANNEL = second byte
881 +(((
882 +Format: Command Code (0x01) followed by 3 bytes time value.
883 +)))
989 989  
885 +(((
886 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
887 +)))
990 990  
991 -== 2.13  Clear the open door times and the duration of the last open door ==
992 -
993 -
994 -(% style="color:blue" %)**AT Command:**
995 -
996 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
997 -|=(% 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**
998 -|(% style="width:155px" %)AT+CLRC|(% style="width:259px" %)clear the open door times and the duration of the last open door.|(% style="width:44px" %)(((
999 -OK
889 +* (((
890 +Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
1000 1000  )))
892 +* (((
893 +Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
1001 1001  
1002 -(% style="color:blue" %)**Downlink Command:**(%%)0xA6 01
1003 1003  
1004 -The sensor will clear the open door times and the duration of the last open door.
1005 -
1006 -
1007 -== 2.14  Set the count value of the number of open door ==
1008 -
1009 -
1010 -(% style="color:blue" %)**AT Command:**
1011 -
1012 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1013 -|=(% 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**
1014 -|(% style="width:155px" %)(((
1015 -AT+SETCNT=1,100
1016 -)))|(% style="width:259px" %)(((
1017 -Set the open door times of PA8 pin to 100 times.
1018 -)))|(% style="width:44px" %)(((
1019 -OK
896 +
1020 1020  )))
1021 -|(% style="width:155px" %)AT+SETCNT=1,0|(% style="width:259px" %)Clear the open door times of PA8 pin.|(% style="width:44px" %)OK
1022 -|(% style="width:155px" %)(((
1023 -AT+SETCNT=2,50
1024 -)))|(% style="width:259px" %)(((
1025 -Set the open door times of PA4 pin to 100 times.
1026 -)))|(% style="width:44px" %)(((
1027 -OK
1028 -)))
1029 1029  
1030 -(% style="color:blue" %)**Downlink Command:**
1031 -
1032 -0xA6 01 00 00 64  ==>  AT+SETCNT=1,100
1033 -
1034 -0xA6 01 00 00 00  ==>  AT+SETCNT=1,0
1035 -
1036 -0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1037 -
1038 -
1039 1039  = 3. Configure DS03A-NB =
1040 1040  
1041 1041  == 3.1 Configure Methods ==
... ... @@ -1144,7 +1144,7 @@
1144 1144  
1145 1145  * Fix bugs.
1146 1146  
1147 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zbsm9p4coksqwd5/AADy2ZJc39KsvfbhTMCUGmz1a?dl=0]]**
1007 +Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/l0bszumyrmil3yv/AAAg8LYGeAgDsD_ycCnweD72a?dl=0]]**
1148 1148  
1149 1149  Methods to Update Firmware:
1150 1150  
... ... @@ -1176,6 +1176,7 @@
1176 1176  (% 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
1177 1177  
1178 1178  
1039 +
1179 1179  = 8. ​Packing Info =
1180 1180  
1181 1181  
image-20231102094508-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -26.6 KB
Content
image-20231102100109-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -33.1 KB
Content
image-20231113180055-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -85.2 KB
Content
image-20231113180254-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -71.5 KB
Content
image-20231114091229-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -32.8 KB
Content
image-20231114091247-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -26.0 KB
Content
image-20231114094432-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -73.6 KB
Content
image-20231114094816-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -78.0 KB
Content
image-20231114094838-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -78.0 KB
Content
image-20231114165017-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -64.0 KB
Content
image-20231114165035-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -50.7 KB
Content