Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 81.1
edited by Edwin Chen
on 2022/10/22 00:24
on 2022/10/22 00:24
Change comment:
There is no comment for this version
To version 73.1
edited by Edwin Chen
on 2022/10/10 18:00
on 2022/10/10 18:00
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -203,11 +203,9 @@ 203 203 === 2.4.1 Uplink FPORT~=5, Device Status === 204 204 205 205 206 -Uplink the device configures with FPORT=5. Once T rackerDJoined the network, it will uplink this message to the server. Afterthefirst uplink, TrackerDwill uplink Device Status every 12 hours.206 +Uplink the device configures with FPORT=5. Once LGT92 Joined the network, it will uplink this message to the server. After first uplink, LHT52 will uplink Device Status every 12 hours. 207 207 208 -Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 209 209 210 - 211 211 (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 212 212 |=(% 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 213 213 |=(% 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 ... ... @@ -215,13 +215,13 @@ 215 215 [[image:1665301570342-765.png]] 216 216 217 217 218 - (%style="color:#037691"%)**Exampleof Device Status:**(%%) 13014001FF0FA24002216 +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"]] 219 219 220 - (% style="color:#037691" %)**Sensor Model:**(%%)For TrackerD,this value is 0x13218 +**Sensor Model**: For TrackerD, this value is 0x13. 221 221 222 - (% style="color:#037691" %)**Firmware Version:**(%%)0x0140,Means:v1.4.0 version220 +**Firmware Version**: 0x0100, Means: v1.0.0 version. 223 223 224 - (% style="color:#037691" %)**Frequency Band**:222 +**Frequency Band**: 225 225 226 226 *0x01: EU868 227 227 ... ... @@ -243,55 +243,20 @@ 243 243 244 244 *0x0a: AS923-3 245 245 246 -Sub- ,Others areFF)244 +**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00) 247 247 248 - (% style="color:#037691" %)**BAT:**(%%)shows the battery voltage for TrackerD.246 +**BAT**: shows the battery voltage for TrackerD. 249 249 248 +Ex1: 0x0B3A = 2874mV 250 250 251 -(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 252 - 253 253 Use can also get the Device Status uplink through the downlink command: 254 254 255 255 256 256 257 -(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 258 - 259 -(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %) 260 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit 261 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings 262 - 263 -(% style="color:blue" %)** SMOD:** 264 - 265 -(% style="color:red" %)** 1 :** (%%) GPS ONLY 266 - 267 -(% style="color:red" %)** 2 :** (%%) BLE ONLY 268 - 269 -(% style="color:red" %)** 3 :** (%%) GPS/BLE Hybrid 270 - 271 - 272 -(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload** 273 - 274 -(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values 275 - 276 -(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values 277 - 278 - 279 -(% style="color:blue" %)** BLE_Settings:** 280 - 281 -(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 282 - 283 - 284 - 285 -(% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 286 - 287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %) 288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)1 Bit 289 -|(% style="width:77px" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:92px" %)[[PNACKMD>>||anchor="H2.4.4A0UplinkFPORT3D42CHistoryGNSSPositioning"]]|(% style="width:48px" %)[[LON>>||anchor="H3.2.5Disable2FEnableLEDflash"]]|(% style="width:126px" %)[[Transport Mode>>||anchor="H2.9TransportMode"]] 290 - 291 291 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 292 292 293 293 294 -User scan use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes,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. 295 295 296 296 297 297 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -315,6 +315,10 @@ 315 315 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 316 316 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 317 317 281 +==== ==== 282 + 283 +==== ==== 284 + 318 318 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 319 319 320 320 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) ... ... @@ -347,12 +347,13 @@ 347 347 348 348 ==== (% style="color:blue" %)**Alarm:**(%%) ==== 349 349 350 - **Example:**0x4B & 0x40 >> 6 = 0x01317 +Example: 0x4B & 0x40 >> 6 = 0x01 351 351 352 352 320 + 353 353 ==== (% style="color:blue" %)**BAT:**(%%) ==== 354 354 355 - **Example:**0x4B45& 0x3FFF ⇒ 2885(mV).323 +Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 356 356 357 357 ((( 358 358 The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ ... ... @@ -364,37 +364,19 @@ 364 364 * 3.40v ~~ 3.69v: 20% ~~ 40% 365 365 * < 3.39v: 0~~20% 366 366 367 -==== (% style="color:blue" %)**MOD:**(%%) ==== 368 - 369 -**Example: ** (0x60>>6) & 0x3f =1 370 - 371 -**Set the format of GPS data uplink link:** 372 - 373 -(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values 374 -(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values 375 - 376 - 377 -**Set the format of BLE data uplink link:** 378 - 379 -(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon 380 - 381 - 382 382 ==== (% style="color:blue" %)**LON:**(%%) ==== 383 383 384 -**Example:** (0x60>>5) & 0x01=1. 385 - 386 386 Enable/Disable LED activity for uplink 387 387 388 388 ((( 389 - (% style="color:#037691" %)**0x00:**(%%)Disable LED indicator.340 +0x00: Disable LED indicator. 390 390 ))) 391 391 392 392 ((( 393 - (% style="color:#037691" %)**0x01:**(%%)Enable LED indicator (Default Value)344 +0x01: Enable LED indicator (Default Value) 394 394 ))) 395 395 396 396 397 - 398 398 ==== (% style="color:blue" %)**Hum:**(%%) ==== 399 399 400 400 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -409,7 +409,7 @@ 409 409 === 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 410 410 411 411 412 -The default uplink payload includes total 11 bytes (**AT+SMOD=1,1,0**). The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)362 +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) 413 413 414 414 415 415 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -428,7 +428,7 @@ 428 428 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 429 429 430 430 431 -Set [[PNACKMD=1>> ||anchor="H3.2.10A0A0AutoSendNone-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.381 +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. 432 432 433 433 434 434 (% style="color:red" %)**Note for this mode:** ... ... @@ -435,7 +435,6 @@ 435 435 436 436 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 437 437 * 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. 438 -* c) the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes of payload. In this case (DR0 of US915/AU915), the payload on server will show NULL 439 439 440 440 The payload is 15 bytes, as below. 441 441 ... ... @@ -451,11 +451,7 @@ 451 451 452 452 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 453 453 454 -TrackerD supports BLE scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon and find the strongest iBeacon info and uplink. 455 455 456 -User can set [[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]] so TrackerD will only search the iBeacons which have UUID match the BLEMASK. 457 - 458 - 459 459 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 460 460 |=(% scope="row" style="width: 60px;" %)((( 461 461 **Size(bytes)** ... ... @@ -475,7 +475,7 @@ 475 475 [[image:1664502425687-834.png]] 476 476 477 477 478 -* (% style="color:#037691" %)**BAT: ** (%%) 423 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 479 479 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 480 480 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 481 481 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -494,9 +494,8 @@ 494 494 [[image:1664502649601-895.png]] 495 495 496 496 497 -Add the decoder from this link: 442 +Add the decoder from this link: 498 498 499 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 500 500 501 501 Save the change the uplink message will be parsed. As below: 502 502 ... ... @@ -506,10 +506,16 @@ 506 506 507 507 == 2.5 Integrate with Datacake == 508 508 453 + 454 +((( 509 509 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. 456 +))) 510 510 458 +((( 511 511 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]] 460 +))) 512 512 462 + 513 513 [[image:1664502695771-538.png]] 514 514 515 515 ... ... @@ -517,13 +517,15 @@ 517 517 == 2.6 Integrate with Tago == 518 518 519 519 470 +((( 471 +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. 472 +))) 520 520 521 -After TrackerD sends data to LoRaWAN server such as TTN, user can pass the data to Datacake and plot out, currently only support GPS plot. 522 - 474 +((( 523 523 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]] 476 +))) 524 524 525 525 526 - 527 527 [[image:1664502715371-321.png]] 528 528 529 529 ... ... @@ -531,9 +531,8 @@ 531 531 == 2.7 Datalog Feature == 532 532 533 533 534 -total 273 entries,by default ,486 +total 273 entries,by default disable 535 535 536 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 537 537 538 538 Example use case. 539 539 ... ... @@ -553,7 +553,7 @@ 553 553 554 554 555 555 ((( 556 -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 salert mode.507 +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. 557 557 ))) 558 558 559 559 ... ... @@ -561,7 +561,7 @@ 561 561 Two ways to exit alarm mode: 562 562 ))) 563 563 564 -* Server send sa downlink command to exit.515 +* Server send a downlink command to exit. 565 565 * User fast press the RED button 10 times. 566 566 567 567 ((( ... ... @@ -649,9 +649,11 @@ 649 649 [[image:1664503022490-662.png]] 650 650 651 651 603 + 652 652 [[image:1664503035713-500.png]] 653 653 654 654 607 + 655 655 [[image:1664503047675-651.png]] 656 656 657 657 ... ... @@ -765,38 +765,42 @@ 765 765 === 3.2.7 Set Positioning Mode === 766 766 767 767 768 -SMOD define how TrackerD scan and uplink data: 721 +SMOD define the how TrackerD scan and uplink data: 769 769 770 770 771 771 * (% style="color:blue" %)**AT Command:** 772 772 773 -(% style="color:#037691" %)**AT+SMOD=aa,bb ,cc**726 +(% style="color:#037691" %)**AT+SMOD=aa,bb** 774 774 775 775 (% style="color:#037691" %)** aa:** 776 776 777 -* (% style="color: red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info.778 -* (% style="color: red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.779 -* (% style="color: red" %)**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.730 +* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 731 +* (% style="color:#037691" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 732 +* (% 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 780 780 781 781 (% style="color:#037691" %)**bb:** 782 782 783 -* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 784 -* (% style="color:red" %)**1 :**(%%) GPS +BAT State 736 +(% style="color:#037691" %)** if aa = 1: ** 785 785 786 -(% style="color:#037691" %)**cc: ** 738 +* (% style="color:#037691" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 739 +* (% style="color:#037691" %)**1 :**(%%) GPS +BAT State 787 787 788 - *(% style="color:red" %)**1:**(%%)(iBeacon)UUID+Major+Minor+Power+Rssi+BAT+State741 +(% style="color:#037691" %)** if aa = 2: ** 789 789 790 -(% style="color: blue" %)**Example:**743 +* (% style="color:#037691" %)**3 : **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 791 791 792 - AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 793 - AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 794 - AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 745 + **Example:** 795 795 747 + AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum 796 796 749 + AT+ SMOD =1,1 **~-~->** GPS +BAT State 750 + 751 + AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 752 + 753 + 797 797 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 798 798 799 -(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ SMOD =1,0,0756 +(% style="color:#037691" %)**0xA5 01 00** (%%) ~/~/ Same as AT+ SMOD =1,0 800 800 801 801 802 802 ... ... @@ -813,7 +813,7 @@ 813 813 814 814 (% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 815 815 816 - **Example:**AT+FTIME=150773 +Example: AT+FTIME=150 817 817 818 818 819 819 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** ... ... @@ -850,7 +850,7 @@ 850 850 851 851 * (% style="color:blue" %)**AT Command:** 852 852 853 -(% style="color:#037691" %)**AT+CFM=xx** 810 +(% style="color:#037691" %)**AT+CFM=xx. ** 854 854 855 855 856 856 **~ Example:** ... ... @@ -866,44 +866,6 @@ 866 866 867 867 868 868 869 -=== 3.2.10 Auto Send None-ACK messages === 870 - 871 - 872 -TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message. 873 - 874 - 875 -* (% style="color:blue" %)**AT Command: AT+PNACKMD** 876 - 877 -The default factory setting is 0. 878 - 879 - 880 -**Command Example Function Response:** 881 - 882 -(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 883 - 884 - 885 -* (% style="color:blue" %)**Downlink Command: 0x34** 886 - 887 -Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 888 - 889 - 890 -=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 891 - 892 -BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. LBT1 will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID. 893 - 894 -Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled. 895 - 896 -(% style="color:blue" %)**AT Command:**(%%) 897 - AT+BLEMASK=123456 ~/~/ Set BLEMASK = 123456 898 - AT+BLEMASK=0 ~/~/ disable BLEMASK 899 - 900 - 901 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%) 902 -Example: 903 -0xA5010203040506 ~/~/ Set BLEMASK to 123456 904 - 905 - 906 - 907 907 = 4. Setting for Different Scenarios = 908 908 909 909