Changes for page TrackerD -- LoRaWAN Tracker User Manual

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

From version < 51.29 >

edited by Xiaoling
on 2022/09/30 15:58

To version < 59.3 >

edited by Edwin Chen
on 2022/10/08 18:10

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 2 added, 0 removed)
- image-20221006181316-1.png
- image-20221006181357-2.png

Details

Page properties

Author

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

Content

@@ -1,3 +1,5 @@
++==   ==
++
  (% style="text-align:center" %)
  [[image:1664505654417-133.png]]
@@ -61,13 +61,11 @@
  * 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,
@@ -89,12 +89,10 @@
  * 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
@@ -101,8 +101,6 @@
  * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
  * Tracking: max: 38mA
--
--
  == 1.3  Features ==
@@ -109,7 +109,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)
@@ -121,8 +121,6 @@
  * Tri-color LED, Alarm button
  * Datalog
--
--
  == 1.4  Applications ==
@@ -129,8 +129,6 @@
  * Logistics and Supply Chain Management
  * Human tracking
--
--
  = 2.1  Use TrackerD =
@@ -193,14 +193,15 @@
  (% style="color:blue" %)**Step 3:**(%%) TrackerD will auto join to the LoRaWAN network. After join success, TrackerD will start to upload message to IoT server.
--(% style="color:blue" %)**Positioning Mode(SMOD):**
++== 2.3 Positioning Mode(SMOD) ==
--* (% 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.
++Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported.
--User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
++* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
++* (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
++* (% 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.
++Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
  == 2.3  Uplink Payload ==
@@ -208,25 +208,67 @@
  === 2.3.1  Uplink FPORT~=5, Device Status ===
++Uplink the device configures with FPORT=5. Once LGT92 Joined the network, it will uplink this message to the server. After first uplink, LHT52 will uplink Device Status every 12 hours.
++|=(% style="width: 150px;" %)**Size (bytes)**|=(% style="width: 233px;" %)**1**|=(% style="width: 150px;" %)**2**|=(% style="width: 164px;" %)**1**|=(% style="width: 215px;" %)**1**|=(% style="width: 94px;" %)2|=(% style="width: 516px;" %)**2**|=(% style="width: 516px;" %)1
++|(% style="width:150px" %)**Value**|(% style="width:233px" %)Sensor Model|(% style="width:150px" %)Firmware Version|(% style="width:164px" %)Frequency Band|(% style="width:215px" %)Sub-band|(% style="width:94px" %)BAT|(% style="width:516px" %)SMOD|(% style="width:516px" %)Status
--=== 2.3.2  Uplink FPORT~= , Realtime GNSS Positioning ===
++[[image:image-20221006181357-2.png]]
++Example Payload (FPort=5):  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT52%20-%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220621105116-11.png?rev=1.1||alt="image-20220621105116-11.png"]]
--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. )
++**Sensor Model**: For TrackerD, this value is 0x13.
++**Firmware Version**: 0x0100, Means: v1.0.0 version.
++**Frequency Band**:
++
++*0x01: EU868
++
++*0x02: US915
++
++*0x03: IN865
++
++*0x04: AU915
++
++*0x05: KZ865
++
++*0x06: RU864
++
++*0x07: AS923
++
++*0x08: AS923-1
++
++*0x09: AS923-2
++
++*0x0a: AS923-3
++
++**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
++
++**BAT**: shows the battery voltage for TrackerD.
++
++Ex1: 0x0B3A = 2874mV
++
++Use can also get the Device Status uplink through the downlink command:
++
++
++=== 2.3.2  Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
++
++
++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.
++
++
  (% 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:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
++2
  )))|(% style="width:87px" %)(((
--2(optional)
++2
  )))
  |=(% 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:87px" %)[[Tem>>||anchor="HTem:"]]
++)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
  [[image:1664501958445-288.png]]
@@ -237,12 +237,11 @@
  |=(% 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="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
++|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
++|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
  **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A
@@ -253,22 +253,18 @@
  * 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.
--2.  In firmware version v1.5, Roll & Pitch is disabled by default.
++2.  In this mode, the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes payload. In this case, the payload on server will be ignore and shows as below:
--3.  When enable 9-axis motion sensor, the total payload will be 15 bytes, while US915/AU915 DR0 accept only 11 bytes payload. In this case, the payload on server will be ignore and shows as below:
--
  [[image:1664502116362-706.png]]
++3.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
--4.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
--
  [[image:1664502166010-515.png]]
@@ -283,10 +283,9 @@
  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: \
++The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
  )))
--
  * > 4.0v :              80% ~~ 100%
  * 3.85v ~~3.99v:    60% ~~ 80%
  * 3.70v ~~ 3.84v:   40% ~~ 60%
@@ -296,7 +296,6 @@
  ==== (% style="color:blue" %)**LON:**(%%) ====
