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
-
... ... @@ -109,7 +109,7 @@ 109 109 * LoRaWAN 1.0.3 Class A 110 110 * ESP32 PICO D4 111 111 * SX1276/78 Wireless Chip 112 -* *112 +* Arduino IDE Compatible 113 113 * Open source hardware / software 114 114 * Regular/ Real-time GPS,BLE,WIFI tracking 115 115 * Built-in3 axis accelerometer (LIS3DH) ... ... @@ -216,41 +216,43 @@ 216 216 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. ) 217 217 218 218 219 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 500px" %)219 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 220 220 |=(% scope="row" style="width: 50px;" %)((( 221 221 **Size(bytes)** 222 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:80px" %)((( 223 -2(optional ) 224 -)))|(% style="width:80px" %)((( 222 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:88px" %)((( 225 225 2(optional) 224 +)))|(% style="width:87px" %)((( 225 +2(optional) 226 226 ))) 227 227 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 228 228 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 229 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:8 3px" %)[[Tem>>||anchor="HTem:"]]229 +)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 230 230 231 231 [[image:1664501958445-288.png]] 232 232 233 233 234 -==== (% style="color:blue" %)Alarm & BAT:(%%) ==== 234 +==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== 235 235 236 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:2 80px" %)237 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14 236 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 237 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 238 238 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 239 239 240 -==== (% style="color:blue" %)FLAG:(%%) ==== 241 241 242 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:280px" %) 243 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2 bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits 244 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 241 +==== (% style="color:blue" %)**FLAG:**(%%) ==== 245 245 243 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 244 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits 245 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 246 + 246 246 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 247 247 248 248 249 -==== (% style="color:blue" %)Location info:(%%) ==== 250 +==== (% style="color:blue" %)**Location info:**(%%) ==== 250 250 251 251 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 252 252 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 253 253 255 + 254 254 (% style="color:red" %)**Important note:** 255 255 256 256 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. ... ... @@ -270,20 +270,19 @@ 270 270 271 271 272 272 273 -==== (% style="color:blue" %)Alarm:(%%) ==== 275 +==== (% style="color:blue" %)**Alarm:**(%%) ==== 274 274 275 - 276 276 Example: 0x4B & 0x40 >> 6 = 0x01 277 277 278 278 279 -==== (% style="color:blue" %)BAT:(%%) ==== 280 +==== (% style="color:blue" %)**BAT:**(%%) ==== 280 280 281 - 282 282 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 283 283 284 +((( 284 284 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: \ 286 +))) 285 285 286 - 287 287 * > 4.0v : 80% ~~ 100% 288 288 * 3.85v ~~3.99v: 60% ~~ 80% 289 289 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -290,28 +290,33 @@ 290 290 * 3.40v ~~ 3.69v: 20% ~~ 40% 291 291 * < 3.39v: 0~~20% 292 292 293 -==== (% style="color:blue" %)LON:(%%) ==== 294 294 295 - 295 + 296 +==== (% style="color:blue" %)**LON:**(%%) ==== 297 + 298 + 296 296 Enable/Disable LED activity for uplink 297 297 301 +((( 298 298 0x00: Disable LED indicator. 303 +))) 299 299 305 +((( 300 300 0x01: Enable LED indicator (Default Value) 307 +))) 301 301 302 302 303 -==== (% style="color:blue" %)Hum:(%%) ==== 310 +==== (% style="color:blue" %)**Hum:**(%%) ==== 304 304 305 305 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 306 306 307 307 308 -==== (% style="color:blue" %)Tem:(%%) ==== 315 +==== (% style="color:blue" %)**Tem:**(%%) ==== 309 309 310 310 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 311 311 312 312 313 313 314 - 315 315 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 316 316 317 317 ... ... @@ -319,17 +319,13 @@ 319 319 === 2.3.4 BLE positioning Payload(Fport2) === 320 320 321 321 322 -Different MODE has different payload: 328 +Different MODE has different payload: (% style="color:blue" %)**MODE=2** 323 323 324 -**MODE=2** 325 - 326 -(% border="2" style="background-color:#ffffcc; color:green; width:491px" %) 327 -|(% style="width:70px" %)((( 328 -**Size** 329 - 330 -**(bytes)** 331 -)))|(% 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 332 -|(% style="width:70px" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 330 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 331 +|=(% scope="row" style="width: 60px;" %)((( 332 +**Size(bytes)** 333 +)))|(% 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 334 +|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 333 333 iBeacon MAJOR 334 334 )))|(% style="width:63px" %)((( 335 335 iBeacon MINOR ... ... @@ -352,6 +352,8 @@ 352 352 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 353 353 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 354 354 357 + 358 + 355 355 === 2.3.5 Add Payload format in TTN V3 === 356 356 357 357 ... ... @@ -375,9 +375,13 @@ 375 375 == 2.4 Integrate with Datacake == 376 376 377 377 382 +((( 378 378 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. 384 +))) 379 379 386 +((( 380 380 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]] 388 +))) 381 381 382 382 383 383 [[image:1664502695771-538.png]] ... ... @@ -387,9 +387,13 @@ 387 387 == 2.5 Integrate with Tago == 388 388 389 389 398 +((( 390 390 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. 400 +))) 391 391 402 +((( 392 392 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]] 404 +))) 393 393 394 394 395 395 [[image:1664502715371-321.png]] ... ... @@ -399,22 +399,30 @@ 399 399 == 2.6 Alarm Mode == 400 400 401 401 414 +((( 402 402 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 416 +))) 403 403 404 404 419 +((( 405 405 Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exit alert mode. 421 +))) 406 406 407 407 424 +((( 408 408 Two ways to exit alarm mode: 426 +))) 409 409 410 410 * Server send a downlink command to exit. 411 411 * User fast press the RED button 10 times. 412 412 431 +((( 413 413 When exit alarm mode, (% style="color:red" %)**RED LED**(%%) will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false. 433 +))) 414 414 415 415 416 416 417 -== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--==437 +== 2.7 Sports Mode == 418 418 419 419 420 420 ... ... @@ -421,8 +421,8 @@ 421 421 == 2.8 LED Status == 422 422 423 423 424 -(% border=" 2" style="background-color:#ffffcc; color:green; width:636px" %)425 -|(% style="width:15 7px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off**444 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 445 +|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 426 426 |(% 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 427 427 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes 428 428 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A ... ... @@ -435,10 +435,11 @@ 435 435 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 436 436 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 437 437 458 + 438 438 == 2.9 Button Function == 439 439 440 440 441 -(% style="color: green" %)**RESET button:**462 +(% style="color:blue" %)**RESET button:** 442 442 443 443 [[image:1664502835802-546.png]] 444 444 ... ... @@ -450,8 +450,8 @@ 450 450 [[image:1664502854406-763.png]] 451 451 452 452 453 -(% border=" 2" style="background-color:#ffffcc; color:green; width:627px" %)454 -|(% style="width:1 35px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**474 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 475 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 455 455 |(% 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"]] 456 456 |(% 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 457 457 |(% 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. ... ... @@ -468,6 +468,7 @@ 468 468 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 469 469 470 470 492 + 471 471 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 472 472 473 473 ... ... @@ -549,7 +549,7 @@ 549 549 550 550 (% style="color:#037691" %)**AT+MTDC=xx. ** 551 551 552 - 574 +Example: AT+MTDC=300000 **~-~-> ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 553 553 554 554 555 555 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -580,7 +580,7 @@ 580 580 581 581 (% style="color:#037691" %)**AT+LON=xx. (Disable (0), Enable (1), default:1)** 582 582 583 - 605 +Example: AT+LON=0 **~-~-> ** Disable LED for position, downlink and uplink. 584 584 585 585 586 586 * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):** ... ... @@ -598,7 +598,7 @@ 598 598 599 599 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 600 600 601 - 623 +Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 602 602 603 603 604 604 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -736,7 +736,7 @@ 736 736 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 737 737 738 738 739 -(% style="color:blue" %)**Step3 :**(%%)761 +(% 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]] 740 740 741 741 742 742 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 ... ... @@ -779,7 +779,7 @@ 779 779 === 6.1.1 Set up ARDUINO compile environment === 780 780 781 781 782 -* 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]] 804 +* **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]]** 783 783 784 784 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]] 785 785 ... ... @@ -787,13 +787,13 @@ 787 787 [[image:1664503635019-941.png]] 788 788 789 789 790 -* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) find the esp32 information and install it. 812 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 791 791 792 792 [[image:1664503715811-892.png]] 793 793 794 794 795 795 796 -* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 818 +* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 797 797 798 798 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 799 799 ... ... @@ -840,8 +840,8 @@ 840 840 841 841 842 842 843 -(% border=" 2" style="background-color:#ffffcc; color:green; width:314px" %)844 -|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin** 865 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %) 866 +|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin** 845 845 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC 846 846 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A) 847 847 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A) ... ... @@ -851,6 +851,7 @@ 851 851 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 852 852 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 853 853 876 + 854 854 = 8. Order Info = 855 855 856 856 ... ... @@ -866,25 +866,31 @@ 866 866 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 867 867 * (% style="color:red" %)**US915**(%%): Default frequency band US915 868 868 892 + 893 + 869 869 = 9. Packing Info = 870 870 871 871 872 -**Package Includes**: 897 +(% style="color:#037691" %)**Package Includes**: 873 873 874 874 * TrackerD LoRaWAN GPS/BLE Tracker x 1 875 875 * USB recharge & program cable x 1 876 876 877 -**Dimensions and Weight**: 902 +(% style="color:#037691" %)**Dimensions and Weight**: 878 878 879 879 * Device Size: 85 x 48 x 15 cm 880 880 * Weight: 50g 881 881 907 + 908 + 882 882 = 10. Support = 883 883 884 884 885 885 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 886 -* 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]] 913 +* 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]]. 887 887 915 + 916 + 888 888 = 11. Reference = 889 889 890 890 ... ... @@ -891,3 +891,5 @@ 891 891 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 892 892 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 893 893 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 923 + 924 +