Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/14 16:33
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - Content
-
... ... @@ -1,3 +1,5 @@ 1 +== == 2 + 1 1 (% style="text-align:center" %) 2 2 [[image:1664505654417-133.png]] 3 3 ... ... @@ -103,7 +103,7 @@ 103 103 * LoRaWAN 1.0.3 Class A 104 104 * ESP32 PICO D4 105 105 * SX1276/78 Wireless Chip 106 -* *108 +* 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) ... ... @@ -183,14 +183,15 @@ 183 183 (% style="color:blue" %)**Step 3:**(%%) TrackerD will auto join to the LoRaWAN network. After join success, TrackerD will start to upload message to IoT server. 184 184 185 185 186 - (% style="color:blue"%)**Positioning Mode(SMOD):**188 +== 2.3 Positioning Mode(SMOD) == 187 187 188 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get GPS location info. 189 -* (% style="color:#037691" %)**BLE ONLY: **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking. 190 -* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking. 190 +Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 191 191 192 -User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 192 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 193 +* (% style="color:#037691" %)**BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 194 +* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 193 193 196 +Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 194 194 195 195 196 196 == 2.3 Uplink Payload == ... ... @@ -198,14 +198,56 @@ 198 198 199 199 === 2.3.1 Uplink FPORT~=5, Device Status === 200 200 204 +Uplink the device configures with FPORT=5. Once LHT52 Joined the network, it will uplink this message to the server. After first uplink, LHT52 will uplink Device Status every 12 hours. 201 201 206 +|=**Size (bytes)**|=**1**|=**2**|=**1**|=**1**|=**2** 207 +|**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 202 202 203 - === 2.3.2 Uplink FPORT~= , RealtimeGNSS Positioning===209 +[[image:image-20221006181357-2.png]] 204 204 211 +Example Payload (FPort=5): [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT52%20-%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220621105116-11.png?rev=1.1||alt="image-20220621105116-11.png"]] 205 205 206 - Thedefault uplink payload includestotally 11 bytes. (Usercan use AT+MOD=0 tonablethe Temperature and humidity sensorto hum/tem info fromaccelerometer.When accelerometerinfo isenable,total payload will be 15 bytes,please note 15 bytes won't work on DR0on US915/AU915 frequency band.)213 +**Sensor Model**: For TrackerD, this value is 0x13. 207 207 215 +**Firmware Version**: 0x0100, Means: v1.0.0 version. 208 208 217 +**Frequency Band**: 218 + 219 +*0x01: EU868 220 + 221 +*0x02: US915 222 + 223 +*0x03: IN865 224 + 225 +*0x04: AU915 226 + 227 +*0x05: KZ865 228 + 229 +*0x06: RU864 230 + 231 +*0x07: AS923 232 + 233 +*0x08: AS923-1 234 + 235 +*0x09: AS923-2 236 + 237 +*0x0a: AS923-3 238 + 239 +**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00) 240 + 241 +**BAT**: shows the battery voltage for TrackerD. 242 + 243 +Ex1: 0x0B3A = 2874mV 244 + 245 +Use can also get the Device Status uplink through the downlink command: 246 + 247 + 248 +=== 2.3.2 Uplink FPORT~=2, Realtime GNSS Positioning === 249 + 250 + 251 +The default uplink payload includes totally 11 bytes. (User can use AT+SMOD=1,0 to enable uploading on-board Temperature and humidity value, and total payload will be 15 bytes, please note 15 bytes won't work on DR0 on US915/AU915 frequency band. ) 252 + 253 + 209 209 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 210 210 |=(% scope="row" style="width: 50px;" %)((( 211 211 **Size(bytes)** ... ... @@ -231,7 +231,7 @@ 231 231 232 232 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 233 233 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits 234 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H 2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version279 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% 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 ... ... @@ -241,16 +241,13 @@ 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. 248 248 249 -2. Infirmwareversionv1.5, Roll&Pitchdisabled bydefault.293 +2. When enable 9-axis motion sensor, the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes payload. In this case, the payload on server will be ignore and shows as below: 250 250 251 -3. When enable 9-axis motion sensor, the total payload will be 15 bytes, while US915/AU915 DR0 accept only 11 bytes payload. In this case, the payload on server will be ignore and shows as below: 252 252 253 - 254 254 [[image:1664502116362-706.png]] 255 255 256 256 ... ... @@ -270,9 +270,10 @@ 270 270 271 271 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 272 272 315 +((( 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: \ 317 +))) 274 274 275 - 276 276 * > 4.0v : 80% ~~ 100% 277 277 * 3.85v ~~3.99v: 60% ~~ 80% 278 278 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -280,15 +280,17 @@ 280 280 * < 3.39v: 0~~20% 281 281 282 282 283 - 284 284 ==== (% style="color:blue" %)**LON:**(%%) ==== 285 285 286 - 287 287 Enable/Disable LED activity for uplink 288 288 330 +((( 289 289 0x00: Disable LED indicator. 332 +))) 290 290 334 +((( 291 291 0x01: Enable LED indicator (Default Value) 336 +))) 292 292 293 293 294 294 ==== (% style="color:blue" %)**Hum:**(%%) ==== ... ... @@ -309,10 +309,8 @@ 309 309 === 2.3.4 BLE positioning Payload(Fport2) === 310 310 311 311 312 -Different MODE has different payload: 357 +Different MODE has different payload: (% style="color:blue" %)**MODE=2** 313 313 314 -**MODE=2** 315 - 316 316 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 317 317 |=(% scope="row" style="width: 60px;" %)((( 318 318 **Size(bytes)** ... ... @@ -363,9 +363,13 @@ 363 363 == 2.4 Integrate with Datacake == 364 364 365 365 409 +((( 366 366 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. 411 +))) 367 367 413 +((( 368 368 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]] 415 +))) 369 369 370 370 371 371 [[image:1664502695771-538.png]] ... ... @@ -375,9 +375,13 @@ 375 375 == 2.5 Integrate with Tago == 376 376 377 377 425 +((( 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. 427 +))) 379 379 429 +((( 380 380 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]] 431 +))) 381 381 382 382 383 383 [[image:1664502715371-321.png]] ... ... @@ -387,18 +387,26 @@ 387 387 == 2.6 Alarm Mode == 388 388 389 389 441 +((( 390 390 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 443 +))) 391 391 392 392 446 +((( 393 393 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. 448 +))) 394 394 395 395 451 +((( 396 396 Two ways to exit alarm mode: 453 +))) 397 397 398 398 * Server send a downlink command to exit. 399 399 * User fast press the RED button 10 times. 400 400 458 +((( 401 401 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. 460 +))) 402 402 403 403 404 404 ... ... @@ -405,12 +405,14 @@ 405 405 == 2.7 Sports Mode == 406 406 407 407 467 +In Sports Mode, TrackerD will check if there is motion. If there is no motion, device will send uplinks every 20 minutes. If there is motion, device will send uplink every 5 minutes. 408 408 469 + 409 409 == 2.8 LED Status == 410 410 411 411 412 412 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 413 -|(% style="width:150px" %)**Event**|(% style="width:200px" %)**Action**|(% style="width:150px" %)**AT+LON to control on/off** 474 +|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**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 ... ... @@ -426,7 +426,7 @@ 426 426 == 2.9 Button Function == 427 427 428 428 429 -(% style="color: green" %)**RESET button:**490 +(% style="color:blue" %)**RESET button:** 430 430 431 431 [[image:1664502835802-546.png]] 432 432 ... ... @@ -438,8 +438,8 @@ 438 438 [[image:1664502854406-763.png]] 439 439 440 440 441 -(% border=" 2" style="background-color:#ffffcc; color:green; width:627px" %)442 -|(% style="width:1 35px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**502 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 503 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 443 443 |(% 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"]] 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. ... ... @@ -535,7 +535,7 @@ 535 535 536 536 (% style="color:#037691" %)**AT+MTDC=xx. ** 537 537 538 - 599 +Example: AT+MTDC=300000 **~-~-> ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 539 539 540 540 541 541 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -566,7 +566,7 @@ 566 566 567 567 (% style="color:#037691" %)**AT+LON=xx. (Disable (0), Enable (1), default:1)** 568 568 569 - 630 +Example: AT+LON=0 **~-~-> ** Disable LED for position, downlink and uplink. 570 570 571 571 572 572 * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):** ... ... @@ -584,7 +584,7 @@ 584 584 585 585 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 586 586 587 - 648 +Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 588 588 589 589 590 590 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -596,18 +596,9 @@ 596 596 === 3.2.7 Set Positioning Mode === 597 597 598 598 599 -SMOD define the how TrackerD scan and uplink dat e.660 +SMOD define the how TrackerD scan and uplink data: 600 600 601 -GPS室外定位模式: 设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 602 602 603 -BLE室内定位模式: 设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。 604 - 605 -GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。 606 - 607 -运动模式: 设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。 608 - 609 - 610 - 611 611 * (% style="color:blue" %)**AT Command:** 612 612 613 613 (% style="color:#037691" %)**AT+SMOD=xx. ** ... ... @@ -722,7 +722,7 @@ 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 :**(%%)777 +(% 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]] 726 726 727 727 728 728 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 ... ... @@ -765,7 +765,7 @@ 765 765 === 6.1.1 Set up ARDUINO compile environment === 766 766 767 767 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]] 820 +* **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 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]] 771 771 ... ... @@ -773,13 +773,13 @@ 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. 828 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 777 777 778 778 [[image:1664503715811-892.png]] 779 779 780 780 781 781 782 -* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 834 +* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 783 783 784 784 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 785 785 ... ... @@ -826,8 +826,8 @@ 826 826 827 827 828 828 829 -(% border=" 2" style="background-color:#ffffcc; color:green; width:314px" %)830 -|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin** 881 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %) 882 +|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin** 831 831 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC 832 832 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A) 833 833 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A) ... ... @@ -837,6 +837,7 @@ 837 837 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 838 838 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 839 839 892 + 840 840 = 8. Order Info = 841 841 842 842 ... ... @@ -855,12 +855,12 @@ 855 855 = 9. Packing Info = 856 856 857 857 858 -**Package Includes**: 911 +(% style="color:#037691" %)**Package Includes**: 859 859 860 860 * TrackerD LoRaWAN GPS/BLE Tracker x 1 861 861 * USB recharge & program cable x 1 862 862 863 -**Dimensions and Weight**: 916 +(% style="color:#037691" %)**Dimensions and Weight**: 864 864 865 865 * Device Size: 85 x 48 x 15 cm 866 866 * Weight: 50g ... ... @@ -869,7 +869,7 @@ 869 869 870 870 871 871 * 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. 872 -* 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]] 925 +* 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]]. 873 873 874 874 = 11. Reference = 875 875 ... ... @@ -877,3 +877,5 @@ 877 877 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 878 878 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 879 879 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 933 + 934 +
- image-20221006181316-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +17.7 KB - Content
- image-20221006181357-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +88.0 KB - Content