Skip to Content

Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35
From version 119.1
edited by Mengting Qiu
on 2023/11/14 09:53
Change comment: There is no comment for this version
To version 137.2
edited by Xiaoling
on 2024/03/18 15:23
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
... ... @@ -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,25 +282,43 @@
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"]]
... ... @@ -308,20 +308,19 @@
308 308  
309 309  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  
311 -
312 312  [[image:image-20231114094432-3.png]]
313 313  
314 314  
315 315  
338 +**The HEX format payload for the double-channel mode is as follows:**
316 316  
340 +(% style="color:#4472c4" %)**f86620705255985712640db71701010000000000000001000000000000006552d13401000000000000000000000000006551f365000000000001050000005f00005f655195e0ed97040b0001070000005c00005c6551925c0000001d00010700000033000033655187dcd797043700010c00000033000033655182b80000004f0001050000003300003365517f34e397041f51eadc00000000000000655179760000001351e75800000000000000654f4125**
317 317  
318 318  [[image:image-20231114091229-1.png||height="180" width="1584"]]
319 319  
320 320  
321 -
322 322  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
323 323  
324 -
325 325  [[image:image-20231114094838-5.png]]
326 326  
327 327  
... ... @@ -368,15 +368,28 @@
368 368  
369 369  Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
370 370  
371 -(% 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 + }**
372 372  
373 -[[image:image-20230922094043-2.png||height="558" width="851"]]
408 +[[image:image-20231115150948-1.png||height="625" width="1188"]]
374 374  
375 375  
376 376  === 2.2.4 ThingSpeak Payload(Type~=1) ===
377 377  
378 378  
379 -This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~3 are:
414 +This payload meets ThingSpeak platform requirement. It includes eight fields. Form 1~~8 are:
380 380  
381 381  Distance, Battery & Signal. This payload type only valid for ThingsSpeak Platform
382 382  
... ... @@ -384,333 +384,15 @@
384 384  
385 385  (% style="color:#4472c4" %)**field1=Flow value&field2=Battery value&field3=signal value**
386 386  
387 -[[image:image-20230921104741-1.png||height="565" width="826"]]
422 +[[image:image-20231115154757-2.png]]
388 388  
424 +[[image:image-20231115154821-3.png||height="695" width="1119"]]
389 389  
390 -== 2.3  ​Uplink Payload ==
391 391  
392 -=== 2.3.1  Sensor Configuration, FPORT~=4 ===
393 393  
428 +== 2.3 Test Uplink and Change Update Interval ==
394 394  
395 -DS03A-NB will only send this command after getting the downlink command **(0x26 02)** from the server.
396 396  
397 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
398 -|(% colspan="8" style="background-color:#4f81bd; color:white; width:515px" %)**Sensor Configuration FPORT=4**
399 -|**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**
400 -|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)(((
401 -Keep status1
402 -)))|(% style="width:99px" %)(((
403 -Keep time1(unit: sec)
404 -)))|(% style="width:87px" %)Keep status2|(% style="width:97px" %)(((
405 -Keep time2(unit: sec)
406 -)))|(% style="width:98px" %)(((
407 -Alarm interval(unit: min)
408 -)))
409 -
410 -Example parse in TTNv3
411 -
412 -[[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"]]
413 -
414 -
415 -* (((
416 -(% style="color:blue" %)**TDC: (default: 0x001C20)**
417 -)))
418 -
419 -Uplink interval for the Open/Close Event, default value is 0x001C20 which is 7200 seconds = 2 hours.
420 -
421 -
422 -* (((
423 -(% style="color:blue" %)**Disalarm: (default: 0)**
424 -)))
425 -
426 - **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.
427 -
428 - **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.
429 -
430 -(% style="color:red" %)** Note: When Disalarm=0, a high frequently open/close event will cause lots of uplink and drain battery very fast. **
431 -
432 -
433 -* (((
434 -(% style="color:blue" %)**Keep Status1 & Keep Time1 & Keep Status2 & Keep Time2**
435 -)))
436 -
437 -Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H2.9AlarmBaseonTimeout"]]
438 -
439 -
440 -* (((
441 -(% style="color:blue" %)**Alarm interval(default: 0)**
442 -)))
443 -
444 -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.
445 -
446 -
447 -=== 2.3.2  Real-Time Open/Close Status, Uplink FPORT~=2 ===
448 -
449 -
450 -DS03A-NB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS03A-NB will send uplinks when:
451 -
452 -* Every 2 hours, this interval [[can be changed>>||anchor="H2.7SetTransmitIntervalTime"]].
453 -* There is an Open/Close event.  (This info can be disabled by AT+DISALARM=1)
454 -
455 -**1) When (% style="color:blue" %)AT+TTRCHANNEL=1(%%), Uplink Payload totals (% style="color:blue" %)11 bytes. (Default mode)(%%)**
456 -
457 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
458 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=2**
459 -|(% style="width:94px" %)**Size(bytes)**|(% style="width:97px" %)**1**|(% style="width:95px" %)**3**|(% style="width:119px" %)**3**|(% style="width:107px" %)**4**
460 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
461 -Status & [[Alarm>>||anchor="2.10TTRIG126TTRIG2timeoutstatusalarm"]]
462 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
463 -The last door open duration (unit: sec)
464 -)))|(% style="width:108px" %)Unix TimeStamp
465 -
466 -**Status & Alarm:**
467 -
468 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
469 -|(% 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**
470 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:110px" %)(((
471 -Count mod
472 -)))|(% style="width:106px" %)TDC flag 0:No;1:Yes|(% style="width:148px" %)(((
473 -Alarm 0: No Alarm; 1: Alarm
474 -)))|(% style="width:131px" %)(((
475 -Status 0: Close; 1: Open
476 -)))
477 -
478 -[[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"]]
479 -
480 -
481 -* (((
482 -(% style="color:blue" %)**Count mod:Default=0**
483 -)))
484 -
485 -0: Uplink total open door times since factory
486 -
487 -1: Uplink total open door times since last FPORT=2 uplink.
488 -
489 -
490 -* (% style="color:blue" %)**TDC flag**
491 -
492 -When the flag is 1, it means sending packets at normal time intervals.
493 -
494 -Otherwise, it is a packet sent at non-TDC time.
495 -
496 -
497 -* (((
498 -(% style="color:#0000ff" %)**Alarm**
499 -)))
500 -
501 -See [[Alarm Base on Timeout>>||anchor="H3.3.3A0AlarmBaseonTimeout"]]
502 -
503 -
504 -* (((
505 -(% style="color:blue" %)**Status**
506 -)))
507 -
508 -This bit is 1 when the door sensor is open and 0 when it is close.
509 -
510 -
511 -* (((
512 -(% style="color:blue" %)**Total open door events**
513 -)))
514 -
515 -Total pulse/counting base on open door.
516 -
517 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
518 -
519 -
520 -* (((
521 -(% style="color:blue" %)**The last door open duration**
522 -)))
523 -
524 -Door sensor last open duration.
525 -
526 -Unit: sec.
527 -
528 -[[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"]]
529 -
530 -
531 -**2) When (% style="color:blue" %)AT+TTRCHANNEL=2(%%), Uplink Payload totals (% style="color:blue" %)18 bytes(%%)**(% style="color:blue" %).
532 -
533 -(When the maximum DR of some frequencies is 11 bytes, it will cause the server to receive empty packets)
534 -
535 -(% style="color:red" %)**Note:When using the AT+TTRCHANNEL=2 command, the Datalog function cannot be used.**
536 -
537 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
538 -|=(% colspan="8" style="background-color:#4F81BD;color:white; width: 515px;" %)**Real-Time Open/Close Status, FPORT=2**
539 -|(% 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**
540 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
541 -Status1 & Alarm1
542 -)))|(% style="width:95px" %)Total open door events1|(% style="width:125px" %)(((
543 -The last door open duration1 (unit: sec)
544 -)))|(% style="width:100px" %)Unix TimeStamp|(% style="width:86px" %)(((
545 -Status2 & Alarm2
546 -)))|(% style="width:96px" %)Total open door events2|(% style="width:126px" %)The last door open duration2 (unit: sec)
547 -
548 -**Status1 & Alarm1:**
549 -
550 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:514px" %)
551 -|(% 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**
552 -|(% style="width:76px" %)**Value**|(% style="width:96px" %)Reserve|(% style="width:99px" %)(((
553 -Count mod
554 -)))|(% style="width:103px" %)TDC flag 0:No;1:Yes|(% style="width:216px" %)(((
555 -Alarm1 0: No Alarm; 1: Alarm (PA8 of pin)
556 -)))|(% style="width:181px" %)(((
557 -Status1 0: Close; 1: Open (PA8 of pin)
558 -)))
559 -
560 -**Status2 & Alarm2:**
561 -
562 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
563 -|(% 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**
564 -|(% style="width:76px" %)**Value**|(% style="width:113px" %)Reserve|(% style="width:219px" %)(((
565 -Alarm2 0: No Alarm; 1: Alarm (PA4 of pin)
566 -)))|(% style="width:181px" %)(((
567 -Status2 0: Close; 1: Open (PA4 of pin)
568 -)))
569 -
570 -[[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"]]
571 -
572 -
573 -* (((
574 -(% style="color:blue" %)**Count mod:Default=0**
575 -)))
576 -
577 -0: Uplink total open door times since factory
578 -
579 -1: Uplink total open door times since last FPORT=2 uplink.
580 -
581 -
582 -* (% style="color:blue" %)**TDC flag**
583 -
584 -When the flag is 1, it means sending packets at normal time intervals.
585 -
586 -Otherwise, it is a packet sent at non-TDC time.
587 -
588 -
589 -* (((
590 -(% style="color:#0000ff" %)**Alarm1 or Alarm2**
591 -)))
592 -
593 -See [[Alarm Base on Timeout>>||anchor="H2.9AlarmBaseonTimeout"]]
594 -
595 -
596 -* (((
597 -(% style="color:blue" %)**Status1 **(% style="color:#0000ff" %)**or **(% style="color:blue" %)**Status2**
598 -)))
599 -
600 -This bit is 1 when the door sensor is open and 0 when it is close.
601 -
602 -
603 -* (((
604 -(% style="color:blue" %)**Total open door events1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** Total open door events2**
605 -)))
606 -
607 -Total pulse/counting base on open door.
608 -
609 -Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215
610 -
611 -
612 -* (((
613 -(% style="color:blue" %)**The last door open duration1 **(% style="color:#0000ff" %)**or**(% style="color:blue" %)** The last door open duration2**
614 -)))
615 -
616 -Door sensor last open duration.
617 -
618 -Unit: sec.
619 -
620 -[[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"]]
621 -
622 -
623 -=== 2.3.3  Historical Door Open/Close Event, FPORT~=3 ===
624 -
625 -
626 -DS03A-NB stores sensor values and users can retrieve these history values via the downlink command.
627 -
628 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status.
629 -
630 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
631 -|=(% colspan="5" style="background-color:#4F81BD;color:white;width:515px" %)**Real-Time Open/Close Status, FPORT=3**
632 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:120px" %)**3**|(% style="width:150px" %)**3**|(% style="width:90px" %)**4**
633 -|(% style="width:95px" %)**Value**|(% style="width:97px" %)(((
634 -Status & [[Alarm>>||anchor="H2.9A0AlarmBaseonTimeout"]]
635 -)))|(% style="width:95px" %)Total open door events|(% style="width:119px" %)(((
636 -The last door open duration (unit: sec)
637 -)))|(% style="width:108px" %)Unix TimeStamp
638 -
639 -**Status & Alarm:**
640 -
641 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:515px" %)
642 -|(% 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**
643 -|(% style="width:76px" %)**Value**|(% style="width:88px" %)No ACK message|(% style="width:92px" %)Poll Message Flag|(% style="width:89px" %)Reserve|(% style="width:90px" %)(((
644 -Count mod
645 -)))|(% style="width:95px" %)(((
646 -TDC flag 0:No; 1:Yes
647 -)))|(% style="width:116px" %)(((
648 -Alarm 0: No Alarm; 1: Alarm
649 -)))|(% style="width:112px" %)(((
650 -Status 0:Close; 1: Open
651 -)))
652 -
653 -* (((
654 -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.
655 -)))
656 -
657 -For example, in the US915 band, the max payload for different DR is:
658 -
659 -(((
660 -**~1. DR0**: max is 11 bytes so one entry of data
661 -)))
662 -
663 -(((
664 -**2. DR1**: max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
665 -)))
666 -
667 -(((
668 -**3. DR2**: total payload includes 11 entries of data
669 -)))
670 -
671 -(((
672 -**4. DR3**: total payload includes 22 entries of data.
673 -)))
674 -
675 -If DS03A-NB doesn't have any data in the polling time. It will uplink 11 bytes of 0
676 -
677 -[[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"]]
678 -
679 -**Downlink:**
680 -
681 -0x31 64 9E 7D 34 64 9E 7E 9C 05
682 -
683 -
684 -**Uplink:**
685 -
686 -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
687 -
688 -
689 -**Parsed Value:**
690 -
691 -[COUNTMOD, TDC_FLAG, ALARM,  DOOR_STATUS, OPEN_DOOR_TIMES, LAST_DOOR_OPEN_DURATION, TIME]
692 -
693 -
694 -[SUM,YES,FALSE,OPEN,0,0,2023-06-30 06:59:20],
695 -
696 -[SUM,NO,FALSE,CLOSE,0,99,2023-06-30 07:00:44],
697 -
698 -[SUM,NO,FALSE,OPEN, 1,99,2023-06-30 07:00:52],
699 -
700 -[SUM,NO,FALSE,CLOSE,1,141,2023-06-30 07:03:13],
701 -
702 -[SUM,NO,TRUE,OPEN, 2,141,2023-06-30 07:03:32],
703 -
704 -[PART,NO,FALSE,CLOSE,2,31,2023-06-30 07:03:53],
705 -
706 -[PART,NO,TRUE,OPEN, 3,31,2023-06-30 07:04:11],
707 -
708 -[[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"]]
709 -
710 -
711 -== 2.4 Test Uplink and Change Update Interval ==
712 -
713 -
714 714  By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
715 715  
716 716  User can use below commands to change the (% style="color:blue" %)**uplink interval**.
... ... @@ -720,7 +720,7 @@
720 720  User can also push the button for more than 1 seconds to activate an uplink.
721 721  
722 722  
723 -== 2.5 Multi-Samplings and One uplink ==
440 +== 2.4 Multi-Samplings and One uplink ==
724 724  
725 725  
726 726  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:
... ... @@ -734,7 +734,7 @@
734 734  [[image:1692424376354-959.png]]
735 735  
736 736  
737 -== 2.6 Trggier an uplink by external interrupt ==
454 +== 2.5 Trggier an uplink by external interrupt ==
738 738  
739 739  
740 740  DS03A-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
... ... @@ -750,8 +750,9 @@
750 750  * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
751 751  
752 752  * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
470 +(% style="display:none" %) (%%)
753 753  
754 -== 2.7 Set Transmit Interval Time ==
472 +== 2.5 Set Transmit Interval Time ==
755 755  
756 756  
757 757  (((
... ... @@ -791,14 +791,11 @@
791 791  )))
792 792  * (((
793 793  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
512 +)))(% style="display:none" %) (%%)
794 794  
514 +== 2.7 Enable / Disable Alarm ==
795 795  
796 -
797 -)))
798 798  
799 -== 2.8 Enable / Disable Alarm ==
800 -
801 -
802 802  Feature: Enable/Disable Alarm for open/close event. Default value 0.
803 803  
804 804  (% style="color:blue" %)**AT Command: **
... ... @@ -815,7 +815,7 @@
815 815  0xA7 00  ~/~/ Same As AT+DISALARM=0
816 816  
817 817  
818 -== 2.9 Alarm Base on Timeout ==
533 +== 2.8 Alarm Base on Timeout ==
819 819  
820 820  
821 821  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:
... ... @@ -897,7 +897,7 @@
897 897  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.
898 898  
899 899  
900 -== 2.10 TTRIG1 & TTRIG2 timeout status alarm ==
615 +== 2.9 TTRIG1 & TTRIG2 timeout status alarm ==
901 901  
902 902  
903 903  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.
... ... @@ -926,7 +926,7 @@
926 926  Example:  0C aa  => AT+TTRALARM= aa
927 927  
928 928  
929 -== 2.11 Count Mod ==
644 +== 2.10 Count Mod ==
930 930  
931 931  
932 932  Feature: Manually set the count mode.
... ... @@ -955,7 +955,7 @@
955 955  Example:  0B aa  => AT+COUNTMOD = second byte
956 956  
957 957  
958 -== 2.12  Number of channel of door sensors ==
673 +== 2.11 Number of channel of door sensors ==
959 959  
960 960  
961 961  Feature: Set the number of door sensor channels.
... ... @@ -984,7 +984,7 @@
984 984  Example:  0D aa => AT+TTRCHANNEL = second byte
985 985  
986 986  
987 -== 2.13  Clear the open door times and the duration of the last open door ==
702 +== 2.12 Clear the open door times and the duration of the last open door ==
988 988  
989 989  
990 990  (% style="color:blue" %)**AT Command:**
... ... @@ -1000,7 +1000,7 @@
1000 1000  The sensor will clear the open door times and the duration of the last open door.
1001 1001  
1002 1002  
1003 -== 2.14  Set the count value of the number of open door ==
718 +== 2.13 Set the count value of the number of open door ==
1004 1004  
1005 1005  
1006 1006  (% style="color:blue" %)**AT Command:**
... ... @@ -1032,6 +1032,49 @@
1032 1032  0xA6 02 00 00 32  ==>  AT+SETCNT=2,50
1033 1033  
1034 1034  
750 +== 2.14 Clock logging (Since firmware version v1.2.1) ==
751 +
752 +
753 +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.
754 +
755 +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.
756 +
757 +* (% style="color:blue" %)**AT Command: AT+CLOCKLOG=a,b,c,d**
758 +
759 +(% style="color:blue" %)**a:**(%%)** 0:** Disable Clock logging.  ** 1: **Enable Clock Logging
760 +
761 +(% 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.
762 +
763 +(% style="color:blue" %)**c:**(%%)** **Specify the sampling interval: range **(0 ~~ 255 minutes)**
764 +
765 +(% style="color:blue" %)**d:**(%%)** **How many entries should be uplink on every TDC **(max 32)**
766 +
767 +[[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"]]
768 +
769 +**Example:**
770 +
771 +**AT+CLOCKLOG=1,65535,1,5**
772 +
773 +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).
774 +
775 +(% class="wikigeneratedid" %)
776 +[[image:image-20240316150911-1.png||height="493" width="1144"]]
777 +
778 +(% class="wikigeneratedid" %)
779 +(% 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.**
780 +
781 +
782 +== 2.8 Example Query saved historical records ==
783 +
784 +
785 +* (% style="color:blue" %)**AT Command: AT+CDP**
786 +
787 +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.
788 +
789 +(% class="wikigeneratedid" %)
790 +[[image:image-20240316151014-2.png||height="632" width="825"]]
791 +
792 +
1035 1035  = 3. Configure DS03A-NB =
1036 1036  
1037 1037  == 3.1 Configure Methods ==
... ... @@ -1042,6 +1042,7 @@
1042 1042  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
1043 1043  
1044 1044  * 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]].
803 +(% style="display:none" %) (%%)
1045 1045  
1046 1046  == 3.2 AT Commands Set ==
1047 1047  
... ... @@ -1146,7 +1146,8 @@
1146 1146  
1147 1147  * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
1148 1148  
1149 -* 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]]**.
908 +* Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.
909 +(% style="display:none" %) (%%)
1150 1150  
1151 1151  = 6. FAQ =
1152 1152  
... ... @@ -1190,6 +1190,7 @@
1190 1190  * Package Size / pcs : 14.0 x 8x 5 cm
1191 1191  
1192 1192  * Weight / pcs : 180g
953 +(% style="display:none" %) (%%)
1193 1193  
1194 1194  = 9. Support =
1195 1195  
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