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 ... ... @@ -349,8 +349,8 @@ 349 349 350 350 351 351 * **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 352 -* **MODE: 353 -* **UUID: 343 +* **MODE: **Define the payload format. 344 +* **UUID: **The uuid from the strongest iBeacon. 354 354 * **MAJOR**: The MAJOR from the strongest iBeacon. 355 355 * **MINOR**: The MAJOR from the strongest iBeacon. 356 356 * **Measured** **Power**: The Measured Power from the strongest iBeacon. ... ... @@ -359,6 +359,7 @@ 359 359 360 360 361 361 353 + 362 362 === 2.3.5 Add Payload format in TTN V3 === 363 363 364 364 ... ... @@ -443,6 +443,7 @@ 443 443 444 444 445 445 438 + 446 446 == 2.9 Button Function == 447 447 448 448 ... ... @@ -465,6 +465,7 @@ 465 465 |(% 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. 466 466 467 467 461 + 468 468 == 2.10 USB Port Function == 469 469 470 470 ... ... @@ -477,6 +477,7 @@ 477 477 478 478 479 479 474 + 480 480 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 481 481 482 482 ... ... @@ -540,7 +540,7 @@ 540 540 541 541 AT+ATDC=xx. 542 542 543 -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 544 544 545 545 546 546 * Downlink Payload (prefix 0xB1): ... ... @@ -558,7 +558,7 @@ 558 558 559 559 AT+MTDC=xx. 560 560 561 - 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 562 562 563 563 564 564 * Downlink Payload (prefix 0x03): ... ... @@ -610,7 +610,7 @@ 610 610 611 611 AT+INTWK=xx. (Disable (0), Enable (1), default:0) 612 612 613 - Example: AT+ INTWK =1 **~-~-> 608 + Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 614 614 615 615 616 616 * Downlink Payload (prefix 0xAF): ... ... @@ -708,7 +708,7 @@ 708 708 709 709 **~ Example:** 710 710 711 - AT+ CFM=0 **~-~-> 706 + AT+ CFM=0 **~-~-> ** Disable confirmation 712 712 713 713 AT+ CFM=1 **~-~-> ** Enable confirmation 714 714 ... ... @@ -803,6 +803,7 @@ 803 803 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 804 804 805 805 801 + 806 806 [[image:1664503715811-892.png]] 807 807 808 808 ... ... @@ -809,6 +809,7 @@ 809 809 810 810 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 811 811 808 + 812 812 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 813 813 814 814 ... ... @@ -868,6 +868,7 @@ 868 868 869 869 870 870 868 + 871 871 = 8. Order Info = 872 872 873 873 ... ... @@ -886,6 +886,7 @@ 886 886 887 887 888 888 887 + 889 889 = 9. Packing Info = 890 890 891 891 ... ... @@ -901,6 +901,7 @@ 901 901 902 902 903 903 903 + 904 904 = 10. Support = 905 905 906 906 ... ... @@ -909,6 +909,7 @@ 909 909 910 910 911 911 912 + 912 912 = 11. Reference = 913 913 914 914