Skip to Content
Last modified by Xiaoling on 2025/04/27 16:48
From version 82.1
edited by Edwin Chen
on 2022/10/22 00:26
Change comment: There is no comment for this version
To version 74.2
edited by Xiaoling
on 2022/10/11 09:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -205,9 +205,7 @@
205 205  
206 206  Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours.
207 207  
208 -Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
209 209  
210 -
211 211  (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
212 212  |=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1
213 213  |=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status
... ... @@ -252,46 +252,50 @@
252 252  
253 253  Use can also get the Device Status uplink through the downlink command:
254 254  
253 +TrackerD Model：0x40
255 255  
255 +(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %)
256 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit
257 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD
256 256  
257 -(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
259 +(% style="color:blue" %)**SMOD：**
258 258  
259 -(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
260 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
261 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings
261 +(% style="color:red" %)**1 :** (%%) GPS ONLY
262 262  
263 -(% style="color:blue" %)** SMOD：**
263 +(% style="color:red" %)**2 :** (%%) BLE ONLY
264 264  
265 -(% style="color:red" %)** 1 :** (%%) GPS ONLY
265 +(% style="color:red" %)**3 :**  (%%) GPS/BLE Hybrid
266 266  
267 -(% style="color:red" %)** 2 :** (%%) BLE ONLY
268 268  
269 -(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
268 +(% style="color:blue" %)**GPS MOD:**
270 270  
270 +(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values
271 271  
272 -(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
272 +(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values
273 273  
274 -(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
275 275  
276 -(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
275 +(% style="color:blue" %)**BLE MOD:**
277 277  
277 +(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon
278 278  
279 -(% style="color:blue" %)** BLE_Settings:**
279 +TrackerD Status:  0x02
280 280  
281 -(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
281 +(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %)
282 +|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit
283 +|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode
282 282  
285 +(% style="color:red" %)**0 : **(%%) Transport Mode
283 283  
287 +(% style="color:red" %)**1 :  **(%%) AT+LON
284 284  
285 -(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
289 +(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable
286 286  
287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %)
288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)1 Bit
289 -|(% style="width:77px" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:92px" %)[[PNACKMD>>||anchor="H2.4.4A0UplinkFPORT3D42CHistoryGNSSPositioning"]]|(% style="width:48px" %)[[LON>>||anchor="H3.2.5Disable2FEnableLEDflash"]]|(% style="width:126px" %)[[Transport Mode>>||anchor="H2.9TransportMode"]]
290 290  
292 +
291 291  === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
292 292  
293 293  
294 -Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes,
296 +User can use **AT+SMOD=1,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, please note that 15 bytes won't work on DR0 on US915/AU915 frequency band.
295 295  
296 296  
297 297  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -347,12 +347,12 @@
347 347  
348 348  ==== (% style="color:blue" %)**Alarm:**(%%) ====
349 349  
350 -**Example: ** 0x4B & 0x40 >> 6 = 0x01
352 +Example:  0x4B & 0x40 >> 6 = 0x01
351 351  
352 352  
353 353  ==== (% style="color:blue" %)**BAT:**(%%) ====
354 354  
355 -**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
357 +Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
356 356  
357 357  (((
358 358  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -364,37 +364,19 @@
364 364  * 3.40v ~~ 3.69v:  20% ~~ 40%
365 365  * < 3.39v:  0~~20%
366 366  
367 -==== (% style="color:blue" %)**MOD:**(%%) ====
368 -
369 -**Example: ** (0x60>>6) & 0x3f =1
370 -
371 -**Set the format of GPS data uplink link：**
372 -
373 -(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
374 -(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
375 -
376 -
377 -**Set the format of BLE data uplink link：**
378 -
379 -(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
380 -
381 -
382 382  ==== (% style="color:blue" %)**LON:**(%%) ====
383 383  
384 -**Example:** (0x60>>5) & 0x01=1.
385 -
386 386  Enable/Disable LED activity for uplink
387 387  
388 388  (((
389 -(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
374 +0x00:  Disable LED indicator.
390 390  )))
391 391  
392 392  (((
393 -(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
378 +0x01:  Enable LED indicator (Default Value)
394 394  )))
395 395  
396 396  
397 -
398 398  ==== (% style="color:blue" %)**Hum:**(%%) ====
399 399  
400 400  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -409,7 +409,7 @@
409 409  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
410 410  
411 411  
412 -The default uplink payload includes total 11 bytes (**AT+SMOD=1,1,0**). The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
396 +The default uplink payload includes totally 11 bytes. The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
413 413  
414 414  
415 415  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -428,7 +428,7 @@
428 428  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
429 429  
430 430  
431 -Set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
415 +Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
432 432  
433 433  
434 434  (% style="color:red" %)**Note for this mode:**
... ... @@ -435,7 +435,6 @@
435 435  
436 436  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
437 437  * b) TrackerD will send data in (% style="color:blue" %)**CONFIRMED Mode**(%%) when PNACKMD=1, but TrackerD won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink, if TrackerD gets an ACK, TrackerD will consider there is a network connection and resend all NONE-ACK Messages.
438 -* c) the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes of payload. In this case (DR0 of US915/AU915), the payload on server will show NULL
439 439  
440 440  The payload is 15 bytes, as below.
441 441  
... ... @@ -451,11 +451,7 @@
451 451  
452 452  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
453 453  
454 -TrackerD supports BLE scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon and find the strongest iBeacon info and uplink.
455 455  
456 -User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
457 -
458 -
459 459  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
460 460  |=(% scope="row" style="width: 60px;" %)(((
461 461  **Size(bytes)**
... ... @@ -475,7 +475,7 @@
475 475  [[image:1664502425687-834.png]]
476 476  
477 477  
478 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
457 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
479 479  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
480 480  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
481 481  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -483,7 +483,6 @@
483 483  * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
484 484  * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
485 485  
486 -
487 487  === 2.4.6  Add Payload format in TTN V3 ===
488 488  
489 489  
... ... @@ -495,9 +495,8 @@
495 495  [[image:1664502649601-895.png]]
496 496  
497 497  
498 -Add the decoder from this link: 
476 +Add the decoder from this link:
499 499  
500 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
501 501  
502 502  Save the change the uplink message will be parsed. As below:
503 503  
... ... @@ -507,10 +507,16 @@
507 507  
508 508  == 2.5 Integrate with Datacake ==
509 509  
487 +
488 +(((
510 510  After TrackerD sends data to LoRaWAN server such as TTN, use can pass the data to Datacake and plot out, currently only support GPS plot.
490 +)))
511 511  
492 +(((
512 512  Instruction is here:  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20Data%20Cake/#H7.Example~~-~~-AddTrackerDGPSTrackingInDataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20Data%20Cake/#H7.Example--AddTrackerDGPSTrackingInDataCake]]
494 +)))
513 513  
496 +
514 514  [[image:1664502695771-538.png]]
515 515  
516 516  
... ... @@ -518,13 +518,15 @@
518 518  == 2.6 Integrate with Tago ==
519 519  
520 520  
504 +(((
505 +After TrackerD sends data to LoRaWAN server such as TTN, use can pass the data to Datacake and plot out, currently only support GPS plot.
506 +)))
521 521  
522 -After TrackerD sends data to LoRaWAN server such as TTN, user can pass the data to Datacake and plot out, currently only support GPS plot.
523 -
508 +(((
524 524  Instruction is here: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Tago.IO/#H3.A0Example-CreateTrackerD2FLGT92positioningwidget>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Tago.IO/#H3.A0Example-CreateTrackerD2FLGT92positioningwidget]]
510 +)))
525 525  
526 526  
527 -
528 528  [[image:1664502715371-321.png]]
529 529  
530 530  
... ... @@ -532,9 +532,8 @@
532 532  == 2.7  Datalog Feature ==
533 533  
534 534  
535 -total 273 entries,by default,
520 +total 273 entries,by default disable
536 536  
537 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
538 538  
539 539  Example use case.
540 540  
... ... @@ -554,7 +554,7 @@
554 554  
555 555  
556 556  (((
557 -Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exits alert mode.
541 +Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exit alert mode.
558 558  )))
559 559  
560 560  
... ... @@ -562,7 +562,7 @@
562 562  Two ways to exit alarm mode:
563 563  )))
564 564  
565 -* Server sends a downlink command to exit.
549 +* Server send a downlink command to exit.
566 566  * User fast press the RED button 10 times.
567 567  
568 568  (((
... ... @@ -650,9 +650,11 @@
650 650  [[image:1664503022490-662.png]]
651 651  
652 652  
637 +
653 653  [[image:1664503035713-500.png]]
654 654  
655 655  
641 +
656 656  [[image:1664503047675-651.png]]
657 657  
658 658  
... ... @@ -766,38 +766,42 @@
766 766  === 3.2.7 Set Positioning Mode ===
767 767  
768 768  
769 -SMOD define how TrackerD scan and uplink data:
755 +SMOD define the how TrackerD scan and uplink data:
770 770  
771 771  
772 772  * (% style="color:blue" %)**AT Command:**
773 773  
774 -(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
760 +(% style="color:#037691" %)**AT+SMOD=aa,bb**
775 775  
776 776  (% style="color:#037691" %)** aa:**
777 777  
778 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
779 -* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
780 -* (% style="color:red" %)**3: GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning.
764 +* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
765 +* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
766 +* (% style="color:#037691" %)**3: GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning
781 781  
782 782  (% style="color:#037691" %)**bb:**
783 783  
784 -* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
785 -* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
770 +(% style="color:#037691" %)** if aa = 1: **
786 786  
787 -(% style="color:#037691" %)**cc:   **
772 +* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
773 +* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
788 788  
789 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
775 +(% style="color:#037691" %)** if aa = 2: **
790 790  
791 -(% style="color:blue" %)**Example:**
777 +* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
792 792  
793 - AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
794 - AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
795 - AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
779 + **Example:**
796 796  
781 + AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
797 797  
783 + AT+ SMOD =1,1    **~-~->**  GPS +BAT State
784 +
785 + AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
786 +
787 +
798 798  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
799 799  
800 -(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
790 +(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
801 801  
802 802  
803 803  
... ... @@ -814,7 +814,7 @@
814 814  
815 815  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
816 816  
817 -**Example:**  AT+FTIME=150
807 +Example:  AT+FTIME=150
818 818  
819 819  
820 820  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -851,7 +851,7 @@
851 851  
852 852  * (% style="color:blue" %)**AT Command:**
853 853  
854 -(% style="color:#037691" %)**AT+CFM=xx**
844 +(% style="color:#037691" %)**AT+CFM=xx. **
855 855  
856 856  
857 857  **~ Example:**
... ... @@ -867,44 +867,6 @@
867 867  
868 868  
869 869  
870 -=== 3.2.10  Auto Send None-ACK messages ===
871 -
872 -
873 -TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message.
874 -
875 -
876 -* (% style="color:blue" %)**AT Command: AT+PNACKMD**
877 -
878 -The default factory setting is 0.
879 -
880 -
881 -**Command Example Function Response:**
882 -
883 -(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
884 -
885 -
886 -* (% style="color:blue" %)**Downlink Command: 0x34**
887 -
888 -Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
889 -
890 -
891 -=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
892 -
893 -BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. LBT1 will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID.
894 -
895 -Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.
896 -
897 -(% style="color:blue" %)**AT Command:**(%%)
898 - AT+BLEMASK=123456     ~/~/ Set BLEMASK = 123456
899 - AT+BLEMASK=0  ~/~/ disable BLEMASK
900 -
901 -
902 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%)
903 -Example:
904 -0xA5010203040506    ~/~/ Set BLEMASK to 123456
905 -
906 -
907 -
908 908  = 4. Setting for Different Scenarios =
909 909  
910 910