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

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
Content
... ... @@ -205,7 +205,9 @@
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**
208 208  
210 +
209 209  (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
210 210  |=(% 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
211 211  |=(% 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
... ... @@ -250,50 +250,46 @@
250 250  
251 251  Use can also get the Device Status uplink through the downlink command:
252 252  
253 -TrackerD Model：0x40
254 254  
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
258 258  
259 -(% style="color:blue" %)**SMOD：**
257 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
260 260  
261 -(% style="color:red" %)**1 :** (%%) GPS ONLY
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
262 262  
263 -(% style="color:red" %)**2 :** (%%) BLE ONLY
263 +(% style="color:blue" %)** SMOD：**
264 264  
265 -(% style="color:red" %)**3 :**  (%%) GPS/BLE Hybrid
265 +(% style="color:red" %)** 1 :** (%%) GPS ONLY
266 266  
267 +(% style="color:red" %)** 2 :** (%%) BLE ONLY
267 267  
268 -(% style="color:blue" %)**GPS MOD:**
269 +(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
269 269  
270 -(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values
271 271  
272 -(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values
272 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
273 273  
274 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
274 274  
275 -(% style="color:blue" %)**BLE MOD:**
276 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
276 276  
277 -(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon
278 278  
279 -TrackerD Status:  0x02
279 +(% style="color:blue" %)** BLE_Settings:**
280 280  
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
281 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
284 284  
285 -(% style="color:red" %)**0 : **(%%) Transport Mode
286 286  
287 -(% style="color:red" %)**1 :  **(%%) AT+LON
288 288  
289 -(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable
285 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
290 290  
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"]]
291 291  
292 -
293 293  === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
294 294  
295 295  
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.
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,
297 297  
298 298  
299 299  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -349,12 +349,12 @@
349 349  
350 350  ==== (% style="color:blue" %)**Alarm:**(%%) ====
351 351  
352 -Example:  0x4B & 0x40 >> 6 = 0x01
350 +**Example: ** 0x4B & 0x40 >> 6 = 0x01
353 353  
354 354  
355 355  ==== (% style="color:blue" %)**BAT:**(%%) ====
356 356  
357 -Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
355 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
358 358  
359 359  (((
360 360  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -366,19 +366,37 @@
366 366  * 3.40v ~~ 3.69v:  20% ~~ 40%
367 367  * < 3.39v:  0~~20%
368 368  
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 +
369 369  ==== (% style="color:blue" %)**LON:**(%%) ====
370 370  
384 +**Example:** (0x60>>5) & 0x01=1.
385 +
371 371  Enable/Disable LED activity for uplink
372 372  
373 373  (((
374 -0x00:  Disable LED indicator.
389 +(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
375 375  )))
376 376  
377 377  (((
378 -0x01:  Enable LED indicator (Default Value)
393 +(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
379 379  )))
380 380  
381 381  
397 +
382 382  ==== (% style="color:blue" %)**Hum:**(%%) ====
383 383  
384 384  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -393,7 +393,7 @@
393 393  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
394 394  
395 395  
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)
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)
397 397  
398 398  
399 399  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -412,7 +412,7 @@
412 412  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
413 413  
414 414  
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.
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.
416 416  
417 417  
418 418  (% style="color:red" %)**Note for this mode:**
... ... @@ -419,6 +419,7 @@
419 419  
420 420  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
421 421  * 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
422 422  
423 423  The payload is 15 bytes, as below.
424 424  
... ... @@ -434,7 +434,11 @@
434 434  
435 435  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
436 436  
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.
437 437  
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 +
438 438  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
439 439  |=(% scope="row" style="width: 60px;" %)(((
440 440  **Size(bytes)**
... ... @@ -454,7 +454,7 @@
454 454  [[image:1664502425687-834.png]]
455 455  
456 456  
457 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
478 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
458 458  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
459 459  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
460 460  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -462,6 +462,7 @@
462 462  * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
463 463  * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
464 464  
486 +
465 465  === 2.4.6  Add Payload format in TTN V3 ===
466 466  
467 467  
... ... @@ -473,8 +473,9 @@
473 473  [[image:1664502649601-895.png]]
474 474  
475 475  
476 -Add the decoder from this link:
498 +Add the decoder from this link: 
477 477  
500 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
478 478  
479 479  Save the change the uplink message will be parsed. As below:
480 480  
... ... @@ -484,16 +484,10 @@
484 484  
485 485  == 2.5 Integrate with Datacake ==
486 486  
487 -
488 -(((
489 489  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 -)))
491 491  
492 -(((
493 493  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 -)))
495 495  
496 -
497 497  [[image:1664502695771-538.png]]
498 498  
499 499  
... ... @@ -501,15 +501,13 @@
501 501  == 2.6 Integrate with Tago ==
502 502  
503 503  
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 -)))
507 507  
508 -(((
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 +
509 509  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 -)))
511 511  
512 512  
527 +
513 513  [[image:1664502715371-321.png]]
514 514  
515 515  
... ... @@ -517,8 +517,9 @@
517 517  == 2.7  Datalog Feature ==
518 518  
519 519  
520 -total 273 entries,by default disable
535 +total 273 entries,by default,
521 521  
537 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
522 522  
523 523  Example use case.
524 524  
... ... @@ -538,7 +538,7 @@
538 538  
539 539  
540 540  (((
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 +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.
542 542  )))
543 543  
544 544  
... ... @@ -546,7 +546,7 @@
546 546  Two ways to exit alarm mode:
547 547  )))
548 548  
549 -* Server send a downlink command to exit.
565 +* Server sends a downlink command to exit.
550 550  * User fast press the RED button 10 times.
551 551  
552 552  (((
... ... @@ -634,11 +634,9 @@
634 634  [[image:1664503022490-662.png]]
635 635  
636 636  
637 -
638 638  [[image:1664503035713-500.png]]
639 639  
640 640  
641 -
642 642  [[image:1664503047675-651.png]]
643 643  
644 644  
... ... @@ -752,42 +752,38 @@
752 752  === 3.2.7 Set Positioning Mode ===
753 753  
754 754  
755 -SMOD define the how TrackerD scan and uplink data:
769 +SMOD define how TrackerD scan and uplink data:
756 756  
757 757  
758 758  * (% style="color:blue" %)**AT Command:**
759 759  
760 -(% style="color:#037691" %)**AT+SMOD=aa,bb**
774 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
761 761  
762 762  (% style="color:#037691" %)** aa:**
763 763  
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
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.
767 767  
768 768  (% style="color:#037691" %)**bb:**
769 769  
770 -(% style="color:#037691" %)** if aa = 1: **
784 +* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
785 +* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
771 771  
772 -* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
773 -* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
787 +(% style="color:#037691" %)**cc:   **
774 774  
775 -(% style="color:#037691" %)** if aa = 2: **
789 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
776 776  
777 -* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
791 +(% style="color:blue" %)**Example:**
778 778  
779 - **Example:**
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
780 780  
781 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
782 782  
783 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
784 -
785 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
786 -
787 -
788 788  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
789 789  
790 -(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
800 +(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
791 791  
792 792  
793 793  
... ... @@ -804,7 +804,7 @@
804 804  
805 805  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
806 806  
807 -Example:  AT+FTIME=150
817 +**Example:**  AT+FTIME=150
808 808  
809 809  
810 810  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -841,7 +841,7 @@
841 841  
842 842  * (% style="color:blue" %)**AT Command:**
843 843  
844 -(% style="color:#037691" %)**AT+CFM=xx. **
854 +(% style="color:#037691" %)**AT+CFM=xx**
845 845  
846 846  
847 847  **~ Example:**
... ... @@ -857,6 +857,44 @@
857 857  
858 858  
859 859  
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 +
860 860  = 4. Setting for Different Scenarios =
861 861  
862 862