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 ... ... @@ -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. ... ... @@ -373,9 +373,11 @@ 373 373 * 3.40v ~~ 3.69v: 20% ~~ 40% 374 374 * < 3.39v: 0~~20% 375 375 377 + 378 + 376 376 ==== (% style="color:blue" %)**MOD:**(%%) ==== 377 377 378 -**Example: ** (0x60>>6)& 0x3f =1 .381 +**Example: ** (0x60>>6) & 0x3f =1 379 379 380 380 **Set the format of GPS data uplink link:** 381 381 ... ... @@ -403,7 +403,6 @@ 403 403 ))) 404 404 405 405 406 - 407 407 ==== (% style="color:blue" %)**Hum:**(%%) ==== 408 408 409 409 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -421,10 +421,10 @@ 421 421 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) 422 422 423 423 424 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)425 -|=(% 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;" %)((( 426 426 **Size(bytes)** 427 -)))|(% 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 428 428 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 429 429 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 430 430 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -448,7 +448,7 @@ 448 448 449 449 The payload is 15 bytes, as below. 450 450 451 -(% border="1.5" style="background-color:#ffffcc; color:green; width:5 20px" %)453 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 452 452 |=(% scope="row" %)((( 453 453 **Size(bytes)** 454 454 )))|4|4|2|1|1|1|1|1 ... ... @@ -461,6 +461,11 @@ 461 461 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 462 462 463 463 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 + 464 464 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 465 465 |=(% scope="row" style="width: 60px;" %)((( 466 466 **Size(bytes)** ... ... @@ -480,7 +480,7 @@ 480 480 [[image:1664502425687-834.png]] 481 481 482 482 483 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 490 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 484 484 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 485 485 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 486 486 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -514,15 +514,10 @@ 514 514 == 2.5 Integrate with Datacake == 515 515 516 516 517 -((( 518 518 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. 519 -))) 520 520 521 -((( 522 522 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]] 523 -))) 524 524 525 - 526 526 [[image:1664502695771-538.png]] 527 527 528 528 ... ... @@ -530,15 +530,12 @@ 530 530 == 2.6 Integrate with Tago == 531 531 532 532 533 -((( 534 -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. 535 -))) 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. 536 536 537 -((( 538 538 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]] 539 -))) 540 540 541 541 540 + 542 542 [[image:1664502715371-321.png]] 543 543 544 544 ... ... @@ -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. 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. 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. 578 +* Server sends a downlink command to exit. 580 580 * User fast press the RED button 10 times. 581 581 582 582 ((( ... ... @@ -609,6 +609,8 @@ 609 609 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 610 610 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 611 611 611 + 612 + 612 612 == 2.11 Button Function == 613 613 614 614 ... ... @@ -624,12 +624,14 @@ 624 624 [[image:1664502854406-763.png]] 625 625 626 626 627 -(% border="1 .5" style="background-color:#ffffcc; color:green; width:520px" %)628 -|=(% 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** 629 629 |(% 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"]] 630 630 |(% 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 631 631 |(% 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. 632 632 634 + 635 + 633 633 == 2.12 USB Port Function == 634 634 635 635 ... ... @@ -640,6 +640,8 @@ 640 640 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 641 641 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 642 642 646 + 647 + 643 643 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 644 644 645 645 ... ... @@ -664,11 +664,9 @@ 664 664 [[image:1664503022490-662.png]] 665 665 666 666 667 - 668 668 [[image:1664503035713-500.png]] 669 669 670 670 671 - 672 672 [[image:1664503047675-651.png]] 673 673 674 674 ... ... @@ -782,7 +782,7 @@ 782 782 === 3.2.7 Set Positioning Mode === 783 783 784 784 785 -SMOD define the how TrackerD scan and uplink data:788 +SMOD define how TrackerD scan and uplink data: 786 786 787 787 788 788 * (% style="color:blue" %)**AT Command:** ... ... @@ -806,7 +806,7 @@ 806 806 807 807 (% style="color:blue" %)**Example:** 808 808 809 - AT+ SMOD =1,0 812 + AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 810 810 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 811 811 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 812 812 ... ... @@ -904,6 +904,27 @@ 904 904 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 905 905 906 906 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 + 907 907 = 4. Setting for Different Scenarios = 908 908 909 909 ... ... @@ -944,6 +944,7 @@ 944 944 [[image:1664503574618-659.png]] 945 945 946 946 971 + 947 947 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 948 948 949 949 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -989,7 +989,18 @@ 989 989 [[image:1664503715811-892.png]] 990 990 991 991 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. 992 992 1019 +[[image:image-20221024105643-1.png]] 1020 + 1021 +**~ Figure1** 1022 + 1023 + 1024 +[[image:image-20221024105643-2.png]] 1025 + 1026 + **Figure2** 1027 + 1028 + 993 993 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 994 994 995 995 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