Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Change comment:
Uploaded new attachment "image-20221024105643-2.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 1 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Kilight1 +XWiki.Xiaoling - 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 ... ... @@ -280,11 +280,12 @@ 280 280 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 281 281 282 282 284 + 283 283 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 284 284 285 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 260px" %)286 -| =(% 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 Bit287 -| =(% 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"]] 288 288 289 289 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 290 290 ... ... @@ -292,12 +292,12 @@ 292 292 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, 293 293 294 294 295 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 320px" %)296 -|=(% 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;" %)((( 297 297 **Size(bytes)** 298 -)))|(% 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" %)((( 299 299 2 300 -)))|(% style="width: 30px" %)(((302 +)))|(% style="width:87px" %)((( 301 301 2 302 302 ))) 303 303 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( ... ... @@ -315,8 +315,8 @@ 315 315 316 316 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 317 317 318 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 120px" %)319 -|=(% 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 320 320 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 321 321 322 322 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -392,6 +392,7 @@ 392 392 ))) 393 393 394 394 397 + 395 395 ==== (% style="color:blue" %)**Hum:**(%%) ==== 396 396 397 397 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -409,10 +409,10 @@ 409 409 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) 410 410 411 411 412 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 300px" %)413 -|=(% 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;" %)((( 414 414 **Size(bytes)** 415 -)))|(% 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 416 416 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 417 417 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 418 418 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -436,7 +436,7 @@ 436 436 437 437 The payload is 15 bytes, as below. 438 438 439 -(% border="1.5" style="background-color:#ffffcc; color:green; width:50 0px" %)442 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 440 440 |=(% scope="row" %)((( 441 441 **Size(bytes)** 442 442 )))|4|4|2|1|1|1|1|1 ... ... @@ -448,7 +448,6 @@ 448 448 449 449 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 450 450 451 - 452 452 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. 453 453 454 454 User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. ... ... @@ -482,34 +482,11 @@ 482 482 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 483 483 484 484 485 -=== 2.4.6 UplinkFPORT~=8,WiFi Positioningwith StrongestWiFiSSID===487 +=== 2.4.6 Add Payload format in TTN V3 === 486 486 487 487 488 - TrackerD supports WiFi scansforindoorpositioning. Usercanset[[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]]to **BLEpure** or **GPS/BLE hybrid**soTrackerD will scan WiFi and findthestrongestWiFi info anduplink.490 +In TTN V3, use can add a custom payload so it shows friendly. 489 489 490 - 491 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %) 492 -|=(% scope="row" style="width: 60px;" %)((( 493 -**Size(bytes)** 494 -)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1 495 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)((( 496 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 497 -)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]] 498 - 499 -(% class="wikigeneratedid" %) 500 -[[image:1667288597595-714.png||height="212" width="1151"]] 501 - 502 - 503 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 504 -* (% style="color:#037691" %)**SSID: **(%%)WiFi name. 505 -* (% style="color:#037691" %)**RSSI: **(%%)The RSSI from the strongest WiFi. 506 - 507 - 508 -=== 2.4.7 Add Payload format in TTN V3 === 509 - 510 - 511 -In TTN V3, user can add a custom payload so it shows friendly. 512 - 513 513 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 514 514 515 515 ... ... @@ -528,7 +528,6 @@ 528 528 529 529 == 2.5 Integrate with Datacake == 530 530 531 - 532 532 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. 533 533 534 534 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]] ... ... @@ -540,6 +540,7 @@ 540 540 == 2.6 Integrate with Tago == 541 541 542 542 521 + 543 543 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. 544 544 545 545 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]] ... ... @@ -631,8 +631,8 @@ 631 631 [[image:1664502854406-763.png]] 632 632 633 633 634 -(% border="1" style="background-color:#ffffcc; color:green; width:5 10px" %)635 -|=(% 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** 636 636 |(% 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"]] 637 637 |(% 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 638 638 |(% 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. ... ... @@ -796,9 +796,9 @@ 796 796 797 797 (% style="color:#037691" %)** aa:** 798 798 799 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%) Only get and uplink GPS location info.800 -* (% style="color:red" %)**2: BLE or WiFiONLY:or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking.801 -* (% 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. 802 802 803 803 (% style="color:#037691" %)**bb:** 804 804 ... ... @@ -808,7 +808,6 @@ 808 808 (% style="color:#037691" %)**cc: ** 809 809 810 810 * (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 811 -* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%)) 812 812 813 813 (% style="color:blue" %)**Example:** 814 814 ... ... @@ -815,7 +815,6 @@ 815 815 AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 816 816 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 817 817 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 818 - AT+ SMOD =2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 819 819 820 820 821 821 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -911,45 +911,23 @@ 911 911 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 912 912 913 913 914 - 915 915 === 3.2.11 Set BLEMASK to filter BLE iBeacon === 916 916 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. 917 917 918 -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. 919 919 920 -(% 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 921 921 922 -(% style="color:blue" %)**AT Command:** 923 923 924 - (% 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 925 925 926 - (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 927 927 928 928 929 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 930 - 931 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 932 - 933 - 934 -=== 3.2.12 Set WiFIMASK to filter WiFi SSID === 935 - 936 - 937 -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. 938 - 939 -(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.** 940 - 941 -(% style="color:blue" %)**AT Command:** 942 - 943 - (% style="color:#037691" %)**AT+ WiFiMASK =123456** (%%) ~/~/ Set WiFiMASK = 123456 944 - 945 - (% style="color:#037691" %)**AT+ WiFiMASK =0** (%%) ~/~/ disable WiFiMASK 946 - 947 - 948 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 949 - 950 -Example: 0xA5010203040506 ~/~/ Set WiFiMASK to 123456 951 - 952 - 953 953 = 4. Setting for Different Scenarios = 954 954 955 955 ... ... @@ -990,7 +990,6 @@ 990 990 [[image:1664503574618-659.png]] 991 991 992 992 993 - 994 994 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 995 995 996 996 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -1036,18 +1036,7 @@ 1036 1036 [[image:1664503715811-892.png]] 1037 1037 1038 1038 1039 -(% 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. 1040 1040 1041 -[[image:image-20221024105643-1.png]] 1042 - 1043 -**~ Figure1** 1044 - 1045 - 1046 -[[image:image-20221024105643-2.png]] 1047 - 1048 - **Figure2** 1049 - 1050 - 1051 1051 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1052 1052 1053 1053 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1147,3 +1147,4 @@ 1147 1147 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1148 1148 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1149 1149 1093 +
- 1667288597595-714.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.9 KB - Content