Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/14 16:33
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -25,14 +25,10 @@ 25 25 ((( 26 26 In TrackerD, there are various sensors such as GPS, WiFi, BLE, Temperature, Humidity, Motion Detection, and Buzzer. User can use TrackerD for different tracking scenario. 27 27 28 -((( 29 29 TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution. 30 -))) 31 31 32 -((( 33 33 The LoRa wireless technology used in TrackerD allows the user to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional tracking services. 34 34 ))) 35 -))) 36 36 37 37 ((( 38 38 TrackerD is equipped with a (% style="color:blue" %)**1000mAh Li-on rechargeable battery**(%%). Each TrackerD has a worldwide unique OTAA keys to join the LoRaWAN network. ... ... @@ -103,7 +103,7 @@ 103 103 * LoRaWAN 1.0.3 Class A 104 104 * ESP32 PICO D4 105 105 * SX1276/78 Wireless Chip 106 -* *Arduino IDE Compatible102 +* Arduino IDE Compatible 107 107 * Open source hardware / software 108 108 * Regular/ Real-time GPS,BLE,WIFI tracking 109 109 * Built-in3 axis accelerometer (LIS3DH) ... ... @@ -206,42 +206,47 @@ 206 206 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. ) 207 207 208 208 209 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 210 -|=(% scope="row" style="width: 50px;" %)((( 211 -**Size(bytes)** 212 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:88px" %)((( 213 -2(optional) 214 -)))|(% style="width:87px" %)((( 215 -2(optional) 205 +(% border="2" style="background-color:#ffffcc; color:green; width:537px" %) 206 +|(% style="width:69px" %)((( 207 +**Size** 208 + 209 +**(bytes)** 210 +)))|(% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)((( 211 +2 212 + 213 +(optional ) 214 +)))|(% style="width:83px" %)((( 215 +2 216 + 217 +(optional) 216 216 ))) 217 -| =(% style="width:;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((219 +|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 218 218 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 219 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:8 7px" %)[[Tem>>||anchor="HTem:"]]221 +)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]] 220 220 221 221 [[image:1664501958445-288.png]] 222 222 223 223 224 -==== (% style="color:blue" %) **Alarm & BAT:**(%%) ====226 +==== (% style="color:blue" %)Alarm & BAT:(%%) ==== 225 225 226 -(% border=" 1.2"cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)227 -| =(% scope="row" style="width:50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits228 -| =(% style="width:;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]]228 +(% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 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:"]] 229 229 230 -==== (% style="color:blue" %) **FLAG:**(%%) ====232 +==== (% style="color:blue" %)FLAG:(%%) ==== 231 231 232 -(% border=" 1.2"cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)233 -| =(% scope="row" style="width:50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits234 -| =(% style="width:;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version234 +(% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 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 version 235 235 236 236 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 237 237 238 238 239 -==== (% style="color:blue" %) **Location info:**(%%) ====241 +==== (% style="color:blue" %)Location info:(%%) ==== 240 240 241 241 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 242 242 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 243 243 244 - 245 245 (% style="color:red" %)**Important note:** 246 246 247 247 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. ... ... @@ -261,13 +261,15 @@ 261 261 262 262 263 263 264 -==== (% style="color:blue" %) **Alarm:**(%%) ====265 +==== (% style="color:blue" %)Alarm:(%%) ==== 265 265 267 + 266 266 Example: 0x4B & 0x40 >> 6 = 0x01 267 267 268 268 269 -==== (% style="color:blue" %) **BAT:**(%%) ====271 +==== (% style="color:blue" %)BAT:(%%) ==== 270 270 273 + 271 271 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 272 272 273 273 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: \ ... ... @@ -279,10 +279,8 @@ 279 279 * 3.40v ~~ 3.69v: 20% ~~ 40% 280 280 * < 3.39v: 0~~20% 281 281 285 +==== (% style="color:blue" %)LON:(%%) ==== 282 282 283 - 284 -==== (% style="color:blue" %)**LON:**(%%) ==== 285 - 286 286 287 287 Enable/Disable LED activity for uplink 288 288 ... ... @@ -291,17 +291,18 @@ 291 291 0x01: Enable LED indicator (Default Value) 292 292 293 293 294 -==== (% style="color:blue" %) **Hum:**(%%) ====295 +==== (% style="color:blue" %)Hum:(%%) ==== 295 295 296 296 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 297 297 298 298 299 -==== (% style="color:blue" %) **Tem:**(%%) ====300 +==== (% style="color:blue" %)Tem:(%%) ==== 300 300 301 301 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 302 302 303 303 304 304 306 + 305 305 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 306 306 307 307 ... ... @@ -313,11 +313,13 @@ 313 313 314 314 **MODE=2** 315 315 316 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 317 -|=(% scope="row" style="width: 60px;" %)((( 318 -**Size(bytes)** 319 -)))|(% style="width:30px" %)16|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:120px" %)2|(% style="width:50px" %)4|(% style="width:50px" %)2|(% style="width:30px" %)1 320 -|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 318 +(% border="2" style="background-color:#ffffcc; color:green; width:491px" %) 319 +|(% style="width:70px" %)((( 320 +**Size** 321 + 322 +**(bytes)** 323 +)))|(% style="width:44px" %)16|(% style="width:61px" %)4|(% style="width:63px" %)4|(% style="width:71px" %)2|(% style="width:50px" %)4|(% style="width:47px" %)2|(% style="width:15px" %)1 324 +|(% style="width:70px" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 321 321 iBeacon MAJOR 322 322 )))|(% style="width:63px" %)((( 323 323 iBeacon MINOR ... ... @@ -340,6 +340,7 @@ 340 340 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 341 341 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 342 342 347 + 343 343 === 2.3.5 Add Payload format in TTN V3 === 344 344 345 345 ... ... @@ -402,7 +402,7 @@ 402 402 403 403 404 404 405 -== 2.7 Sports Mode == 410 +== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- == 406 406 407 407 408 408 ... ... @@ -409,8 +409,8 @@ 409 409 == 2.8 LED Status == 410 410 411 411 412 -(% border=" 1.5" style="background-color:#ffffcc; color:green; width:500px" %)413 -|(% style="width:15 0px" %)**Event**|(% style="width:200px" %)**Action**|(% style="width:150px" %)**AT+LON to control on/off**417 +(% border="2" style="background-color:#ffffcc; color:green; width:636px" %) 418 +|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off** 414 414 |(% style="width:157px" %)**Power On**|(% style="width:271px" %)(% style="color:blue" %)**BLUE, **(% style="color:red" %)**RED , **(% style="color:green" %)**Green** flash once|(% style="width:202px" %)N/A 415 415 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes 416 416 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A ... ... @@ -423,6 +423,8 @@ 423 423 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 424 424 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 425 425 431 + 432 + 426 426 == 2.9 Button Function == 427 427 428 428 ... ... @@ -444,6 +444,10 @@ 444 444 |(% 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 445 445 |(% 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. 446 446 454 + 455 + 456 + 457 + 447 447 == 2.10 USB Port Function == 448 448 449 449 ... ... @@ -454,6 +454,10 @@ 454 454 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 455 455 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 456 456 468 + 469 + 470 + 471 + 457 457 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 458 458 459 459 ... ... @@ -551,6 +551,9 @@ 551 551 552 552 * (% style="color:blue" %)**AT Command: No AT Command** 553 553 569 + 570 + 571 + 554 554 * (% style="color:blue" %)**Downlink Payload (prefix 0x02):** 555 555 556 556 (% style="color:#037691" %)**0x02 01** (%%) ~/~/ Exit Alarm Mode ... ... @@ -722,9 +722,11 @@ 722 722 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 723 723 724 724 725 -(% style="color:blue" %)**Step3:**(%%) Download and Install Flash Tool: [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]]743 +(% style="color:blue" %)**Step3:**(%%) Download and Install Flash Tool: 726 726 745 +[[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]] 727 727 747 + 728 728 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 729 729 730 730 ... ... @@ -767,13 +767,13 @@ 767 767 768 768 * Download the latest Arduino software (IDE) from the Arduino official website: [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]] 769 769 770 -Install IDE on PC, open and click (% style="color:#037691" %)**File ~-~-> Preference**,(%%)add the following URL: [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]]790 +Install IDE on PC, open and click **File ~-~-> Preference**, add the following URL: [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]] 771 771 772 772 773 773 [[image:1664503635019-941.png]] 774 774 775 775 776 -* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%)find the esp32 information and install it.796 +* Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 777 777 778 778 [[image:1664503715811-892.png]] 779 779 ... ... @@ -791,19 +791,19 @@ 791 791 == 6.2 Source Code == 792 792 793 793 794 -* (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:**814 +* Open the example in the TrackerD file, please select the correct port in the IDE, as shown below: 795 795 796 796 [[image:1664503794261-827.png]] 797 797 798 798 799 799 800 -* (% style="color:blue" %)**Click to upload**820 +* Click to upload 801 801 802 802 [[image:1664503808294-336.png]] 803 803 804 804 805 805 806 -* (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data**826 +* Check the result, if the upload is successful, as shown below, open the serial port to view the data 807 807 808 808 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]] 809 809 ... ... @@ -815,7 +815,7 @@ 815 815 == 7.1 How to change the LoRa Frequency Bands/Region? == 816 816 817 817 818 -User can follow the introduction for [[how to upgrade image>> ||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.838 +User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download. 819 819 820 820 821 821