Changes for page TrackerD -- LoRaWAN Tracker User Manual

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

From version < 77.1 >

edited by Edwin Chen
on 2022/10/13 23:15

To version < 84.5 >

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

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-20221024105643-1.png
- image-20221024105643-2.png

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Edwin
++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,6 +121,8 @@
  * Logistics and Supply Chain Management
  * Human tracking
++
++
  = 2.1  Use TrackerD =
@@ -253,7 +253,6 @@
  Use can also get the Device Status uplink through the downlink command:
--
  (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
  (% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
@@ -281,12 +281,11 @@
  (% style="color:red" %)**      1: ** (%%)  BLE Positioning with Strongest iBeacon
--
  (% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
--(% border="1.5" style="background-color:#ffffcc; color:green; width:450px" %)
--|(% style="width:77px" %)**Size(bit)**|(% style="width:82px" %)5 Bits|(% style="width:106px" %)1 Bit|(% style="width:67px" %)1 Bit|(% style="width:121px" %)1 Bit
--|(% style="width:77px" %)**Value**|(% style="width:82px" %)Reserve|(% style="width:106px" %)PNACKMD|(% style="width:67px" %)LON|(% style="width:121px" %)Transport** **Mode
++(% 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"]]
@@ -295,9 +295,7 @@
  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,
--(% style="color:red" %)Please note that 15 bytes won't work on DR0 on US915/AU915 frequency band. IoT server will see NULL payload in this case.(%%)
--
  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
  |=(% scope="row" style="width: 50px;" %)(((
  **Size(bytes)**
@@ -368,9 +368,11 @@
  * 3.40v ~~ 3.69v:   20% ~~ 40%
  * < 3.39v:             0~~20%
++
++
  ==== (% style="color:blue" %)**MOD:**(%%) ====
--**Example: ** (0x60>>6)& 0x3f =1.
++**Example: ** (0x60>>6) & 0x3f =1
  **Set the format of GPS data uplink link：**
@@ -413,7 +413,7 @@
  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
--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)
++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)
  (% 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>>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.
++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.
  (% style="color:red" %)**Note for this mode:**
@@ -439,6 +439,7 @@
  * 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,6 +455,11 @@
  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
++TrackerD supports BLE scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon and find the strongest iBeacon info and uplink.
++
++User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
++
++
  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
  |=(% scope="row" style="width: 60px;" %)(((
  **Size(bytes)**
@@ -474,7 +474,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.
@@ -482,6 +482,8 @@
  * (% 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  Add Payload format in TTN V3 ===
@@ -493,8 +493,9 @@
  [[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:
@@ -505,15 +505,10 @@
  == 2.5  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]]
@@ -521,15 +521,12 @@
  == 2.6  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.
--)))
++After TrackerD sends data to LoRaWAN server such as TTN, user 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]]
@@ -537,8 +537,9 @@
  == 2.7  Datalog Feature ==
--total 273 entries,by default disable
++total 273 entries,by default,
++User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
  Example use case.
@@ -558,7 +558,7 @@
  (((
--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.
++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 exits alert mode.
  )))
@@ -566,7 +566,7 @@
  Two ways to exit alarm mode:
  )))
--* Server send a downlink command to exit.
++* Server sends a downlink command to exit.
  * User fast press the RED button 10 times.
  (((
@@ -599,6 +599,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 ==
@@ -620,6 +620,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 ==
@@ -630,6 +630,8 @@
  * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
  * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
++
++
  = 3.  Configure TrackerD via AT command or LoRaWAN downlink =
@@ -654,11 +654,9 @@
  [[image:1664503022490-662.png]]
--
  [[image:1664503035713-500.png]]
--
  [[image:1664503047675-651.png]]
@@ -772,7 +772,7 @@
  === 3.2.7  Set Positioning Mode ===
--SMOD define the how TrackerD scan and uplink data:
++SMOD define how TrackerD scan and uplink data:
  * (% style="color:blue" %)**AT Command:**
@@ -796,7 +796,7 @@
  (% 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
@@ -894,6 +894,27 @@
  Example: 0x3401     ~/~/  Same as AT+PNACKMD=1
++
++=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
++
++
++BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. LBT1 will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID.
++
++(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.**
++
++(% style="color:blue" %)**AT Command:**
++
++     (% style="color:#037691" %)**AT+BLEMASK=123456**   (%%)  ~/~/ Set BLEMASK = 123456
++
++     (% style="color:#037691" %)**AT+BLEMASK=0**  (%%)             ~/~/ disable BLEMASK
++
++
++(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**
++
++Example:  0xA5010203040506    ~/~/ Set BLEMASK to 123456
++
++
++
  = 4.  Setting for Different Scenarios =
@@ -934,6 +934,7 @@
  [[image:1664503574618-659.png]]
++
  (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
  [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
@@ -979,7 +979,18 @@
  [[image:1664503715811-892.png]]
++(% id="cke_bm_4554S" style="display:none" %) (%%)Find the path of SP32 installation, find the file as shown in Figure 1, and change the SPI pin to the shown in Figure 2.
++[[image:image-20221024105643-1.png]]
++
++**~                                                                                Figure1**
++
++
++[[image:image-20221024105643-2.png]]
++
++                                                                                   **Figure2**
++
++
  * **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:
@@ -1038,6 +1038,8 @@
  |(% 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 =
@@ -1053,6 +1053,8 @@
  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
  * (% style="color:red" %)**US915**(%%): Default frequency band US915
++
++
  = 9.  Packing Info =
@@ -1066,6 +1066,8 @@
  * Device Size: 85 x 48 x 15 cm
  * Weight: 50g
++
++
  = 10.  Support =
@@ -1072,6 +1072,8 @@
  * 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 =

image-20221024105643-1.png

Author

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

Size

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

Content

image-20221024105643-2.png

Author

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

Size

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

Content

Changes for page TrackerD -- LoRaWAN Tracker User Manual

Summary

Details

Applications

Navigation