Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Mengting Qiu on 2025/03/04 09:37
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -120,15 +120,15 @@ 120 120 121 121 122 122 123 -1. Use TrackerD 124 -11. How it works? 123 += 2.1 Use TrackerD = 125 125 125 +== 2.1 How it works? == 126 126 127 + 127 127 TrackerD is configured as LoRaWAN OTAA Class A GPS tracker by default. It has OTAA keys to join LoRaWAN network. To connect a LoRaWAN network, user need to input the OTAA keys in the LoRaWAN IoT server and push reset button of TrackerD (next to USB port). TrackerD will wake up and auto join the network via OTAA. 128 128 129 129 130 -1. 131 -11. Quick guide to connect to LoRaWAN server 131 +== 2.2 Quick guide to connect to LoRaWAN server == 132 132 133 133 Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example. 134 134 ... ... @@ -138,7 +138,7 @@ 138 138 139 139 The LPS8N is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. What the rest need to is register this device in TTN V3: 140 140 141 -**Step 1**: Create a device in TTN V3 with the OTAA keys from TrackerD. 141 +**(% style="color:blue" %)Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD. 142 142 143 143 Each TrackerD is shipped with a sticker with the default device EUI as below: 144 144 ... ... @@ -168,13 +168,13 @@ 168 168 169 169 170 170 171 -**Step 2**: Power on TrackerD by using the on board switch. 171 +**(% style="color:blue" %)Step 2**:(%%) Power on TrackerD by using the on board switch. 172 172 173 173 174 -**Step 3:** TrackerD will auto join to the LoRaWAN network. After join success, TrackerD will start to upload message to IoT server. 174 +**(% style="color:blue" %)Step 3:**(%%) TrackerD will auto join to the LoRaWAN network. After join success, TrackerD will start to upload message to IoT server. 175 175 176 176 177 -**Positioning Mode(SMOD):** 177 +**(% style="color:blue" %)Positioning Mode(SMOD):** 178 178 179 179 * **GPS ONLY(Factory Settings): **only get GPS location info. 180 180 * **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking. ... ... @@ -183,19 +183,14 @@ 183 183 User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 184 184 185 185 186 -1. 187 -11. Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- 186 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 188 188 189 189 190 -1. 191 -11. 192 -111. Uplink FPORT=5, Device Status 189 +=== 2.3.1 Uplink FPORT=5, Device Status === 193 193 194 194 195 195 196 -1. 197 -11. 198 -111. Uplink FPORT= , Realtime GNSS Positioning 193 +=== 2.3.2 Uplink FPORT= , Realtime GNSS Positioning === 199 199 200 200 The default uplink payload includes totally 11 bytes. (User can use AT+MOD=0 to enable the Temperature and humidity sensor to hum/tem info from accelerometer. When accelerometer info is enable, total payload will be 15 bytes, please note 15 bytes won’t work on DR0 on US915/AU915 frequency band. ) 201 201 ... ... @@ -287,15 +287,11 @@ 287 287 288 288 289 289 290 -1. 291 -11. 292 -111. Uplink FPORT= , History GNSS Positioning 285 +=== 2.3.3 Uplink FPORT= , History GNSS Positioning === 293 293 294 294 295 295 296 -1. 297 -11. 298 -111. BLE positioning Payload(Fport=2) 289 +=== 2.3.4 BLE positioning Payload(Fport=2) === 299 299 300 300 Different MODE has different payload: 301 301 ... ... @@ -341,10 +341,9 @@ 341 341 * **RSSI**: The RSSI from the strongest iBeacon. 342 342 343 343 344 -1. 345 -11. 346 -111. Add Payload format in TTN V3 347 347 336 +=== 2.3.5 Add Payload format in TTN V3 === 337 + 348 348 In TTN V3, use can add a custom payload so it shows friendly. 349 349 350 350 In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder ... ... @@ -362,8 +362,7 @@ 362 362 363 363 364 364 365 -1. 366 -11. Integrate with Datacake 355 +== 2.4 Integrate with Datacake == 367 367 368 368 369 369 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. ... ... @@ -373,8 +373,7 @@ 373 373 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] 374 374 375 375 376 -1. 377 -11. Integrate with Tago 365 +== 2.5 Integrate with Tago == 378 378 379 379 380 380 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. ... ... @@ -386,8 +386,7 @@ 386 386 387 387 388 388 389 -1. 390 -11. Alarm Mode 377 +== 2.6 Alarm Mode == 391 391 392 392 393 393 User can push the **RED button** by more than 5 seconds to enter Alarm Mode. ... ... @@ -404,13 +404,11 @@ 404 404 When exit alarm mode, **RED LED** will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false. 405 405 406 406 407 -1. 408 -11. Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- 394 +== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- == 409 409 410 410 411 411 412 -1. 413 -11. LED Status 398 +== 2.8 LED Status == 414 414 415 415 416 416 |**Event**|**Action**|**AT+LON to control on/off** ... ... @@ -430,8 +430,7 @@ 430 430 431 431 432 432 433 -1. 434 -11. Button Function 418 +== 2.9 Button Function == 435 435 436 436 **RESET button:** 437 437 ... ... @@ -452,8 +452,7 @@ 452 452 453 453 454 454 455 -1. 456 -11. USB Port Function 439 +== 2.10 USB Port Function == 457 457 458 458 The USB interface of TrackerD has below functions: 459 459 ... ... @@ -466,7 +466,7 @@ 466 466 467 467 468 468 469 - 1. Configure TrackerD via AT command or LoRaWAN downlink452 += 3. Configure TrackerD via AT command or LoRaWAN downlink = 470 470 471 471 472 472 User can configure TrackerD via AT Command or LoRaWAN Downlink. ... ... @@ -474,8 +474,7 @@ 474 474 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]] 475 475 476 476 477 -1. 478 -11. Access AT Command 460 +== 3.1 Access AT Command == 479 479 480 480 TrackerD supports the AT command set in stock firmware. User can connect to TrackerD with TYPE-C cable to use AT commands as shown below. ... 481 481 ... ... @@ -494,13 +494,10 @@ 494 494 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]] 495 495 496 496 497 -1. 498 -11. Command Set 479 +== 3.2 Command Set == 499 499 500 500 501 -1. 502 -11. 503 -111. Set Transmit Interval 482 +=== 3.2.1 Set Transmit Interval === 504 504 505 505 Set device uplink interval. 506 506 ... ... @@ -516,9 +516,7 @@ 516 516 0x01 00 01 2C ~/~/ Same as AT+TDC=300000 517 517 518 518 519 -1. 520 -11. 521 -111. Set Alarm Packet transmission interval 498 +=== 3.2.2 Set Alarm Packet transmission interval === 522 522 523 523 Set alarm packet transmit interval 524 524 ... ... @@ -534,9 +534,7 @@ 534 534 0xB1 00 00 3C ~/~/Same as AT+ATDC=60000 535 535 536 536 537 -1. 538 -11. 539 -111. Set Sports Mode Packet transmission interval 514 +=== 3.3.3 Set Sports Mode Packet transmission interval === 540 540 541 541 Set sports packet transmit interval 542 542 ... ... @@ -553,9 +553,7 @@ 553 553 554 554 555 555 556 -1. 557 -11. 558 -111. Exit Alarm 531 +=== 3.3.4 Exit Alarm === 559 559 560 560 Server send downlink command to exit Alarm mode 561 561 ... ... @@ -569,9 +569,7 @@ 569 569 0x02 01 ~/~/ Exit Alarm Mode 570 570 571 571 572 -1. 573 -11. 574 -111. Disable/Enable LED flash 545 +=== 3.3.5 Disable/Enable LED flash === 575 575 576 576 Disable/Enable LED for position, downlink and uplink 577 577 ... ... @@ -589,9 +589,7 @@ 589 589 590 590 591 591 592 -1. 593 -11. 594 -111. Disable/Enable movement detect (Debug Only) 563 +=== 3.3.6 Disable/Enable movement detect (Debug Only) === 595 595 596 596 User can use this feature to check and set thread hole of movement detect 597 597 ... ... @@ -608,9 +608,7 @@ 608 608 609 609 610 610 611 -1. 612 -11. 613 -111. Set Positioning Mode 580 +=== 3.3.7 Set Positioning Mode === 614 614 615 615 SMOD define the how TrackerD scan and uplink date. 616 616 ... ... @@ -643,9 +643,7 @@ 643 643 0xA5 01 00 ~/~/ Same as AT+ SMOD =1,0 644 644 645 645 646 -1. 647 -11. 648 -111. Set MAX GPS position time 613 +=== 3.3.8 Set MAX GPS position time === 649 649 650 650 Set max positioning time, default is 150 seconds. TrackerD will try to get location info within this period. If fail to get position data within this time, TrackerD will use 000000 for latitude and longitude. 651 651 ... ... @@ -667,9 +667,7 @@ 667 667 668 668 669 669 670 -1. 671 -11. 672 -111. Set PDOP value for GPS fix accuracy 635 +=== 3.3.9 Set PDOP value for GPS fix accuracy === 673 673 674 674 PDOP(Position Dilution of Precision) filter, TrackerD will only accept GPS data with a lower PDOP value than pre-configure PDOP value. If device can’t get a valid GPS packet within FTIME timeout, it will use the GPS data with lowest PDOP value to server. 675 675 ... ... @@ -712,34 +712,35 @@ 712 712 713 713 714 714 715 - 1. Setting for Different Scenarios678 += 4. Setting for Different Scenarios = 716 716 717 717 718 718 719 -1. Upload Firmware 720 -11. Firmware Change Log 682 += 5. Upload Firmware = 721 721 684 + 685 +== 5.1 Firmware Change Log == 686 + 722 722 **[[See this link>>url:https://github.com/dragino/TrackerD]]** 723 723 724 724 725 -1. 726 -11. How to upgrade firmware 690 +== 5.2 How to upgrade firmware == 727 727 728 728 User can use the TrackerD ’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below: 729 729 730 730 731 -**Step1: **Connect TrackerD and PC via USB cable shipped with TrackerD. 695 +**(% style="color:blue" %)Step1: **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD. 732 732 733 -**Step2:** Install CH9102 driver in the PC. 697 +**(% style="color:blue" %)Step2:** (%%) Install CH9102 driver in the PC. 734 734 735 735 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 736 736 737 737 738 -**Step3:** Download and Install Flash Tool: 702 +**(% style="color:blue" %)Step3:**(%%) Download and Install Flash Tool: 739 739 740 740 [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]] 741 741 742 -**Step4:** Run Flash Download Tool and configure chip type to ESP32 706 +**(% style="color:blue" %)Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 743 743 744 744 745 745 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png||alt="image-20220712083115-1.png"]] ... ... @@ -747,7 +747,7 @@ 747 747 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png||alt="image-20220712083115-2.png"]] 748 748 749 749 750 -**Step5:** Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 714 +**(% style="color:blue" %)Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 751 751 752 752 [[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 753 753 ... ... @@ -768,12 +768,15 @@ 768 768 769 769 770 770 771 - 1. Developer Guide735 += 6. Developer Guide = 772 772 773 773 774 -* 775 -*1. Compile Source Code 776 -*11. Set up ARDUINO compile environment 738 +== 6.1 Compile Source Code == 739 + 740 + 741 +=== 6.1.1 Set up ARDUINO compile environment === 742 + 743 + 777 777 * Download the latest Arduino software (IDE) from the Arduino official website 778 778 779 779 [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]] ... ... @@ -799,8 +799,9 @@ 799 799 800 800 801 801 802 -* 803 -*1. Source Code 769 +== 6.2 Source Code == 770 + 771 + 804 804 * Open the example in the TrackerD file, please select the correct port in the IDE, as shown below: 805 805 806 806 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]