Changes for page TrackerD -- LoRaWAN Tracker User Manual

Last modified by Bei Jinggeng on 2025/08/01 17:45

From 223.1 to 224.1 From 238.1 to 239.1

From version 224.1

edited by Bei Jinggeng
on 2024/06/06 16:27

Change comment: There is no comment for this version

To version 238.1

edited by Edwin Chen
on 2025/02/02 15:46

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Bei
++XWiki.Edwin

Content

@@ -60,7 +60,7 @@
  (% style="color:blue" %)**Common DC Characteristics:**
  * Supply Voltage: 5V via USB port or Internal li-on battery
--* Operating Temperature: -40 ~~ 60°C
++* Operating Temperature: -15℃ ~~ 60°C
  (% style="color:blue" %)**LoRa Spec:**
@@ -395,17 +395,19 @@
  ==== (% style="color:blue" %)**Hum:**(%%) ====
--0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
++0230   value = 0x0230  / 10 = 560 ⇒ 56%
  ==== (% style="color:blue" %)**Tem:**(%%) ====
--011A =if (0x011A & 0x8000 = 1 ):   value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
++0202 = if (0x0202 & 0x8000 = 0 ):  value = 0x0202 / 100 = +514 ⇒ 5.14 degree
++011A =if (0xF11A & 0x8000 = 1 ):   value =( 0xF11A - 0x10000)/100(dec) ⇒ -38.14 degree
--=== 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
++=== 2.4.3  Uplink FPORT~=3, Realti me GNSS Positioning (Default Mode) ===
++
  The default uplink payload includes total 11 bytes ((% style="color:blue" %)**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)
