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
-
... ... @@ -97,8 +97,6 @@ 97 97 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 98 98 * Tracking: max: 38mA 99 99 100 - 101 - 102 102 == 1.3 Features == 103 103 104 104 ... ... @@ -117,8 +117,6 @@ 117 117 * Tri-color LED, Alarm button 118 118 * Datalog 119 119 120 - 121 - 122 122 == 1.4 Applications == 123 123 124 124 ... ... @@ -125,8 +125,6 @@ 125 125 * Logistics and Supply Chain Management 126 126 * Human tracking 127 127 128 - 129 - 130 130 = 2.1 Use TrackerD = 131 131 132 132 ... ... @@ -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;" %)1211 +(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %) 212 +|=(% 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_Settings258 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %) 259 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit 260 +|=(% 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,12 @@ 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"]] 285 +(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %) 286 +|=(% 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 287 +|=(% 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 - 298 298 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 299 299 300 300 ... ... @@ -301,14 +301,10 @@ 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;" %)((( 306 -**Size(bytes)** 307 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 308 -2 309 -)))|(% style="width:87px" %)((( 310 -2 311 -))) 295 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %) 296 +|=(% scope="row" style="width: 60px;" %)((( 297 +**Size(bytes)**)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)((( 298 +2)))|(% style="width:30px" %)(((2))) 312 312 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 313 313 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 314 314 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] ... ... @@ -322,11 +322,10 @@ 322 322 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 323 323 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 324 324 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" %)1bit314 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %) 315 +|=(% 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 ... ... @@ -337,7 +337,6 @@ 337 337 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 338 338 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 339 339 340 - 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. ... ... @@ -373,11 +373,9 @@ 373 373 * 3.40v ~~ 3.69v: 20% ~~ 40% 374 374 * < 3.39v: 0~~20% 375 375 376 - 377 - 378 378 ==== (% style="color:blue" %)**MOD:**(%%) ==== 379 379 380 -**Example: ** (0x60>>6)& 0x3f =1 .363 +**Example: ** (0x60>>6) & 0x3f =1 381 381 382 382 **Set the format of GPS data uplink link:** 383 383 ... ... @@ -423,10 +423,8 @@ 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;" %)((( 428 -**Size(bytes)** 429 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1 409 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %) 410 +|=(% scope="row" style="width: 60px;" %)(((**Size(bytes)**)))|(% 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" %)434 +(% 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 447 +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. 448 + 449 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 450 + 451 + 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: 471 +* (% 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. ... ... @@ -490,8 +490,6 @@ 490 490 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 491 491 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 492 492 493 - 494 - 495 495 === 2.4.6 Add Payload format in TTN V3 === 496 496 497 497 ... ... @@ -503,8 +503,9 @@ 503 503 [[image:1664502649601-895.png]] 504 504 505 505 506 -Add the decoder from this link: 490 +Add the decoder from this link: 507 507 492 +[[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 -))) 514 +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 519 + 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. 549 +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. 557 +* Server sends a downlink command to exit. 581 581 * User fast press the RED button 10 times. 582 582 583 583 ((( ... ... @@ -610,7 +610,6 @@ 610 610 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 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 - 614 614 == 2.11 Button Function == 615 615 616 616 ... ... @@ -632,7 +632,6 @@ 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 - 636 636 == 2.12 USB Port Function == 637 637 638 638 ... ... @@ -643,7 +643,6 @@ 643 643 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 644 644 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 645 645 646 - 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:761 +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 785 + 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 883 + 884 +=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 885 + 886 + 887 +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. 888 + 889 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 890 + 891 +(% style="color:blue" %)**AT Command:** 892 + 893 + (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 894 + 895 + (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 896 + 897 + 898 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 899 + 900 +Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 901 + 902 + 903 + 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 944 + 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 990 +(% 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 992 +[[image:image-20221024105643-1.png]] 993 + 994 +**~ Figure1** 995 + 996 + 997 +[[image:image-20221024105643-2.png]] 998 + 999 + **Figure2** 1000 + 1001 + 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: ... ... @@ -1052,8 +1052,6 @@ 1052 1052 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 1053 1053 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 1054 1054 1055 - 1056 - 1057 1057 = 8. Order Info = 1058 1058 1059 1059 ... ... @@ -1069,8 +1069,6 @@ 1069 1069 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 1070 1070 * (% style="color:red" %)**US915**(%%): Default frequency band US915 1071 1071 1072 - 1073 - 1074 1074 = 9. Packing Info = 1075 1075 1076 1076 ... ... @@ -1084,8 +1084,6 @@ 1084 1084 * Device Size: 85 x 48 x 15 cm 1085 1085 * Weight: 50g 1086 1086 1087 - 1088 - 1089 1089 = 10. Support = 1090 1090 1091 1091 ... ... @@ -1092,8 +1092,6 @@ 1092 1092 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 1093 1093 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]. 1094 1094 1095 - 1096 - 1097 1097 = 11. Reference = 1098 1098 1099 1099
- 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