Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 80.1
edited by Edwin Chen
on 2022/10/22 00:15
on 2022/10/22 00:15
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)
Details
- Page properties
-
- Content
-
... ... @@ -205,9 +205,7 @@ 205 205 206 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. 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" %)**Example of Device Status:**(%%) 13014001FF0FA24002216 +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"]] 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,7 @@ 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 + 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,12 @@ 347 347 348 348 ==== (% style="color:blue" %)**Alarm:**(%%) ==== 349 349 350 - **Example:**0x4B & 0x40 >> 6 = 0x01314 +Example: 0x4B & 0x40 >> 6 = 0x01 351 351 352 352 353 353 ==== (% style="color:blue" %)**BAT:**(%%) ==== 354 354 355 - **Example:**0x4B45& 0x3FFF ⇒ 2885(mV).319 +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.336 +0x00: Disable LED indicator. 390 390 ))) 391 391 392 392 ((( 393 - (% style="color:#037691" %)**0x01:**(%%)Enable LED indicator (Default Value)340 +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)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) 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.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. 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,9 +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** to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon before each uplink. 455 455 456 - 457 457 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 458 458 |=(% scope="row" style="width: 60px;" %)((( 459 459 **Size(bytes)** ... ... @@ -473,7 +473,7 @@ 473 473 [[image:1664502425687-834.png]] 474 474 475 475 476 -* (% style="color:#037691" %)**BAT: ** (%%) 419 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 477 477 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 478 478 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 479 479 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -492,9 +492,8 @@ 492 492 [[image:1664502649601-895.png]] 493 493 494 494 495 -Add the decoder from this link: 438 +Add the decoder from this link: 496 496 497 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 498 498 499 499 Save the change the uplink message will be parsed. As below: 500 500 ... ... @@ -537,9 +537,8 @@ 537 537 == 2.7 Datalog Feature == 538 538 539 539 540 -total 273 entries,by default ,482 +total 273 entries,by default disable 541 541 542 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 543 543 544 544 Example use case. 545 545 ... ... @@ -773,38 +773,42 @@ 773 773 === 3.2.7 Set Positioning Mode === 774 774 775 775 776 -SMOD define how TrackerD scan and uplink data: 717 +SMOD define the how TrackerD scan and uplink data: 777 777 778 778 779 779 * (% style="color:blue" %)**AT Command:** 780 780 781 -(% style="color:#037691" %)**AT+SMOD=aa,bb ,cc**722 +(% style="color:#037691" %)**AT+SMOD=aa,bb** 782 782 783 783 (% style="color:#037691" %)** aa:** 784 784 785 -* (% style="color: red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info.786 -* (% style="color: red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.787 -* (% 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.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 788 788 789 789 (% style="color:#037691" %)**bb:** 790 790 791 -* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 792 -* (% style="color:red" %)**1 :**(%%) GPS +BAT State 732 +(% style="color:#037691" %)** if aa = 1: ** 793 793 794 -(% style="color:#037691" %)**cc: ** 734 +* (% style="color:#037691" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 735 +* (% style="color:#037691" %)**1 :**(%%) GPS +BAT State 795 795 796 - *(% style="color:red" %)**1:**(%%)(iBeacon)UUID+Major+Minor+Power+Rssi+BAT+State737 +(% style="color:#037691" %)** if aa = 2: ** 797 797 798 -(% style="color: blue" %)**Example:**739 +* (% style="color:#037691" %)**3 : **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 799 799 800 - AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 801 - AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 802 - AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 741 + **Example:** 803 803 743 + AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum 804 804 745 + AT+ SMOD =1,1 **~-~->** GPS +BAT State 746 + 747 + AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 748 + 749 + 805 805 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 806 806 807 -(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ SMOD =1,0,0752 +(% style="color:#037691" %)**0xA5 01 00** (%%) ~/~/ Same as AT+ SMOD =1,0 808 808 809 809 810 810 ... ... @@ -821,7 +821,7 @@ 821 821 822 822 (% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 823 823 824 - **Example:**AT+FTIME=150769 +Example: AT+FTIME=150 825 825 826 826 827 827 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** ... ... @@ -858,7 +858,7 @@ 858 858 859 859 * (% style="color:blue" %)**AT Command:** 860 860 861 -(% style="color:#037691" %)**AT+CFM=xx** 806 +(% style="color:#037691" %)**AT+CFM=xx. ** 862 862 863 863 864 864 **~ Example:** ... ... @@ -874,44 +874,6 @@ 874 874 875 875 876 876 877 -=== 3.2.10 Auto Send None-ACK messages === 878 - 879 - 880 -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. 881 - 882 - 883 -* (% style="color:blue" %)**AT Command: AT+PNACKMD** 884 - 885 -The default factory setting is 0. 886 - 887 - 888 -**Command Example Function Response:** 889 - 890 -(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 891 - 892 - 893 -* (% style="color:blue" %)**Downlink Command: 0x34** 894 - 895 -Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 896 - 897 - 898 -=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 899 - 900 -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. 901 - 902 -Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled. 903 - 904 -(% style="color:blue" %)**AT Command:**(%%) 905 - AT+BLEMASK=123456 ~/~/ Set BLEMASK = 123456 906 - AT+BLEMASK=0 ~/~/ disable BLEMASK 907 - 908 - 909 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%) 910 -Example: 911 -0xA5010203040506 ~/~/ Set BLEMASK to 123456 912 - 913 - 914 - 915 915 = 4. Setting for Different Scenarios = 916 916 917 917