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,7 +450,6 @@ 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 456 User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. ... ... @@ -484,36 +484,11 @@ 484 484 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 485 485 486 486 487 +=== 2.4.6 Add Payload format in TTN V3 === 487 487 488 -=== 2.4.6 Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID === 489 489 490 +In TTN V3, use can add a custom payload so it shows friendly. 490 490 491 -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. 492 - 493 - 494 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %) 495 -|=(% scope="row" style="width: 60px;" %)((( 496 -**Size(bytes)** 497 -)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1 498 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)((( 499 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 500 -)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]] 501 - 502 -(% class="wikigeneratedid" %) 503 -[[image:1667288597595-714.png||height="212" width="1151"]] 504 - 505 - 506 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 507 -* (% style="color:#037691" %)**SSID: **(%%)WiFi name. 508 -* (% style="color:#037691" %)**RSSI: **(%%)The RSSI from the strongest WiFi. 509 - 510 - 511 - 512 -=== 2.4.7 Add Payload format in TTN V3 === 513 - 514 - 515 -In TTN V3, user can add a custom payload so it shows friendly. 516 - 517 517 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 518 518 519 519 ... ... @@ -532,7 +532,6 @@ 532 532 533 533 == 2.5 Integrate with Datacake == 534 534 535 - 536 536 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. 537 537 538 538 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]] ... ... @@ -544,6 +544,7 @@ 544 544 == 2.6 Integrate with Tago == 545 545 546 546 521 + 547 547 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. 548 548 549 549 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]] ... ... @@ -635,8 +635,8 @@ 635 635 [[image:1664502854406-763.png]] 636 636 637 637 638 -(% border="1" style="background-color:#ffffcc; color:green; width:5 10px" %)639 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 20 5px;" %)**Action**|=(% style="width: 205px;" %)**Description**613 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 614 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 640 640 |(% 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"]] 641 641 |(% 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 642 642 |(% 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. ... ... @@ -800,9 +800,9 @@ 800 800 801 801 (% style="color:#037691" %)** aa:** 802 802 803 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%) Only get and uplink GPS location info.804 -* (% style="color:red" %)**2: BLE or WiFiONLY:or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking.805 -* (% style="color:red" %)**3: GPS/BLE Hybrid: 778 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 779 +* (% style="color:red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 780 +* (% 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. 806 806 807 807 (% style="color:#037691" %)**bb:** 808 808 ... ... @@ -812,7 +812,6 @@ 812 812 (% style="color:#037691" %)**cc: ** 813 813 814 814 * (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 815 -* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%)) 816 816 817 817 (% style="color:blue" %)**Example:** 818 818 ... ... @@ -819,7 +819,6 @@ 819 819 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 - AT+ SMOD =2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 823 823 824 824 825 825 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -915,45 +915,23 @@ 915 915 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 916 916 917 917 918 - 919 919 === 3.2.11 Set BLEMASK to filter BLE iBeacon === 920 920 893 +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. 921 921 922 -BLEMASK is to filterthe unwantedBLEiBeaconsduringscan.Forexample,if BLEMASKis123456.TrackerD will onlyuplink UUID info which includes123456.Itwillignoreall otheriBeaconswhich doesn’t contact 123456 in theUUID.895 +Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled. 923 923 924 -(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 897 +(% style="color:blue" %)**AT Command:**(%%) 898 + AT+BLEMASK=123456 ~/~/ Set BLEMASK = 123456 899 + AT+BLEMASK=0 ~/~/ disable BLEMASK 925 925 926 -(% style="color:blue" %)**AT Command:** 927 927 928 - (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 902 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%) 903 +Example: 904 +0xA5010203040506 ~/~/ Set BLEMASK to 123456 929 929 930 - (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 931 931 932 932 933 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 934 - 935 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 936 - 937 - 938 -=== 3.2.12 Set WiFIMASK to filter WiFi SSID === 939 - 940 - 941 -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. 942 - 943 -(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.** 944 - 945 -(% style="color:blue" %)**AT Command:** 946 - 947 - (% style="color:#037691" %)**AT+ WiFiMASK =123456** (%%) ~/~/ Set WiFiMASK = 123456 948 - 949 - (% style="color:#037691" %)**AT+ WiFiMASK =0** (%%) ~/~/ disable WiFiMASK 950 - 951 - 952 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 953 - 954 -Example: 0xA5010203040506 ~/~/ Set WiFiMASK to 123456 955 - 956 - 957 957 = 4. Setting for Different Scenarios = 958 958 959 959 ... ... @@ -994,7 +994,6 @@ 994 994 [[image:1664503574618-659.png]] 995 995 996 996 997 - 998 998 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 999 999 1000 1000 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -1040,18 +1040,7 @@ 1040 1040 [[image:1664503715811-892.png]] 1041 1041 1042 1042 1043 -(% 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. 1044 1044 1045 -[[image:image-20221024105643-1.png]] 1046 - 1047 -**~ Figure1** 1048 - 1049 - 1050 -[[image:image-20221024105643-2.png]] 1051 - 1052 - **Figure2** 1053 - 1054 - 1055 1055 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1056 1056 1057 1057 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1150,3 +1150,5 @@ 1150 1150 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1151 1151 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1152 1152 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1092 + 1093 +
- 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