Changes for page TrackerD -- LoRaWAN Tracker User Manual

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

From version < 51.16 >

edited by Xiaoling
on 2022/09/30 13:42

To version < 51.31 >

edited by Xiaoling
on 2022/09/30 16:44

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -25,10 +25,14 @@
  (((
  In TrackerD, there are various sensors such as GPS, WiFi, BLE, Temperature, Humidity, Motion Detection, and Buzzer. User can use TrackerD for different tracking scenario.
++(((
  TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution.
++)))
++(((
  The LoRa wireless technology used in TrackerD allows the user to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional tracking services.
  )))
++)))
  (((
  TrackerD is equipped with a (% style="color:blue" %)**1000mAh Li-on rechargeable battery**(%%). Each TrackerD has a worldwide unique OTAA keys to join the LoRaWAN network.
@@ -57,11 +57,13 @@
  * EEPROM: 520 KB
  * Clock Speed: 32Mhz
++
  (% style="color:blue" %)**Common DC Characteristics:**
  * Supply Voltage: 5V via USB port or Internal li-on battery
  * Operating Temperature: -40 ~~ 60°C
++
  (% style="color:blue" %)**LoRa Spec:**
  * Frequency Range,
@@ -83,10 +83,12 @@
  * Packet engine up to 256 bytes with CRC.
  * LoRaWAN 1.0.3 Specification
++
  (% style="color:blue" %)**Battery:**
  * 1000mA Li-on Battery power (for model TrackerD)
++
  (% style="color:blue" %)**Power Consumption**
  * Sleeping Mode: 200uA
@@ -93,6 +93,8 @@
  * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
  * Tracking: max: 38mA
++
++
  == 1.3  Features ==
@@ -99,7 +99,7 @@
  * LoRaWAN 1.0.3 Class A
  * ESP32 PICO D4
  * SX1276/78 Wireless Chip
--*    Arduino IDE Compatible
++* Arduino IDE Compatible
  * Open source hardware / software
  * Regular/ Real-time GPS,BLE,WIFI tracking
  * Built-in3 axis accelerometer (LIS3DH)
@@ -111,6 +111,8 @@
  * Tri-color LED, Alarm button
  * Datalog
++
++
  == 1.4  Applications ==
@@ -117,6 +117,8 @@
  * Logistics and Supply Chain Management
  * Human tracking
++
++
  = 2.1  Use TrackerD =
@@ -202,47 +202,43 @@
  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. )
--(% border="2" style="background-color:#ffffcc; color:green; width:537px" %)
--|(% style="width:69px" %)(((
--**Size**
--
--**(bytes)**
--)))|(% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)(((
--2
--
--(optional )
--)))|(% style="width:83px" %)(((
--2
--
--(optional)
++(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
++|=(% scope="row" style="width: 50px;" %)(((
++**Size(bytes)**
++)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:88px" %)(((
++2(optional)
++)))|(% style="width:87px" %)(((
++2(optional)
  )))
--|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
++|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
  [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
--)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]]
++)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
  [[image:1664501958445-288.png]]
--==== (% style="color:blue" %)Alarm & BAT:(%%) ====
++==== (% style="color:blue" %)**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>>||anchor="HBAT:"]]
++(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
++|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
++|=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]]
--==== (% style="color:blue" %)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>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version
++==== (% style="color:blue" %)**FLAG:**(%%) ====
++(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
++|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits
++|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version
++
  **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A
--==== (% style="color:blue" %)Location info:(%%) ====
++==== (% style="color:blue" %)**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:**
 .  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.
@@ -262,20 +262,19 @@
--==== (% style="color:blue" %)Alarm:(%%) ====
++==== (% style="color:blue" %)**Alarm:**(%%) ====
--
  Example:  0x4B & 0x40 >> 6 = 0x01
--==== (% style="color:blue" %)BAT:(%%) ====
++==== (% style="color:blue" %)**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,28 +282,33 @@
  * 3.40v ~~ 3.69v:   20% ~~ 40%
  * < 3.39v:             0~~20%
--==== (% style="color:blue" %)LON:(%%) ====
--
++
++==== (% style="color:blue" %)**LON:**(%%) ====
++
++
  Enable/Disable LED activity for uplink
++(((
 x00:   Disable LED indicator.
++)))
++(((
 x01:   Enable LED indicator (Default Value)
++)))
--==== (% style="color:blue" %)Hum:(%%) ====
++==== (% style="color:blue" %)**Hum:**(%%) ====
 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
--==== (% style="color:blue" %)Tem:(%%) ====
++==== (% style="color:blue" %)**Tem:**(%%) ====
 A =if (0x011A & 0x8000 = 1 ):   value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
--
  === 2.3.3  Uplink FPORT~= , History GNSS Positioning ===
@@ -311,17 +311,13 @@
  === 2.3.4  BLE positioning Payload(Fport2) ===
--Different MODE has different payload:
++Different MODE has different payload:  (% style="color:blue" %)**MODE=2**
--**MODE=2**
--
--(% border="2" style="background-color:#ffffcc; color:green; width:491px" %)
--|(% style="width:70px" %)(((
--**Size**
--
--**(bytes)**
--)))|(% style="width:44px" %)16|(% style="width:61px" %)4|(% style="width:63px" %)4|(% style="width:71px" %)2|(% style="width:50px" %)4|(% style="width:47px" %)2|(% style="width:15px" %)1
--|(% style="width:70px" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
++(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
++|=(% scope="row" style="width: 60px;" %)(((
++**Size(bytes)**
++)))|(% style="width:30px" %)16|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:120px" %)2|(% style="width:50px" %)4|(% style="width:50px" %)2|(% style="width:30px" %)1
++|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
  iBeacon MAJOR
  )))|(% style="width:63px" %)(((
  iBeacon MINOR
@@ -344,6 +344,8 @@
  * (% 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 ===
@@ -367,9 +367,13 @@
  == 2.4  Integrate with Datacake ==
++(((
  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.
++)))
++(((
  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]]
++)))
  [[image:1664502695771-538.png]]
@@ -379,9 +379,13 @@
  == 2.5  Integrate with Tago ==
++(((
  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.
++)))
++(((
  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]]
++)))
  [[image:1664502715371-321.png]]
