Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Change comment:
Uploaded new attachment "1667288597595-714.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 3 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Kilight - 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" %)((( ... ... @@ -327,8 +327,8 @@ 327 327 328 328 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 329 329 330 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:2 50px" %)331 -|=(% 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 332 332 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 333 333 334 334 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -380,7 +380,7 @@ 380 380 381 381 ==== (% style="color:blue" %)**MOD:**(%%) ==== 382 382 383 -**Example: ** (0x60>>6)& 0x3f =1 .381 +**Example: ** (0x60>>6) & 0x3f =1 384 384 385 385 **Set the format of GPS data uplink link:** 386 386 ... ... @@ -408,7 +408,6 @@ 408 408 ))) 409 409 410 410 411 - 412 412 ==== (% style="color:blue" %)**Hum:**(%%) ==== 413 413 414 414 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -426,10 +426,10 @@ 426 426 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) 427 427 428 428 429 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)430 -|=(% 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;" %)((( 431 431 **Size(bytes)** 432 -)))|(% 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 433 433 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 434 434 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 435 435 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -453,7 +453,7 @@ 453 453 454 454 The payload is 15 bytes, as below. 455 455 456 -(% border="1.5" style="background-color:#ffffcc; color:green; width:5 20px" %)453 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 457 457 |=(% scope="row" %)((( 458 458 **Size(bytes)** 459 459 )))|4|4|2|1|1|1|1|1 ... ... @@ -466,6 +466,11 @@ 466 466 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 467 467 468 468 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 + 469 469 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 470 470 |=(% scope="row" style="width: 60px;" %)((( 471 471 **Size(bytes)** ... ... @@ -485,7 +485,7 @@ 485 485 [[image:1664502425687-834.png]] 486 486 487 487 488 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 490 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 489 489 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 490 490 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 491 491 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -506,8 +506,9 @@ 506 506 [[image:1664502649601-895.png]] 507 507 508 508 509 -Add the decoder from this link: 511 +Add the decoder from this link: 510 510 513 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 511 511 512 512 Save the change the uplink message will be parsed. As below: 513 513 ... ... @@ -518,15 +518,10 @@ 518 518 == 2.5 Integrate with Datacake == 519 519 520 520 521 -((( 522 522 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. 523 -))) 524 524 525 -((( 526 526 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]] 527 -))) 528 528 529 - 530 530 [[image:1664502695771-538.png]] 531 531 532 532 ... ... @@ -534,15 +534,12 @@ 534 534 == 2.6 Integrate with Tago == 535 535 536 536 537 -((( 538 -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. 539 -))) 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. 540 540 541 -((( 542 542 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]] 543 -))) 544 544 545 545 540 + 546 546 [[image:1664502715371-321.png]] 547 547 548 548 ... ... @@ -572,7 +572,7 @@ 572 572 573 573 574 574 ((( 575 -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. 576 576 ))) 577 577 578 578 ... ... @@ -580,7 +580,7 @@ 580 580 Two ways to exit alarm mode: 581 581 ))) 582 582 583 -* Server send a downlink command to exit. 578 +* Server sends a downlink command to exit. 584 584 * User fast press the RED button 10 times. 585 585 586 586 ((( ... ... @@ -630,8 +630,8 @@ 630 630 [[image:1664502854406-763.png]] 631 631 632 632 633 -(% border="1 .5" style="background-color:#ffffcc; color:green; width:520px" %)634 -|=(% 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** 635 635 |(% 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"]] 636 636 |(% 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 637 637 |(% 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. ... ... @@ -674,11 +674,9 @@ 674 674 [[image:1664503022490-662.png]] 675 675 676 676 677 - 678 678 [[image:1664503035713-500.png]] 679 679 680 680 681 - 682 682 [[image:1664503047675-651.png]] 683 683 684 684 ... ... @@ -792,7 +792,7 @@ 792 792 === 3.2.7 Set Positioning Mode === 793 793 794 794 795 -SMOD define the how TrackerD scan and uplink data:788 +SMOD define how TrackerD scan and uplink data: 796 796 797 797 798 798 * (% style="color:blue" %)**AT Command:** ... ... @@ -816,7 +816,7 @@ 816 816 817 817 (% style="color:blue" %)**Example:** 818 818 819 - AT+ SMOD =1,0 812 + AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 820 820 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 821 821 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 822 822 ... ... @@ -914,6 +914,27 @@ 914 914 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 915 915 916 916 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 + 917 917 = 4. Setting for Different Scenarios = 918 918 919 919 ... ... @@ -954,6 +954,7 @@ 954 954 [[image:1664503574618-659.png]] 955 955 956 956 971 + 957 957 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 958 958 959 959 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -999,7 +999,18 @@ 999 999 [[image:1664503715811-892.png]] 1000 1000 1001 1001 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. 1002 1002 1019 +[[image:image-20221024105643-1.png]] 1020 + 1021 +**~ Figure1** 1022 + 1023 + 1024 +[[image:image-20221024105643-2.png]] 1025 + 1026 + **Figure2** 1027 + 1028 + 1003 1003 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1004 1004 1005 1005 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1060,7 +1060,6 @@ 1060 1060 1061 1061 1062 1062 1063 - 1064 1064 = 8. Order Info = 1065 1065 1066 1066
- 1667288597595-714.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.9 KB - Content
- 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