Changes for page wiki_test
Last modified by Mengting Qiu on 2024/09/05 17:35
From version 118.1
edited by Mengting Qiu
on 2023/11/14 09:48
on 2023/11/14 09:48
Change comment:
Uploaded new attachment "image-20231114094838-5.png", version {1}
To version 139.1
edited by Mengting Qiu
on 2024/05/09 11:47
on 2024/05/09 11:47
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 12 added, 0 removed)
- image-20231114165017-6.png
- image-20231114165035-7.png
- image-20231114174523-8.png
- image-20231115150948-1.png
- image-20231115154757-2.png
- image-20231115154821-3.png
- image-20231115161111-4.png
- image-20231115161128-5.png
- image-20231115161803-6.png
- image-20231115162221-7.png
- image-20240316150911-1.png
- image-20240316151014-2.png
Details
- Page properties
-
- Content
-
... ... @@ -54,6 +54,7 @@ 54 54 * Downlink to change configure 55 55 * 8500mAh Battery for long term use 56 56 * Nano SIM card slot for NB-IoT SIM 57 +(% style="display:none" %) (%%) 57 57 58 58 == 1.3 Specification == 59 59 ... ... @@ -99,11 +99,8 @@ 99 99 100 100 * STOP Mode: 10uA @ 3.3v 101 101 * Max transmit power: 350mA@3.3v 102 - 103 -(% class="wikigeneratedid" id="H1.4Ratedenvironmentalconditions" %) 104 104 (% style="display:none" %) (%%) 105 105 106 - 107 107 == 1.4 Applications == 108 108 109 109 ... ... @@ -155,7 +155,7 @@ 155 155 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 156 156 157 157 158 -== 1.8 Pin Definitions &Switch ==156 +== 1.8 Pin Definitions , Switch & SIM Direction == 159 159 160 160 161 161 [[image:image-20230819104805-5.png]] ... ... @@ -183,6 +183,12 @@ 183 183 (% style="display:none" %) 184 184 185 185 184 +=== 1.8.4 SIM Card Direction === 185 + 186 + 187 +See this link. [[How to insert SIM Card>>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]]. 188 + 189 + 186 186 == 1.9 Mechanical == 187 187 188 188 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png"]] ... ... @@ -205,6 +205,7 @@ 205 205 206 206 * Wood Door: 10mm ~~ 30mm 207 207 * Iron Door: 30 ~~ 45mm 212 +(% style="display:none" %) (%%) 208 208 209 209 = 2. Use DS03A-NB to communicate with IoT Server = 210 210 ... ... @@ -282,37 +282,64 @@ 282 282 === 2.2.1 General Json Format(Type~=5) === 283 283 284 284 285 -This is the General Json Format. As below:290 +(% style="color:red" %)**This is the General Json Format. Payloads in General Json format for single-channel mode and double-channel mode have different byte lengths.** 286 286 292 + 293 +**The General Json format payload for the single-channel mode is as follows:** 294 + 287 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}}** 288 288 297 +[[image:image-20231115162221-7.png]] 289 289 290 -[[image:image-20231113180055-1.png]] 291 291 300 +**The General Json format payload for the double-channel mode is as follows:** 292 292 302 +(% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"DS03A-NB","level status":1,"alarm status":0,"door open num":2,"last open time":0,"level status2":1,"alarm status2":0,"door open num2":3,"last open time2":0,"battery":3.39,"signal":25,"1":{1,4,0,1,3,0,2023/11/15 07:54:30},"2":{1,3,0,1,6,1,2023/11/15 07:10:04},"3":{0,0,0,1,1,0,2023/11/15 06:55:04},"4":{0,0,0,1,0,0,2023/11/15 06:40:04},"5":{0,0,0,1,0,0,2023/11/15 03:50:36},"6":{0,0,0,1,4,11,2023/11/15 03:28:16},"7":{0,0,0,1,4,11,2023/11/15 03:13:16},"8":{0,0,0,1,3,11,2023/11/15 02:58:25}}** 303 + 304 +[[image:image-20231115161803-6.png]] 305 + 306 + 293 293 (% style="color:red" %)**Notice, from above payload:** 294 294 295 -* Distance , Battery & Signal are the value at uplink time.309 +* level status, alarm status, door open num, last open time, level status2, alarm status2, door open sum2, last open time2, Battery & Signal are the value at uplink time. 296 296 297 -* 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.311 +* 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): 298 298 313 + Single-channel mode: level status, door open num, last open time, Sampling time. 314 + 315 + Double-channel mode: level status, door open num, last open time, level status2, door open sum2, last open time2, Sampling time. 316 + 317 + 318 + 299 299 === 2.2.2 HEX format Payload(Type~=0) === 300 300 301 301 302 -This is the HEX Format. As below:322 +(% style="color:red" %)**This is the HEX Format. Payloads in HEX format for single-channel mode and double-channel mode have different byte lengths.** 303 303 324 + 325 +**The HEX format payload for the single-channel mode is as follows:** 326 + 304 304 (% style="color:#4472c4" %)**f86620705255985712640d9c180101000000000000006551f424010000000000006551f36500000000000105655195e0ed97040b0001076551925c0000001d000107655187dcd797043700010c655182b80000004f00010565517f34e397041f51eadc655179760000001351e758654f4125** 305 305 306 306 [[image:image-20231114091247-2.png||height="186" width="1363"]] 307 307 308 308 309 - [[image:image-20231114091229-1.png||height="180"width="1584"]]332 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data. 310 310 334 +[[image:image-20231114094432-3.png]] 311 311 312 312 337 + 338 +**The HEX format payload for the double-channel mode is as follows:** 339 + 340 +(% style="color:#4472c4" %)**f86620705255985712640db71701010000000000000001000000000000006552d13401000000000000000000000000006551f365000000000001050000005f00005f655195e0ed97040b0001070000005c00005c6551925c0000001d00010700000033000033655187dcd797043700010c00000033000033655182b80000004f0001050000003300003365517f34e397041f51eadc00000000000000655179760000001351e75800000000000000654f4125** 341 + 342 +[[image:image-20231114091229-1.png||height="180" width="1584"]] 343 + 344 + 313 313 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data. 314 314 315 -[[image:image-2023111 3180254-2.png]]347 +[[image:image-20231114094838-5.png]] 316 316 317 317 318 318 (% style="color:blue" %)**Version:** ... ... @@ -358,15 +358,28 @@ 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}** 393 +(% style="color:#4472c4" %)**{ 394 + "IMEI": "866207058378443", 395 + "Model": "DS03A-NB", 396 + "level status": 1, 397 + "alarm status": 0, 398 + "door open num": 6, 399 + "last open time": 1, 400 + "level status2": 1, 401 + "alarm status2": 0, 402 + "door open num2": 2, 403 + "last open time2": 0, 404 + "battery": 3.4, 405 + "signal": 24 406 + }** 362 362 363 -[[image:image-202309 22094043-2.png||height="558" width="851"]]408 +[[image:image-20231115150948-1.png||height="625" width="1188"]] 364 364 365 365 366 366 === 2.2.4 ThingSpeak Payload(Type~=1) === 367 367 368 368 369 -This payload meets ThingSpeak platform requirement. It includes onlyfour fields. Form 1~~3are:414 +This payload meets ThingSpeak platform requirement. It includes eight fields. Form 1~~8 are: 370 370 371 371 Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform 372 372 ... ... @@ -374,333 +374,15 @@ 374 374 375 375 (% style="color:#4472c4" %)**field1=Flow value&field2=Battery value&field3=signal value** 376 376 377 -[[image:image-2023 0921104741-1.png||height="565" width="826"]]422 +[[image:image-20231115154757-2.png]] 378 378 424 +[[image:image-20231115154821-3.png||height="695" width="1119"]] 379 379 380 -== 2.3 Uplink Payload == 381 381 382 -=== 2.3.1 Sensor Configuration, FPORT~=4 === 383 383 428 +== 2.3 Test Uplink and Change Update Interval == 384 384 385 -DS03A-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 -))) 399 - 400 -Example parse in TTNv3 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"]] 403 - 404 - 405 -* ((( 406 -(% style="color:blue" %)**TDC: (default: 0x001C20)** 407 -))) 408 - 409 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours. 410 - 411 - 412 -* ((( 413 -(% style="color:blue" %)**Disalarm: (default: 0)** 414 -))) 415 - 416 - **If Disalarm = 1**, DS03A-NB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many open/close event, and platform only care about the total number of pulse. 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 - 420 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. ** 421 - 422 - 423 -* ((( 424 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2** 425 -))) 426 - 427 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H2.9AlarmBaseonTimeout"]] 428 - 429 - 430 -* ((( 431 -(% style="color:blue" %)**Alarm interval(default: 0)** 432 -))) 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. 435 - 436 - 437 -=== 2.3.2 Real-Time Open/Close Status, Uplink FPORT~=2 === 438 - 439 - 440 -DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when: 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) 444 - 445 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)** 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 455 - 456 -**Status & Alarm:** 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 466 -))) 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 -* ((( 472 -(% style="color:blue" %)**Count mod:Default=0** 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 -* ((( 488 -(% style="color:#0000ff" %)**Alarm** 489 -))) 490 - 491 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]] 492 - 493 - 494 -* ((( 495 -(% style="color:blue" %)**Status** 496 -))) 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** 503 -))) 504 - 505 -Total pulse/counting base on open door. 506 - 507 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 508 - 509 - 510 -* ((( 511 -(% style="color:blue" %)**The last door open duration** 512 -))) 513 - 514 -Door sensor last open duration. 515 - 516 -Unit: sec. 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 - 520 - 521 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %). 522 - 523 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets) 524 - 525 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.** 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) 537 - 538 -**Status1 & Alarm1:** 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) 548 -))) 549 - 550 -**Status2 & Alarm2:** 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) 558 -))) 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"]] 561 - 562 - 563 -* ((( 564 -(% style="color:blue" %)**Count mod:Default=0** 565 -))) 566 - 567 -0: Uplink total open door times since factory 568 - 569 -1: Uplink total open door times since last FPORT=2 uplink. 570 - 571 - 572 -* (% style="color:blue" %)**TDC flag** 573 - 574 -When the flag is 1, it means sending packets at normal time intervals. 575 - 576 -Otherwise, it is a packet sent at non-TDC time. 577 - 578 - 579 -* ((( 580 -(% style="color:#0000ff" %)**Alarm1 or Alarm2** 581 -))) 582 - 583 -See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]] 584 - 585 - 586 -* ((( 587 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2** 588 -))) 589 - 590 -This bit is 1 when the door sensor is open and 0 when it is close. 591 - 592 - 593 -* ((( 594 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2** 595 -))) 596 - 597 -Total pulse/counting base on open door. 598 - 599 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 600 - 601 - 602 -* ((( 603 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2** 604 -))) 605 - 606 -Door sensor last open duration. 607 - 608 -Unit: sec. 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"]] 611 - 612 - 613 -=== 2.3.3 Historical Door Open/Close Event, FPORT~=3 === 614 - 615 - 616 -DS03A-NB stores sensor values and users can retrieve these history values via the downlink command. 617 - 618 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 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 628 - 629 -**Status & Alarm:** 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 641 -))) 642 - 643 -* ((( 644 -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. 645 -))) 646 - 647 -For example, in the US915 band, the max payload for different DR is: 648 - 649 -((( 650 -**~1. DR0**: max is 11 bytes so one entry of data 651 -))) 652 - 653 -((( 654 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 655 -))) 656 - 657 -((( 658 -**3. DR2**: total payload includes 11 entries of data 659 -))) 660 - 661 -((( 662 -**4. DR3**: total payload includes 22 entries of data. 663 -))) 664 - 665 -If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0 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"]] 668 - 669 -**Downlink:** 670 - 671 -0x31 64 9E 7D 34 64 9E 7E 9C 05 672 - 673 - 674 -**Uplink:** 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 677 - 678 - 679 -**Parsed Value:** 680 - 681 -[COUNTMOD, TDC_FLAG, ALARM, DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME] 682 - 683 - 684 -[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20], 685 - 686 -[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44], 687 - 688 -[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52], 689 - 690 -[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13], 691 - 692 -[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32], 693 - 694 -[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53], 695 - 696 -[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11], 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 - 700 - 701 -== 2.4 Test Uplink and Change Update Interval == 702 - 703 - 704 704 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8 705 705 706 706 User can use below commands to change the (% style="color:blue" %)**uplink interval**. ... ... @@ -710,8 +710,9 @@ 710 710 User can also push the button for more than 1 seconds to activate an uplink. 711 711 712 712 713 -== 2. 5Multi-Samplings and One uplink ==440 +== 2.4 Multi-Samplings and One uplink == 714 714 442 +(% style="color:red" %)Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>||anchor="H2.14Clocklogging28Sincefirmwareversionv1.2.129"]] 715 715 716 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: 717 717 ... ... @@ -724,7 +724,7 @@ 724 724 [[image:1692424376354-959.png]] 725 725 726 726 727 -== 2. 6Trggier an uplink by external interrupt ==455 +== 2.5 Trggier an uplink by external interrupt == 728 728 729 729 730 730 DS03A-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets. ... ... @@ -740,8 +740,9 @@ 740 740 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge 741 741 742 742 * (% style="color:#037691" %)**AT+INTMOD=3 **(%%) ~/~/ Trigger by rising edge 471 +(% style="display:none" %) (%%) 743 743 744 -== 2. 7Set Transmit Interval Time ==473 +== 2.5 Set Transmit Interval Time == 745 745 746 746 747 747 ((( ... ... @@ -781,14 +781,11 @@ 781 781 ))) 782 782 * ((( 783 783 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 513 +)))(% style="display:none" %) (%%) 784 784 515 +== 2.7 Enable / Disable Alarm == 785 785 786 - 787 -))) 788 788 789 -== 2.8 Enable / Disable Alarm == 790 - 791 - 792 792 Feature: Enable/Disable Alarm for open/close event. Default value 0. 793 793 794 794 (% style="color:blue" %)**AT Command: ** ... ... @@ -805,7 +805,7 @@ 805 805 0xA7 00 ~/~/ Same As AT+DISALARM=0 806 806 807 807 808 -== 2. 9Alarm Base on Timeout ==534 +== 2.8 Alarm Base on Timeout == 809 809 810 810 811 811 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: ... ... @@ -887,7 +887,7 @@ 887 887 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. 888 888 889 889 890 -== 2. 10TTRIG1 & TTRIG2 timeout status alarm ==616 +== 2.9 TTRIG1 & TTRIG2 timeout status alarm == 891 891 892 892 893 893 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. ... ... @@ -916,7 +916,7 @@ 916 916 Example: 0C aa => AT+TTRALARM= aa 917 917 918 918 919 -== 2.1 1Count Mod ==645 +== 2.10 Count Mod == 920 920 921 921 922 922 Feature: Manually set the count mode. ... ... @@ -945,7 +945,7 @@ 945 945 Example: 0B aa => AT+COUNTMOD = second byte 946 946 947 947 948 -== 2.1 2Number of channel of door sensors ==674 +== 2.11 Number of channel of door sensors == 949 949 950 950 951 951 Feature: Set the number of door sensor channels. ... ... @@ -974,7 +974,7 @@ 974 974 Example: 0D aa => AT+TTRCHANNEL = second byte 975 975 976 976 977 -== 2.1 3Clear the open door times and the duration of the last open door ==703 +== 2.12 Clear the open door times and the duration of the last open door == 978 978 979 979 980 980 (% style="color:blue" %)**AT Command:** ... ... @@ -990,7 +990,7 @@ 990 990 The sensor will clear the open door times and the duration of the last open door. 991 991 992 992 993 -== 2.1 4Set the count value of the number of open door ==719 +== 2.13 Set the count value of the number of open door == 994 994 995 995 996 996 (% style="color:blue" %)**AT Command:** ... ... @@ -1022,6 +1022,61 @@ 1022 1022 0xA6 02 00 00 32 ==> AT+SETCNT=2,50 1023 1023 1024 1024 751 +== 2.14 Clock logging (Since firmware version v1.2.1) == 752 + 753 + 754 +Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature. 755 + 756 +We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data. 757 + 758 +* (% style="color:blue" %)**AT Command: AT+CLOCKLOG=a,b,c,d** 759 + 760 +(% style="color:blue" %)**a:**(%%)** 0:** Disable Clock logging. ** 1: **Enable Clock Logging 761 + 762 +(% style="color:blue" %)**b:**(%%)** **Specify First sampling start second: range **(0 ~~ 3599, 65535) ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets. 763 + 764 +(% style="color:blue" %)**c:**(%%)** **Specify the sampling interval: range **(0 ~~ 255 minutes)** 765 + 766 +(% style="color:blue" %)**d:**(%%)** **How many entries should be uplink on every TDC **(max 32)** 767 + 768 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1||alt="image-20240315141254-1.png"]] 769 + 770 +**Example:** 771 + 772 +**AT+CLOCKLOG=1,65535,1,5** 773 + 774 +After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp). 775 + 776 +(% class="wikigeneratedid" %) 777 +[[image:image-20240316150911-1.png||height="493" width="1144"]] 778 + 779 +(% class="wikigeneratedid" %) 780 +(% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.** 781 + 782 + 783 +== 2.15 Example Query saved historical records == 784 + 785 + 786 +* (% style="color:blue" %)**AT Command: AT+CDP** 787 + 788 +This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes. 789 + 790 +(% class="wikigeneratedid" %) 791 +[[image:image-20240316151014-2.png||height="632" width="825"]] 792 + 793 + 794 +== 2.16 Uplink log query == 795 + 796 + 797 +* (% style="color:blue" %)**AT Command: AT+GETLOG** 798 + 799 +This command can be used to query upstream logs of data packets. 800 + 801 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20240407191922-2.png?width=903&height=631&rev=1.1||alt="image-20240407191922-2.png"]] 802 + 803 + 804 + 805 + 1025 1025 = 3. Configure DS03A-NB = 1026 1026 1027 1027 == 3.1 Configure Methods == ... ... @@ -1032,6 +1032,7 @@ 1032 1032 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 1033 1033 1034 1034 * 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]]. 816 +(% style="display:none" %) (%%) 1035 1035 1036 1036 == 3.2 AT Commands Set == 1037 1037 ... ... @@ -1084,11 +1084,6 @@ 1084 1084 AT+SERVADDR : Server Address 1085 1085 1086 1086 1087 -(% style="color:blue" %)**UDP Management** 1088 - 1089 -AT+CFM : Upload confirmation mode (only valid for UDP) 1090 - 1091 - 1092 1092 (% style="color:blue" %)**MQTT Management** 1093 1093 1094 1094 AT+CLIENT : Get or Set MQTT client ... ... @@ -1136,7 +1136,8 @@ 1136 1136 1137 1137 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]]. 1138 1138 1139 -* 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]]**. 916 +* Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**. 917 +(% style="display:none" %) (%%) 1140 1140 1141 1141 = 6. FAQ = 1142 1142 ... ... @@ -1180,6 +1180,7 @@ 1180 1180 * Package Size / pcs : 14.0 x 8x 5 cm 1181 1181 1182 1182 * Weight / pcs : 180g 961 +(% style="display:none" %) (%%) 1183 1183 1184 1184 = 9. Support = 1185 1185
- image-20231114165017-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +64.0 KB - Content
- image-20231114165035-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +50.7 KB - Content
- image-20231114174523-8.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +51.6 KB - Content
- image-20231115150948-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +91.1 KB - Content
- image-20231115154757-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +66.4 KB - Content
- image-20231115154821-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +51.1 KB - Content
- image-20231115161111-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +82.8 KB - Content
- image-20231115161128-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +82.8 KB - Content
- image-20231115161803-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +91.3 KB - Content
- image-20231115162221-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +88.3 KB - Content
- image-20240316150911-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +210.6 KB - Content
- image-20240316151014-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +105.3 KB - Content