Changes for page TrackerD - LoRaWAN Tracker User Manual(Remove WiFi)
Last modified by Xiaoling on 2023/12/27 09:15
From version 70.1
edited by Edwin Chen
on 2022/10/09 23:47
on 2022/10/09 23:47
Change comment:
Uploaded new attachment "image-20221009234703-2.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.Xiaoling - Content
-
... ... @@ -209,9 +209,11 @@ 209 209 === 2.4.1 Uplink FPORT~=5, Device Status === 210 210 211 211 212 -Uplink the device configures with FPORT=5. Once LGT92Joined the network, it will uplink this message to the server. After first uplink,LHT52will uplink Device Status every 12 hours.212 +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. 213 213 214 +Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 214 214 216 + 215 215 (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 216 216 |=(% 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 217 217 |=(% 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 ... ... @@ -219,13 +219,13 @@ 219 219 [[image:1665301570342-765.png]] 220 220 221 221 222 - ExamplePayload (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"]]224 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002 223 223 224 -**Sensor Model** :For TrackerD,.226 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13 225 225 226 -**Firmware Version** :0x0100,0.0 version.228 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version 227 227 228 -**Frequency Band**: 230 +(% style="color:#037691" %)**Frequency Band**: 229 229 230 230 *0x01: EU868 231 231 ... ... @@ -247,20 +247,57 @@ 247 247 248 248 *0x0a: AS923-3 249 249 250 - **Sub-Band**:CN470,AU915,US915.Others are0x00)252 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF) 251 251 252 -**BAT** :shows the battery voltage for TrackerD.254 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD. 253 253 254 -Ex1: 0x0B3A = 2874mV 255 255 257 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 258 + 256 256 Use can also get the Device Status uplink through the downlink command: 257 257 258 258 259 259 263 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 264 + 265 +(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %) 266 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit 267 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings 268 + 269 +(% style="color:blue" %)** SMOD:** 270 + 271 +(% style="color:red" %)** 1 :** (%%) GPS ONLY 272 + 273 +(% style="color:red" %)** 2 :** (%%) BLE ONLY 274 + 275 +(% style="color:red" %)** 3 :** (%%) GPS/BLE Hybrid 276 + 277 + 278 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload** 279 + 280 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values 281 + 282 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values 283 + 284 + 285 +(% style="color:blue" %)** BLE_Settings:** 286 + 287 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 288 + 289 + 290 + 291 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 292 + 293 +(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %) 294 +|(% 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 295 +|(% 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"]] 296 + 297 + 298 + 260 260 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 261 261 262 262 263 -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.302 +Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, 264 264 265 265 266 266 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -284,12 +284,6 @@ 284 284 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 285 285 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 286 286 287 -(% class="wikigeneratedid" %) 288 -==== ==== 289 - 290 -(% class="wikigeneratedid" %) 291 -==== ==== 292 - 293 293 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 294 294 295 295 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) ... ... @@ -305,7 +305,6 @@ 305 305 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 306 306 307 307 308 - 309 309 (% style="color:red" %)**Important note:** 310 310 311 311 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. ... ... @@ -324,13 +324,12 @@ 324 324 325 325 ==== (% style="color:blue" %)**Alarm:**(%%) ==== 326 326 327 -Example: 359 +**Example: ** 0x4B & 0x40 >> 6 = 0x01 328 328 329 329 330 - 331 331 ==== (% style="color:blue" %)**BAT:**(%%) ==== 332 332 333 -Example: 0CDD& 0x3FFF ⇒3293(mV).364 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV). 334 334 335 335 ((( 336 336 The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ ... ... @@ -342,21 +342,37 @@ 342 342 * 3.40v ~~ 3.69v: 20% ~~ 40% 343 343 * < 3.39v: 0~~20% 344 344 376 +==== (% style="color:blue" %)**MOD:**(%%) ==== 345 345 378 +**Example: ** (0x60>>6)& 0x3f =1. 346 346 380 +**Set the format of GPS data uplink link:** 381 + 382 +(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values 383 +(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values 384 + 385 + 386 +**Set the format of BLE data uplink link:** 387 + 388 +(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon 389 + 390 + 347 347 ==== (% style="color:blue" %)**LON:**(%%) ==== 348 348 393 +**Example:** (0x60>>5) & 0x01=1. 394 + 349 349 Enable/Disable LED activity for uplink 350 350 351 351 ((( 352 -0x00: Disable LED indicator. 398 +(% style="color:#037691" %)**0x00:** (%%) Disable LED indicator. 353 353 ))) 354 354 355 355 ((( 356 -0x01: Enable LED indicator (Default Value) 402 +(% style="color:#037691" %)**0x01:** (%%) Enable LED indicator (Default Value) 357 357 ))) 358 358 359 359 406 + 360 360 ==== (% style="color:blue" %)**Hum:**(%%) ==== 361 361 362 362 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree ... ... @@ -371,7 +371,7 @@ 371 371 === 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 372 372 373 373 374 -The default uplink payload includes total ly11 bytes. The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)421 +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) 375 375 376 376 377 377 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -390,7 +390,7 @@ 390 390 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 391 391 392 392 393 -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.440 +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. 394 394 395 395 396 396 (% style="color:red" %)**Note for this mode:** ... ... @@ -397,6 +397,7 @@ 397 397 398 398 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 399 399 * 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. 447 +* 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 400 400 401 401 The payload is 15 bytes, as below. 402 402 ... ... @@ -442,7 +442,6 @@ 442 442 443 443 444 444 445 - 446 446 === 2.4.6 Add Payload format in TTN V3 === 447 447 448 448 ... ... @@ -454,8 +454,9 @@ 454 454 [[image:1664502649601-895.png]] 455 455 456 456 457 -Add the decoder from this link: 504 +Add the decoder from this link: 458 458 506 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 459 459 460 460 Save the change the uplink message will be parsed. As below: 461 461 ... ... @@ -498,10 +498,19 @@ 498 498 == 2.7 Datalog Feature == 499 499 500 500 501 -total 273 entries,by default disable549 +total 273 entries,by default, 502 502 551 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 503 503 553 +Example use case. 504 504 555 +[[image:image-20221009234703-2.png||height="328" width="899"]] 556 + 557 + 558 +[[image:image-20221009234629-1.png||height="390" width="577"]] 559 + 560 + 561 + 505 505 == 2.8 Alarm Mode == 506 506 507 507 ... ... @@ -552,9 +552,6 @@ 552 552 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 553 553 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 554 554 555 - 556 - 557 - 558 558 == 2.11 Button Function == 559 559 560 560 ... ... @@ -576,9 +576,6 @@ 576 576 |(% 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 577 577 |(% 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. 578 578 579 - 580 - 581 - 582 582 == 2.12 USB Port Function == 583 583 584 584 ... ... @@ -589,9 +589,6 @@ 589 589 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 590 590 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 591 591 592 - 593 - 594 - 595 595 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 596 596 597 597 ... ... @@ -739,37 +739,33 @@ 739 739 740 740 * (% style="color:blue" %)**AT Command:** 741 741 742 -(% style="color:#037691" %)**AT+SMOD=aa,bb** 790 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc** 743 743 744 744 (% style="color:#037691" %)** aa:** 745 745 746 -* (% style="color: #037691" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info.747 -* (% style="color: #037691" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.748 -* (% 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 positioning794 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 795 +* (% style="color:red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 796 +* (% 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. 749 749 750 750 (% style="color:#037691" %)**bb:** 751 751 752 -(% style="color:#037691" %)** if aa = 1: ** 800 +* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 801 +* (% style="color:red" %)**1 :**(%%) GPS +BAT State 753 753 754 -* (% style="color:#037691" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 755 -* (% style="color:#037691" %)**1 :**(%%) GPS +BAT State 803 +(% style="color:#037691" %)**cc: ** 756 756 757 -(% style="color: #037691" %)**faa= 2: **805 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 758 758 759 - *(% style="color:#037691" %)**3:(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State807 +(% style="color:blue" %)**Example:** 760 760 761 - **Example:** 809 + AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 810 + AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 811 + AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 762 762 763 - AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum 764 764 765 - AT+ SMOD =1,1 **~-~->** GPS +BAT State 766 - 767 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 768 - 769 - 770 770 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 771 771 772 -(% style="color:#037691" %)**0xA5 01 00** (%%) ~/~/ Same as AT+ SMOD =1,0 816 +(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ SMOD =1,0,0 773 773 774 774 775 775 ... ... @@ -786,7 +786,7 @@ 786 786 787 787 (% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 788 788 789 -Example: AT+FTIME=150 833 +**Example:** AT+FTIME=150 790 790 791 791 792 792 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** ... ... @@ -823,7 +823,7 @@ 823 823 824 824 * (% style="color:blue" %)**AT Command:** 825 825 826 -(% style="color:#037691" %)**AT+CFM=xx .**870 +(% style="color:#037691" %)**AT+CFM=xx** 827 827 828 828 829 829 **~ Example:** ... ... @@ -839,6 +839,27 @@ 839 839 840 840 841 841 886 +=== 3.2.10 Auto Send None-ACK messages === 887 + 888 + 889 +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. 890 + 891 + 892 +* (% style="color:blue" %)**AT Command: AT+PNACKMD** 893 + 894 +The default factory setting is 0. 895 + 896 + 897 +**Command Example Function Response:** 898 + 899 +(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 900 + 901 + 902 +* (% style="color:blue" %)**Downlink Command: 0x34** 903 + 904 +Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 905 + 906 + 842 842 = 4. Setting for Different Scenarios = 843 843 844 844 ... ... @@ -881,7 +881,7 @@ 881 881 882 882 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 883 883 884 -[[https:~~/~~/ www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]949 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] 885 885 886 886 887 887 Users need to use below files: ... ... @@ -985,7 +985,6 @@ 985 985 986 986 987 987 988 - 989 989 = 8. Order Info = 990 990 991 991 ... ... @@ -1003,7 +1003,6 @@ 1003 1003 1004 1004 1005 1005 1006 - 1007 1007 = 9. Packing Info = 1008 1008 1009 1009