Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/14 16:33
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -214,8 +214,8 @@ 214 214 Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 215 215 216 216 217 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 520px" %)218 -|=(% s cope="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;" %)1217 +(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %) 218 +|=(% style="width: 60px;" %)**Size(bytes)**|=(% style="width: 70px;" %)**1**|=(% style="width: 70px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 50px;" %)**1**|=(% style="width: 30px;" %)2|=(% style="width: 40px;" %)**2**|=(% style="width: 40px;" %)1 219 219 |=(% 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 220 220 221 221 [[image:1665301570342-765.png]] ... ... @@ -259,12 +259,11 @@ 259 259 Use can also get the Device Status uplink through the downlink command: 260 260 261 261 262 - 263 263 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 264 264 265 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 420px" %)266 -|(% style="width: 75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit267 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:1 37px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings264 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %) 265 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit 266 +|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings 268 268 269 269 (% style="color:blue" %)** SMOD:** 270 270 ... ... @@ -287,14 +287,14 @@ 287 287 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 288 288 289 289 290 - 291 291 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 292 292 293 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 417px" %)294 -|(% style="width: 77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)1 Bit295 -|(% 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 +(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %) 292 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)5 Bits|(% style="width:60px" %)1 Bit|(% style="width:20px" %)1 Bit|(% style="width:80px" %)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"]] 296 296 297 297 296 + 298 298 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 299 299 300 300 ... ... @@ -301,12 +301,12 @@ 301 301 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, 302 302 303 303 304 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)305 -|=(% scope="row" style="width: 50px;" %)(((303 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %) 304 +|=(% scope="row" style="width: 60px;" %)((( 306 306 **Size(bytes)** 307 -)))|(% style="width: 60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((306 +)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)((( 308 308 2 309 -)))|(% style="width: 87px" %)(((308 +)))|(% style="width:30px" %)((( 310 310 2 311 311 ))) 312 312 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( ... ... @@ -323,10 +323,11 @@ 323 323 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 324 324 325 325 325 + 326 326 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 327 327 328 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:2 50px" %)329 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width: 50px" %)2bits|(% style="width:50px" %)1bit328 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %) 329 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit 330 330 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 331 331 332 332 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -338,6 +338,7 @@ 338 338 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 339 339 340 340 341 + 341 341 (% style="color:red" %)**Important note:** 342 342 343 343 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. ... ... @@ -377,7 +377,7 @@ 377 377 378 378 ==== (% style="color:blue" %)**MOD:**(%%) ==== 379 379 380 -**Example: ** (0x60>>6)& 0x3f =1 .381 +**Example: ** (0x60>>6) & 0x3f =1 381 381 382 382 **Set the format of GPS data uplink link:** 383 383 ... ... @@ -405,7 +405,6 @@ 405 405 ))) 406 406 407 407 408 - 409 409 ==== (% style="color:blue" %)**Hum:**(%%) ==== 410 410 411 411 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -423,10 +423,10 @@ 423 423 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) 424 424 425 425 426 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)427 -|=(% scope="row" style="width: 50px;" %)(((426 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %) 427 +|=(% scope="row" style="width: 60px;" %)((( 428 428 **Size(bytes)** 429 -)))|(% style="width:60px" %)4|(% style="width: 70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1429 +)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1 430 430 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 431 431 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 432 432 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -450,7 +450,7 @@ 450 450 451 451 The payload is 15 bytes, as below. 452 452 453 -(% border="1.5" style="background-color:#ffffcc; color:green; width:5 20px" %)453 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 454 454 |=(% scope="row" %)((( 455 455 **Size(bytes)** 456 456 )))|4|4|2|1|1|1|1|1 ... ... @@ -463,6 +463,11 @@ 463 463 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 464 464 465 465 466 +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. 467 + 468 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 469 + 470 + 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: 490 +* (% 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: 511 +Add the decoder from this link: 507 507 513 +[[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 -))) 535 +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 540 + 543 543 [[image:1664502715371-321.png]] 544 544 545 545 ... ... @@ -569,7 +569,7 @@ 569 569 570 570 571 571 ((( 572 -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. 570 +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. 573 573 ))) 574 574 575 575 ... ... @@ -577,7 +577,7 @@ 577 577 Two ways to exit alarm mode: 578 578 ))) 579 579 580 -* Server send a downlink command to exit. 578 +* Server sends a downlink command to exit. 581 581 * User fast press the RED button 10 times. 582 582 583 583 ((( ... ... @@ -611,6 +611,7 @@ 611 611 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 612 612 613 613 612 + 614 614 == 2.11 Button Function == 615 615 616 616 ... ... @@ -626,13 +626,14 @@ 626 626 [[image:1664502854406-763.png]] 627 627 628 628 629 -(% border="1 .5" style="background-color:#ffffcc; color:green; width:520px" %)630 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 2 10px;" %)**Action**|=(% style="width: 210px;" %)**Description**628 +(% border="1" style="background-color:#ffffcc; color:green; width:510px" %) 629 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description** 631 631 |(% style="width:135px" %)Send Alarm|(% style="width:220px" %)Keep Pressing (% style="color:red" %)**RED**(%%) button for more than 5 seconds|(% style="width:265px" %)Enter Alarm Mode. See [[Alarm Mode>>||anchor="H2.6AlarmMode"]] 632 632 |(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the (% style="color:red" %)**RED** (%%)button 10 times|(% style="width:265px" %)Exit Alarm Mode 633 633 |(% style="width:135px" %)Enter Deep Sleep Mode|(% style="width:220px" %)Press and hold the button for 10 seconds, then quickly press the device 3 times to enter deep sleep|(% style="width:265px" %)This is the mode ship out from factory. CPU will be complete in sleep mode and no LoRa activity, only use before deploy. 634 634 635 635 635 + 636 636 == 2.12 USB Port Function == 637 637 638 638 ... ... @@ -644,6 +644,7 @@ 644 644 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 645 645 646 646 647 + 647 647 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 648 648 649 649 ... ... @@ -668,11 +668,9 @@ 668 668 [[image:1664503022490-662.png]] 669 669 670 670 671 - 672 672 [[image:1664503035713-500.png]] 673 673 674 674 675 - 676 676 [[image:1664503047675-651.png]] 677 677 678 678 ... ... @@ -786,7 +786,7 @@ 786 786 === 3.2.7 Set Positioning Mode === 787 787 788 788 789 -SMOD define the how TrackerD scan and uplink data:788 +SMOD define how TrackerD scan and uplink data: 790 790 791 791 792 792 * (% style="color:blue" %)**AT Command:** ... ... @@ -810,7 +810,7 @@ 810 810 811 811 (% style="color:blue" %)**Example:** 812 812 813 - AT+ SMOD =1,0 812 + AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 814 814 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 815 815 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 816 816 ... ... @@ -908,6 +908,27 @@ 908 908 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 909 909 910 910 910 + 911 +=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 912 + 913 + 914 +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. 915 + 916 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 917 + 918 +(% style="color:blue" %)**AT Command:** 919 + 920 + (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 921 + 922 + (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 923 + 924 + 925 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 926 + 927 +Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 928 + 929 + 930 + 911 911 = 4. Setting for Different Scenarios = 912 912 913 913 ... ... @@ -948,6 +948,7 @@ 948 948 [[image:1664503574618-659.png]] 949 949 950 950 971 + 951 951 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 952 952 953 953 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -993,7 +993,18 @@ 993 993 [[image:1664503715811-892.png]] 994 994 995 995 1017 +(% 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. 996 996 1019 +[[image:image-20221024105643-1.png]] 1020 + 1021 +**~ Figure1** 1022 + 1023 + 1024 +[[image:image-20221024105643-2.png]] 1025 + 1026 + **Figure2** 1027 + 1028 + 997 997 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 998 998 999 999 Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
- 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