Skip to Content
Last modified by Xiaoling on 2025/04/27 16:48
From version 74.8
edited by Xiaoling
on 2022/10/11 17:08
Change comment: There is no comment for this version
To version 84.5
edited by Xiaoling
on 2022/10/24 11:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -211,7 +211,9 @@
211 211  
212 212  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.
213 213  
214 +Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
214 214  
216 +
215 215  (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
216 216  |=(% 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
217 217  |=(% 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
... ... @@ -256,50 +256,46 @@
256 256  
257 257  Use can also get the Device Status uplink through the downlink command:
258 258  
259 -TrackerD Model：0x40
260 260  
261 -(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %)
262 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit
263 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD
262 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
264 264  
265 -(% style="color:blue" %)**SMOD：**
264 +(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
265 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
266 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings
266 266  
267 -(% style="color:red" %)**1 :** (%%) GPS ONLY
268 +(% style="color:blue" %)** SMOD：**
268 268  
269 -(% style="color:red" %)**2 :** (%%) BLE ONLY
270 +(% style="color:red" %)** 1 :** (%%) GPS ONLY
270 270  
271 -(% style="color:red" %)**3 :**  (%%) GPS/BLE Hybrid
272 +(% style="color:red" %)** 2 :** (%%) BLE ONLY
272 272  
274 +(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
273 273  
274 -(% style="color:blue" %)**GPS MOD:**
275 275  
276 -(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values
277 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
277 277  
278 -(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values
279 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
279 279  
281 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
280 280  
281 -(% style="color:blue" %)**BLE MOD:**
282 282  
283 -(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon
284 +(% style="color:blue" %)** BLE_Settings:**
284 284  
285 -TrackerD Status:  0x02
286 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
286 286  
287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %)
288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit
289 -|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode
290 290  
291 -(% style="color:red" %)**0 : **(%%) Transport Mode
289 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
292 292  
293 -(% style="color:red" %)**1 :  **(%%) AT+LON
291 +(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %)
292 +|(% 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
293 +|(% 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"]]
294 294  
295 -(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable
296 296  
297 297  
298 -
299 299  === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
300 300  
301 301  
302 -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.
300 +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,
303 303  
304 304  
305 305  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -323,8 +323,6 @@
323 323  |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
324 324  |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
325 325  
326 -
327 -
328 328  ==== (% style="color:blue" %)**FLAG:**(%%) ====
329 329  
330 330  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
... ... @@ -339,7 +339,6 @@
339 339  * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
340 340  * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
341 341  
342 -
343 343  (% style="color:red" %)**Important note:**
344 344  
345 345  1.  When power is low (<2.84v), GPS won't be able to get location info and GPS feature will be disabled and the location field will be filled with 0x0FFFFFFF, 0x0FFFFFFF.
... ... @@ -358,12 +358,12 @@
358 358  
359 359  ==== (% style="color:blue" %)**Alarm:**(%%) ====
360 360  
361 -Example:  0x4B & 0x40 >> 6 = 0x01
356 +**Example: ** 0x4B & 0x40 >> 6 = 0x01
362 362  
363 363  
364 364  ==== (% style="color:blue" %)**BAT:**(%%) ====
365 365  
366 -Example: 0x4B45 & 0x3FFF ⇒ 2885 (mV).
361 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
367 367  
368 368  (((
369 369  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -379,12 +379,12 @@
379 379  
380 380  ==== (% style="color:blue" %)**MOD:**(%%) ====
381 381  
382 -mod = (0x60>>6)& 0x3f;
377 +**Example: ** (0x60>>6) & 0x3f =1
383 383  
384 384  **Set the format of GPS data uplink link：**
385 385  
386 386  (% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
387 -(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
382 +(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
388 388  
389 389  
390 390  **Set the format of BLE data uplink link：**
... ... @@ -394,7 +394,7 @@
394 394  
395 395  ==== (% style="color:blue" %)**LON:**(%%) ====
396 396  
397 -lon=(0x60>>5) & 0x01;
392 +**Example:** (0x60>>5) & 0x01=1.
398 398  
399 399  Enable/Disable LED activity for uplink
400 400  
... ... @@ -407,6 +407,7 @@
407 407  )))
408 408  
409 409  
405 +
410 410  ==== (% style="color:blue" %)**Hum:**(%%) ====
411 411  
412 412  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -421,7 +421,7 @@
421 421  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
422 422  
423 423  
424 -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)
420 +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)
425 425  
426 426  
427 427  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
... ... @@ -440,7 +440,7 @@
440 440  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
441 441  
442 442  
443 -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.
439 +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.
444 444  
445 445  
446 446  (% style="color:red" %)**Note for this mode:**
... ... @@ -447,6 +447,7 @@
447 447  
448 448  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
449 449  * 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.
446 +* 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
450 450  
451 451  The payload is 15 bytes, as below.
452 452  
... ... @@ -463,6 +463,11 @@
463 463  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
464 464  
465 465  
463 +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.
464 +
465 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
466 +
467 +
466 466  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
467 467  |=(% scope="row" style="width: 60px;" %)(((
468 468  **Size(bytes)**
... ... @@ -482,7 +482,7 @@
482 482  [[image:1664502425687-834.png]]
483 483  
484 484  
485 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
487 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
486 486  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
487 487  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
488 488  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -503,8 +503,9 @@
503 503  [[image:1664502649601-895.png]]
504 504  
505 505  
506 -Add the decoder from this link:
508 +Add the decoder from this link: 
507 507  
510 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
508 508  
509 509  Save the change the uplink message will be parsed. As below:
510 510  
... ... @@ -515,15 +515,10 @@
515 515  == 2.5 Integrate with Datacake ==
516 516  
517 517  
518 -(((
519 519  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.
520 -)))
521 521  
522 -(((
523 523  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]]
524 -)))
525 525  
526 -
527 527  [[image:1664502695771-538.png]]
528 528  
529 529  
... ... @@ -531,15 +531,12 @@
531 531  == 2.6 Integrate with Tago ==
532 532  
533 533  
534 -(((
535 -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.
536 -)))
532 +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.
537 537  
538 -(((
539 539  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]]
540 -)))
541 541  
542 542  
537 +
543 543  [[image:1664502715371-321.png]]
544 544  
545 545  
... ... @@ -547,8 +547,9 @@
547 547  == 2.7  Datalog Feature ==
548 548  
549 549  
550 -total 273 entries,by default disable
545 +total 273 entries,by default,
551 551  
547 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
552 552  
553 553  Example use case.
554 554  
... ... @@ -568,7 +568,7 @@
568 568  
569 569  
570 570  (((
571 -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.
567 +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.
572 572  )))
573 573  
574 574  
... ... @@ -576,7 +576,7 @@
576 576  Two ways to exit alarm mode:
577 577  )))
578 578  
579 -* Server send a downlink command to exit.
575 +* Server sends a downlink command to exit.
580 580  * User fast press the RED button 10 times.
581 581  
582 582  (((
... ... @@ -611,7 +611,6 @@
611 611  
612 612  
613 613  
614 -
615 615  == 2.11 Button Function ==
616 616  
617 617  
... ... @@ -635,7 +635,6 @@
635 635  
636 636  
637 637  
638 -
639 639  == 2.12 USB Port Function ==
640 640  
641 641  
... ... @@ -672,11 +672,9 @@
672 672  [[image:1664503022490-662.png]]
673 673  
674 674  
675 -
676 676  [[image:1664503035713-500.png]]
677 677  
678 678  
679 -
680 680  [[image:1664503047675-651.png]]
681 681  
682 682  
... ... @@ -790,7 +790,7 @@
790 790  === 3.2.7 Set Positioning Mode ===
791 791  
792 792  
793 -SMOD define the how TrackerD scan and uplink data:
785 +SMOD define how TrackerD scan and uplink data:
794 794  
795 795  
796 796  * (% style="color:blue" %)**AT Command:**
... ... @@ -814,7 +814,7 @@
814 814  
815 815  (% style="color:blue" %)**Example:**
816 816  
817 - AT+ SMOD =1,0 ,0 ~-~->  GPS+ BAT+ State+Tem&Hum
809 + AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
818 818   AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
819 819   AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
820 820  
... ... @@ -912,6 +912,27 @@
912 912  Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
913 913  
914 914  
907 +
908 +=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
909 +
910 +
911 +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.
912 +
913 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.**
914 +
915 +(% style="color:blue" %)**AT Command:**
916 +
917 + (% style="color:#037691" %)**AT+BLEMASK=123456**   (%%) ~/~/ Set BLEMASK = 123456
918 +
919 + (% style="color:#037691" %)**AT+BLEMASK=0**  (%%) ~/~/ disable BLEMASK
920 +
921 +
922 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**
923 +
924 +Example: 0xA5010203040506    ~/~/ Set BLEMASK to 123456
925 +
926 +
927 +
915 915  = 4. Setting for Different Scenarios =
916 916  
917 917  
... ... @@ -952,6 +952,7 @@
952 952  [[image:1664503574618-659.png]]
953 953  
954 954  
968 +
955 955  (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
956 956  
957 957  [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
... ... @@ -997,7 +997,18 @@
997 997  [[image:1664503715811-892.png]]
998 998  
999 999  
1014 +(% id="cke_bm_4554S" style="display:none" %) (%%)Find the path of SP32 installation, find the file as shown in Figure 1, and change the SPI pin to the shown in Figure 2.
1000 1000  
1016 +[[image:image-20221024105643-1.png]]
1017 +
1018 +**~ Figure1**
1019 +
1020 +
1021 +[[image:image-20221024105643-2.png]]
1022 +
1023 + **Figure2**
1024 +
1025 +
1001 1001  * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
1002 1002  
1003 1003  Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
... ... @@ -1058,7 +1058,6 @@
1058 1058  
1059 1059  
1060 1060  
1061 -
1062 1062  = 8.  Order Info =
1063 1063  
1064 1064  
image-20221024105643-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +11.3 KB
Content
image-20221024105643-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +64.5 KB
Content