Skip to Content
Last modified by Xiaoling on 2025/04/27 16:48
From version 81.1
edited by Edwin Chen
on 2022/10/22 00:24
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 match the BLEMASK.
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.
... ... @@ -494,9 +494,8 @@
494 494  [[image:1664502649601-895.png]]
495 495  
496 496  
497 -Add the decoder from this link: 
476 +Add the decoder from this link:
498 498  
499 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
500 500  
501 501  Save the change the uplink message will be parsed. As below:
502 502  
... ... @@ -506,10 +506,16 @@
506 506  
507 507  == 2.5 Integrate with Datacake ==
508 508  
487 +
488 +(((
509 509  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 +)))
510 510  
492 +(((
511 511  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 +)))
512 512  
496 +
513 513  [[image:1664502695771-538.png]]
514 514  
515 515  
... ... @@ -517,13 +517,15 @@
517 517  == 2.6 Integrate with Tago ==
518 518  
519 519  
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 +)))
520 520  
521 -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.
522 -
508 +(((
523 523  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 +)))
524 524  
525 525  
526 -
527 527  [[image:1664502715371-321.png]]
528 528  
529 529  
... ... @@ -531,9 +531,8 @@
531 531  == 2.7  Datalog Feature ==
532 532  
533 533  
534 -total 273 entries,by default,
520 +total 273 entries,by default disable
535 535  
536 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
537 537  
538 538  Example use case.
539 539  
... ... @@ -553,7 +553,7 @@
553 553  
554 554  
555 555  (((
556 -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.
557 557  )))
558 558  
559 559  
... ... @@ -561,7 +561,7 @@
561 561  Two ways to exit alarm mode:
562 562  )))
563 563  
564 -* Server sends a downlink command to exit.
549 +* Server send a downlink command to exit.
565 565  * User fast press the RED button 10 times.
566 566  
567 567  (((
... ... @@ -649,9 +649,11 @@
649 649  [[image:1664503022490-662.png]]
650 650  
651 651  
637 +
652 652  [[image:1664503035713-500.png]]
653 653  
654 654  
641 +
655 655  [[image:1664503047675-651.png]]
656 656  
657 657  
... ... @@ -765,38 +765,42 @@
765 765  === 3.2.7 Set Positioning Mode ===
766 766  
767 767  
768 -SMOD define how TrackerD scan and uplink data:
755 +SMOD define the how TrackerD scan and uplink data:
769 769  
770 770  
771 771  * (% style="color:blue" %)**AT Command:**
772 772  
773 -(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
760 +(% style="color:#037691" %)**AT+SMOD=aa,bb**
774 774  
775 775  (% style="color:#037691" %)** aa:**
776 776  
777 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
778 -* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
779 -* (% 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
780 780  
781 781  (% style="color:#037691" %)**bb:**
782 782  
783 -* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
784 -* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
770 +(% style="color:#037691" %)** if aa = 1: **
785 785  
786 -(% style="color:#037691" %)**cc:   **
772 +* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
773 +* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
787 787  
788 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
775 +(% style="color:#037691" %)** if aa = 2: **
789 789  
790 -(% style="color:blue" %)**Example:**
777 +* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
791 791  
792 - AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
793 - AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
794 - AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
779 + **Example:**
795 795  
781 + AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
796 796  
783 + AT+ SMOD =1,1    **~-~->**  GPS +BAT State
784 +
785 + AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
786 +
787 +
797 797  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
798 798  
799 -(% 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
800 800  
801 801  
802 802  
... ... @@ -813,7 +813,7 @@
813 813  
814 814  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
815 815  
816 -**Example:**  AT+FTIME=150
807 +Example:  AT+FTIME=150
817 817  
818 818  
819 819  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -850,7 +850,7 @@
850 850  
851 851  * (% style="color:blue" %)**AT Command:**
852 852  
853 -(% style="color:#037691" %)**AT+CFM=xx**
844 +(% style="color:#037691" %)**AT+CFM=xx. **
854 854  
855 855  
856 856  **~ Example:**
... ... @@ -866,44 +866,6 @@
866 866  
867 867  
868 868  
869 -=== 3.2.10  Auto Send None-ACK messages ===
870 -
871 -
872 -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.
873 -
874 -
875 -* (% style="color:blue" %)**AT Command: AT+PNACKMD**
876 -
877 -The default factory setting is 0.
878 -
879 -
880 -**Command Example Function Response:**
881 -
882 -(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
883 -
884 -
885 -* (% style="color:blue" %)**Downlink Command: 0x34**
886 -
887 -Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
888 -
889 -
890 -=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
891 -
892 -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.
893 -
894 -Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.
895 -
896 -(% style="color:blue" %)**AT Command:**(%%)
897 - AT+BLEMASK=123456     ~/~/ Set BLEMASK = 123456
898 - AT+BLEMASK=0  ~/~/ disable BLEMASK
899 -
900 -
901 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%)
902 -Example:
903 -0xA5010203040506    ~/~/ Set BLEMASK to 123456
904 -
905 -
906 -
907 907  = 4. Setting for Different Scenarios =
908 908  
909 909