@@ -391,22 +391,30 @@
  == 2.6  Alarm Mode ==
++(((
  User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode.
++)))
++(((
  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.
++)))
++(((
  Two ways to exit alarm mode:
++)))
  * Server send a downlink command to exit.
  * User fast press the RED button 10 times.
++(((
  When exit alarm mode, (% style="color:red" %)**RED LED**(%%) will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false.
++)))
--== 2.7  Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ==
++== 2.7  Sports Mode ==
@@ -413,8 +413,8 @@
  == 2.8  LED Status ==
--(% border="2" style="background-color:#ffffcc; color:green; width:636px" %)
--|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off**
++(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
++|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
  |(% style="width:157px" %)**Power On**|(% style="width:271px" %)(% style="color:blue" %)**BLUE, **(% style="color:red" %)**RED , **(% style="color:green" %)**Green** flash once|(% style="width:202px" %)N/A
  |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
  |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
@@ -427,10 +427,11 @@
  |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
  |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
++
  == 2.9  Button Function ==
--(% style="color:green" %)**RESET button:**
++(% style="color:blue" %)**RESET button:**
  [[image:1664502835802-546.png]]
@@ -442,14 +442,13 @@
  [[image:1664502854406-763.png]]
--(% border="2" style="background-color:#ffffcc; color:green; width:627px" %)
--|(% style="width:135px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**
++(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
++|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
  |(% 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"]]
  |(% 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
  |(% 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 ==
@@ -543,7 +543,7 @@
  (% style="color:#037691" %)**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
  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
@@ -559,7 +559,6 @@
  * (% style="color:blue" %)**AT Command: No AT Command**
--
  * (% style="color:blue" %)**Downlink Payload (prefix 0x02):**
  (% style="color:#037691" %)**0x02 01**    (%%)   ~/~/  Exit Alarm Mode
@@ -575,7 +575,7 @@
  (% style="color:#037691" %)**AT+LON=xx.  (Disable (0), Enable (1), default:1)**
-- Example: AT+LON=0   **~-~-> ** Disable LED for position, downlink and uplink.
++Example: AT+LON=0   **~-~-> ** Disable LED for position, downlink and uplink.
  * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**
@@ -593,7 +593,7 @@
  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
-- Example:  AT+ INTWK =1   **~-~->   ** Enable detect movement.
++Example:  AT+ INTWK =1   **~-~->   ** Enable detect movement.
  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
@@ -731,11 +731,9 @@
  After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
--(% style="color:blue" %)**Step3：**(%%) Download and Install Flash Tool:
++(% style="color:blue" %)**Step3:  **(%%)Download and Install Flash Tool:  [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]]
--[[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]]
--
  (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
@@ -776,7 +776,7 @@
  === 6.1.1  Set up ARDUINO compile environment ===
--* Download the latest Arduino software (IDE) from the Arduino official website:  [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]
++* **Download the latest Arduino software (IDE) from the Arduino official website:  [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]**
  Install IDE on PC, open and click (% style="color:#037691" %)**File ~-~-> Preference**,(%%) add the following URL:  [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]]
@@ -784,13 +784,13 @@
  [[image:1664503635019-941.png]]
--* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) find the esp32 information and install it.
++* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.**
  [[image:1664503715811-892.png]]
--* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
++* **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:
@@ -837,8 +837,8 @@
--(% border="2" style="background-color:#ffffcc; color:green; width:314px" %)
--|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin**
++(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)
++|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin**
  |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
  |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
  |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
@@ -848,6 +848,7 @@
  |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
  |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
++
  = 8.  Order Info =
@@ -863,25 +863,31 @@
  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
  * (% style="color:red" %)**US915**(%%): Default frequency band US915
++
++
  = 9.  Packing Info =
--**Package Includes**:
++(% style="color:#037691" %)**Package Includes**:
  * TrackerD LoRaWAN GPS/BLE Tracker x 1
  * USB recharge & program cable x 1
--**Dimensions and Weight**:
++(% style="color:#037691" %)**Dimensions and Weight**:
  * Device Size: 85 x 48 x 15 cm
  * Weight: 50g
++
++
  = 10.  Support =
  * 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.
--* 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]]
++* 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]].
++
++
  = 11.  Reference =
@@ -888,3 +888,5 @@
  * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
  * **[[Source Code>>https://github.com/dragino/TrackerD]] **
  * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
++
++

Changes for page TrackerD -- LoRaWAN Tracker User Manual

Summary

Details

Applications

Navigation