Changes for page TrackerD -- LoRaWAN Tracker User Manual

Last modified by Xiaoling on 2025/04/14 16:33

From version < 51.1 >

edited by Xiaoling
on 2022/09/30 10:40

To version < 51.8 >

edited by Xiaoling
on 2022/09/30 11:24

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -1,6 +1,13 @@
++(% style="text-align:center" %)
++[[image:1664505654417-133.png]]
++
++
++
++
  (% class="wikigeneratedid" %)
  **Table of Contents:**
++{{toc/}}
@@ -87,7 +87,6 @@
  * Tracking: max: 38mA
--
  == 1.3  Features ==
@@ -106,7 +106,6 @@
  * Tri-color LED, Alarm button
  * Datalog
--
  == 1.4  Applications ==
@@ -114,7 +114,6 @@
  * Human tracking
--
  = 2.1  Use TrackerD =
@@ -142,11 +142,10 @@
  Each TrackerD is shipped with a sticker with the default device EUI as below:
++
  [[image:1664501677253-891.png]]
--
--
  Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot:
@@ -180,15 +180,15 @@
  (% style="color:blue" %)**Positioning Mode(SMOD):**
--* **GPS ONLY(Factory Settings): **only get GPS location info.
--* **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking.
--* **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking.
++* **(% style="color:#037691" %)GPS ONLY(Factory Settings):    **(%%)only get GPS location info.
++* **(% style="color:#037691" %)BLE ONLY:              **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking.
++* **(% style="color:#037691" %)GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.
--User can switch modes by [[changing SMOD>>path:#Positioning_Mode]].
++User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
--== 2.3  Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- ==
++== 2.3  Uplink Payload ==
  === 2.3.1  Uplink FPORT~=5, Device Status ===
@@ -195,7 +195,7 @@
--=== 2.3.2  Uplink FPORT~= , Realtime GNSS Positioning  ===
++=== 2.3.2  Uplink FPORT~= , Realtime GNSS Positioning ===
  The default uplink payload includes totally 11 bytes. (User can use AT+MOD=0 to enable the Temperature and humidity sensor to hum/tem info from accelerometer. When accelerometer info is enable, total payload will be 15 bytes, please note 15 bytes won't work on DR0 on US915/AU915 frequency band. )
@@ -215,43 +215,38 @@
  (optional)
  )))
--|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)(((
--[[Alarm &>>path:#Alarm]]
++|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
++[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
--[[BAT>>path:#Alarm]]
--)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]]
++)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]]
--
  [[image:1664501958445-288.png]]
--**Alarm & BAT:**
++==== Alarm & BAT: ====
  (% border="2" style="background-color:#ffffcc; color:green; width:329px" %)
  |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits
--|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]]
++|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]]
++==== FLAG: ====
--**FLAG:**
--
  (% border="2" style="background-color:#ffffcc; color:green; width:332px" %)
  |(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits
--|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version
++|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLocationinfo:"]]|(% style="width:140px" %)Firmware version
++**(% style="color:blue" %)Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A  **
--**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A  **
++==== Location info: ====
--**Location info:**
--
  * Latitude: 02863D68     ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://        //value = 02863D68 /1000000 = 42.351976//
  * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://   //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
++**(% style="color:red" %)Important note:**
--**Important note:**
--
 .  When power is low (<2.84v), GPS won't be able to get location info and GPS feature will be disabled and the location field will be filled with 0x0FFFFFFF, 0x0FFFFFFF.
 .  In firmware version v1.5, Roll & Pitch is disabled by default.
@@ -269,12 +269,18 @@
--* **Alarm**:  Example:  0x4B & 0x40 >> 6 = 0x01
--* **BAT**:     Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
++==== Alarm: ====
--The battery info shows the current voltage, for **TrackerD** version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \
++Example:  0x4B & 0x40 >> 6 = 0x01
++==== BAT: ====
++
++Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
++
++The battery info shows the current voltage, for **(% style="color:blue" %)TrackerD**(%%) version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \
++
++
  * > 4.0v :              80% ~~ 100%
  * 3.85v ~~3.99v:    60% ~~ 80%
  * 3.70v ~~ 3.84v:   40% ~~ 60%
@@ -282,21 +282,26 @@
  * < 3.39v:             0~~20%
++==== LON: ====
++Enable/Disable LED activity for uplink
--* **LON: **Enable/Disable LED activity for uplink
--
 x00:   Disable LED indicator.
 x01:   Enable LED indicator (Default Value)
--* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
--* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ):   value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree
++==== Hum: ====
++0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
++==== Tem: ====
++011A =if (0x011A & 0x8000 = 1 ):   value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree
++
++
++
  === 2.3.3  Uplink FPORT~= , History GNSS Positioning ===
