Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,13 +7,6 @@ 1 -(% style="text-align:center" %) 2 -[[image:1664505654417-133.png]] 3 - 4 - 5 - 6 - 7 7 (% class="wikigeneratedid" %) 8 8 **Table of Contents:** 9 9 10 -{{toc/}} 11 11 12 12 13 13 ... ... @@ -94,6 +94,7 @@ 94 94 * Tracking: max: 38mA 95 95 96 96 90 + 97 97 == 1.3 Features == 98 98 99 99 ... ... @@ -112,6 +112,7 @@ 112 112 * Tri-color LED, Alarm button 113 113 * Datalog 114 114 109 + 115 115 == 1.4 Applications == 116 116 117 117 ... ... @@ -119,6 +119,7 @@ 119 119 * Human tracking 120 120 121 121 117 + 122 122 = 2.1 Use TrackerD = 123 123 124 124 ... ... @@ -146,10 +146,11 @@ 146 146 147 147 Each TrackerD is shipped with a sticker with the default device EUI as below: 148 148 149 - 150 150 [[image:1664501677253-891.png]] 151 151 152 152 148 + 149 + 153 153 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 154 154 155 155 ... ... @@ -183,15 +183,15 @@ 183 183 184 184 (% style="color:blue" %)**Positioning Mode(SMOD):** 185 185 186 -* ** (% style="color:#037691" %)GPS ONLY(Factory Settings):(%%)only get GPS location info.187 -* ** (% style="color:#037691" %)BLE ONLY:(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking.188 -* ** (% style="color:#037691" %)GPS/BLE Hybrid:(%%)Combination for Indoor and Outdoor tracking.183 +* **GPS ONLY(Factory Settings): **only get GPS location info. 184 +* **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking. 185 +* **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking. 189 189 190 -User can switch modes by [[changing SMOD>> ||anchor="H3.2.7SetPositioningMode"]].187 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 191 191 192 192 193 193 194 -== 2.3 Uplink Payload == 191 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 195 195 196 196 197 197 === 2.3.1 Uplink FPORT~=5, Device Status === ... ... @@ -198,7 +198,7 @@ 198 198 199 199 200 200 201 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 198 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 202 202 203 203 204 204 The default uplink payload includes totally 11 bytes. (User can use AT+MOD=0 to enable the Temperature and humidity sensor to hum/tem info from accelerometer. When accelerometer info is enable, total payload will be 15 bytes, please note 15 bytes won't work on DR0 on US915/AU915 frequency band. ) ... ... @@ -218,38 +218,43 @@ 218 218 219 219 (optional) 220 220 ))) 221 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>> ||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((222 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]218 +|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)((( 219 +[[Alarm &>>path:#Alarm]] 223 223 224 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]] 221 +[[BAT>>path:#Alarm]] 222 +)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]] 225 225 226 226 225 + 227 227 [[image:1664501958445-288.png]] 228 228 229 229 230 - ====Alarm & BAT:====229 +**Alarm & BAT:** 231 231 232 232 (% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 233 233 |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 234 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>> ||anchor="HBAT:"]]233 +|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]] 235 235 236 236 237 -==== FLAG: ==== 238 238 237 +**FLAG:** 238 + 239 239 (% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 240 240 |(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 241 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>> ||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLocationinfo:"]]|(% style="width:140px" %)Firmware version241 +|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version 242 242 243 -**(% style="color:blue" %)Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 244 244 244 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 245 245 246 -==== Location info: ==== 247 247 247 +**Location info:** 248 + 248 248 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 249 249 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 250 250 251 -**(% style="color:red" %)Important note:** 252 252 253 +**Important note:** 254 + 253 253 1. When power is low (<2.84v), GPS won't be able to get location info and GPS feature will be disabled and the location field will be filled with 0x0FFFFFFF, 0x0FFFFFFF. 254 254 255 255 2. In firmware version v1.5, Roll & Pitch is disabled by default. ... ... @@ -267,18 +267,12 @@ 267 267 268 268 269 269 270 -==== Alarm: ==== 272 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 273 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 271 271 272 - Example:0x4B&0x40>>6=0x01275 +The battery info shows the current voltage, for **TrackerD** version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \ 273 273 274 274 275 -==== BAT: ==== 276 - 277 -Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 278 - 279 -The battery info shows the current voltage, for **(% style="color:blue" %)TrackerD**(%%) version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \ 280 - 281 - 282 282 * > 4.0v : 80% ~~ 100% 283 283 * 3.85v ~~3.99v: 60% ~~ 80% 284 284 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -286,26 +286,21 @@ 286 286 * < 3.39v: 0~~20% 287 287 288 288 289 -==== LON: ==== 290 -Enable/Disable LED activity for uplink 291 291 286 +* **LON: **Enable/Disable LED activity for uplink 287 + 292 292 0x00: Disable LED indicator. 293 293 294 294 0x01: Enable LED indicator (Default Value) 295 295 296 296 297 -==== Hum: ==== 293 +* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 294 +* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 298 298 299 -0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 300 300 301 301 302 -==== Tem: ==== 303 303 304 -011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 305 305 306 - 307 - 308 - 309 309 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 310 310 311 311 ... ... @@ -323,38 +323,49 @@ 323 323 324 324 **(bytes)** 325 325 )))|(% style="width:54px" %)16|(% style="width:72px" %)4|(% style="width:71px" %)4|(% style="width:145px" %)2|(% style="width:72px" %)4|(% style="width:76px" %)2|(% style="width:54px" %)1 326 -|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:72px" %)((( 327 -iBeacon MAJOR 317 +|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)((( 318 +iBeacon 319 + 320 +MAJOR 328 328 )))|(% style="width:71px" %)((( 329 -iBeacon MINOR 322 +iBeacon 323 + 324 +MINOR 330 330 )))|(% style="width:145px" %)((( 331 -iBeacon Measured Power 326 +iBeacon Measured 327 + 328 +Power 332 332 )))|(% style="width:72px" %)((( 333 -iBeacon RSSI 330 +iBeacon 331 + 332 +RSSI 334 334 )))|(% style="width:76px" %)((( 335 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 336 -)))|(% style="width:54px" %)[[FLAG>>||anchor="HFLAG:"]] 334 +[[Alarm &>>path:#Alarm]] 337 337 336 +[[BAT>>path:#Alarm]] 337 +)))|(% style="width:54px" %)[[FLAG>>path:#Flag]] 338 + 338 338 [[image:1664502425687-834.png]] 339 339 340 340 341 -* ** (% style="color:#037691" %)BAT:**(%%)Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).342 -* ** (% style="color:#037691" %)MODE:(%%)Define the payload format.343 -* ** (% style="color:#037691" %)UUID:(%%)The uuid from the strongest iBeacon.344 -* ** (% style="color:#037691" %)MAJOR:**(%%)The MAJOR from the strongest iBeacon.345 -* ** (% style="color:#037691" %)MINOR:**(%%)The MAJOR from the strongest iBeacon.346 -* ** (% style="color:#037691" %)Measured Power:**(%%)The Measured Power from the strongest iBeacon.347 -* ** (% style="color:#037691" %)RSSI:**(%%)The RSSI from the strongest iBeacon.342 +* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 343 +* **MODE: **Define the payload format. 344 +* **UUID: **The uuid from the strongest iBeacon. 345 +* **MAJOR**: The MAJOR from the strongest iBeacon. 346 +* **MINOR**: The MAJOR from the strongest iBeacon. 347 +* **Measured** **Power**: The Measured Power from the strongest iBeacon. 348 +* **RSSI**: The RSSI from the strongest iBeacon. 348 348 349 349 350 350 351 351 353 + 352 352 === 2.3.5 Add Payload format in TTN V3 === 353 353 354 354 355 355 In TTN V3, use can add a custom payload so it shows friendly. 356 356 357 -In the page Applications (%style="color:#037691" %)~-~-> Payload Formats ~-~-> Custom ~-~-> decoder359 +In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 358 358 359 359 360 360 [[image:1664502649601-895.png]] ... ... @@ -433,6 +433,7 @@ 433 433 434 434 435 435 438 + 436 436 == 2.9 Button Function == 437 437 438 438 ... ... @@ -455,6 +455,7 @@ 455 455 |(% 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. 456 456 457 457 461 + 458 458 == 2.10 USB Port Function == 459 459 460 460 ... ... @@ -467,6 +467,7 @@ 467 467 468 468 469 469 474 + 470 470 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 471 471 472 472 ... ... @@ -530,7 +530,7 @@ 530 530 531 531 AT+ATDC=xx. 532 532 533 -Example: AT+ATDC=60000 **~-~-> 538 +Example: AT+ATDC=60000 **~-~-> ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000 534 534 535 535 536 536 * Downlink Payload (prefix 0xB1): ... ... @@ -548,7 +548,7 @@ 548 548 549 549 AT+MTDC=xx. 550 550 551 - Example: AT+MTDC=300000 **~-~-> 556 + Example: AT+MTDC=300000 **~-~-> ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 552 552 553 553 554 554 * Downlink Payload (prefix 0x03): ... ... @@ -600,7 +600,7 @@ 600 600 601 601 AT+INTWK=xx. (Disable (0), Enable (1), default:0) 602 602 603 - Example: AT+ INTWK =1 **~-~-> 608 + Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 604 604 605 605 606 606 * Downlink Payload (prefix 0xAF): ... ... @@ -698,7 +698,7 @@ 698 698 699 699 **~ Example:** 700 700 701 - AT+ CFM=0 **~-~-> 706 + AT+ CFM=0 **~-~-> ** Disable confirmation 702 702 703 703 AT+ CFM=1 **~-~-> ** Enable confirmation 704 704 ... ... @@ -793,6 +793,7 @@ 793 793 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 794 794 795 795 801 + 796 796 [[image:1664503715811-892.png]] 797 797 798 798 ... ... @@ -799,6 +799,7 @@ 799 799 800 800 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 801 801 808 + 802 802 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 803 803 804 804 ... ... @@ -858,6 +858,7 @@ 858 858 859 859 860 860 868 + 861 861 = 8. Order Info = 862 862 863 863 ... ... @@ -876,6 +876,7 @@ 876 876 877 877 878 878 887 + 879 879 = 9. Packing Info = 880 880 881 881 ... ... @@ -891,6 +891,7 @@ 891 891 892 892 893 893 903 + 894 894 = 10. Support = 895 895 896 896 ... ... @@ -899,6 +899,7 @@ 899 899 900 900 901 901 912 + 902 902 = 11. Reference = 903 903 904 904