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 ... ... @@ -93,6 +93,8 @@ 93 93 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 94 94 * Tracking: max: 38mA 95 95 89 + 90 + 96 96 == 1.3 Features == 97 97 98 98 ... ... @@ -111,6 +111,7 @@ 111 111 * Tri-color LED, Alarm button 112 112 * Datalog 113 113 109 + 114 114 == 1.4 Applications == 115 115 116 116 ... ... @@ -117,6 +117,8 @@ 117 117 * Logistics and Supply Chain Management 118 118 * Human tracking 119 119 116 + 117 + 120 120 = 2.1 Use TrackerD = 121 121 122 122 ... ... @@ -144,10 +144,11 @@ 144 144 145 145 Each TrackerD is shipped with a sticker with the default device EUI as below: 146 146 147 - 148 148 [[image:1664501677253-891.png]] 149 149 150 150 148 + 149 + 151 151 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 152 152 153 153 ... ... @@ -181,15 +181,15 @@ 181 181 182 182 (% style="color:blue" %)**Positioning Mode(SMOD):** 183 183 184 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings):(%%)only get GPS location info.185 -* (% style="color:#037691" %)**BLE ONLY:(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking.186 -* (% 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. 187 187 188 -User can switch modes by [[changing SMOD>> ||anchor="H3.2.7SetPositioningMode"]].187 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 189 189 190 190 191 191 192 -== 2.3 Uplink Payload == 191 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 193 193 194 194 195 195 === 2.3.1 Uplink FPORT~=5, Device Status === ... ... @@ -196,7 +196,7 @@ 196 196 197 197 198 198 199 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 198 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 200 200 201 201 202 202 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. ) ... ... @@ -216,35 +216,43 @@ 216 216 217 217 (optional) 218 218 ))) 219 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 220 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 221 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]] 218 +|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)((( 219 +[[Alarm &>>path:#Alarm]] 222 222 221 +[[BAT>>path:#Alarm]] 222 +)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]] 223 + 224 + 225 + 223 223 [[image:1664501958445-288.png]] 224 224 225 225 226 - ==== (% style="color:blue" %)Alarm & BAT:====229 +**Alarm & BAT:** 227 227 228 228 (% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 229 229 |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 230 -|(% 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]] 231 231 232 -==== (% style="color:blue" %)FLAG: ==== 233 233 236 + 237 +**FLAG:** 238 + 234 234 (% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 235 235 |(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 236 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>> ||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% 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 237 237 238 -(% style="color:blue" %)**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 239 239 244 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 240 240 241 -==== (% style="color:blue" %)Location info: ==== 242 242 247 +**Location info:** 248 + 243 243 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 244 244 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 245 245 246 -(% style="color:red" %)**Important note:** 247 247 253 +**Important note:** 254 + 248 248 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. 249 249 250 250 2. In firmware version v1.5, Roll & Pitch is disabled by default. ... ... @@ -262,20 +262,12 @@ 262 262 263 263 264 264 265 -==== (% style="color:blue" %)Alarm: ==== 272 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 273 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 266 266 275 +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: \ 267 267 268 -Example: 0x4B & 0x40 >> 6 = 0x01 269 269 270 - 271 -==== (% style="color:blue" %)BAT: ==== 272 - 273 - 274 -Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 275 - 276 -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: \ 277 - 278 - 279 279 * > 4.0v : 80% ~~ 100% 280 280 * 3.85v ~~3.99v: 60% ~~ 80% 281 281 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -282,28 +282,22 @@ 282 282 * 3.40v ~~ 3.69v: 20% ~~ 40% 283 283 * < 3.39v: 0~~20% 284 284 285 -==== (% style="color:blue" %)LON: ==== 286 286 287 - 288 -Enable/Disable LED activity for uplink 289 289 286 +* **LON: **Enable/Disable LED activity for uplink 287 + 290 290 0x00: Disable LED indicator. 291 291 292 292 0x01: Enable LED indicator (Default Value) 293 293 294 294 295 -==== (% style="color:blue" %)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 296 296 297 -0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 298 298 299 299 300 -==== (% style="color:blue" %)Tem: ==== 301 301 302 -011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 303 303 304 - 305 - 306 - 307 307 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 308 308 309 309 ... ... @@ -321,42 +321,53 @@ 321 321 322 322 **(bytes)** 323 323 )))|(% 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 324 -|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:72px" %)((( 325 -iBeacon MAJOR 317 +|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)((( 318 +iBeacon 319 + 320 +MAJOR 326 326 )))|(% style="width:71px" %)((( 327 -iBeacon MINOR 322 +iBeacon 323 + 324 +MINOR 328 328 )))|(% style="width:145px" %)((( 329 -iBeacon Measured Power 326 +iBeacon Measured 327 + 328 +Power 330 330 )))|(% style="width:72px" %)((( 331 -iBeacon RSSI 330 +iBeacon 331 + 332 +RSSI 332 332 )))|(% style="width:76px" %)((( 333 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 334 -)))|(% style="width:54px" %)[[FLAG>>||anchor="HFLAG:"]] 334 +[[Alarm &>>path:#Alarm]] 335 335 336 +[[BAT>>path:#Alarm]] 337 +)))|(% style="width:54px" %)[[FLAG>>path:#Flag]] 338 + 336 336 [[image:1664502425687-834.png]] 337 337 338 338 339 -* (% style="color:#037691" %)**BAT:**(%%)Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).340 -* (% style="color:#037691" %)**MODE:(%%)Define the payload format.341 -* (% style="color:#037691" %)**UUID:(%%)The uuid from the strongest iBeacon.342 -* (% style="color:#037691" %)**MAJOR:**(%%)The MAJOR from the strongest iBeacon.343 -* (% style="color:#037691" %)**MINOR:**(%%)The MAJOR from the strongest iBeacon.344 -* (% style="color:#037691" %)**Measured Power:**(%%)The Measured Power from the strongest iBeacon.345 -* (% 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. 346 346 347 347 348 348 352 + 353 + 349 349 === 2.3.5 Add Payload format in TTN V3 === 350 350 351 351 352 352 In TTN V3, use can add a custom payload so it shows friendly. 353 353 354 -In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**359 +In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 355 355 356 356 357 357 [[image:1664502649601-895.png]] 358 358 359 - 360 360 Add the decoder from this link: 361 361 362 362 ... ... @@ -430,6 +430,8 @@ 430 430 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)**RED **on 500ms|(% style="width:202px" %)N/A 431 431 432 432 437 + 438 + 433 433 == 2.9 Button Function == 434 434 435 435 ... ... @@ -451,6 +451,8 @@ 451 451 |(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the **RED** button 10 times|(% style="width:265px" %)Exit Alarm Mode 452 452 |(% 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. 453 453 460 + 461 + 454 454 == 2.10 USB Port Function == 455 455 456 456 ... ... @@ -462,6 +462,8 @@ 462 462 * [[Upgrade Firmware>>path:#upgrade_image]] 463 463 464 464 473 + 474 + 465 465 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 466 466 467 467 ... ... @@ -525,7 +525,7 @@ 525 525 526 526 AT+ATDC=xx. 527 527 528 -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 529 529 530 530 531 531 * Downlink Payload (prefix 0xB1): ... ... @@ -543,7 +543,7 @@ 543 543 544 544 AT+MTDC=xx. 545 545 546 - 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 547 547 548 548 549 549 * Downlink Payload (prefix 0x03): ... ... @@ -595,7 +595,7 @@ 595 595 596 596 AT+INTWK=xx. (Disable (0), Enable (1), default:0) 597 597 598 - Example: AT+ INTWK =1 **~-~-> 608 + Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 599 599 600 600 601 601 * Downlink Payload (prefix 0xAF): ... ... @@ -693,7 +693,7 @@ 693 693 694 694 **~ Example:** 695 695 696 - AT+ CFM=0 **~-~-> 706 + AT+ CFM=0 **~-~-> ** Disable confirmation 697 697 698 698 AT+ CFM=1 **~-~-> ** Enable confirmation 699 699 ... ... @@ -787,6 +787,8 @@ 787 787 788 788 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 789 789 800 + 801 + 790 790 [[image:1664503715811-892.png]] 791 791 792 792 ... ... @@ -793,6 +793,7 @@ 793 793 794 794 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 795 795 808 + 796 796 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 797 797 798 798 ... ... @@ -851,6 +851,8 @@ 851 851 852 852 853 853 867 + 868 + 854 854 = 8. Order Info = 855 855 856 856 ... ... @@ -868,6 +868,8 @@ 868 868 869 869 870 870 886 + 887 + 871 871 = 9. Packing Info = 872 872 873 873 ... ... @@ -882,6 +882,8 @@ 882 882 * Weight: 50g 883 883 884 884 902 + 903 + 885 885 = 10. Support = 886 886 887 887 ... ... @@ -889,6 +889,8 @@ 889 889 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]] 890 890 891 891 911 + 912 + 892 892 = 11. Reference = 893 893 894 894