Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 3 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Kilight1 +XWiki.Edwin - Content
-
... ... @@ -189,9 +189,9 @@ 189 189 190 190 Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 191 191 192 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%) Only get and uplink GPS location info.193 -* (% style="color:#037691" %)**BLE or WiFiONLY: **(%%)** **Only obtain iBeacon info via BLE and uplinkor obtain wifi ssid info via WiFi and uplink. Design for Indoor tracking.194 -* (% style="color:#037691" %)**GPS/BLE Hybrid: 192 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 193 +* (% style="color:#037691" %)**BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 194 +* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 195 195 196 196 Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 197 197 ... ... @@ -208,8 +208,8 @@ 208 208 Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 209 209 210 210 211 -(% 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;" %)1211 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 212 +|=(% scope="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;" %)1 213 213 |=(% 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 214 214 215 215 [[image:1665301570342-765.png]] ... ... @@ -253,11 +253,12 @@ 253 253 Use can also get the Device Status uplink through the downlink command: 254 254 255 255 256 + 256 256 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 257 257 258 -(% border="1.5" style="background-color:#ffffcc; color:green; width:2 70px" %)259 -| =(% scope="row" style="width:60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit260 -| =(% style="width:;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings259 +(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %) 260 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit 261 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings 261 261 262 262 (% style="color:blue" %)** SMOD:** 263 263 ... ... @@ -279,14 +279,13 @@ 279 279 280 280 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 281 281 282 -(% style="color:red" %)** 2:** (%%)WiFi Positioning with Strongest WiFi SSID(V1.4.1 Version support this function later) 283 283 284 284 285 285 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 286 286 287 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 260px" %)288 -| =(% 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 Bit289 -| =(% style="width:;" %)**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"]]287 +(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %) 288 +|(% style="width:77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)1 Bit 289 +|(% 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"]] 290 290 291 291 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 292 292 ... ... @@ -294,12 +294,12 @@ 294 294 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, 295 295 296 296 297 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 320px" %)298 -|=(% scope="row" style="width: 60px;" %)(((297 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 298 +|=(% scope="row" style="width: 50px;" %)((( 299 299 **Size(bytes)** 300 -)))|(% style="width: 50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)(((300 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 301 301 2 302 -)))|(% style="width: 30px" %)(((302 +)))|(% style="width:87px" %)((( 303 303 2 304 304 ))) 305 305 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( ... ... @@ -317,8 +317,8 @@ 317 317 318 318 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 319 319 320 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 120px" %)321 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width: 30px" %)2bits|(% style="width:30px" %)1bit320 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 321 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 322 322 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 323 323 324 324 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -394,6 +394,7 @@ 394 394 ))) 395 395 396 396 397 + 397 397 ==== (% style="color:blue" %)**Hum:**(%%) ==== 398 398 399 399 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -411,10 +411,10 @@ 411 411 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) 412 412 413 413 414 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 300px" %)415 -|=(% scope="row" style="width: 60px;" %)(((415 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 416 +|=(% scope="row" style="width: 50px;" %)((( 416 416 **Size(bytes)** 417 -)))|(% style="width:60px" %)4|(% style="width: 60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1418 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1 418 418 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 419 419 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 420 420 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -438,7 +438,7 @@ 438 438 439 439 The payload is 15 bytes, as below. 440 440 441 -(% border="1.5" style="background-color:#ffffcc; color:green; width:50 0px" %)442 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 442 442 |=(% scope="row" %)((( 443 443 **Size(bytes)** 444 444 )))|4|4|2|1|1|1|1|1 ... ... @@ -450,10 +450,9 @@ 450 450 451 451 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 452 452 453 - 454 454 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. 455 455 456 -User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]**so TrackerD will only search the iBeacons which have UUIDthatmatch the BLEMASKsettings.456 +User can set [[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]] so TrackerD will only search the iBeacons which have UUID match the BLEMASK. 457 457 458 458 459 459 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) ... ... @@ -483,35 +483,11 @@ 483 483 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 484 484 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 485 485 486 +=== 2.4.6 Add Payload format in TTN V3 === 486 486 487 -=== 2.4.6 Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID === 488 488 489 +In TTN V3, use can add a custom payload so it shows friendly. 489 489 490 -TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan WiFi and find the strongest WiFi info and uplink. 491 - 492 - 493 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %) 494 -|=(% scope="row" style="width: 60px;" %)((( 495 -**Size(bytes)** 496 -)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1 497 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)((( 498 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 499 -)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]] 500 - 501 -(% class="wikigeneratedid" %) 502 -[[image:1667288597595-714.png||height="212" width="1151"]] 503 - 504 - 505 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 506 -* (% style="color:#037691" %)**SSID: **(%%)WiFi name. 507 -* (% style="color:#037691" %)**RSSI: **(%%)The RSSI from the strongest WiFi. 508 - 509 - 510 -=== 2.4.7 Add Payload format in TTN V3 === 511 - 512 - 513 -In TTN V3, user can add a custom payload so it shows friendly. 514 - 515 515 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 516 516 517 517 ... ... @@ -530,7 +530,6 @@ 530 530 531 531 == 2.5 Integrate with Datacake == 532 532 533 - 534 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 536 536 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]] ... ... @@ -542,6 +542,7 @@ 542 542 == 2.6 Integrate with Tago == 543 543 544 544 520 + 545 545 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. 546 546 547 547 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]] ... ... @@ -633,8 +633,8 @@ 633 633 [[image:1664502854406-763.png]] 634 634 635 635 636 -(% border="1" style="background-color:#ffffcc; color:green; width:5 10px" %)637 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 20 5px;" %)**Action**|=(% style="width: 205px;" %)**Description**612 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 613 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 638 638 |(% 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"]] 639 639 |(% 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 640 640 |(% 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. ... ... @@ -798,9 +798,9 @@ 798 798 799 799 (% style="color:#037691" %)** aa:** 800 800 801 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%) Only get and uplink GPS location info.802 -* (% style="color:red" %)**2: BLE or WiFiONLY:or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking.803 -* (% style="color:red" %)**3: GPS/BLE Hybrid: 777 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 778 +* (% style="color:red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 779 +* (% style="color:red" %)**3: GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 804 804 805 805 (% style="color:#037691" %)**bb:** 806 806 ... ... @@ -810,7 +810,6 @@ 810 810 (% style="color:#037691" %)**cc: ** 811 811 812 812 * (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 813 -* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%)) 814 814 815 815 (% style="color:blue" %)**Example:** 816 816 ... ... @@ -817,7 +817,6 @@ 817 817 AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 818 818 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 819 819 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 820 - AT+ SMOD =2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 821 821 822 822 823 823 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -913,45 +913,23 @@ 913 913 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 914 914 915 915 916 - 917 917 === 3.2.11 Set BLEMASK to filter BLE iBeacon === 918 918 892 +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. 919 919 920 -BLEMASK is to filterthe unwantedBLEiBeaconsduringscan.Forexample,if BLEMASKis123456.TrackerD will onlyuplink UUID info which includes123456.Itwillignoreall otheriBeaconswhich doesn’t contact 123456 in theUUID.894 +Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled. 921 921 922 -(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 896 +(% style="color:blue" %)**AT Command:**(%%) 897 + AT+BLEMASK=123456 ~/~/ Set BLEMASK = 123456 898 + AT+BLEMASK=0 ~/~/ disable BLEMASK 923 923 924 -(% style="color:blue" %)**AT Command:** 925 925 926 - (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 901 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%) 902 +Example: 903 +0xA5010203040506 ~/~/ Set BLEMASK to 123456 927 927 928 - (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 929 929 930 930 931 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 932 - 933 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 934 - 935 - 936 -=== 3.2.12 Set WiFIMASK to filter WiFi SSID === 937 - 938 - 939 -WiFiMASK is to filter the unwanted WiFi SSID during scan. For example, if WiFiMASK is 123456. TrackerD will only uplink SSID info which includes 123456. It will ignore all other WiFi which doesn’t contact 123456 in the SSID. 940 - 941 -(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.** 942 - 943 -(% style="color:blue" %)**AT Command:** 944 - 945 - (% style="color:#037691" %)**AT+ WiFiMASK =123456** (%%) ~/~/ Set WiFiMASK = 123456 946 - 947 - (% style="color:#037691" %)**AT+ WiFiMASK =0** (%%) ~/~/ disable WiFiMASK 948 - 949 - 950 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 951 - 952 -Example: 0xA5010203040506 ~/~/ Set WiFiMASK to 123456 953 - 954 - 955 955 = 4. Setting for Different Scenarios = 956 956 957 957 ... ... @@ -992,7 +992,6 @@ 992 992 [[image:1664503574618-659.png]] 993 993 994 994 995 - 996 996 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 997 997 998 998 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -1038,18 +1038,7 @@ 1038 1038 [[image:1664503715811-892.png]] 1039 1039 1040 1040 1041 -(% 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. 1042 1042 1043 -[[image:image-20221024105643-1.png]] 1044 - 1045 -**~ Figure1** 1046 - 1047 - 1048 -[[image:image-20221024105643-2.png]] 1049 - 1050 - **Figure2** 1051 - 1052 - 1053 1053 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1054 1054 1055 1055 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1148,3 +1148,5 @@ 1148 1148 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1149 1149 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1150 1150 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1091 + 1092 +
- 1667288597595-714.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.9 KB - Content
- image-20221024105643-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -11.3 KB - Content
- image-20221024105643-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.5 KB - Content