Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 74.1
edited by Edwin Chen
on 2022/10/11 00:10
on 2022/10/11 00:10
Change comment:
There is no comment for this version
To version 56.1
edited by Edwin Chen
on 2022/10/06 18:45
on 2022/10/06 18:45
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 8 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,3 +1,5 @@ 1 +== == 2 + 1 1 (% style="text-align:center" %) 2 2 [[image:1664505654417-133.png]] 3 3 ... ... @@ -183,10 +183,8 @@ 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 188 +== 2.3 Positioning Mode(SMOD) == 186 186 187 -== 2.3 Positioning Mode(SMOD) == 188 - 189 - 190 190 Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 191 191 192 192 * (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. ... ... @@ -196,25 +196,20 @@ 196 196 Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 197 197 198 198 199 +== 2.3 Uplink Payload == 199 199 200 -== 2.4 Uplink Payload == 201 201 202 +=== 2.3.1 Uplink FPORT~=5, Device Status === 202 202 203 - === 2.4.1Uplink FPORT~=5, Device Status===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. 204 204 206 +|=**Size (bytes)**|=**1**|=**2**|=**1**|=**1**|=**2** 207 +|**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 205 205 206 - Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink thismessageto the server. After the first uplink, TrackerD will uplink Device Status every12hours.209 +[[image:image-20221006181357-2.png]] 207 207 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"]] 208 208 209 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 210 -|=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1 211 -|=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status 212 - 213 -[[image:1665301570342-765.png]] 214 - 215 - 216 -Example of Device Status: [[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"]] 217 - 218 218 **Sensor Model**: For TrackerD, this value is 0x13. 219 219 220 220 **Firmware Version**: 0x0100, Means: v1.0.0 version. ... ... @@ -250,26 +250,25 @@ 250 250 Use can also get the Device Status uplink through the downlink command: 251 251 252 252 248 +=== 2.3.2 Uplink FPORT~=2, Realtime GNSS Positioning === 253 253 254 -=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 255 255 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. ) 256 256 257 -User can use **AT+SMOD=1,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, please note that 15 bytes won't work on DR0 on US915/AU915 frequency band. 258 258 259 - 260 260 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 261 261 |=(% scope="row" style="width: 50px;" %)((( 262 262 **Size(bytes)** 263 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width: 73px" %)1|(% style="width:40px" %)(((264 -2 257 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:88px" %)((( 258 +2(optional) 265 265 )))|(% style="width:87px" %)((( 266 -2 260 +2(optional) 267 267 ))) 268 268 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 269 269 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 270 -)))|(% style="width: 73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]264 +)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 271 271 272 -[[image:1665 301636888-168.png]]266 +[[image:1664501958445-288.png]] 273 273 274 274 275 275 ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== ... ... @@ -278,12 +278,11 @@ 278 278 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 279 279 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 280 280 281 - 282 282 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 283 283 284 284 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 285 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 286 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 278 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits 279 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 287 287 288 288 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 289 289 ... ... @@ -297,14 +297,15 @@ 297 297 298 298 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. 299 299 300 -2. Inthis mode, 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: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: 301 301 302 302 303 303 [[image:1664502116362-706.png]] 304 304 305 305 306 -3. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 307 307 300 +4. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 301 + 308 308 [[image:1664502166010-515.png]] 309 309 310 310 ... ... @@ -319,7 +319,7 @@ 319 319 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 320 320 321 321 ((( 322 -The battery info shows the battery voltage,User can usethebelow mapping to indicate the battery in percentage: \316 +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: \ 323 323 ))) 324 324 325 325 * > 4.0v : 80% ~~ 100% ... ... @@ -352,51 +352,15 @@ 352 352 353 353 354 354 355 -=== 2. 4.33,RealtimeGNSS Positioning(Default Mode)===349 +=== 2.3.3 Uplink FPORT~= , History GNSS Positioning === 356 356 357 357 358 -The default uplink payload includes totally 11 bytes. The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity) 359 359 353 +=== 2.3.4 BLE positioning Payload(Fport2) === 360 360 361 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 362 -|=(% scope="row" style="width: 50px;" %)((( 363 -**Size(bytes)** 364 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1 365 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 366 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 367 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] 368 368 369 -(% class="wikigeneratedid" %) 370 -[[image:1665301687277-443.png]] 356 +Different MODE has different payload: (% style="color:blue" %)**MODE=2** 371 371 372 - 373 - 374 -=== 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 375 - 376 - 377 -Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery. 378 - 379 - 380 -(% style="color:red" %)**Note for this mode:** 381 - 382 -* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 383 -* b) TrackerD will send data in (% style="color:blue" %)**CONFIRMED Mode**(%%) when PNACKMD=1, but TrackerD won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink, if TrackerD gets an ACK, TrackerD will consider there is a network connection and resend all NONE-ACK Messages. 384 - 385 -The payload is 15 bytes, as below. 386 - 387 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 388 -|=(% scope="row" %)((( 389 -**Size(bytes)** 390 -)))|4|4|2|1|1|1|1|1 391 -|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen 392 - 393 -[[image:image-20221009160309-2.png]] 394 - 395 - 396 - 397 -=== 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 398 - 399 - 400 400 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 401 401 |=(% scope="row" style="width: 60px;" %)((( 402 402 **Size(bytes)** ... ... @@ -424,7 +424,7 @@ 424 424 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 425 425 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 426 426 427 -=== 2. 4.6Add Payload format in TTN V3 ===385 +=== 2.3.5 Add Payload format in TTN V3 === 428 428 429 429 430 430 In TTN V3, use can add a custom payload so it shows friendly. ... ... @@ -444,7 +444,7 @@ 444 444 445 445 446 446 447 -== 2. 5Integrate with Datacake ==405 +== 2.4 Integrate with Datacake == 448 448 449 449 450 450 ((( ... ... @@ -460,7 +460,7 @@ 460 460 461 461 462 462 463 -== 2. 6Integrate with Tago ==421 +== 2.5 Integrate with Tago == 464 464 465 465 466 466 ((( ... ... @@ -476,24 +476,12 @@ 476 476 477 477 478 478 479 -== 2. 7Datalog Feature ==437 +== 2.6 Datalog Feature == 480 480 481 481 482 - total273entries,bydefaultdisable440 +== 2.6 Alarm Mode == 483 483 484 484 485 -Example use case. 486 - 487 -[[image:image-20221009234703-2.png||height="328" width="899"]] 488 - 489 - 490 -[[image:image-20221009234629-1.png||height="390" width="577"]] 491 - 492 - 493 - 494 -== 2.8 Alarm Mode == 495 - 496 - 497 497 ((( 498 498 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 499 499 ))) ... ... @@ -517,16 +517,15 @@ 517 517 518 518 519 519 520 -== 2. 9Transport Mode ==466 +== 2.7 Sports Mode == 521 521 522 522 523 -In Transport 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.469 +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. 524 524 525 525 472 +== 2.8 LED Status == 526 526 527 -== 2.10 LED Status == 528 528 529 - 530 530 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 531 531 |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 532 532 |(% 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 ... ... @@ -541,7 +541,7 @@ 541 541 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 542 542 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 543 543 544 -== 2. 11Button Function ==489 +== 2.9 Button Function == 545 545 546 546 547 547 (% style="color:blue" %)**RESET button:** ... ... @@ -562,7 +562,7 @@ 562 562 |(% 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 563 563 |(% 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. 564 564 565 -== 2.1 2USB Port Function ==510 +== 2.10 USB Port Function == 566 566 567 567 568 568 The USB interface of TrackerD has below functions: ... ... @@ -644,16 +644,16 @@ 644 644 645 645 646 646 647 -=== 3.2.3 Set Transport Mode Packet transmission interval ===592 +=== 3.2.3 Set Sports Mode Packet transmission interval === 648 648 649 649 650 -Set TransportModepacket transmit interval595 +Set sports packet transmit interval 651 651 652 652 * (% style="color:blue" %)**AT Command:** 653 653 654 654 (% style="color:#037691" %)**AT+MTDC=xx. ** 655 655 656 -Example: AT+MTDC=300000 **~-~-> ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds inTransport mode, Default Value: 300000601 +Example: AT+MTDC=300000 **~-~-> ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 657 657 658 658 659 659 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -693,16 +693,16 @@ 693 693 694 694 695 695 696 -=== 3.2.6 Disable/Enable TransportMode ===641 +=== 3.2.6 Disable/Enable movement detect (Debug Only) === 697 697 698 698 699 -User scan use this feature to enable/disableTransportMode.644 +User can use this feature to check and set thread hole of movement detect 700 700 701 701 * (% style="color:blue" %)**AT Command:** 702 702 703 703 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 704 704 705 -Example: AT+ INTWK =1 **~-~-> ** Enable TransportMode.650 +Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 706 706 707 707 708 708 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -719,25 +719,9 @@ 719 719 720 720 * (% style="color:blue" %)**AT Command:** 721 721 722 -(% style="color:#037691" %)**AT+SMOD= aa,bb**667 +(% style="color:#037691" %)**AT+SMOD=xx. ** 723 723 724 -(% style="color:#037691" %)** aa:** 725 725 726 -* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 727 -* (% style="color:#037691" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 728 -* (% style="color:#037691" %)**3: 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 729 - 730 -(% style="color:#037691" %)**bb:** 731 - 732 -(% style="color:#037691" %)** if aa = 1: ** 733 - 734 -* (% style="color:#037691" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 735 -* (% style="color:#037691" %)**1 :**(%%) GPS +BAT State 736 - 737 -(% style="color:#037691" %)** if aa = 2: ** 738 - 739 -* (% style="color:#037691" %)**3 : **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 740 - 741 741 **Example:** 742 742 743 743 AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum ... ... @@ -744,7 +744,7 @@ 744 744 745 745 AT+ SMOD =1,1 **~-~->** GPS +BAT State 746 746 747 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 676 + AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 748 748 749 749 750 750 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -775,7 +775,7 @@ 775 775 776 776 777 777 778 -=== 3. 2.9 Set PDOP value for GPS fix accuracy ===707 +=== 3.3.9 Set PDOP value for GPS fix accuracy === 779 779 780 780 781 781 PDOP(Position Dilution of Precision) filter, TrackerD will only accept GPS data with a lower PDOP value than pre-configure PDOP value. If device can't get a valid GPS packet within FTIME timeout, it will use the GPS data with lowest PDOP value to server. ... ... @@ -861,7 +861,7 @@ 861 861 862 862 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 863 863 864 -[[https:~~/~~/ github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]793 +[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 865 865 866 866 867 867 Users need to use below files: ... ... @@ -898,7 +898,6 @@ 898 898 [[image:1664503635019-941.png]] 899 899 900 900 901 - 902 902 * (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 903 903 904 904 [[image:1664503715811-892.png]]
- 1665301570342-765.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -31.6 KB - Content
- 1665301636888-168.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -36.6 KB - Content
- 1665301687277-443.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -22.6 KB - Content
- 1665301786397-168.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -22.6 KB - Content
- image-20221009160220-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.4 KB - Content
- image-20221009160309-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -57.2 KB - Content
- image-20221009234629-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -222.9 KB - Content
- image-20221009234703-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -136.4 KB - Content