Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 2 removed)
Details
- Page properties
-
- Content
-
... ... @@ -208,11 +208,9 @@ 208 208 209 209 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 -Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 212 212 213 - 214 214 (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 215 -|=(% style="width: 60px;" %)**Size(bytes)**|=(% style="width:70px;" %)**1**|=(% style="width:70px;" %)**2**|=(% style="width:70px;" %)**1**|=(% style="width:50px;" %)**1**|=(% style="width:30px;" %)2|=(% style="width:40px;" %)**2**|=(% style="width:40px;" %)1213 +|=(% 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 216 216 |=(% 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 217 217 218 218 [[image:1665301570342-765.png]] ... ... @@ -255,45 +255,50 @@ 255 255 256 256 Use can also get the Device Status uplink through the downlink command: 257 257 256 +TrackerD Model:0x40 258 258 259 -(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 258 +(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %) 259 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit 260 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD 260 260 261 -(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %) 262 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit 263 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings 262 +(% style="color:blue" %)**SMOD:** 264 264 265 -(% style="color: blue" %)**MOD:**264 +(% style="color:red" %)**1 :** (%%) GPS ONLY 266 266 267 -(% style="color:red" %)** 1:** (%%)GPSONLY266 +(% style="color:red" %)**2 :** (%%) BLE ONLY 268 268 269 -(% style="color:red" %)** 2:** (%%)ONLY268 +(% style="color:red" %)**3 :** (%%) GPS/BLE Hybrid 270 270 271 -(% style="color:red" %)** 3 :** (%%) GPS/BLE Hybrid 272 272 271 +(% style="color:blue" %)**GPS MOD:** 273 273 274 -(% style="color: blue" %)**GPS_MOD: DefinehowtosendGPSpayload**273 +(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values 275 275 276 -(% style="color:red" %)** 0:Enable275 +(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values 277 277 278 -(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values 279 279 278 +(% style="color:blue" %)**BLE MOD:** 280 280 281 -(% style="color: blue" %)**_Settings:**280 +(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon 282 282 283 - (% style="color:red"%)** 1: ** (%%) BLE Positioning withStrongestiBeacon282 +TrackerD Status: 0x02 284 284 284 +(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %) 285 +|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit 286 +|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode 285 285 286 -(% style="color: #037691" %)**StatusField(total 1 byte)**(%%):0x02288 +(% style="color:red" %)**0 : **(%%) Transport Mode 287 287 288 -(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %) 289 -|(% 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 290 -|(% 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 +(% style="color:red" %)**1 : **(%%) AT+LON 291 291 292 +(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable 292 292 294 + 295 + 293 293 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 294 294 295 295 296 -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,299 +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. 297 297 298 298 299 299 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -317,6 +317,8 @@ 317 317 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 318 318 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 319 319 323 + 324 + 320 320 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 321 321 322 322 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) ... ... @@ -367,10 +367,9 @@ 367 367 * < 3.39v: 0~~20% 368 368 369 369 375 + 370 370 ==== (% style="color:blue" %)**MOD:**(%%) ==== 371 371 372 -**Example: ** (0x60>>6) & 0x3f =1 373 - 374 374 **Set the format of GPS data uplink link:** 375 375 376 376 (% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values ... ... @@ -382,10 +382,12 @@ 382 382 (% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon 383 383 384 384 385 - ==== (% style="color:blue"%)**LON:**(%%) ====389 +**Example: ** (0x60>>6)& 0x3f =1. 386 386 387 -**Example:** (0x60>>5) & 0x01=1. 388 388 392 + 393 +==== (% style="color:blue" %)**LON:**(%%) ==== 394 + 389 389 Enable/Disable LED activity for uplink 390 390 391 391 ((( ... ... @@ -396,6 +396,7 @@ 396 396 (% style="color:#037691" %)**0x01:** (%%) Enable LED indicator (Default Value) 397 397 ))) 398 398 405 +**Example:** (0x60>>5) & 0x01=1. 399 399 400 400 401 401 ==== (% style="color:blue" %)**Hum:**(%%) ==== ... ... @@ -412,7 +412,7 @@ 412 412 === 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 413 413 414 414 415 -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)422 +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) 416 416 417 417 418 418 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -431,7 +431,7 @@ 431 431 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 432 432 433 433 434 -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.441 +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. 435 435 436 436 437 437 (% style="color:red" %)**Note for this mode:** ... ... @@ -438,7 +438,6 @@ 438 438 439 439 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 440 440 * 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. 441 -* 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 442 442 443 443 The payload is 15 bytes, as below. 444 444 ... ... @@ -455,11 +455,6 @@ 455 455 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 456 456 457 457 458 -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. 459 - 460 -User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 461 - 462 - 463 463 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 464 464 |=(% scope="row" style="width: 60px;" %)((( 465 465 **Size(bytes)** ... ... @@ -479,7 +479,7 @@ 479 479 [[image:1664502425687-834.png]] 480 480 481 481 482 -* (% style="color:#037691" %)**BAT: ** (%%) 483 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 483 483 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 484 484 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 485 485 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -499,9 +499,8 @@ 499 499 [[image:1664502649601-895.png]] 500 500 501 501 502 -Add the decoder from this link: 503 +Add the decoder from this link: 503 503 504 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 505 505 506 506 Save the change the uplink message will be parsed. As below: 507 507 ... ... @@ -512,10 +512,15 @@ 512 512 == 2.5 Integrate with Datacake == 513 513 514 514 515 +((( 515 515 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. 517 +))) 516 516 519 +((( 517 517 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]] 521 +))) 518 518 523 + 519 519 [[image:1664502695771-538.png]] 520 520 521 521 ... ... @@ -523,12 +523,15 @@ 523 523 == 2.6 Integrate with Tago == 524 524 525 525 526 -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. 531 +((( 532 +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. 533 +))) 527 527 535 +((( 528 528 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]] 537 +))) 529 529 530 530 531 - 532 532 [[image:1664502715371-321.png]] 533 533 534 534 ... ... @@ -536,9 +536,8 @@ 536 536 == 2.7 Datalog Feature == 537 537 538 538 539 -total 273 entries,by default ,547 +total 273 entries,by default disable 540 540 541 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 542 542 543 543 Example use case. 544 544 ... ... @@ -558,7 +558,7 @@ 558 558 559 559 560 560 ((( 561 -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.568 +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. 562 562 ))) 563 563 564 564 ... ... @@ -566,7 +566,7 @@ 566 566 Two ways to exit alarm mode: 567 567 ))) 568 568 569 -* Server send sa downlink command to exit.576 +* Server send a downlink command to exit. 570 570 * User fast press the RED button 10 times. 571 571 572 572 ((( ... ... @@ -600,6 +600,7 @@ 600 600 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 601 601 602 602 610 + 603 603 == 2.11 Button Function == 604 604 605 605 ... ... @@ -622,6 +622,7 @@ 622 622 |(% 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. 623 623 624 624 633 + 625 625 == 2.12 USB Port Function == 626 626 627 627 ... ... @@ -657,9 +657,11 @@ 657 657 [[image:1664503022490-662.png]] 658 658 659 659 669 + 660 660 [[image:1664503035713-500.png]] 661 661 662 662 673 + 663 663 [[image:1664503047675-651.png]] 664 664 665 665 ... ... @@ -773,7 +773,7 @@ 773 773 === 3.2.7 Set Positioning Mode === 774 774 775 775 776 -SMOD define how TrackerD scan and uplink data: 787 +SMOD define the how TrackerD scan and uplink data: 777 777 778 778 779 779 * (% style="color:blue" %)**AT Command:** ... ... @@ -797,7 +797,7 @@ 797 797 798 798 (% style="color:blue" %)**Example:** 799 799 800 - AT+ SMOD =1,0,0 811 + AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 801 801 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 802 802 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 803 803 ... ... @@ -895,27 +895,6 @@ 895 895 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 896 896 897 897 898 - 899 -=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 900 - 901 - 902 -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. 903 - 904 -(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 905 - 906 -(% style="color:blue" %)**AT Command:** 907 - 908 - (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 909 - 910 - (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 911 - 912 - 913 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 914 - 915 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 916 - 917 - 918 - 919 919 = 4. Setting for Different Scenarios = 920 920 921 921 ... ... @@ -956,7 +956,6 @@ 956 956 [[image:1664503574618-659.png]] 957 957 958 958 959 - 960 960 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 961 961 962 962 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -1002,18 +1002,7 @@ 1002 1002 [[image:1664503715811-892.png]] 1003 1003 1004 1004 1005 -(% id="cke_bm_4554S" style="display:none" %) (%%)Find the path of SP32 installation, find the file as shown in Figure 1, and change the SPI pin to the shown in Figure 2. 1006 1006 1007 -[[image:image-20221024105643-1.png]] 1008 - 1009 -**~ Figure1** 1010 - 1011 - 1012 -[[image:image-20221024105643-2.png]] 1013 - 1014 - **Figure2** 1015 - 1016 - 1017 1017 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1018 1018 1019 1019 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1073,6 +1073,7 @@ 1073 1073 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 1074 1074 1075 1075 1054 + 1076 1076 = 8. Order Info = 1077 1077 1078 1078
- image-20221024105643-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -11.3 KB - Content
- image-20221024105643-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.5 KB - Content