@@ -449,12 +449,14 @@
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:450px" %)
--|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**16**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:120px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:30px" %)**1**
++|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**16**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:120px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:30px" %)**1**|(% style="background-color:#4f81bd; color:white; width:30px" %)**1**|(% style="background-color:#4f81bd; color:white; width:30px" %)**1**
  |(% style="width:50px" %)Value|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
  iBeacon MAJOR
  )))|(% style="width:63px" %)(((
  iBeacon MINOR
  )))|(% style="width:71px" %)(((
++senseless
++)))|(% style="width:50px" %)RSSI of the device within 1m|(% style="width:50px" %)(((
  iBeacon Measured Power
  )))|(% style="width:50px" %)(((
  iBeacon RSSI
@@ -472,6 +472,7 @@
  * (% style="color:#037691" %)**MINOR:**  (%%)The MINOR from the strongest iBeacon.
  * (% style="color:#037691" %)**Measured Power: ** (%%)   The Measured Power from the strongest iBeacon.
  * (% style="color:#037691" %)**RSSI:  **    (%%) The RSSI from the strongest iBeacon.
++* (% style="color:#037691" %)**RSSI_1M:** (%%) RSSI of the device within 1m.
  (% style="display:none" %) (%%)
@@ -522,7 +522,7 @@
  TrackerD supports BLE scanning for indoor positioning. Users can set SMOD to BLE pure or GPS/BLE Hybrid, so TrackerD will scan up to 40 BLE iBeacons and send uplinks.
--User can set [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)**BLEMASK**>>path:#H3.2.11A0SetBLEMASKtofilterBLEiBeacon]](%%) so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
++User can set [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)**BLEMASK**>>path:#H3.2.11A0SetBLEMASKtofilterBLEiBeacon]](%%) so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:348px" %)
  |(% style="background-color:#4f81bd; color:white" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**2**|(% style="background-color:#4f81bd; color:white" %)**1**|(% style="background-color:#4f81bd; color:white" %)**...**
@@ -535,7 +535,7 @@
  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
  * (% style="color:#037691" %)**MINOR:**  (%%)The MINOR from the strongest iBeacon.
  * (% style="color:#037691" %)**RSSI:  **    (%%) The RSSI from the strongest iBeacon.
--* (% style="color:#037691" %)**MOD:      **(%%)Bluetooth mode: 1: Search the beacon with the strongest signal. 2: Search the three beacons with the strongest signal. 3: Search all Bluetooth beacons (up to 40 Bluetooth beacons are displayed).
++* (% style="color:#037691" %)**MOD:      **(%%)Bluetooth mode: 1: Search the beacon with the strongest signal. 2: Search the three beacons with the strongest signal. 3: Search all Bluetooth beacons (up to 40 Bluetooth beacons are displayed).
  (% class="wikigeneratedid" %)
  (% style="color:red" %)**Note: This mode does not have a fixed decoder. Its decoder depends on the number of beacons and can be parsed according to the order of the payload.**
@@ -817,7 +817,7 @@
  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
--(% style="color:#037691" %)**0x03 00 01 2C**  (%%)     ~/~/  Same as AT+MTDC=3000000
++(% style="color:#037691" %)**0x03 00 01 2C**  (%%)     ~/~/  Same as AT+MTDC=300000
  === 3.2.4  Exit Alarm ===
@@ -1157,7 +1157,7 @@
  === (% data-sider-select-id="358d0797-d8c7-4a5d-b51f-fd0c537f26e4" %)3.2.21 Set long press time(Since firmware 1.4.6)(%%) ===
--When using the red button Changan to alarm, press and hold the time to set 0~~10 seconds, which is convenient for use scenarios.
++When using the red button Changan to alarm, press and hold the time to set 0~~10 seconds(The default value is 5 seconds), which is convenient for use scenarios.
  (% data-sider-select-id="5e6cc597-e839-4a16-9d6b-776f523bcb8c" style="color:blue" %)**AT Command:**
@@ -1167,13 +1167,32 @@
  AT+EAT=2    ~-~->  Set the long press time to 2s
--(% style="color:blue" %)**Downlink Payload:0XBA**
++(% style="color:blue" %)**Downlink Payload: 0XBA**
 xBA 02          ~/~/  Same as AT+EAT=2
--
++
++
++=== 3.2.22 Set the Bluetooth scan time(Since firmware 1.5.1) ===
++
++
++Use this command to set the Bluetooth scan time. Default is 5s, value range: 1~~255.
++
++(% data-sider-select-id="5e6cc597-e839-4a16-9d6b-776f523bcb8c" style="color:blue" %)**AT Command:**
++
++(% style="color:#037691" %)**AT+BTDC=XX**
++
++Example:
++
++AT+BTDC=5    ~-~->  Set the Bluetooth scan time to 5s
++
++(% style="color:blue" %)**Downlink Payload:**
++
++No downlink
++
++
  (% data-sider-select-id="8e1bc417-f7f8-49f0-b796-8460ff412d7c" %)
--=== 3.2.22 Conversion of TrackerD and TrackerD-LS ===
++=== 3.2.23 Conversion of TrackerD and TrackerD-LS(Since firmware 1.4.9) ===
  They use the same source code and can be converted using the AT command below
@@ -1497,6 +1497,25 @@
  [[image:image-20240329120308-1.png||height="537" width="525"]]
++== 7.8 FAQs for upgrading to version 1.4.9 or later ==
++
++1.The device does not display version information or indicates low battery
++
++Please set the device type
++
++(% style="color:red" %)**AT+DEVICE=13~-~->TrackerD
++AT+DEVICE=22->TrackerD-LS**
++
++
++2.Unable to control the red button on trackerD
++
++Please set any 8-digit DADDR less than** 01880788**.
++
++(% style="color:red" %)**Example:**
++
++(% style="color:red" %)**AT+DADDR=01880688**
++
++
  = 8  Trouble Shooting =
  == 8.1  TDC is changed to 4294947296 and cause no uplink. ==
@@ -1741,3 +1741,115 @@
  )))
++
++
++= Sensor Payload Decoding Description =
++
++== Device Overview ==
++
++{{figure reference="device.png" alt="Device Image" caption="TrackerD Sensor Device" width="300" /}}
++
++== Decoding Rules for Fport=5 ==
++
++The following table describes the decoding rules for Fport=5:
++
++|= Byte Position |= Field Name |= Description |= Example Value
++| 1 | Sensor Model | Sensor model, `0x13` represents TrackerD, otherwise display raw value | `0x13` → TrackerD
++| 2-3 | Firmware Version | Firmware version, `0x0140` represents v1.4.0 | `0x0140` → v1.4.0
++| 4 | Frequency Band | Frequency band mapping: |
++| | | `0x01`: EU868 |
++| | | `0x02`: US915 |
++| | | `0x03`: IN865 |
++| | | `0x04`: AU915 |
++| | | `0x05`: KZ865 |
++| | | `0x06`: RU864 |
++| | | `0x07`: AS923 |
++| | | `0x08`: AS923-1 |
++| | | `0x09`: AS923-2 |
++| | | `0x0a`: AS923-3 |
++| 5 | Sub Band | Sub band, `0x00~0x08` (only for AU915/US915), others are `0xFF` | `0xFF` → N/A
++| 6-7 | Battery | Battery voltage in mV | `0x0FA2` → 4002 mV
++| 8 | SMOD | BLE settings, GPS mode, and positioning mode: |
++| | | Bits 1-4: BLE settings |
++| | | Bits 5-6: GPS mode |
++| | | Bits 7-8: Positioning mode |
++| 9 | Status | Status bits: |
++| | | Bit 1: Transport Mode |
++| | | Bit 2: LON |
++| | | Bit 3: PNACKMD |
++| | | Bits 4-8: Reserved |
++
++== Decoding Rules for Fport=2 ==
++
++The following table describes the decoding rules for Fport=2:
++
++|= Byte Position |= Field Name |= Description |= Example Value
++| 1-4 | Latitude | Latitude in degrees | `0x02863D68` → 42.351976
++| 5-8 | Longitude | Longitude in degrees | `0xFAC29BAF` → -87.909457
++| 9-10 | Alarm & Battery | Alarm and battery voltage: |
++| | | Bit 7: Alarm |
++| | | Bits 1-6 + Byte 10: Battery (in mV) | `0x4B45` → Alarm=True, Battery=2885 mV
++| 11 | Flag | Flag bits: |
++| | | Bits 2-3: MOD |
++| | | Bit 1: LON |
++| 12-13 | Humidity | Humidity in % | `0x0230` → 56%
++| 14-15 | Temperature | Temperature in °C | `0x0202` → 5.14°C, `0xF11A` → -38.14°C
++
++== Example Payload Decoding ==
++
++Below are examples of decoded payloads:
++
++=== Example for Fport=5 ===
++{{code}}
++Payload: [0x13, 0x01, 0x40, 0x01, 0xFF, 0x0F, 0xA2, 0x12, 0x03]
++Decoded Result:
++{
++  "sensorModel": "TrackerD",
++  "firmwareVersion": "v1.4.0",
++  "frequencyBand": "EU868",
++  "subBand": "N/A",
++  "batteryVoltage": "4002 mV",
++  "bleSettings": "BLE Positioning with Strongest iBeacon",
++  "gpsMod": "GPS Only",
++  "positioningMod": "BLE",
++  "status": {
++    "transportMode": true,
++    "lon": true,
++    "pnackmd": false
++  }
++}
++{{/code}}
++
++=== Example for Fport=2 ===
++{{code}}
++Payload: [0x02, 0x86, 0x3D, 0x68, 0xFA, 0xC2, 0x9B, 0xAF, 0x4B, 0x45, 0x03, 0x02, 0x30, 0x02, 0x02]
++Decoded Result:
++{
++  "latitude": 42.351976,
++  "longitude": -87.909457,
++  "alarm": true,
++  "battery": "2885 mV",
++  "mod": 1,
++  "lon": true,
++  "humidity": "56 %",
++  "temperature": "5.14 °C"
++}
++{{/code}}
++
++== Horizontal Byte Layout ==
++
++Below is the horizontal byte layout for better visualization:
++
++=== Fport=5 Byte Layout ===
++{{code}}
++| Byte 1 | Byte 2 | Byte 3 | Byte 4 | Byte 5 | Byte 6 | Byte 7 | Byte 8 | Byte 9 |
++|--------|--------|--------|--------|--------|--------|--------|--------|--------|
++| Model  | Firmware Version | Frequency Band | Sub Band | Battery Voltage | SMOD | Status |
++{{/code}}
++
++=== Fport=2 Byte Layout ===
++{{code}}
++| Byte 1-4 | Byte 5-8 | Byte 9-10 | Byte 11 | Byte 12-13 | Byte 14-15 |
++|----------|----------|-----------|---------|------------|------------|
++| Latitude | Longitude | Alarm & Battery | Flag | Humidity | Temperature |
++{{/code}}

Changes for page TrackerD -- LoRaWAN Tracker User Manual

Summary

Details

Applications

Navigation