Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/14 16:33
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.Xiaoling - Content
-
... ... @@ -208,8 +208,8 @@ 208 208 Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 209 209 210 210 211 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 520px" %)212 -|=(% s cope="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;" %)1211 +(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %) 212 +|=(% 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;" %)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 214 214 215 215 [[image:1665301570342-765.png]] ... ... @@ -253,12 +253,11 @@ 253 253 Use can also get the Device Status uplink through the downlink command: 254 254 255 255 256 - 257 257 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 258 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" %)4bit261 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:1 37px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings258 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %) 259 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit 260 +|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings 262 262 263 263 (% style="color:blue" %)** SMOD:** 264 264 ... ... @@ -281,30 +281,22 @@ 281 281 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 282 282 283 283 284 - 285 285 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 286 286 287 -(% border="1.5" style="background-color:#ffffcc; color:green; width: 450px" %)288 -|(% style="width: 77px" %)**Size(bit)**|(% style="width:82px" %)5 Bits|(% style="width:106px" %)1 Bit|(% style="width:67px" %)1 Bit|(% style="width:121px" %)1 Bit289 -|(% style="width:77px" %)**Value**|(% style="width: 82px" %)Reserve|(% style="width:106px" %)PNACKMD|(% style="width:67px" %)LON|(% style="width:121px" %)Transport****Mode285 +(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %) 286 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)5 Bits|(% style="width:60px" %)1 Bit|(% style="width:20px" %)1 Bit|(% style="width:80px" %)1 Bit 287 +|=(% 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 290 291 - 292 - 293 - 294 294 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 295 295 296 296 297 -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.292 +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, 298 298 299 299 300 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 301 -|=(% scope="row" style="width: 50px;" %)((( 302 -**Size(bytes)** 303 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 304 -2 305 -)))|(% style="width:87px" %)((( 306 -2 307 -))) 295 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %) 296 +|=(% scope="row" style="width: 60px;" %)((( 297 +**Size(bytes)**)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)((( 298 +2)))|(% style="width:30px" %)(((2))) 308 308 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 309 309 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 310 310 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] ... ... @@ -320,8 +320,8 @@ 320 320 321 321 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 322 322 323 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:2 50px" %)324 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width: 50px" %)2bits|(% style="width:50px" %)1bit314 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %) 315 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit 325 325 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 326 326 327 327 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -369,7 +369,7 @@ 369 369 370 370 ==== (% style="color:blue" %)**MOD:**(%%) ==== 371 371 372 -**Example: ** (0x60>>6)& 0x3f =1 .363 +**Example: ** (0x60>>6) & 0x3f =1 373 373 374 374 **Set the format of GPS data uplink link:** 375 375 ... ... @@ -412,13 +412,11 @@ 412 412 === 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 413 413 414 414 415 -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)406 +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) 416 416 417 417 418 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 419 -|=(% scope="row" style="width: 50px;" %)((( 420 -**Size(bytes)** 421 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1 409 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %) 410 +|=(% scope="row" style="width: 60px;" %)(((**Size(bytes)**)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1 422 422 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 423 423 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 424 424 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -431,7 +431,7 @@ 431 431 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 432 432 433 433 434 -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.423 +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. 435 435 436 436 437 437 (% style="color:red" %)**Note for this mode:** ... ... @@ -438,10 +438,11 @@ 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. 430 +* 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 441 441 442 442 The payload is 15 bytes, as below. 443 443 444 -(% border="1.5" style="background-color:#ffffcc; color:green; width:5 20px" %)434 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 445 445 |=(% scope="row" %)((( 446 446 **Size(bytes)** 447 447 )))|4|4|2|1|1|1|1|1 ... ... @@ -454,6 +454,11 @@ 454 454 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 455 455 456 456 447 +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. 448 + 449 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 450 + 451 + 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: ** (%%) Ex1: 471 +* (% 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. ... ... @@ -481,7 +481,6 @@ 481 481 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 482 482 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 483 483 484 - 485 485 === 2.4.6 Add Payload format in TTN V3 === 486 486 487 487 ... ... @@ -493,8 +493,9 @@ 493 493 [[image:1664502649601-895.png]] 494 494 495 495 496 -Add the decoder from this link: 490 +Add the decoder from this link: 497 497 492 +[[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 ... ... @@ -505,15 +505,10 @@ 505 505 == 2.5 Integrate with Datacake == 506 506 507 507 508 -((( 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. 510 -))) 511 511 512 -((( 513 513 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]] 514 -))) 515 515 516 - 517 517 [[image:1664502695771-538.png]] 518 518 519 519 ... ... @@ -521,15 +521,12 @@ 521 521 == 2.6 Integrate with Tago == 522 522 523 523 524 -((( 525 -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. 526 -))) 514 +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. 527 527 528 -((( 529 529 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]] 530 -))) 531 531 532 532 519 + 533 533 [[image:1664502715371-321.png]] 534 534 535 535 ... ... @@ -537,8 +537,9 @@ 537 537 == 2.7 Datalog Feature == 538 538 539 539 540 -total 273 entries,by default disable527 +total 273 entries,by default, 541 541 529 +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 alert mode. 549 +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 exits 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 a downlink command to exit. 557 +* Server sends a downlink command to exit. 570 570 * User fast press the RED button 10 times. 571 571 572 572 ((( ... ... @@ -599,7 +599,6 @@ 599 599 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 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 - 603 603 == 2.11 Button Function == 604 604 605 605 ... ... @@ -621,7 +621,6 @@ 621 621 |(% 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 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 - 625 625 == 2.12 USB Port Function == 626 626 627 627 ... ... @@ -632,7 +632,6 @@ 632 632 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 633 633 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 634 634 635 - 636 636 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 637 637 638 638 ... ... @@ -657,11 +657,9 @@ 657 657 [[image:1664503022490-662.png]] 658 658 659 659 660 - 661 661 [[image:1664503035713-500.png]] 662 662 663 663 664 - 665 665 [[image:1664503047675-651.png]] 666 666 667 667 ... ... @@ -775,7 +775,7 @@ 775 775 === 3.2.7 Set Positioning Mode === 776 776 777 777 778 -SMOD define the how TrackerD scan and uplink data:761 +SMOD define how TrackerD scan and uplink data: 779 779 780 780 781 781 * (% style="color:blue" %)**AT Command:** ... ... @@ -799,7 +799,7 @@ 799 799 800 800 (% style="color:blue" %)**Example:** 801 801 802 - AT+ SMOD =1,0 785 + AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 803 803 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 804 804 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 805 805 ... ... @@ -897,6 +897,27 @@ 897 897 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 898 898 899 899 883 + 884 +=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 885 + 886 + 887 +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. 888 + 889 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 890 + 891 +(% style="color:blue" %)**AT Command:** 892 + 893 + (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 894 + 895 + (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 896 + 897 + 898 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 899 + 900 +Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 901 + 902 + 903 + 900 900 = 4. Setting for Different Scenarios = 901 901 902 902 ... ... @@ -937,6 +937,7 @@ 937 937 [[image:1664503574618-659.png]] 938 938 939 939 944 + 940 940 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 941 941 942 942 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -982,7 +982,18 @@ 982 982 [[image:1664503715811-892.png]] 983 983 984 984 990 +(% 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. 985 985 992 +[[image:image-20221024105643-1.png]] 993 + 994 +**~ Figure1** 995 + 996 + 997 +[[image:image-20221024105643-2.png]] 998 + 999 + **Figure2** 1000 + 1001 + 986 986 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 987 987 988 988 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1041,7 +1041,6 @@ 1041 1041 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 1042 1042 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 1043 1043 1044 - 1045 1045 = 8. Order Info = 1046 1046 1047 1047 ... ... @@ -1057,7 +1057,6 @@ 1057 1057 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 1058 1058 * (% style="color:red" %)**US915**(%%): Default frequency band US915 1059 1059 1060 - 1061 1061 = 9. Packing Info = 1062 1062 1063 1063 ... ... @@ -1071,7 +1071,6 @@ 1071 1071 * Device Size: 85 x 48 x 15 cm 1072 1072 * Weight: 50g 1073 1073 1074 - 1075 1075 = 10. Support = 1076 1076 1077 1077 ... ... @@ -1078,7 +1078,6 @@ 1078 1078 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 1079 1079 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]. 1080 1080 1081 - 1082 1082 = 11. Reference = 1083 1083 1084 1084
- image-20221024105643-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +11.3 KB - Content
- image-20221024105643-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +64.5 KB - Content