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,12 +287,11 @@ 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 298 298 ... ... @@ -302,12 +302,12 @@ 302 302 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 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)306 -|=(% 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;" %)((( 307 307 **Size(bytes)** 308 -)))|(% 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" %)((( 309 309 2 310 -)))|(% style="width: 87px" %)(((308 +)))|(% style="width:30px" %)((( 311 311 2 312 312 ))) 313 313 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( ... ... @@ -323,10 +323,12 @@ 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 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" %)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 ... ... @@ -375,9 +375,10 @@ 375 375 * < 3.39v: 0~~20% 376 376 377 377 378 + 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: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]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 ((( ... ... @@ -610,6 +610,8 @@ 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 611 + 612 + 613 613 == 2.11 Button Function == 614 614 615 615 ... ... @@ -625,12 +625,14 @@ 625 625 [[image:1664502854406-763.png]] 626 626 627 627 628 -(% border="1 .5" style="background-color:#ffffcc; color:green; width:520px" %)629 -|=(% 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** 630 630 |(% 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"]] 631 631 |(% 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 632 632 |(% 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. 633 633 634 + 635 + 634 634 == 2.12 USB Port Function == 635 635 636 636 ... ... @@ -641,6 +641,8 @@ 641 641 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 642 642 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 643 643 646 + 647 + 644 644 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 645 645 646 646 ... ... @@ -665,11 +665,9 @@ 665 665 [[image:1664503022490-662.png]] 666 666 667 667 668 - 669 669 [[image:1664503035713-500.png]] 670 670 671 671 672 - 673 673 [[image:1664503047675-651.png]] 674 674 675 675 ... ... @@ -783,7 +783,7 @@ 783 783 === 3.2.7 Set Positioning Mode === 784 784 785 785 786 -SMOD define the how TrackerD scan and uplink data:788 +SMOD define how TrackerD scan and uplink data: 787 787 788 788 789 789 * (% style="color:blue" %)**AT Command:** ... ... @@ -807,7 +807,7 @@ 807 807 808 808 (% style="color:blue" %)**Example:** 809 809 810 - AT+ SMOD =1,0 812 + AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 811 811 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 812 812 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 813 813 ... ... @@ -905,6 +905,27 @@ 905 905 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 906 906 907 907 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 + 908 908 = 4. Setting for Different Scenarios = 909 909 910 910 ... ... @@ -945,6 +945,7 @@ 945 945 [[image:1664503574618-659.png]] 946 946 947 947 971 + 948 948 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 949 949 950 950 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -990,7 +990,18 @@ 990 990 [[image:1664503715811-892.png]] 991 991 992 992 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. 993 993 1019 +[[image:image-20221024105643-1.png]] 1020 + 1021 +**~ Figure1** 1022 + 1023 + 1024 +[[image:image-20221024105643-2.png]] 1025 + 1026 + **Figure2** 1027 + 1028 + 994 994 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 995 995 996 996 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