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, 10 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -127,7 +127,7 @@ 127 127 128 128 129 129 130 -= 2. 1130 += 2. Use TrackerD = 131 131 132 132 133 133 == 2.1 How it works? == ... ... @@ -195,9 +195,9 @@ 195 195 196 196 Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 197 197 198 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%) only get and uplink GPS location info.199 -* (% style="color:#037691" %)**BLE ONLY: 200 -* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 198 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 199 +* (% style="color:#037691" %)**BLE or WiFi ONLY: **(%%)** **Only obtain iBeacon info via BLE and uplink or obtain wifi ssid info via WiFi and uplink. Design for Indoor tracking. 200 +* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking. Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 201 201 202 202 Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 203 203 ... ... @@ -211,9 +211,11 @@ 211 211 212 212 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. 213 213 214 +Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 214 214 215 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 216 -|=(% 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 + 217 +(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %) 218 +|=(% 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 217 217 |=(% 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 218 218 219 219 [[image:1665301570342-765.png]] ... ... @@ -256,43 +256,41 @@ 256 256 257 257 Use can also get the Device Status uplink through the downlink command: 258 258 259 -TrackerD Model:0x40 260 260 261 -(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %) 262 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit 263 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD 262 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 264 264 265 -(% style="color:blue" %)**SMOD:** 264 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %) 265 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit 266 +|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings 266 266 267 -(% style="color: red" %)**1:**(%%)GPSONLY268 +(% style="color:blue" %)** SMOD:** 268 268 269 -(% style="color:red" %)** 2:** (%%)BLEONLY270 +(% style="color:red" %)** 1 :** (%%) GPS ONLY 270 270 271 -(% style="color:red" %)** 3:**GPS/BLEHybrid272 +(% style="color:red" %)** 2 :** (%%) BLE ONLY 272 272 274 +(% style="color:red" %)** 3 :** (%%) GPS/BLE Hybrid 273 273 274 -(% style="color:blue" %)**GPS MOD:** 275 275 276 -(% style="color: red" %)**0:**(%%)Enableuploadingon-boardTemperatureandhumidityvalues277 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload** 277 277 278 -(% style="color:red" %)** 1:** (%%)Disable279 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values 279 279 281 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values 280 280 281 -(% style="color:blue" %)**BLE MOD:** 282 282 283 -(% style="color: red" %)**1:**(%%)BLEPositioning withStrongestBeacon284 +(% style="color:blue" %)** BLE_Settings:** 284 284 285 - TrackerDStatus:0x02286 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 286 286 287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %) 288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit 289 -|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode 288 +(% style="color:red" %)** 2:** (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%) 290 290 291 -(% style="color:red" %)**0 : **(%%) Transport Mode 292 292 293 -(% style="color: red" %)**1:**(%%)AT+LON291 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 294 294 295 -(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable 293 +(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %) 294 +|=(% 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 295 +|=(% 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"]] 296 296 297 297 298 298 ... ... @@ -299,15 +299,15 @@ 299 299 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 300 300 301 301 302 -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.302 +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, 303 303 304 304 305 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 480px" %)306 -|=(% scope="row" style="width: 50px;" %)(((305 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %) 306 +|=(% scope="row" style="width: 60px;" %)((( 307 307 **Size(bytes)** 308 -)))|(% style="width: 60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((308 +)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)((( 309 309 2 310 -)))|(% style="width: 87px" %)(((310 +)))|(% style="width:30px" %)((( 311 311 2 312 312 ))) 313 313 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( ... ... @@ -327,8 +327,8 @@ 327 327 328 328 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 329 329 330 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:2 50px" %)331 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width: 50px" %)2bits|(% style="width:50px" %)1bit330 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %) 331 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit 332 332 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 333 333 334 334 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ... ... @@ -357,12 +357,12 @@ 357 357 358 358 ==== (% style="color:blue" %)**Alarm:**(%%) ==== 359 359 360 -Example: 360 +**Example: ** 0x4B & 0x40 >> 6 = 0x01 361 361 362 362 363 363 ==== (% style="color:blue" %)**BAT:**(%%) ==== 364 364 365 -Example: 0CDD& 0x3FFF ⇒3293(mV).365 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV). 366 366 367 367 ((( 368 368 The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ ... ... @@ -378,23 +378,31 @@ 378 378 379 379 ==== (% style="color:blue" %)**MOD:**(%%) ==== 380 380 381 - SettheformatofGPS data uplink link381 +**Example: ** (0x60>>6) & 0x3f =1 382 382 383 - 0x00:Enableuploadingon-boardTemperatureandhumidityvalues383 +**Set the format of GPS data uplink link:** 384 384 385 -0x01: Disable uploading on-board Temperature and humidity values 385 +(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values 386 +(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values 386 386 387 387 389 +**Set the format of BLE data uplink link:** 390 + 391 +(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon 392 + 393 + 388 388 ==== (% style="color:blue" %)**LON:**(%%) ==== 389 389 396 +**Example:** (0x60>>5) & 0x01=1. 397 + 390 390 Enable/Disable LED activity for uplink 391 391 392 392 ((( 393 -0x00: Disable LED indicator. 401 +(% style="color:#037691" %)**0x00:** (%%) Disable LED indicator. 394 394 ))) 395 395 396 396 ((( 397 -0x01: Enable LED indicator (Default Value) 405 +(% style="color:#037691" %)**0x01:** (%%) Enable LED indicator (Default Value) 398 398 ))) 399 399 400 400 ... ... @@ -412,13 +412,13 @@ 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)423 +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;" %)(((426 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %) 427 +|=(% scope="row" style="width: 60px;" %)((( 420 420 **Size(bytes)** 421 -)))|(% style="width:60px" %)4|(% style="width: 70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1429 +)))|(% 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,17 +431,18 @@ 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.442 +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 438 439 439 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 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. 448 +* b) TrackerD will send data in CONFIRMED Mode when PNACKMD=1 and CFM=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. 449 +* 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" %)453 +(% 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 466 +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. 467 + 468 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 469 + 470 + 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: 490 +* (% 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. ... ... @@ -483,11 +483,35 @@ 483 483 484 484 485 485 486 -=== 2.4.6 AddPayloadformat inTTNV3===500 +=== 2.4.6 Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID(Since firmware 1.4.1) === 487 487 488 488 489 - InTTNV3,usecanaddacustompayloadso itshows friendly.503 +TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **WiFi** so TrackerD will scan WiFi and find the strongest WiFi info and uplink. 490 490 505 + 506 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %) 507 +|=(% scope="row" style="width: 60px;" %)((( 508 +**Size(bytes)** 509 +)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1 510 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)((( 511 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 512 +)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]] 513 + 514 +(% class="wikigeneratedid" %) 515 +[[image:1667288597595-714.png||height="212" width="1151"]] 516 + 517 + 518 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 519 +* (% style="color:#037691" %)**SSID: **(%%)WiFi name. 520 +* (% style="color:#037691" %)**RSSI: **(%%)The RSSI from the strongest WiFi. 521 + 522 + 523 + 524 +=== 2.4.7 Add Payload format in TTN V3 === 525 + 526 + 527 +In TTN V3, user can add a custom payload so it shows friendly. 528 + 491 491 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 492 492 493 493 ... ... @@ -494,8 +494,9 @@ 494 494 [[image:1664502649601-895.png]] 495 495 496 496 497 -Add the decoder from this link: 535 +Add the decoder from this link: 498 498 537 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 499 499 500 500 Save the change the uplink message will be parsed. As below: 501 501 ... ... @@ -506,15 +506,10 @@ 506 506 == 2.5 Integrate with Datacake == 507 507 508 508 509 -((( 510 510 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. 511 -))) 512 512 513 -((( 514 514 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]] 515 -))) 516 516 517 - 518 518 [[image:1664502695771-538.png]] 519 519 520 520 ... ... @@ -522,15 +522,12 @@ 522 522 == 2.6 Integrate with Tago == 523 523 524 524 525 -((( 526 -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. 527 -))) 559 +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. 528 528 529 -((( 530 530 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]] 531 -))) 532 532 533 533 564 + 534 534 [[image:1664502715371-321.png]] 535 535 536 536 ... ... @@ -538,8 +538,9 @@ 538 538 == 2.7 Datalog Feature == 539 539 540 540 541 -total 273 entries,by default disable572 +total 273 entries,by default, 542 542 574 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 543 543 544 544 Example use case. 545 545 ... ... @@ -559,7 +559,7 @@ 559 559 560 560 561 561 ((( 562 -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. 594 +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. 563 563 ))) 564 564 565 565 ... ... @@ -567,7 +567,7 @@ 567 567 Two ways to exit alarm mode: 568 568 ))) 569 569 570 -* Server send a downlink command to exit. 602 +* Server sends a downlink command to exit. 571 571 * User fast press the RED button 10 times. 572 572 573 573 ((( ... ... @@ -617,8 +617,8 @@ 617 617 [[image:1664502854406-763.png]] 618 618 619 619 620 -(% border="1 .5" style="background-color:#ffffcc; color:green; width:520px" %)621 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 2 10px;" %)**Action**|=(% style="width: 210px;" %)**Description**652 +(% border="1" style="background-color:#ffffcc; color:green; width:510px" %) 653 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description** 622 622 |(% style="width:135px" %)Send Alarm|(% style="width:220px" %)Keep Pressing (% style="color:red" %)**RED**(%%) button for more than 5 seconds|(% style="width:265px" %)Enter Alarm Mode. See [[Alarm Mode>>||anchor="H2.6AlarmMode"]] 623 623 |(% 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 624 624 |(% 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. ... ... @@ -661,11 +661,9 @@ 661 661 [[image:1664503022490-662.png]] 662 662 663 663 664 - 665 665 [[image:1664503035713-500.png]] 666 666 667 667 668 - 669 669 [[image:1664503047675-651.png]] 670 670 671 671 ... ... @@ -723,7 +723,7 @@ 723 723 724 724 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** 725 725 726 -(% style="color:#037691" %)**0x03 00 01 2C** (%%) ~/~/ Same as AT+ 756 +(% style="color:#037691" %)**0x03 00 01 2C** (%%) ~/~/ Same as AT+MTDC=3000000 727 727 728 728 729 729 ... ... @@ -767,12 +767,12 @@ 767 767 768 768 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 769 769 770 -Example: AT+ 800 +Example: AT+INTWK=1 **~-~-> ** Enable Transport Mode. 771 771 772 772 773 773 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** 774 774 775 -(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/ Same as AT+ 805 +(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/ Same as AT+INTWK=1 776 776 777 777 778 778 ... ... @@ -779,7 +779,7 @@ 779 779 === 3.2.7 Set Positioning Mode === 780 780 781 781 782 -SMOD define the how TrackerD scan and uplink data:812 +SMOD define how TrackerD scan and uplink data: 783 783 784 784 785 785 * (% style="color:blue" %)**AT Command:** ... ... @@ -788,30 +788,36 @@ 788 788 789 789 (% style="color:#037691" %)** aa:** 790 790 791 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%) only get and uplink GPS location info.792 -* (% style="color:red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 793 -* (% style="color:red" %)**3: GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 821 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 822 +* (% style="color:red" %)**2: BLE or WiFi ONLY: **(%%)Only obtain iBeacon info via BLE and uplink or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking. 823 +* (% style="color:red" %)**3: GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 794 794 795 795 (% style="color:#037691" %)**bb:** 796 796 797 797 * (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 828 + 798 798 * (% style="color:red" %)**1 :**(%%) GPS +BAT State 799 799 800 800 (% style="color:#037691" %)**cc: ** 801 801 802 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 833 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 834 + 835 +* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%)) 803 803 804 - 805 805 (% style="color:blue" %)**Example:** 806 806 807 - AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 808 - AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 809 - AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 839 + AT+SMOD=1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 810 810 841 + AT+SMOD=1,1,0 ~-~-> GPS +BAT State 811 811 843 + AT+SMOD=2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 844 + 845 + AT+SMOD=2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 846 + 847 + 812 812 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 813 813 814 -(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ 850 +(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+SMOD=1,0,0 815 815 816 816 817 817 ... ... @@ -865,22 +865,110 @@ 865 865 866 866 * (% style="color:blue" %)**AT Command:** 867 867 868 -(% style="color:#037691" %)**AT+CFM=xx .**904 +(% style="color:#037691" %)**AT+CFM=xx** 869 869 870 870 871 871 **~ Example:** 872 872 873 - AT+ 909 + AT+CFM=0 **~-~-> ** Disable confirmation 874 874 875 - AT+ 911 + AT+CFM=1 **~-~-> ** Enable confirmation 876 876 877 877 878 878 * (% style="color:blue" %)**Downlink Payload (prefix 0x05):** 879 879 880 -(% style="color:#037691" %)**0x05 01 **(%%) ~/~/ Same as AT+ SMOD=1916 +(% style="color:#037691" %)**0x05 01 **(%%) ~/~/ Same as AT+CFM=1 881 881 882 882 883 883 920 +=== 3.2.10 Auto Send None-ACK messages === 921 + 922 + 923 +TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message. 924 + 925 + 926 +* (% style="color:blue" %)**AT Command: AT+PNACKMD** 927 + 928 +The default factory setting is 0. 929 + 930 + 931 +**Command Example Function Response:** 932 + 933 +(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 934 + 935 + 936 +* (% style="color:blue" %)**Downlink Command: 0x34** 937 + 938 +Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 939 + 940 + 941 + 942 +=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 943 + 944 + 945 +BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. TrackerD will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID. 946 + 947 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 948 + 949 +(% style="color:blue" %)**AT Command:** 950 + 951 + (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 952 + 953 + (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 954 + 955 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1)** 956 + 957 +Example: 0xB2010203040506 ~/~/ Set BLEMASK to 123456 958 + 959 + 960 + 961 +=== 3.2.12 Set WiFIMASK to filter WiFi SSID(Since firmware 1.4.1) === 962 + 963 + 964 +WiFiMASK is to filter the unwanted WiFi SSID during scan. For example, if WiFiMASK is 123456. TrackerD will only uplink SSID info which includes 123456 as prefix. It will ignore all other WiFi which doesn’t contact 123456 in the SSID. 965 + 966 +(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.** 967 + 968 +(% style="color:blue" %)**AT Command:** 969 + 970 + (% style="color:#037691" %)**AT+WiFiMASK=123456** (%%) ~/~/ Set WiFiMASK = 123456 971 + 972 + (% style="color:#037691" %)**AT+WiFiMASK=0** (%%) ~/~/ disable WiFiMASK 973 + 974 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1)** 975 + 976 +Example: 0xB3010203040506 ~/~/ Set WiFiMASK to 123456 977 + 978 + 979 + 980 +=== 3.2.13 Disable/Enable Information printing(Since firmware 1.4.1) === 981 + 982 + 983 +Users can use this feature to enable/disable Information printing. 984 + 985 +(% style="color:blue" %)**AT Command:** 986 + 987 +(% style="color:#037691" %)**AT+SHOWID=XX **(%%) ~/~/(Disable (0), Enable (1), default:0) 988 +\\Example: AT+SHOWID=1 ~-~-> Enable Information printing. 989 + 990 + 991 + 992 +=== 3.2.14 Get or Set Eight Channels Mode, only for us915, AU915(Since firmware 1.4.1) === 993 + 994 + 995 +The Channels Mode in the LORAWAN LMIC library is from 0 ~~ 7. When CHE = 8, 72 channels will be accessible to the network. 996 + 997 +(% style="color:blue" %)**AT Command:** 998 + 999 +(% style="color:#037691" %)**AT+CHE=1**(%%) ~/~/ set one channels mode 1000 + 1001 + 1002 +(% style="color:blue" %)**Downlink Payload:0X24**(%%) 1003 + 1004 +Example: 0x24 01 ~/~/ Same as AT+CHE=1 1005 + 1006 + 1007 + 884 884 = 4. Setting for Different Scenarios = 885 885 886 886 ... ... @@ -921,6 +921,7 @@ 921 921 [[image:1664503574618-659.png]] 922 922 923 923 1048 + 924 924 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 925 925 926 926 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] ... ... @@ -966,7 +966,18 @@ 966 966 [[image:1664503715811-892.png]] 967 967 968 968 1094 +(% 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. 969 969 1096 +[[image:image-20221024105643-1.png]] 1097 + 1098 +**~ Figure1** 1099 + 1100 + 1101 +[[image:image-20221024105643-2.png]] 1102 + 1103 + **Figure2** 1104 + 1105 + 970 970 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 971 971 972 972 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1025,11 +1025,75 @@ 1025 1025 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 1026 1026 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 1027 1027 1164 +== 7.3 Notes on using different serial port tools for TrackerD == 1028 1028 1029 1029 1030 -= 8. OrderInfo =1167 +=== **Serial port utility** === 1031 1031 1032 1032 1170 +Serial port utility requires you to automatically add data streams. 1171 + 1172 +Need to adjust the data stream to RTS/CTS on physical restart. 1173 + 1174 + 1175 +(% class="wikigeneratedid" %) 1176 +[[image:image-20221102140621-1.png]] 1177 + 1178 + 1179 +When using AT commands, the data flow needs to be adjusted to XON/XOFF 1180 + 1181 + 1182 +[[image:image-20221102140638-2.png]] 1183 + 1184 + 1185 + 1186 +=== **SecureCRT** === 1187 + 1188 + 1189 +The default command window of SecureCRT is not displayed. Entering a command requires a complete input of the entire command. You can open the command window in the view. 1190 + 1191 + 1192 +[[image:image-20221102140704-3.png]] 1193 + 1194 + 1195 +[[image:image-20221102140712-4.png]] 1196 + 1197 + 1198 + 1199 +=== **PUTTY** === 1200 + 1201 + 1202 +[[image:image-20221102140748-5.png]] 1203 + 1204 + 1205 +Since putty does not have a command window, you need to fill in the complete command externally, and then copy it to putty.The information copied outside can be pasted by right-clicking the mouse in putty. 1206 + 1207 + 1208 +[[image:image-20221102140801-6.png]] 1209 + 1210 + 1211 += 8 Trouble Shooting = 1212 + 1213 +== 8.1 TDC is changed to 4294947296 and cause no uplink. == 1214 + 1215 +Before firmware v1.4.0: When the Transport Mode is enabled (**AT+INTWK=1**), the **TDC** needs to be greater than **MTDC**, otherwise, TDC setting will because 4294947296 after wakre up from motion. This bug is fixed in firmware v1.4.1 1216 + 1217 + 1218 +== 8.2 Device not able get AT Command or show output after wake up from deep sleep mode == 1219 + 1220 +ESP32 is not able to accept the Interrupt from UART after wake up from deep sleep mode. User need to press the button (one click) and trackerD will be able to accept UART command, it there is no action in UART for 15 seconds. it will go to deep sleep mode. 1221 + 1222 + 1223 +== 8.3 The reason why it has been restarted after upgrading(V.1.4.1) == 1224 + 1225 +If it is V1.4.0 and the previous version, new partitions need to be loaded when upgrading. The new version of the software is stored in the partition package. The upgrade method is shown in the figure 1226 + 1227 +[[image:image-20221107145243-1.png||height="695" width="443"]] 1228 + 1229 + 1230 += 9. Order Info = 1231 + 1232 + 1033 1033 Part Number: (% style="color:blue" %)**TrackerD-XXX** 1034 1034 1035 1035 (% style="color:blue" %)**XXX**(%%): The default frequency band ... ... @@ -1042,11 +1042,9 @@ 1042 1042 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 1043 1043 * (% style="color:red" %)**US915**(%%): Default frequency band US915 1044 1044 1245 += 10. Packing Info = 1045 1045 1046 1046 1047 -= 9. Packing Info = 1048 - 1049 - 1050 1050 (% style="color:#037691" %)**Package Includes**: 1051 1051 1052 1052 * TrackerD LoRaWAN GPS/BLE Tracker x 1 ... ... @@ -1054,22 +1054,18 @@ 1054 1054 1055 1055 (% style="color:#037691" %)**Dimensions and Weight**: 1056 1056 1057 -* Device Size: 85 x 48 x 15 cm1255 +* Device Size: 85 x 48 x 15 mm 1058 1058 * Weight: 50g 1059 1059 1258 += 11. Support = 1060 1060 1061 1061 1062 -= 10. Support = 1063 - 1064 - 1065 1065 * 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. 1066 1066 * 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]]. 1067 1067 1264 += 12. Reference = 1068 1068 1069 1069 1070 -= 11. Reference = 1071 - 1072 - 1073 1073 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1074 1074 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1075 1075 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
- 1667288597595-714.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.9 KB - Content
- 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
- image-20221102140621-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +46.1 KB - Content
- image-20221102140638-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +40.8 KB - Content
- image-20221102140704-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +15.5 KB - Content
- image-20221102140712-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +73.2 KB - Content
- image-20221102140748-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +56.0 KB - Content
- image-20221102140801-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +21.0 KB - Content
- image-20221107145243-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +107.3 KB - Content