Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From 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
To 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
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 8 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,5 +3,3 @@ 1 -== == 2 - 3 3 (% style="text-align:center" %) 4 4 [[image:1664505654417-133.png]] 5 5 ... ... @@ -185,8 +185,10 @@ 185 185 (% 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. 186 186 187 187 188 -== 2.3 Positioning Mode(SMOD) == 189 189 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,20 +196,25 @@ 196 196 Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 197 197 198 198 199 -== 2.3 Uplink Payload == 200 200 200 +== 2.4 Uplink Payload == 201 201 202 -=== 2.3.1 Uplink FPORT~=5, Device Status === 203 203 204 -Uplink the device configures withFPORT=5. Once LHT52 Joined the network,it will uplink this message to the server. After first uplink, LHT52 will uplinkDevice Statusevery 12 hours.203 +=== 2.4.1 Uplink FPORT~=5, Device Status === 205 205 206 -|=**Size (bytes)**|=**1**|=**2**|=**1**|=**1**|=**2** 207 -|**Value**|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT 208 208 209 - [[image:image-20221006181357-2.png]]206 +Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours. 210 210 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"]] 212 212 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 + 213 213 **Sensor Model**: For TrackerD, this value is 0x13. 214 214 215 215 **Firmware Version**: 0x0100, Means: v1.0.0 version. ... ... @@ -245,25 +245,26 @@ 245 245 Use can also get the Device Status uplink through the downlink command: 246 246 247 247 248 -=== 2.3.2 Uplink FPORT~=2, Realtime GNSS Positioning === 249 249 254 +=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 250 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 252 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. 253 253 259 + 254 254 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 255 255 |=(% scope="row" style="width: 50px;" %)((( 256 256 **Size(bytes)** 257 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width: 50px" %)1|(% style="width:88px" %)(((258 -2 (optional)263 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 264 +2 259 259 )))|(% style="width:87px" %)((( 260 -2 (optional)266 +2 261 261 ))) 262 262 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 263 263 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 264 -)))|(% style="width: 52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]270 +)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 265 265 266 -[[image:166 4501958445-288.png]]272 +[[image:1665301636888-168.png]] 267 267 268 268 269 269 ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== ... ... @@ -272,11 +272,12 @@ 272 272 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 273 273 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 274 274 281 + 275 275 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 276 276 277 277 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 278 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit |(% style="width:100px" %)5 bits279 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] |(% style="width:140px" %)Firmware version285 +|=(% 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:"]] 280 280 281 281 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 282 282 ... ... @@ -290,15 +290,14 @@ 290 290 291 291 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. 292 292 293 -2. Whenenable 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:300 +2. In this 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: 294 294 295 295 296 296 [[image:1664502116362-706.png]] 297 297 298 298 306 +3. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 299 299 300 -4. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 301 - 302 302 [[image:1664502166010-515.png]] 303 303 304 304 ... ... @@ -313,7 +313,7 @@ 313 313 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 314 314 315 315 ((( 316 -The battery info shows the currentvoltage, for(% style="color:blue"%)**TrackerD**(%%)version which powered byli-on battery.User can use below mapping to indicate the battery in percentage: \322 +The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ 317 317 ))) 318 318 319 319 * > 4.0v : 80% ~~ 100% ... ... @@ -346,15 +346,51 @@ 346 346 347 347 348 348 349 -=== 2. 3.3HistoryGNSS Positioning ===355 +=== 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 350 350 351 351 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) 352 352 353 -=== 2.3.4 BLE positioning Payload(Fport2) === 354 354 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:"]] 355 355 356 -Different MODE has different payload: (% style="color:blue" %)**MODE=2** 369 +(% class="wikigeneratedid" %) 370 +[[image:1665301687277-443.png]] 357 357 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 + 358 358 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 359 359 |=(% scope="row" style="width: 60px;" %)((( 360 360 **Size(bytes)** ... ... @@ -382,7 +382,7 @@ 382 382 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 383 383 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 384 384 385 -=== 2. 3.5427 +=== 2.4.6 Add Payload format in TTN V3 === 386 386 387 387 388 388 In TTN V3, use can add a custom payload so it shows friendly. ... ... @@ -402,7 +402,7 @@ 402 402 403 403 404 404 405 -== 2. 4Integrate with Datacake ==447 +== 2.5 Integrate with Datacake == 406 406 407 407 408 408 ((( ... ... @@ -418,7 +418,7 @@ 418 418 419 419 420 420 421 -== 2. 5Integrate with Tago ==463 +== 2.6 Integrate with Tago == 422 422 423 423 424 424 ((( ... ... @@ -434,12 +434,24 @@ 434 434 435 435 436 436 437 -== 2. 6Datalog Feature ==479 +== 2.7 Datalog Feature == 438 438 439 439 440 - ==2.6AlarmMode==482 +total 273 entries,by default disable 441 441 442 442 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 + 443 443 ((( 444 444 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 445 445 ))) ... ... @@ -463,15 +463,16 @@ 463 463 464 464 465 465 466 -== 2. 7SportsMode ==520 +== 2.9 Transport Mode == 467 467 468 468 469 -In SportsMode, 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.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. 470 470 471 471 472 -== 2.8 LED Status == 473 473 527 +== 2.10 LED Status == 474 474 529 + 475 475 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 476 476 |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 477 477 |(% 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 ... ... @@ -486,7 +486,7 @@ 486 486 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 487 487 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 488 488 489 -== 2. 9Button Function ==544 +== 2.11 Button Function == 490 490 491 491 492 492 (% style="color:blue" %)**RESET button:** ... ... @@ -507,7 +507,7 @@ 507 507 |(% 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 508 508 |(% 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. 509 509 510 -== 2.1 0USB Port Function ==565 +== 2.12 USB Port Function == 511 511 512 512 513 513 The USB interface of TrackerD has below functions: ... ... @@ -589,16 +589,16 @@ 589 589 590 590 591 591 592 -=== 3.2.3 Set SportsMode Packet transmission interval ===647 +=== 3.2.3 Set Transport Mode Packet transmission interval === 593 593 594 594 595 -Set sport spacket transmit interval650 +Set Transport Mode packet transmit interval 596 596 597 597 * (% style="color:blue" %)**AT Command:** 598 598 599 599 (% style="color:#037691" %)**AT+MTDC=xx. ** 600 600 601 -Example: AT+MTDC=300000 **~-~-> ** Set SportsMode Packet Interval to 300 seconds. TrackerD will send every 300 seconds inSportsmode, Default Value: 300000656 +Example: AT+MTDC=300000 **~-~-> ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000 602 602 603 603 604 604 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -638,16 +638,16 @@ 638 638 639 639 640 640 641 -=== 3.2.6 Disable/Enable movement detect(Debug Only)===696 +=== 3.2.6 Disable/Enable Transport Mode === 642 642 643 643 644 -User can use this feature to check andet thread holeof movement detect699 +Users can use this feature to enable/disable Transport Mode. 645 645 646 646 * (% style="color:blue" %)**AT Command:** 647 647 648 648 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 649 649 650 -Example: AT+ INTWK =1 **~-~-> ** Enable detectmovement.705 +Example: AT+ INTWK =1 **~-~-> ** Enable Transport Mode. 651 651 652 652 653 653 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -664,9 +664,25 @@ 664 664 665 665 * (% style="color:blue" %)**AT Command:** 666 666 667 -(% style="color:#037691" %)**AT+SMOD= xx.**722 +(% style="color:#037691" %)**AT+SMOD=aa,bb** 668 668 724 +(% style="color:#037691" %)** aa:** 669 669 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 + 670 670 **Example:** 671 671 672 672 AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum ... ... @@ -673,7 +673,7 @@ 673 673 674 674 AT+ SMOD =1,1 **~-~->** GPS +BAT State 675 675 676 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 。747 + AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 677 677 678 678 679 679 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -704,7 +704,7 @@ 704 704 705 705 706 706 707 -=== 3. 3.9 Set PDOP value for GPS fix accuracy ===778 +=== 3.2.9 Set PDOP value for GPS fix accuracy === 708 708 709 709 710 710 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. ... ... @@ -790,7 +790,7 @@ 790 790 791 791 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 792 792 793 -[[https:~~/~~/ www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]864 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] 794 794 795 795 796 796 Users need to use below files: ... ... @@ -827,6 +827,7 @@ 827 827 [[image:1664503635019-941.png]] 828 828 829 829 901 + 830 830 * (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 831 831 832 832 [[image:1664503715811-892.png]]
- 1665301570342-765.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +31.6 KB - Content
- 1665301636888-168.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +36.6 KB - Content
- 1665301687277-443.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +22.6 KB - Content
- 1665301786397-168.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +22.6 KB - Content
- image-20221009160220-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +46.4 KB - Content
- image-20221009160309-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +57.2 KB - Content
- image-20221009234629-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +222.9 KB - Content
- image-20221009234703-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +136.4 KB - Content