Changes for page TrackerD -- LoRaWAN Tracker User Manual

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

From 74.5 to 74.4 From 80.1 to 79.1

From version 79.1

edited by Edwin Chen
on 2022/10/22 00:11

Change comment: There is no comment for this version

To version 74.5

edited by Xiaoling
on 2022/10/11 10:22

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.Edwin
++XWiki.Xiaoling

Content

@@ -98,6 +98,7 @@
  * Tracking: max: 38mA
++
  == 1.3  Features ==
@@ -117,6 +117,7 @@
  * Datalog
++
  == 1.4  Applications ==
@@ -124,6 +124,7 @@
  * Human tracking
++
  = 2.1  Use TrackerD =
@@ -208,9 +208,7 @@
  Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours.
--Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
--
  (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
  |=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1
  |=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status
@@ -255,47 +255,50 @@
  Use can also get the Device Status uplink through the downlink command:
++TrackerD Model：0x40
++(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %)
++|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit
++|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD
--(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
++(% style="color:blue" %)**SMOD：**
--(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
--|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
--|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings
++(% style="color:red" %)**1 :** (%%)  GPS ONLY
--(% style="color:blue" %)**     SMOD：**
++(% style="color:red" %)**2 :** (%%)  BLE ONLY
--(% style="color:red" %)**      1 :** (%%)  GPS ONLY
++(% style="color:red" %)**3 :**  (%%) GPS/BLE Hybrid
--(% style="color:red" %)**      2 :** (%%)  BLE ONLY
--(% style="color:red" %)**      3 :**  (%%) GPS/BLE Hybrid
++(% style="color:blue" %)**GPS MOD:**
++(% style="color:red" %)**0 : ** (%%)  Enable uploading on-board Temperature and humidity values
--(% style="color:blue" %)**      GPS_MOD: Define how to send GPS payload**
++(% style="color:red" %)**1 :** (%%)   Disable uploading on-board Temperature and humidity values
--(% style="color:red" %)**      0 : ** (%%)  Enable uploading on-board Temperature and humidity values
--(% style="color:red" %)**      1 :** (%%)   Disable uploading on-board Temperature and humidity values
++(% style="color:blue" %)**BLE MOD:**
++(% style="color:red" %)**1: ** (%%)  BLE Positioning with Strongest iBeacon
--(% style="color:blue" %)**      BLE_Settings:**
++TrackerD Status:  0x02
--(% style="color:red" %)**      1: ** (%%)  BLE Positioning with Strongest iBeacon
++(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %)
++|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit
++|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode
++(% style="color:red" %)**0 : **(%%) Transport Mode
++(% style="color:red" %)**1 :  **(%%) AT+LON
--(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
++(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable
--(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %)
--|(% style="width:77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)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 ===
--Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes,
++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" %)
@@ -319,6 +319,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:250px" %)
@@ -351,12 +351,12 @@
  ==== (% style="color:blue" %)**Alarm:**(%%) ====
--**Example: ** 0x4B & 0x40 >> 6 = 0x01
++Example:  0x4B & 0x40 >> 6 = 0x01
  ==== (% style="color:blue" %)**BAT:**(%%) ====
--**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
++Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
  (((
  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
@@ -368,37 +368,30 @@
  * 3.40v ~~ 3.69v:   20% ~~ 40%
  * < 3.39v:             0~~20%
--==== (% style="color:blue" %)**MOD:**(%%) ====
--**Example: ** (0x60>>6) & 0x3f =1
--**Set the format of GPS data uplink link：**
++==== (% style="color:blue" %)**MOD:**(%%) ====
--(% style="color:#037691" %)**0x00:** (%%)  Enable uploading on-board Temperature and humidity values
--(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
++Set the format of GPS data uplink link
++0x00:    Enable uploading on-board Temperature and humidity values
--**Set the format of BLE data uplink link：**
++0x01:    Disable uploading on-board Temperature and humidity values
--(% style="color:#037691" %)**0x01: ** (%%)  BLE Positioning with Strongest iBeacon
--
  ==== (% style="color:blue" %)**LON:**(%%) ====
--**Example:** (0x60>>5) & 0x01=1.
--
  Enable/Disable LED activity for uplink
  (((
--(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
++0x00:   Disable LED indicator.
  )))
  (((
--(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
++0x01:   Enable LED indicator (Default Value)
  )))
--
  ==== (% style="color:blue" %)**Hum:**(%%) ====
 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
@@ -413,7 +413,7 @@
  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
--The default uplink payload includes total 11 bytes (**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)
++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" %)
@@ -432,7 +432,7 @@
  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
--Set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-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.
++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.
  (% style="color:red" %)**Note for this mode:**
@@ -439,7 +439,6 @@
  * 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.
--* 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.
@@ -455,9 +455,7 @@
  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
--TrackerD supports BLE scans for indoor positioning. User can set **SMOD** to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon before each uplink.
--
  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
  |=(% scope="row" style="width: 60px;" %)(((
  **Size(bytes)**
@@ -477,7 +477,7 @@
  [[image:1664502425687-834.png]]
--* (% style="color:#037691" %)**BAT: **  (%%)     Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
++* (% 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.
@@ -486,6 +486,7 @@
  * (% style="color:#037691" %)**RSSI:  **    (%%) The RSSI from the strongest iBeacon.
++
  === 2.4.6  Add Payload format in TTN V3 ===
@@ -497,9 +497,8 @@
  [[image:1664502649601-895.png]]
--Add the decoder from this link:
++Add the decoder from this link:
--[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
  Save the change the uplink message will be parsed. As below:
@@ -542,9 +542,8 @@
  == 2.7  Datalog Feature ==
--total 273 entries,by default,
++total 273 entries,by default disable
--User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
  Example use case.
@@ -605,6 +605,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 ==
@@ -626,6 +626,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 ==
@@ -636,6 +636,8 @@
  * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
  * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
++
++
  = 3.  Configure TrackerD via AT command or LoRaWAN downlink =
@@ -778,7 +778,7 @@
  === 3.2.7  Set Positioning Mode ===
--SMOD define how TrackerD scan and uplink data:
++SMOD define the how TrackerD scan and uplink data:
  * (% style="color:blue" %)**AT Command:**
@@ -800,9 +800,10 @@
  * (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
++
  (% style="color:blue" %)**Example:**
--  AT+ SMOD =1,0,0    ~-~->    GPS+ BAT+ State+Tem&Hum
++  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
@@ -863,7 +863,7 @@
  * (% style="color:blue" %)**AT Command:**
--(% style="color:#037691" %)**AT+CFM=xx**
++(% style="color:#037691" %)**AT+CFM=xx. **
  **~ Example:**
@@ -879,27 +879,6 @@
--=== 3.2.10  Auto Send None-ACK messages ===
--
--
--TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message.
--
--
--* (% style="color:blue" %)**AT Command: AT+PNACKMD**
--
--The default factory setting is 0.
--
--
--**Command Example Function Response:**
--
--(% style="color:#037691" %)**AT+PNACKMD=1**  (%%)  ~/~/  Poll None-ACK message OK
--
--
--* (% style="color:blue" %)**Downlink Command: 0x34**
--
--Example: 0x3401     ~/~/  Same as AT+PNACKMD=1
--
--
  = 4.  Setting for Different Scenarios =
@@ -1045,6 +1045,7 @@
  |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
++
  = 8.  Order Info =
@@ -1061,6 +1061,7 @@
  * (% style="color:red" %)**US915**(%%): Default frequency band US915
++
  = 9.  Packing Info =
@@ -1075,6 +1075,7 @@
  * Weight: 50g
++
  = 10.  Support =
@@ -1082,6 +1082,7 @@
  * 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 =