Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 2 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - 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: 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;" %)1211 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 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 214 214 215 215 [[image:1665301570342-765.png]] ... ... @@ -253,11 +253,12 @@ 253 253 Use can also get the Device Status uplink through the downlink command: 254 254 255 255 256 + 256 256 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 257 257 258 -(% border="1.5" style="background-color:#ffffcc; color:green; width:2 70px" %)259 -| =(% scope="row" style="width:60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit260 -| =(% style="width:;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings259 +(% 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 261 261 262 262 (% style="color:blue" %)** SMOD:** 263 263 ... ... @@ -280,22 +280,31 @@ 280 280 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 281 281 282 282 284 + 283 283 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 284 284 285 -(% 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 Bit287 -| =(% style="width:;" %)**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"]]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 Bit 289 +|(% style="width:77px" %)**Value**|(% style="width:82px" %)Reserve|(% style="width:106px" %)PNACKMD|(% style="width:67px" %)LON|(% style="width:121px" %)Transport** **Mode 288 288 291 + 292 + 289 289 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 290 290 291 291 292 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, 293 293 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.(%%) 294 294 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))) 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 +))) 299 299 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 300 300 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 301 301 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] ... ... @@ -311,8 +311,8 @@ 311 311 312 312 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 313 313 314 -(% 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" %)1bit324 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 325 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 316 316 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 317 317 318 318 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -360,7 +360,7 @@ 360 360 361 361 ==== (% style="color:blue" %)**MOD:**(%%) ==== 362 362 363 -**Example: ** (0x60>>6) 373 +**Example: ** (0x60>>6)& 0x3f =1. 364 364 365 365 **Set the format of GPS data uplink link:** 366 366 ... ... @@ -403,7 +403,7 @@ 403 403 === 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 404 404 405 405 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 +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) 407 407 408 408 409 409 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) ... ... @@ -422,7 +422,7 @@ 422 422 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 423 423 424 424 425 -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 +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. 426 426 427 427 428 428 (% style="color:red" %)**Note for this mode:** ... ... @@ -429,7 +429,6 @@ 429 429 430 430 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 431 431 * 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. 432 -* 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 433 433 434 434 The payload is 15 bytes, as below. 435 435 ... ... @@ -446,11 +446,6 @@ 446 446 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 447 447 448 448 449 -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. 450 - 451 -User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 452 - 453 - 454 454 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 455 455 |=(% scope="row" style="width: 60px;" %)((( 456 456 **Size(bytes)** ... ... @@ -470,7 +470,7 @@ 470 470 [[image:1664502425687-834.png]] 471 471 472 472 473 -* (% style="color:#037691" %)**BAT: ** (%%) 477 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 474 474 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 475 475 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 476 476 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -489,9 +489,8 @@ 489 489 [[image:1664502649601-895.png]] 490 490 491 491 492 -Add the decoder from this link: 496 +Add the decoder from this link: 493 493 494 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 495 495 496 496 Save the change the uplink message will be parsed. As below: 497 497 ... ... @@ -502,10 +502,15 @@ 502 502 == 2.5 Integrate with Datacake == 503 503 504 504 508 +((( 505 505 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 +))) 506 506 512 +((( 507 507 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 +))) 508 508 516 + 509 509 [[image:1664502695771-538.png]] 510 510 511 511 ... ... @@ -513,12 +513,15 @@ 513 513 == 2.6 Integrate with Tago == 514 514 515 515 516 -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. 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 +))) 517 517 528 +((( 518 518 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 +))) 519 519 520 520 521 - 522 522 [[image:1664502715371-321.png]] 523 523 524 524 ... ... @@ -526,9 +526,8 @@ 526 526 == 2.7 Datalog Feature == 527 527 528 528 529 -total 273 entries,by default ,540 +total 273 entries,by default disable 530 530 531 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 532 532 533 533 Example use case. 534 534 ... ... @@ -548,7 +548,7 @@ 548 548 549 549 550 550 ((( 551 -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.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. 552 552 ))) 553 553 554 554 ... ... @@ -556,7 +556,7 @@ 556 556 Two ways to exit alarm mode: 557 557 ))) 558 558 559 -* Server send sa downlink command to exit.569 +* Server send a downlink command to exit. 560 560 * User fast press the RED button 10 times. 561 561 562 562 ((( ... ... @@ -644,9 +644,11 @@ 644 644 [[image:1664503022490-662.png]] 645 645 646 646 657 + 647 647 [[image:1664503035713-500.png]] 648 648 649 649 661 + 650 650 [[image:1664503047675-651.png]] 651 651 652 652 ... ... @@ -760,7 +760,7 @@ 760 760 === 3.2.7 Set Positioning Mode === 761 761 762 762 763 -SMOD define how TrackerD scan and uplink data: 775 +SMOD define the how TrackerD scan and uplink data: 764 764 765 765 766 766 * (% style="color:blue" %)**AT Command:** ... ... @@ -784,7 +784,7 @@ 784 784 785 785 (% style="color:blue" %)**Example:** 786 786 787 - AT+ SMOD =1,0,0 799 + AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 788 788 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 789 789 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 790 790 ... ... @@ -882,27 +882,6 @@ 882 882 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 883 883 884 884 885 - 886 -=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 887 - 888 - 889 -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. 890 - 891 -(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 892 - 893 -(% style="color:blue" %)**AT Command:** 894 - 895 - (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 896 - 897 - (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 898 - 899 - 900 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 901 - 902 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 903 - 904 - 905 - 906 906 = 4. Setting for Different Scenarios = 907 907 908 908 ... ... @@ -943,7 +943,6 @@ 943 943 [[image:1664503574618-659.png]] 944 944 945 945 946 - 947 947 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 948 948 949 949 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -989,18 +989,7 @@ 989 989 [[image:1664503715811-892.png]] 990 990 991 991 992 -(% 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. 993 993 994 -[[image:image-20221024105643-1.png]] 995 - 996 -**~ Figure1** 997 - 998 - 999 -[[image:image-20221024105643-2.png]] 1000 - 1001 - **Figure2** 1002 - 1003 - 1004 1004 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1005 1005 1006 1006 Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
- 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