Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/14 16:33
Change comment:
There is no comment for this version
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. Edwin1 +XWiki.Kilight - 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 ONLY: 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. 192 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 193 +* (% style="color:#037691" %)**BLE or WiFi ONLY: **(%%)** **Only obtain iBeacon info via BLE and uplink or obtain wifi ssid info via WiFi 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: 520px" %)212 -|=(% 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;" %)1211 +(% 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;" %)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,12 +253,11 @@ 253 253 Use can also get the Device Status uplink through the downlink command: 254 254 255 255 256 - 257 257 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 258 258 259 -(% 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" %)4bit261 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:1 37px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings258 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %) 259 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit 260 +|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings 262 262 263 263 (% style="color:blue" %)** SMOD:** 264 264 ... ... @@ -280,13 +280,14 @@ 280 280 281 281 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 282 282 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: 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 Bit289 -|(% 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"]] 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 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: 480px" %)298 -|=(% scope="row" style="width: 50px;" %)(((297 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %) 298 +|=(% scope="row" style="width: 60px;" %)((( 299 299 **Size(bytes)** 300 -)))|(% style="width: 60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((300 +)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)((( 301 301 2 302 -)))|(% style="width: 87px" %)(((302 +)))|(% style="width:30px" %)((( 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:2 50px" %)321 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width: 50px" %)2bits|(% style="width:50px" %)1bit320 +(% 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" %)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,7 +394,6 @@ 394 394 ))) 395 395 396 396 397 - 398 398 ==== (% style="color:blue" %)**Hum:**(%%) ==== 399 399 400 400 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -412,10 +412,10 @@ 412 412 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) 413 413 414 414 415 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)416 -|=(% scope="row" style="width: 50px;" %)(((414 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %) 415 +|=(% scope="row" style="width: 60px;" %)((( 417 417 **Size(bytes)** 418 -)))|(% style="width:60px" %)4|(% style="width: 70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1417 +)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1 419 419 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 420 420 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 421 421 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -439,7 +439,7 @@ 439 439 440 440 The payload is 15 bytes, as below. 441 441 442 -(% border="1.5" style="background-color:#ffffcc; color:green; width:5 20px" %)441 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 443 443 |=(% scope="row" %)((( 444 444 **Size(bytes)** 445 445 )))|4|4|2|1|1|1|1|1 ... ... @@ -451,6 +451,7 @@ 451 451 452 452 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 453 453 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,11 +484,36 @@ 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 === 488 488 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. 491 491 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 + 492 492 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 493 493 494 494 ... ... @@ -507,6 +507,7 @@ 507 507 508 508 == 2.5 Integrate with Datacake == 509 509 535 + 510 510 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. 511 511 512 512 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]] ... ... @@ -518,7 +518,6 @@ 518 518 == 2.6 Integrate with Tago == 519 519 520 520 521 - 522 522 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. 523 523 524 524 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]] ... ... @@ -610,8 +610,8 @@ 610 610 [[image:1664502854406-763.png]] 611 611 612 612 613 -(% border="1 .5" style="background-color:#ffffcc; color:green; width:520px" %)614 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 2 10px;" %)**Action**|=(% style="width: 210px;" %)**Description**638 +(% border="1" style="background-color:#ffffcc; color:green; width:510px" %) 639 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description** 615 615 |(% 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"]] 616 616 |(% 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 617 617 |(% 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. ... ... @@ -775,9 +775,9 @@ 775 775 776 776 (% style="color:#037691" %)** aa:** 777 777 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. 803 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 804 +* (% style="color:red" %)**2: BLE or WiFi ONLY: **(%%)Only obtain iBeacon info via BLE and uplink or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking. 805 +* (% 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. 781 781 782 782 (% style="color:#037691" %)**bb:** 783 783 ... ... @@ -787,6 +787,7 @@ 787 787 (% style="color:#037691" %)**cc: ** 788 788 789 789 * (% 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(%%)) 790 790 791 791 (% style="color:blue" %)**Example:** 792 792 ... ... @@ -793,6 +793,7 @@ 793 793 AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 794 794 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 795 795 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 822 + AT+ SMOD =2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 796 796 797 797 798 798 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -888,23 +888,45 @@ 888 888 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 889 889 890 890 918 + 891 891 === 3.2.11 Set BLEMASK to filter BLE iBeacon === 892 892 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. 894 894 895 - Note:BLEMASK range is6~~10bytes.IfAT+BLEMASK<6bytes,BLEMASKwillbedisabled.922 +BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. TrackerD will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID. 896 896 897 -(% style="color:blue" %)**AT Command:**(%%) 898 - AT+BLEMASK=123456 ~/~/ Set BLEMASK = 123456 899 - AT+BLEMASK=0 ~/~/ disable BLEMASK 924 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 900 900 926 +(% style="color:blue" %)**AT Command:** 901 901 902 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%) 903 -Example: 904 -0xA5010203040506 ~/~/ Set BLEMASK to 123456 928 + (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 905 905 930 + (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 906 906 907 907 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 + 908 908 = 4. Setting for Different Scenarios = 909 909 910 910 ... ... @@ -945,6 +945,7 @@ 945 945 [[image:1664503574618-659.png]] 946 946 947 947 997 + 948 948 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 949 949 950 950 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -990,7 +990,18 @@ 990 990 [[image:1664503715811-892.png]] 991 991 992 992 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. 993 993 1045 +[[image:image-20221024105643-1.png]] 1046 + 1047 +**~ Figure1** 1048 + 1049 + 1050 +[[image:image-20221024105643-2.png]] 1051 + 1052 + **Figure2** 1053 + 1054 + 994 994 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 995 995 996 996 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1089,5 +1089,3 @@ 1089 1089 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1090 1090 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1091 1091 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1092 - 1093 -
- 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