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,31 +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 293 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 294 294 295 295 296 296 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, 297 297 298 -(% style="color:red" %)Please note that 15 bytes won't work on DR0 on US915/AU915 frequency band. IoT server will see NULL payload in this case.(%%) 299 299 300 - 301 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 302 -|=(% scope="row" style="width: 50px;" %)((( 303 -**Size(bytes)** 304 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 305 -2 306 -)))|(% style="width:87px" %)((( 307 -2 308 -))) 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))) 309 309 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 310 310 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 311 311 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] ... ... @@ -321,8 +321,8 @@ 321 321 322 322 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 323 323 324 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:2 50px" %)325 -|=(% 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 326 326 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 327 327 328 328 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -370,7 +370,7 @@ 370 370 371 371 ==== (% style="color:blue" %)**MOD:**(%%) ==== 372 372 373 -**Example: ** (0x60>>6)& 0x3f =1 .363 +**Example: ** (0x60>>6) & 0x3f =1 374 374 375 375 **Set the format of GPS data uplink link:** 376 376 ... ... @@ -413,13 +413,11 @@ 413 413 === 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 414 414 415 415 416 -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) 417 417 418 418 419 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 420 -|=(% scope="row" style="width: 50px;" %)((( 421 -**Size(bytes)** 422 -)))|(% 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 423 423 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 424 424 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 425 425 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -432,7 +432,7 @@ 432 432 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 433 433 434 434 435 -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. 436 436 437 437 438 438 (% style="color:red" %)**Note for this mode:** ... ... @@ -439,6 +439,7 @@ 439 439 440 440 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 441 441 * 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 442 442 443 443 The payload is 15 bytes, as below. 444 444 ... ... @@ -455,6 +455,11 @@ 455 455 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 456 456 457 457 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 + 458 458 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 459 459 |=(% scope="row" style="width: 60px;" %)((( 460 460 **Size(bytes)** ... ... @@ -474,7 +474,7 @@ 474 474 [[image:1664502425687-834.png]] 475 475 476 476 477 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 471 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 478 478 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 479 479 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 480 480 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -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 ((( ... ... @@ -654,11 +654,9 @@ 654 654 [[image:1664503022490-662.png]] 655 655 656 656 657 - 658 658 [[image:1664503035713-500.png]] 659 659 660 660 661 - 662 662 [[image:1664503047675-651.png]] 663 663 664 664 ... ... @@ -772,7 +772,7 @@ 772 772 === 3.2.7 Set Positioning Mode === 773 773 774 774 775 -SMOD define the how TrackerD scan and uplink data:761 +SMOD define how TrackerD scan and uplink data: 776 776 777 777 778 778 * (% style="color:blue" %)**AT Command:** ... ... @@ -796,7 +796,7 @@ 796 796 797 797 (% style="color:blue" %)**Example:** 798 798 799 - AT+ SMOD =1,0 785 + AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 800 800 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 801 801 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 802 802 ... ... @@ -894,6 +894,27 @@ 894 894 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 895 895 896 896 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 + 897 897 = 4. Setting for Different Scenarios = 898 898 899 899 ... ... @@ -934,6 +934,7 @@ 934 934 [[image:1664503574618-659.png]] 935 935 936 936 944 + 937 937 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 938 938 939 939 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -979,7 +979,18 @@ 979 979 [[image:1664503715811-892.png]] 980 980 981 981 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. 982 982 992 +[[image:image-20221024105643-1.png]] 993 + 994 +**~ Figure1** 995 + 996 + 997 +[[image:image-20221024105643-2.png]] 998 + 999 + **Figure2** 1000 + 1001 + 983 983 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 984 984 985 985 Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
- 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