Changes for page TrackerD -- LoRaWAN Tracker User Manual

Last modified by Xiaoling on 2025/04/27 16:48

From 97.1 to 98.1 From 113.5 to 113.6

From version 98.1

edited by Bei Jinggeng
on 2022/11/02 14:47

Change comment: There is no comment for this version

To version 113.5

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Author

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

Content

@@ -97,6 +97,8 @@
  * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
  * Tracking: max: 38mA
++
++
  == 1.3  Features ==
@@ -115,6 +115,8 @@
  * Tri-color LED, Alarm button
  * Datalog
++
++
  == 1.4  Applications ==
@@ -121,9 +121,11 @@
  * Logistics and Supply Chain Management
  * Human tracking
--= 2.1  Use TrackerD =
++= 2.  Use TrackerD =
++
++
  == 2.1  How it works? ==
@@ -172,11 +172,10 @@
  **__Add APP KEY and DEV EUI:__**
--[[image:1664501784668-703.png]]
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS02%20-%20LoRaWAN%20Door%20Sensor%20User%20Manual/WebHome/1654671889112-678.png?rev=1.1||alt="1654671889112-678.png"]]
--
  (% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
@@ -288,6 +288,8 @@
  |=(% 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
  |=(% 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"]]
++
++
  === 2.4.2  Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
@@ -315,6 +315,8 @@
  |=(% 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:120px" %)
@@ -364,6 +364,8 @@
  * 3.40v ~~ 3.69v:   20% ~~ 40%
  * < 3.39v:             0~~20%
++
++
  ==== (% style="color:blue" %)**MOD:**(%%) ====
  **Example: ** (0x60>>6) & 0x3f =1
@@ -433,7 +433,7 @@
  (% style="color:red" %)**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 (% 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.
++* 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.
  * 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
  The payload is 15 bytes, as below.
@@ -483,12 +483,14 @@
  * (% style="color:#037691" %)**Measured Power: ** (%%)   The Measured Power from the strongest iBeacon.
  * (% style="color:#037691" %)**RSSI:  **    (%%) The RSSI from the strongest iBeacon.
--=== 2.4.6  Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID ===
--TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan WiFi and find the strongest WiFi info and uplink.
++=== 2.4.6  Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID（Since firmware 1.4.1） ===
++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.
++
++
  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %)
  |=(% scope="row" style="width: 60px;" %)(((
  **Size(bytes)**
@@ -505,6 +505,8 @@
  * (% style="color:#037691" %)**SSID:      **(%%)WiFi name.
  * (% style="color:#037691" %)**RSSI:      **(%%)The RSSI from the strongest WiFi.
++
++
  === 2.4.7  Add Payload format in TTN V3 ===
@@ -533,6 +533,7 @@
  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]]
@@ -545,7 +545,6 @@
  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]]
@@ -616,6 +616,8 @@
  |(% 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.11  Button Function ==
@@ -637,6 +637,8 @@
  |(% 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.12  USB Port Function ==
@@ -647,6 +647,8 @@
  * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
  * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
++
++
  = 3.  Configure TrackerD via AT command or LoRaWAN downlink =
@@ -731,7 +731,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=3000000
@@ -775,12 +775,12 @@
  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
--Example:  AT+ INTWK =1   **~-~->   ** Enable Transport Mode.
++Example:  AT+INTWK=1   **~-~->   ** Enable Transport Mode.
  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
--(% style="color:#037691" %)**0xAF 01 ** (%%)    ~/~/  Same as AT+ INTWK =1
++(% style="color:#037691" %)**0xAF 01 ** (%%)    ~/~/  Same as AT+INTWK=1
@@ -797,30 +797,37 @@
  (% style="color:#037691" %)** aa:**
  * (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
++
  * (% 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.
--* (% 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.
++* (% 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.
++
  (% style="color:#037691" %)**bb:**
  * (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
++
  * (% style="color:red" %)**1 :**(%%)  GPS +BAT State
  (% style="color:#037691" %)**cc:   **
--* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
++* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
++
  * (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%))
  (% style="color:blue" %)**Example:**
--  AT+ SMOD =1,0,0    ~-~->    GPS+ BAT+ State+Tem&Hum
--  AT+ SMOD =1,1,0    ~-~->    GPS +BAT State
--  AT+ SMOD =2,0,1    ~-~->    (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
--  AT+ SMOD =2,0,2    ~-~->    (WiFi)SSID+Rssi+BAT+State
++  AT+SMOD=1,0,0    ~-~->    GPS+ BAT+ State+Tem&Hum
++  AT+SMOD=1,1,0    ~-~->    GPS +BAT State
++  AT+SMOD=2,0,1    ~-~->    (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
++
++  AT+SMOD=2,0,2    ~-~->    (WiFi)SSID+Rssi+BAT+State
++
++
  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
--(% style="color:#037691" %)**0xA5 01 00 00**    (%%)   ~/~/  Same as AT+ SMOD =1,0,0
++(% style="color:#037691" %)**0xA5 01 00 00**    (%%)   ~/~/  Same as AT+SMOD=1,0,0
@@ -879,14 +879,14 @@
  **~ Example:**
--  AT+ CFM=0    **~-~->   ** Disable confirmation
++  AT+CFM=0    **~-~->   ** Disable confirmation
--  AT+ CFM=1    **~-~->  **  Enable confirmation
++  AT+CFM=1    **~-~->  **  Enable confirmation
  * (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
--(% style="color:#037691" %)**0x05 01 **(%%)         ~/~/  Same as AT+ SMOD =1
++(% style="color:#037691" %)**0x05 01 **(%%)         ~/~/  Same as AT+CFM=1
@@ -925,32 +925,32 @@
       (% style="color:#037691" %)**AT+BLEMASK=0**  (%%)             ~/~/ disable BLEMASK
++(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1）**
--(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**
++Example:  0xB2010203040506    ~/~/ Set BLEMASK to 123456
--Example:  0xA5010203040506    ~/~/ Set BLEMASK to 123456
--=== 3.2.12  Set WiFIMASK to filter WiFi SSID ===
++=== 3.2.12  Set WiFIMASK to filter WiFi SSID（Since firmware 1.4.1） ===
--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. It will ignore all other WiFi which doesn’t contact 123456 in the SSID.
++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.
  (% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.**
  (% style="color:blue" %)**AT Command:**
--     (% style="color:#037691" %)**AT+ WiFiMASK =123456**    (%%) ~/~/ Set WiFiMASK = 123456
++     (% style="color:#037691" %)**AT+WiFiMASK=123456**    (%%) ~/~/ Set WiFiMASK = 123456
--     (% style="color:#037691" %)**AT+ WiFiMASK =0**       (%%)        ~/~/ disable WiFiMASK
++     (% style="color:#037691" %)**AT+WiFiMASK=0**       (%%)        ~/~/ disable WiFiMASK
++(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1）**
--(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**
++Example:  0xB3010203040506    ~/~/ Set WiFiMASK to 123456
--Example:  0xA5010203040506    ~/~/ Set WiFiMASK to 123456
--=== 3.2.13  Disable/Enable Information printing ===
++=== 3.2.13  Disable/Enable Information printing（Since firmware 1.4.1） ===
  Users can use this feature to enable/disable Information printing.
@@ -957,12 +957,27 @@
  (% style="color:blue" %)**AT Command:**
++(% style="color:#037691" %)**AT+SHOWID=XX         **(%%)  ~/~/(Disable (0), Enable (1), default:0)
++\\Example:  AT+SHOWID=1   ~-~->    Enable Information printing.
--(% style="color:#037691" %)**AT+ SHOWID=XX         **(%%)  ~/~/(Disable (0), Enable (1), default:0)
--
--Example:  AT+ SHOWID =1   ~-~->    Enable Information printing.
++=== 3.2.14 Get or Set Eight Channels Mode, only for us915, AU915（Since firmware 1.4.1） ===
++
++
++The Channels Mode in the LORAWAN LMIC library is from 0 ~~ 7. When CHE = 8, 72 channels will be accessible to the network.
++
++(% style="color:blue" %)**AT Command:**
++
++(% style="color:#037691" %)**AT+CHE=1**(%%) ~/~/ set one channels mode
++
++
++(% style="color:blue" %)**Downlink Payload:0X24**
++
++Example: 0x24 01 ~/~/ Same as AT+CHE=1
++
++
++
  = 4.  Setting for Different Scenarios =
@@ -1119,13 +1119,14 @@
  |(% 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
--== 7.3  Notes on using different serial port tools for TrackerD ==
--=== **Serial port utility** ===
++== 7.3  Notes on using different serial port tools for TrackerD ==
++=== 7.3.1  Serial port utility ===
++
  Serial port utility requires you to automatically add data streams.
  Need to adjust the data stream to RTS/CTS on physical restart.
@@ -1141,9 +1141,10 @@
  [[image:image-20221102140638-2.png]]
--=== **SecureCRT** ===
++=== 7.3.2  SecureCRT ===
++
  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.
@@ -1153,9 +1153,10 @@
  [[image:image-20221102140712-4.png]]
--=== **PUTTY** ===
++=== 7.3.3  PUTTY ===
++
  [[image:image-20221102140748-5.png]]
@@ -1164,9 +1164,44 @@
  [[image:image-20221102140801-6.png]]
--= 8.  Order Info =
++= 8  Trouble Shooting =
++
++
++== 8.1  TDC is changed to 4294947296 and cause no uplink. ==
++
++
++(((
++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
++)))
++
++
++
++== 8.2  Device not able get AT Command or show output after wake up from deep sleep mode ==
++
++
++(((
++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.
++)))
++
++
++
++== 8.3  The reason why it has been restarted after upgrading（V.1.4.1） ==
++
++
++(((
++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
++)))
++
++
++[[image:image-20221107145243-1.png||height="695" width="443"]]
++
++
++
++= 9.  Order Info =
++
++
  Part Number: (% style="color:blue" %)**TrackerD-XXX**
  (% style="color:blue" %)**XXX**(%%): The default frequency band
@@ -1179,9 +1179,11 @@
  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
  * (% style="color:red" %)**US915**(%%): Default frequency band US915
--= 9.  Packing Info =
++= 10.  Packing Info =
++
++
  (% style="color:#037691" %)**Package Includes**:
  * TrackerD LoRaWAN GPS/BLE Tracker x 1
@@ -1189,18 +1189,24 @@
  (% style="color:#037691" %)**Dimensions and Weight**:
--* Device Size: 85 x 48 x 15 cm
++* Device Size: 85 x 48 x 15 mm
  * Weight: 50g
--= 10.  Support =
++= 11.  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]].
--= 11.  Reference =
++= 12.  Reference =
++
++
  * [[**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]]
++
++

image-20221107145243-1.png

Author

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

Size

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

Content