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,11 +403,13 @@ 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 -(% 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 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 411 411 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 412 412 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 413 413 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] ... ... @@ -420,7 +420,7 @@ 420 420 === 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 421 421 422 422 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 +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. 424 424 425 425 426 426 (% style="color:red" %)**Note for this mode:** ... ... @@ -427,7 +427,6 @@ 427 427 428 428 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 429 429 * 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 431 431 432 432 The payload is 15 bytes, as below. 433 433 ... ... @@ -444,11 +444,6 @@ 444 444 === 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 445 445 446 446 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 - 452 452 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 453 453 |=(% scope="row" style="width: 60px;" %)((( 454 454 **Size(bytes)** ... ... @@ -468,7 +468,7 @@ 468 468 [[image:1664502425687-834.png]] 469 469 470 470 471 -* (% style="color:#037691" %)**BAT: ** (%%) 477 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 472 472 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 473 473 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 474 474 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -487,9 +487,8 @@ 487 487 [[image:1664502649601-895.png]] 488 488 489 489 490 -Add the decoder from this link: 496 +Add the decoder from this link: 491 491 492 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 493 493 494 494 Save the change the uplink message will be parsed. As below: 495 495 ... ... @@ -500,10 +500,15 @@ 500 500 == 2.5 Integrate with Datacake == 501 501 502 502 508 +((( 503 503 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 +))) 504 504 512 +((( 505 505 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 +))) 506 506 516 + 507 507 [[image:1664502695771-538.png]] 508 508 509 509 ... ... @@ -511,12 +511,15 @@ 511 511 == 2.6 Integrate with Tago == 512 512 513 513 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. 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 +))) 515 515 528 +((( 516 516 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 +))) 517 517 518 518 519 - 520 520 [[image:1664502715371-321.png]] 521 521 522 522 ... ... @@ -524,9 +524,8 @@ 524 524 == 2.7 Datalog Feature == 525 525 526 526 527 -total 273 entries,by default ,540 +total 273 entries,by default disable 528 528 529 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 530 530 531 531 Example use case. 532 532 ... ... @@ -546,7 +546,7 @@ 546 546 547 547 548 548 ((( 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 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. 550 550 ))) 551 551 552 552 ... ... @@ -554,7 +554,7 @@ 554 554 Two ways to exit alarm mode: 555 555 ))) 556 556 557 -* Server send sa downlink command to exit.569 +* Server send a downlink command to exit. 558 558 * User fast press the RED button 10 times. 559 559 560 560 ((( ... ... @@ -642,9 +642,11 @@ 642 642 [[image:1664503022490-662.png]] 643 643 644 644 657 + 645 645 [[image:1664503035713-500.png]] 646 646 647 647 661 + 648 648 [[image:1664503047675-651.png]] 649 649 650 650 ... ... @@ -758,7 +758,7 @@ 758 758 === 3.2.7 Set Positioning Mode === 759 759 760 760 761 -SMOD define how TrackerD scan and uplink data: 775 +SMOD define the how TrackerD scan and uplink data: 762 762 763 763 764 764 * (% style="color:blue" %)**AT Command:** ... ... @@ -782,7 +782,7 @@ 782 782 783 783 (% style="color:blue" %)**Example:** 784 784 785 - AT+ SMOD =1,0,0 799 + AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 786 786 AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 787 787 AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 788 788 ... ... @@ -880,27 +880,6 @@ 880 880 Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 881 881 882 882 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 - 904 904 = 4. Setting for Different Scenarios = 905 905 906 906 ... ... @@ -941,7 +941,6 @@ 941 941 [[image:1664503574618-659.png]] 942 942 943 943 944 - 945 945 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 946 946 947 947 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -987,18 +987,7 @@ 987 987 [[image:1664503715811-892.png]] 988 988 989 989 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. 991 991 992 -[[image:image-20221024105643-1.png]] 993 - 994 -**~ Figure1** 995 - 996 - 997 -[[image:image-20221024105643-2.png]] 998 - 999 - **Figure2** 1000 - 1001 - 1002 1002 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1003 1003 1004 1004 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