--
  Enable/Disable LED activity for uplink
  (((
@@ -318,14 +318,37 @@
 A =if (0x011A & 0x8000 = 1 ):   value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
++=== 2.3.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
--=== 2.3.3  Uplink FPORT~= , History GNSS Positioning ===
++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)
++(% 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:73px" %)1
++|=(% 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:73px" %)[[FLAG>>||anchor="HFLAG:"]]
--=== 2.3.4  BLE positioning Payload(Fport2) ===
++=== 2.3.4  Uplink FPORT~=4, History GNSS Positioning ===
++
++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.
++
++**Note for this mode:**
++
++* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
++* b) TrackerD will send data in **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.
++
++The payload is 15 bytes, as below.
++
++
++
++=== 2.3.5  BLE positioning Payload(Fport2) ===
++
++
  Different MODE has different payload:  (% style="color:blue" %)**MODE=2**
  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
@@ -344,7 +344,6 @@
  [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
  )))|(% style="width:15px" %)[[FLAG>>||anchor="HFLAG:"]]
--
  [[image:1664502425687-834.png]]
@@ -356,8 +356,6 @@
  * (% 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 ===
@@ -410,6 +410,9 @@
++== 2.6 Datalog Feature ==
++
++
  == 2.6  Alarm Mode ==
@@ -430,7 +430,6 @@
  * 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.
  )))
@@ -437,10 +437,12 @@
--== 2.7  Sports Mode ==
++== 2.7  Transport Mode ==
++In Transport Mode, TrackerD will check if there is motion. If there is no motion, device will send uplinks every 20 minutes. If there is motion, device will send uplink every 5 minutes.
++
  == 2.8  LED Status ==
@@ -458,8 +458,6 @@
  |(% 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 ==
@@ -481,8 +481,6 @@
  |(% 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 ==
@@ -493,9 +493,6 @@
  * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
  * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
--
--
--
  = 3.  Configure TrackerD via AT command or LoRaWAN downlink =
@@ -568,16 +568,16 @@
--=== 3.2.3  Set Sports Mode Packet transmission interval ===
++=== 3.2.3  Set Transport Mode Packet transmission interval ===
--Set sports packet transmit interval
++Set Transport Mode packet transmit interval
  * (% style="color:blue" %)**AT Command:**
  (% 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 Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000
  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
@@ -617,16 +617,16 @@
--=== 3.2.6  Disable/Enable movement detect (Debug Only) ===
++=== 3.2.6  Disable/Enable Transport Mode ===
--User can use this feature to check and set thread hole of movement detect
++Users can use this feature to enable/disable Transport Mode.
  * (% style="color:blue" %)**AT Command:**
  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
--Example:  AT+ INTWK =1   **~-~->   ** Enable detect movement.
++Example:  AT+ INTWK =1   **~-~->   ** Enable Transport Mode.
  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
@@ -638,18 +638,9 @@
  === 3.2.7  Set Positioning Mode ===
--SMOD define the how TrackerD scan and uplink date.
++SMOD define the how TrackerD scan and uplink data:
--GPS室外定位模式：  设备默认模式，设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是3分钟定位，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。GPS还有一种logdata模式，在断网的情况下将数据存储下来，等到有网的时候，一次将数据以每10秒上报。
--BLE室内定位模式：   设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是5秒，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每3分钟发送一次）。
--
--GPS和BLE混动模式：设备入网后会发送device当前模式下的信息，随后立即判断是否在室内，如果是就进行BLE定位，不是就GPS定位。如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。
--
--运动模式：               设备入网后会发送device当前模式下的信息，随后发送GPS定位数据，设备判断是否在运动，没有运动传感器没有检测到动作，立即进入静止状态（默认20分钟），如果产生运动，将每5分钟发送一次数据，再第五分钟后检测设备有误运动，无将切换到静止状态，有立即发送数据。
--
--
--
  * (% style="color:blue" %)**AT Command:**
  (% style="color:#037691" %)**AT+SMOD=xx. **
@@ -879,8 +879,6 @@
  |(% 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 =
@@ -896,25 +896,19 @@
  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
  * (% style="color:red" %)**US915**(%%): Default frequency band US915
--
--
--
  = 9.  Packing Info =
--**(% style="color:#037691" %)Package Includes**:
++(% style="color:#037691" %)**Package Includes**:
  * TrackerD LoRaWAN GPS/BLE Tracker x 1
  * USB recharge & program cable x 1
--**(% style="color:#037691" %)Dimensions and Weight**:
++(% style="color:#037691" %)**Dimensions and Weight**:
  * Device Size: 85 x 48 x 15 cm
  * Weight: 50g
--
--
--
  = 10.  Support =
@@ -921,9 +921,6 @@
  * 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]].
--
--
--
  = 11.  Reference =
@@ -931,5 +931,4 @@
  * **[[Source Code>>https://github.com/dragino/TrackerD]] **
  * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
--

image-20221006181316-1.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+17.7 KB

Content

image-20221006181357-2.png

Author

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

Size

...	...	@@ -1,0 +1,1 @@
	1	+88.0 KB

Content

Changes for page TrackerD -- LoRaWAN Tracker User Manual

Summary

Details

Applications

Navigation