@@ -314,49 +314,38 @@
  **(bytes)**
  )))|(% style="width:54px" %)16|(% style="width:72px" %)4|(% style="width:71px" %)4|(% style="width:145px" %)2|(% style="width:72px" %)4|(% style="width:76px" %)2|(% style="width:54px" %)1
--|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)(((
--iBeacon
--
--MAJOR
++|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:72px" %)(((
++iBeacon MAJOR
  )))|(% style="width:71px" %)(((
--iBeacon
--
--MINOR
++iBeacon MINOR
  )))|(% style="width:145px" %)(((
--iBeacon Measured
--
--Power
++iBeacon Measured Power
  )))|(% style="width:72px" %)(((
--iBeacon
--
--RSSI
++iBeacon RSSI
  )))|(% style="width:76px" %)(((
--[[Alarm &>>path:#Alarm]]
++[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
++)))|(% style="width:54px" %)[[FLAG>>||anchor="HFLAG:"]]
--[[BAT>>path:#Alarm]]
--)))|(% style="width:54px" %)[[FLAG>>path:#Flag]]
--
  [[image:1664502425687-834.png]]
--* **BAT**:       Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
--* **MODE:   **Define the payload format.
--* **UUID:     **The uuid from the strongest iBeacon.
--* **MAJOR**:  The MAJOR from the strongest iBeacon.
--* **MINOR**:  The MAJOR from the strongest iBeacon.
--* **Measured** **Power**:     The Measured Power from the strongest iBeacon.
--* **RSSI**:       The RSSI from the strongest iBeacon.
++* **(% style="color:#037691" %)BAT: **  (%%)    Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
++* **(% style="color:#037691" %)MODE:   **(%%)Define the payload format.
++* **(% style="color:#037691" %)UUID:     **(%%)The uuid from the strongest iBeacon.
++* **(% style="color:#037691" %)MAJOR:** (%%) The MAJOR from the strongest iBeacon.
++* **(% style="color:#037691" %)MINOR:**  (%%)The MAJOR 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.
--
  === 2.3.5  Add Payload format in TTN V3 ===
  In TTN V3, use can add a custom payload so it shows friendly.
--In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder
++In the page Applications(% style="color:#037691" %) ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder
  [[image:1664502649601-895.png]]
@@ -435,7 +435,6 @@
--
  == 2.9  Button Function ==
@@ -458,7 +458,6 @@
  |(% 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.
--
  == 2.10  USB Port Function ==
@@ -471,7 +471,6 @@
--
  = 3.  Configure TrackerD via AT command or LoRaWAN downlink =
@@ -535,7 +535,7 @@
  AT+ATDC=xx.
--Example:  AT+ATDC=60000    **~-~->    ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
++Example:  AT+ATDC=60000    **~-~->    ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
  * Downlink Payload (prefix 0xB1):
@@ -553,7 +553,7 @@
  AT+MTDC=xx.
-- Example:  AT+MTDC=300000    **~-~->    ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
++ Example:  AT+MTDC=300000    **~-~->    ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
  * Downlink Payload (prefix 0x03):
@@ -605,7 +605,7 @@
  AT+INTWK=xx.  (Disable (0), Enable (1), default:0)
-- Example:  AT+ INTWK =1   **~-~->   ** Enable detect movement.
++ Example:  AT+ INTWK =1   **~-~->   ** Enable detect movement.
  * Downlink Payload (prefix 0xAF):
@@ -703,7 +703,7 @@
  **~ Example:**
--  AT+ CFM=0    **~-~->   ** Disable confirmation
++  AT+ CFM=0    **~-~->   ** Disable confirmation
    AT+ CFM=1    **~-~->  **  Enable confirmation
@@ -798,7 +798,6 @@
  * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it.
--
  [[image:1664503715811-892.png]]
@@ -805,7 +805,6 @@
  * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
--
  Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
@@ -865,7 +865,6 @@
--
  = 8.  Order Info =
@@ -884,7 +884,6 @@
--
  = 9.  Packing Info =
@@ -900,7 +900,6 @@
--
  = 10.  Support =
@@ -909,7 +909,6 @@
--
  = 11.  Reference =

Changes for page TrackerD -- LoRaWAN Tracker User Manual

Summary

Details

Applications

Navigation