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

From version 74.5
edited by Xiaoling
on 2022/10/11 10:22
Change comment: There is no comment for this version
To version 50.1
edited by Xiaoling
on 2022/09/30 10:10
Change comment: Uploaded new attachment "1664503831430-500.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -1,13 +7,6 @@
1 -(% style="text-align:center" %)
2 -[[image:1664505654417-133.png]]
3 -
4 -
5 -
6 -
7 7  (% class="wikigeneratedid" %)
8 8  **Table of Contents:**
9 9  
10 -{{toc/}}
11 11  
12 12  
13 13  
... ... @@ -14,10 +14,9 @@
14 14  
15 15  = 1.  Introduction =
16 16  
10 +== 1.1  OverView ==
17 17  
18 -== 1.1  What is TrackerD ==
19 19  
20 -
21 21  (((
22 22  TrackerD is an (% style="color:blue" %)**Open Source LoRaWAN Tracker**(%%) based on (% style="color:blue" %)**ESP32 MCU**(%%) and (% style="color:blue" %)**Semtech LoRa Wireless Chip**.
23 23  )))
... ... @@ -25,14 +25,10 @@
25 25  (((
26 26  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.
27 27  
28 -(((
29 29  TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution.
30 -)))
31 31  
32 -(((
33 33  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.
34 34  )))
35 -)))
36 36  
37 37  (((
38 38  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.
... ... @@ -46,7 +46,6 @@
46 46  (% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.**
47 47  
48 48  
49 -
50 50  == 1.2 Specifications ==
51 51  
52 52  
... ... @@ -61,11 +61,13 @@
61 61  * EEPROM: 520 KB
62 62  * Clock Speed: 32Mhz
63 63  
51 +
64 64  (% style="color:blue" %)**Common DC Characteristics:**
65 65  
66 66  * Supply Voltage: 5V via USB port or Internal li-on battery
67 67  * Operating Temperature: -40 ~~ 60°C
68 68  
57 +
69 69  (% style="color:blue" %)**LoRa Spec:**
70 70  
71 71  * Frequency Range,
... ... @@ -87,10 +87,12 @@
87 87  * Packet engine up to 256 bytes with CRC.
88 88  * LoRaWAN 1.0.3 Specification
89 89  
79 +
90 90  (% style="color:blue" %)**Battery:**
91 91  
92 92  * 1000mA Li-on Battery power (for model TrackerD)
93 93  
84 +
94 94  (% style="color:blue" %)**Power Consumption**
95 95  
96 96  * Sleeping Mode: 200uA
... ... @@ -99,6 +99,7 @@
99 99  
100 100  
101 101  
93 +
102 102  == 1.3  Features ==
103 103  
104 104  
... ... @@ -105,7 +105,7 @@
105 105  * LoRaWAN 1.0.3 Class A
106 106  * ESP32 PICO D4
107 107  * SX1276/78 Wireless Chip
108 -* Arduino IDE Compatible
100 +* Arduino IDE Compatible
109 109  * Open source hardware / software
110 110  * Regular/ Real-time GPS,BLE,WIFI tracking
111 111  * Built-in3 axis accelerometer (LIS3DH)
... ... @@ -127,9 +127,9 @@
127 127  
128 128  
129 129  
122 +
130 130  = 2.1 Use TrackerD =
131 131  
132 -
133 133  == 2.1 How it works? ==
134 134  
135 135  
... ... @@ -136,688 +136,490 @@
136 136  TrackerD is configured as LoRaWAN OTAA Class A GPS tracker by default. It has OTAA keys to join LoRaWAN network. To connect a LoRaWAN network, user need to input the OTAA keys in the LoRaWAN IoT server and push reset button of TrackerD (next to USB port). TrackerD will wake up and auto join the network via OTAA.
137 137  
138 138  
139 -
140 140  == 2.2 Quick guide to connect to LoRaWAN server ==
141 141  
133 +Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example.
142 142  
143 -Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example. 
144 144  
136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
145 145  
146 -[[image:1664501652064-326.png]]
147 147  
148 -
149 -
150 150  The LPS8N is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. What the rest need to is register this device in TTN V3:
151 151  
141 +**(% style="color:blue" %)Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD.
152 152  
153 -(% style="color:blue" %)**Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD.
154 -
155 155  Each TrackerD is shipped with a sticker with the default device EUI as below:
156 156  
145 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
157 157  
158 -[[image:1664501677253-891.png]]
159 159  
160 160  
149 +
161 161  Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot:
162 162  
163 163  
164 -**__Add APP EUI in the application:__**
153 +Add APP EUI in the application
165 165  
155 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
166 166  
167 -[[image:1664501711466-918.png]]
157 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
168 168  
169 169  
160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
170 170  
171 -[[image:1664501721248-725.png]]
172 172  
173 173  
174 -[[image:1664501734705-405.png]]
164 +Add APP KEY and DEV EUI
175 175  
166 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
176 176  
177 177  
178 -**__Add APP KEY and DEV EUI:__**
179 179  
180 180  
181 -[[image:1664501784668-703.png]]
171 +**(% style="color:blue" %)Step 2**:(%%) Power on TrackerD by using the on board switch.
182 182  
183 183  
174 +**(% 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.
184 184  
185 185  
186 -(% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
177 +**(% style="color:blue" %)Positioning Mode(SMOD):**
187 187  
179 +* **GPS ONLY(Factory Settings): **only get GPS location info.
180 +* **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking.
181 +* **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking.
188 188  
189 -(% 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.
183 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]].
190 190  
191 191  
186 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- ==
192 192  
193 -== 2.3  Positioning Mode(SMOD) ==
194 194  
189 +=== 2.3.1 Uplink FPORT=5, Device Status ===
195 195  
196 -Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported.
197 197  
198 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
199 -* (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
200 -* (% 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.
201 201  
202 -Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
193 +=== 2.3.2 Uplink FPORT= , Realtime GNSS Positioning ===
203 203  
195 +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. )
204 204  
205 205  
206 -== 2.4  Uplink Payload ==
198 +|(((
199 +**Size**
207 207  
201 +**(bytes)**
202 +)))|4|4|2|1|(((
203 +2
208 208  
209 -=== 2.4.1 Uplink FPORT~=5, Device Status ===
210 -
211 -
212 -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.
213 -
214 -
215 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
216 -|=(% 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
217 -|=(% 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
218 -
219 -[[image:1665301570342-765.png]]
220 -
221 -
222 -(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
223 -
224 -(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
225 -
226 -(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
227 -
228 -(% style="color:#037691" %)**Frequency Band**:
229 -
230 -*0x01: EU868
231 -
232 -*0x02: US915
233 -
234 -*0x03: IN865
235 -
236 -*0x04: AU915
237 -
238 -*0x05: KZ865
239 -
240 -*0x06: RU864
241 -
242 -*0x07: AS923
243 -
244 -*0x08: AS923-1
245 -
246 -*0x09: AS923-2
247 -
248 -*0x0a: AS923-3
249 -
250 -Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
251 -
252 -(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
253 -
254 -
255 -(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
256 -
257 -Use can also get the Device Status uplink through the downlink command:
258 -
259 -TrackerD Model:0x40
260 -
261 -(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %)
262 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit
263 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD
264 -
265 -(% style="color:blue" %)**SMOD:**
266 -
267 -(% style="color:red" %)**1 :** (%%) GPS ONLY
268 -
269 -(% style="color:red" %)**2 :** (%%) BLE ONLY
270 -
271 -(% style="color:red" %)**3 :**  (%%) GPS/BLE Hybrid
272 -
273 -
274 -(% style="color:blue" %)**GPS MOD:**
275 -
276 -(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values
277 -
278 -(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values
279 -
280 -
281 -(% style="color:blue" %)**BLE MOD:**
282 -
283 -(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon
284 -
285 -TrackerD Status:  0x02
286 -
287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %)
288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit
289 -|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode
290 -
291 -(% style="color:red" %)**0 : **(%%) Transport Mode
292 -
293 -(% style="color:red" %)**1 :  **(%%) AT+LON
294 -
295 -(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable
296 -
297 -
298 -
299 -=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
300 -
301 -
302 -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.
303 -
304 -
305 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
306 -|=(% scope="row" style="width: 50px;" %)(((
307 -**Size(bytes)**
308 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
205 +(optional )
206 +)))|(((
309 309  2
310 -)))|(% style="width:87px" %)(((
311 -2
208 +
209 +(optional)
312 312  )))
313 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
314 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
315 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
211 +|**Value**|[[Latitude>>path:#Location]]|[[Longitude>>path:#Location]]|(((
212 +[[Alarm &>>path:#Alarm]]
316 316  
317 -[[image:1665301636888-168.png]]
214 +[[BAT>>path:#Alarm]]
215 +)))|[[FLAG>>path:#Flag]]|Hum|[[Tem>>path:#Pitch]]
318 318  
319 319  
320 -==== (% style="color:blue" %)**Alarm & BAT:**(%%) ====
218 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
321 321  
322 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
323 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
324 -|=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
325 325  
221 +**Alarm & BAT:**
326 326  
223 +|**Size(bit)**|1 bit|1bit|14 bits
224 +|**Value**|reserve|Alarm Indicate|[[BAT>>path:#BAT]]
327 327  
328 -==== (% style="color:blue" %)**FLAG:**(%%) ====
226 +**FLAG:**
329 329  
330 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
331 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
332 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
228 +|**Size(bit)**|2 bits|1bit|5 bits
229 +|**Value**|[[MOD>>path:#MD]]|[[LON>>path:#LON]]|Firmware version
333 333  
334 -**Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
335 335  
336 336  
337 -==== (% style="color:blue" %)**Location info:**(%%) ====
233 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A **
338 338  
339 -* Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
340 -* Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
341 341  
342 -(% style="color:red" %)**Important note:**
236 +**Location info:**
343 343  
344 -1.  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.
238 +* Latitude: 02863D68⇒ //if (0x//02863D68//& 0x80000000 = 0 )~://
345 345  
346 -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:
240 +//value = 02863D68 /1000000 = 42.351976//
347 347  
242 +* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://
348 348  
349 -[[image:1664502116362-706.png]]
244 +//value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
350 350  
351 351  
352 -3.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
247 +Important note:
353 353  
354 -[[image:1664502166010-515.png]]
249 +1. 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.
250 +1. In firmware version v1.5, Roll & Pitch is disabled by default.
251 +1. 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:
355 355  
253 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
356 356  
357 357  
358 -==== (% style="color:blue" %)**Alarm:**(%%) ====
256 +1. While GPS can’t get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
359 359  
360 -Example:  0x4B & 0x40 >> 6 = 0x01
258 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
361 361  
260 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01
261 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV).
362 362  
363 -==== (% style="color:blue" %)**BAT:**(%%) ====
263 +The battery info shows the current voltage, for **TrackerD** version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \
364 364  
365 -Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
366 366  
367 -(((
368 -The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
369 -)))
266 +* > 4.0v : 80% ~~ 100%
267 +* 3.85v ~~3.99v: 60% ~~ 80%
268 +* 3.70v ~~ 3.84v: 40% ~~ 60%
269 +* 3.40v ~~ 3.69v: 20% ~~ 40%
270 +* < 3.39v: 0~~20%
370 370  
371 -* > 4.0v :  80% ~~ 100%
372 -* 3.85v ~~3.99v:  60% ~~ 80%
373 -* 3.70v ~~ 3.84v:  40% ~~ 60%
374 -* 3.40v ~~ 3.69v:  20% ~~ 40%
375 -* < 3.39v:  0~~20%
376 376  
273 +* **LON: **Enable/Disable LED activity for uplink
377 377  
275 +0x00: Disable LED indicator.
378 378  
379 -==== (% style="color:blue" %)**MOD:**(%%) ====
277 +0x01: Enable LED indicator (Default Value)
380 380  
381 -Set the format of GPS data uplink link
382 382  
383 -0x00:  Enable uploading on-board Temperature and humidity values
280 +* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
281 +* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree
384 384  
385 -0x01:  Disable uploading on-board Temperature and humidity values
386 386  
387 387  
388 -==== (% style="color:blue" %)**LON:**(%%) ====
285 +=== 2.3.3 Uplink FPORT= , History GNSS Positioning ===
389 389  
390 -Enable/Disable LED activity for uplink
391 391  
392 -(((
393 -0x00:  Disable LED indicator.
394 -)))
395 395  
396 -(((
397 -0x01:  Enable LED indicator (Default Value)
398 -)))
289 +=== 2.3.4 BLE positioning Payload(Fport=2) ===
399 399  
291 +Different MODE has different payload:
400 400  
401 -==== (% style="color:blue" %)**Hum:**(%%) ====
293 +**MODE=2**
402 402  
403 -0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
295 +|(((
296 +**Size**
404 404  
298 +**(bytes)**
299 +)))|16|4|4|2|4|2|1
300 +|**Value**|[[UUID>>path:#Location]]|(((
301 +iBeacon
405 405  
406 -==== (% style="color:blue" %)**Tem:**(%%) ====
303 +MAJOR
304 +)))|(((
305 +iBeacon
407 407  
408 -011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
307 +MINOR
308 +)))|(((
309 +iBeacon Measured
409 409  
311 +Power
312 +)))|(((
313 +iBeacon
410 410  
315 +RSSI
316 +)))|(((
317 +[[Alarm &>>path:#Alarm]]
411 411  
412 -=== 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
319 +[[BAT>>path:#Alarm]]
320 +)))|[[FLAG>>path:#Flag]]
413 413  
414 414  
415 -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)
323 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
416 416  
417 417  
418 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
419 -|=(% scope="row" style="width: 50px;" %)(((
420 -**Size(bytes)**
421 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
422 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
423 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
424 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
326 +* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
327 +* **MODE: **Define the payload format.
328 +* **UUID: **The uuid from the strongest iBeacon.
329 +* **MAJOR**: The MAJOR from the strongest iBeacon.
330 +* **MINOR**: The MAJOR from the strongest iBeacon.
331 +* **Measured** **Power**: The Measured Power from the strongest iBeacon.
332 +* **RSSI**: The RSSI from the strongest iBeacon.
425 425  
426 -(% class="wikigeneratedid" %)
427 -[[image:1665301687277-443.png]]
428 428  
429 429  
336 +=== 2.3.5 Add Payload format in TTN V3 ===
430 430  
431 -=== 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
432 -
433 -
434 -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.
435 -
436 -
437 -(% style="color:red" %)**Note for this mode:**
438 -
439 -* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
440 -* 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.
441 -
442 -The payload is 15 bytes, as below.
443 -
444 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
445 -|=(% scope="row" %)(((
446 -**Size(bytes)**
447 -)))|4|4|2|1|1|1|1|1
448 -|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen
449 -
450 -[[image:image-20221009160309-2.png]]
451 -
452 -
453 -
454 -=== 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
455 -
456 -
457 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
458 -|=(% scope="row" style="width: 60px;" %)(((
459 -**Size(bytes)**
460 -)))|(% 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
461 -|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
462 -iBeacon MAJOR
463 -)))|(% style="width:63px" %)(((
464 -iBeacon MINOR
465 -)))|(% style="width:71px" %)(((
466 -iBeacon Measured Power
467 -)))|(% style="width:50px" %)(((
468 -iBeacon RSSI
469 -)))|(% style="width:47px" %)(((
470 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
471 -)))|(% style="width:15px" %)[[FLAG>>||anchor="HFLAG:"]]
472 -
473 -[[image:1664502425687-834.png]]
474 -
475 -
476 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
477 -* (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
478 -* (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
479 -* (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
480 -* (% style="color:#037691" %)**MINOR:**  (%%)The MAJOR from the strongest iBeacon.
481 -* (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
482 -* (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
483 -
484 -
485 -
486 -=== 2.4.6  Add Payload format in TTN V3 ===
487 -
488 -
489 489  In TTN V3, use can add a custom payload so it shows friendly.
490 490  
491 -In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
340 +In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder
492 492  
342 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
493 493  
494 -[[image:1664502649601-895.png]]
495 -
496 -
497 497  Add the decoder from this link:
498 498  
499 499  
500 500  Save the change the uplink message will be parsed. As below:
501 501  
502 -[[image:1664502676891-606.png]]
349 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
503 503  
504 504  
505 505  
506 -== 2.5 Integrate with Datacake ==
507 507  
508 508  
509 -(((
510 -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.
511 -)))
355 +== 2.4 Integrate with Datacake ==
512 512  
513 -(((
514 -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]]
515 -)))
516 516  
358 +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.
517 517  
518 -[[image:1664502695771-538.png]]
360 +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]]
519 519  
362 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
520 520  
521 521  
522 -== 2.6 Integrate with Tago ==
365 +== 2.5 Integrate with Tago ==
523 523  
524 524  
525 -(((
526 526  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.
527 -)))
528 528  
529 -(((
530 530  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]]
531 -)))
532 532  
372 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
533 533  
534 -[[image:1664502715371-321.png]]
535 535  
536 536  
537 537  
538 -== 2. Datalog Feature ==
377 +== 2.6 Alarm Mode ==
539 539  
540 540  
541 -total 273 entries,by default disable
380 +User can push the **RED button** by more than 5 seconds to enter Alarm Mode.
542 542  
543 543  
544 -Example use case.
383 +Once enter Alarm mode, the **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.
545 545  
546 -[[image:image-20221009234703-2.png||height="328" width="899"]]
547 547  
548 -
549 -[[image:image-20221009234629-1.png||height="390" width="577"]]
550 -
551 -
552 -
553 -== 2.8 Alarm Mode ==
554 -
555 -
556 -(((
557 -User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode.
558 -)))
559 -
560 -
561 -(((
562 -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.
563 -)))
564 -
565 -
566 -(((
567 567  Two ways to exit alarm mode:
568 -)))
569 569  
570 570  * Server send a downlink command to exit.
571 571  * User fast press the RED button 10 times.
572 572  
573 -(((
574 -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.
575 -)))
391 +When exit alarm mode, **RED LED** will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false.
576 576  
577 577  
394 +== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ==
578 578  
579 -== 2.9 Transport Mode ==
580 580  
581 581  
582 -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.
398 +== 2.8 LED Status ==
583 583  
584 584  
401 +|**Event**|**Action**|**AT+LON to control on/off**
402 +|**Power On**|**BLUE, RED , Green** flash once|N/A
403 +|**Join request**|**Green** led fast blink once (200ms)|Yes
404 +|**Join Success**|**Green** led on 5 second|N/A
405 +|**Fixing Location**|**BLUE **blinks 200ms per second|Yes
406 +|**Fixed and uplink**|**GREEN **blinks twice (200ms per blink)|Yes
407 +|**Fail Fix and uplink**|**RED **blinks twice (200ms per blink)|Yes
408 +|**Enter Alarm mode**|**RED **on for 3 seconds|Yes
409 +|**Uplink under Alarm**|**RED **on for 1 second|Yes
410 +|**Exit Alarm**|**BLUE **led on 5 second|Yes
411 +|**Get Downlink**|**GREEN** led on 1 second|Yes
412 +|**Movement Detect**|**RED **on 500ms|N/A
585 585  
586 -== 2.10 LED Status ==
587 587  
588 588  
589 -(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
590 -|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
591 -|(% 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
592 -|(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
593 -|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
594 -|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes
595 -|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes
596 -|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
597 -|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes
598 -|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes
599 -|(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)led on 5 second|(% style="width:202px" %)Yes
600 -|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
601 -|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
602 602  
603 603  
418 +== 2.9 Button Function ==
604 604  
605 -== 2.11 Button Function ==
420 +**RESET button:**
606 606  
422 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
607 607  
608 -(% style="color:blue" %)**RESET button:**
609 -
610 -[[image:1664502835802-546.png]]
611 -
612 612  Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server.
613 613  
614 614  
615 -(% style="color:red" %)**RED button:**
427 +**RED button:**
616 616  
617 -[[image:1664502854406-763.png]]
429 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
618 618  
431 +|**Function**|**Action**|**Description**
432 +|Send Alarm|Keep Pressing **RED** button for more than 5 seconds|Enter Alarm Mode.  See [[Alarm Mode>>path:#Alarm_Mode]]
433 +|Exit Alarm Mode|Fast press the **RED** button 10 times|Exit Alarm Mode
434 +|Enter Deep Sleep Mode|Press and hold the button for 10 seconds, then quickly press the device 3 times to enter deep sleep|This is the mode ship out from factory. CPU will be complete in sleep mode and no LoRa activity, only use before deploy.
619 619  
620 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
621 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
622 -|(% 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"]]
623 -|(% 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
624 -|(% 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.
625 625  
626 626  
627 627  
628 -== 2.12 USB Port Function ==
439 +== 2.10 USB Port Function ==
629 629  
630 -
631 631  The USB interface of TrackerD has below functions:
632 632  
633 633  * Power on the device
634 634  * Recharge the battery
635 -* [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
636 -* [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
445 +* [[Configure Device>>path:#AT_Command]]
446 +* [[Upgrade Firmware>>path:#upgrade_image]]
637 637  
638 638  
639 639  
450 +
451 +
640 640  = 3. Configure TrackerD via AT command or LoRaWAN downlink =
641 641  
642 642  
643 643  User can configure TrackerD via AT Command or LoRaWAN Downlink.
644 644  
645 -LoRaWAN Downlink instruction for different platforms:  [[IoT LoRaWAN Server>>doc:Main.WebHome]]
457 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]]
646 646  
647 647  
648 -
649 649  == 3.1 Access AT Command ==
650 650  
462 +TrackerD supports the AT command set in stock firmware. User can connect to TrackerD with TYPE-C cable to use AT commands as shown below. ...
651 651  
652 -TrackerD supports the AT command set in stock firmware. User can connect to TrackerD with TYPE-C cable to use AT commands as shown below.
464 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
653 653  
654 654  
655 -[[image:1664502999401-486.png]]
467 +In PC, User needs to set serial tool baud rate to **115200** to access serial console for TrackerD. TrackerD will output system info once power on and user will be able to send AT commands:
656 656  
657 657  
658 -In PC, User needs to set serial tool baud rate to (% style="color:green" %)**115200**(%%) to access serial console for TrackerD. TrackerD will output system info once power on and user will be able to send AT commands:
470 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
659 659  
660 660  
661 -[[image:1664503022490-662.png]]
662 662  
474 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
663 663  
476 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
664 664  
665 -[[image:1664503035713-500.png]]
666 666  
667 -
668 -
669 -[[image:1664503047675-651.png]]
670 -
671 -
672 -
673 673  == 3.2 Command Set ==
674 674  
675 675  
676 676  === 3.2.1 Set Transmit Interval ===
677 677  
678 -
679 679  Set device uplink interval.
680 680  
681 -* (% style="color:blue" %)**AT Command:**
486 +* AT Command:
682 682  
683 -(% style="color:#037691" %)**AT+TDC=xxx **
488 +AT+TDC=xxx
684 684  
685 -Example:  AT+TDC=300000. Means set interval to 5 minutes(300 seconds)
490 +Example: AT+TDC=300000. Means set interval to 5 minutes(300 seconds)
686 686  
687 687  
688 -* (% style="color:blue" %)**Downlink Payload (prefix 0x01):**
493 +* Downlink Payload (prefix 0x01):
689 689  
690 -(% style="color:#037691" %)**0x01 00 01 2C**  (%%) ~/~/  Same as AT+TDC=300000
495 +0x01 00 01 2C     ~/~/ Same as AT+TDC=300000
691 691  
692 692  
693 -
694 694  === 3.2.2 Set Alarm Packet transmission interval ===
695 695  
696 -
697 697  Set alarm packet transmit interval
698 698  
699 -* (% style="color:blue" %)**AT Command:**
502 +* AT Command:
700 700  
701 -(% style="color:#037691" %)**AT+ATDC=xx. **
504 +AT+ATDC=xx.
702 702  
703 -Example:  AT+ATDC=60000  **~-~->    ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
506 +Example: AT+ATDC=60000  à Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
704 704  
705 705  
706 -* (% style="color:blue" %)**Downlink Payload (prefix 0xB1):**
509 +* Downlink Payload (prefix 0xB1):
707 707  
708 -(% style="color:#037691" %)**0xB1 00 00 3C ** (%%) ~/~/  Same as AT+ATDC=60000
511 +0xB1 00 00 3C    ~/~/Same as AT+ATDC=60000
709 709  
710 710  
514 +=== 3.3.3 Set Sports Mode Packet transmission interval ===
711 711  
712 -=== 3.2.3 Set Transport Mode Packet transmission interval ===
516 +Set sports packet transmit interval
713 713  
518 +* AT Command:
714 714  
715 -Set Transport Mode packet transmit interval
520 +AT+MTDC=xx.
716 716  
717 -* (% style="color:blue" %)**AT Command:**
522 + Example: AT+MTDC=300000  à Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
718 718  
719 -(% style="color:#037691" %)**AT+MTDC=xx. **
720 720  
721 -Example:  AT+MTDC=300000  **~-~->    ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000
525 +* Downlink Payload (prefix 0x03):
722 722  
527 +0x03 00 01 2C    ~/~/Same as AT+ MTDC=3000000
723 723  
724 -* (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
725 725  
726 -(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+ MTDC=3000000
727 727  
531 +=== 3.3.4 Exit Alarm ===
728 728  
729 -
730 -=== 3.2.4 Exit Alarm ===
731 -
732 -
733 733  Server send downlink command to exit Alarm mode
734 734  
735 -* (% style="color:blue" %)**AT Command: No AT Command**
535 +* AT Command:
736 736  
737 -* (% style="color:blue" %)**Downlink Payload (prefix 0x02):**
537 +No AT Command
738 738  
739 -(% style="color:#037691" %)**0x02 01**    (%%) ~/~/  Exit Alarm Mode
740 740  
540 +* Downlink Payload (prefix 0x02):
741 741  
542 +0x02 01     ~/~/ Exit Alarm Mode
742 742  
743 -=== 3.2.5 Disable/Enable LED flash ===
744 744  
545 +=== 3.3.5 Disable/Enable LED flash ===
745 745  
746 746  Disable/Enable LED for position, downlink and uplink
747 747  
748 -* (% style="color:blue" %)**AT Command:**
549 +* AT Command:
749 749  
750 -(% style="color:#037691" %)**AT+LON=xx.  (Disable (0), Enable (1), default:1)**
551 +AT+LON=xx.  (Disable (0), Enable (1), default:1)
751 751  
752 -Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
553 + Example: AT+LON=0 à Disable LED for position, downlink and uplink.
753 753  
754 754  
755 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**
556 +* Downlink Payload (prefix 0xAE):
756 756  
757 -(% style="color:#037691" %)**0xAE 00 ** (%%) ~/~/  Same as AT+LON=0
558 +0xAE 00    ~/~/Same as AT+LON=0
758 758  
759 759  
760 760  
761 -=== 3.2.6 Disable/Enable Transport Mode ===
762 762  
563 +=== 3.3.6 Disable/Enable movement detect (Debug Only) ===
763 763  
764 -Users can use this feature to enable/disable Transport Mode.
565 +User can use this feature to check and set thread hole of movement detect
765 765  
766 -* (% style="color:blue" %)**AT Command:**
567 +* AT Command:
767 767  
768 -(% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
569 +AT+INTWK=xx.  (Disable (0), Enable (1), default:0)
769 769  
770 -Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
571 + Example: AT+ INTWK =1 à Enable detect movement.
771 771  
772 772  
773 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
574 +* Downlink Payload (prefix 0xAF):
774 774  
775 -(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+ INTWK =1
576 +0xAF 01    ~/~/Same as AT+ INTWK =1
776 776  
777 777  
778 778  
779 -=== 3.2.7 Set Positioning Mode ===
580 +=== 3.3.7 Set Positioning Mode ===
780 780  
582 +SMOD define the how TrackerD scan and uplink date.
781 781  
782 -SMOD define the how TrackerD scan and uplink data:
584 +GPS室外定位模式:设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。
783 783  
586 + BLE室内定位模式:设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。
784 784  
785 -* (% style="color:blue" %)**AT Command:**
588 + GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。
786 786  
787 -(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
590 +运动模式:设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。
788 788  
789 -(% style="color:#037691" %)** aa:**
790 790  
791 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
792 -* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
793 -* (% 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.
794 794  
795 -(% style="color:#037691" %)**bb:**
796 796  
797 -* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
798 -* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
595 +* AT Command:
799 799  
800 -(% style="color:#037691" %)**cc:   **
597 +AT+SMOD=xx.
801 801  
802 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
599 + Example:
803 803  
601 + AT+ SMOD =1,0    à GPS+ BAT+ State+Tem&Hum
804 804  
805 -(% style="color:blue" %)**Example:**
603 + AT+ SMOD =1,1    à GPS +BAT State
806 806  
807 - AT+ SMOD =1,0 ,0 ~-~->  GPS+ BAT+ State+Tem&Hum
808 - AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
809 - AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
605 + AT+ SMOD =2,3    à (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
810 810  
811 811  
812 -* (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
608 +* Downlink Payload (prefix 0xA5):
813 813  
814 -(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
610 +0xA5 01 00     ~/~/ Same as AT+ SMOD =1,0
815 815  
816 816  
613 +=== 3.3.8 Set MAX GPS position time ===
817 817  
818 -=== 3.2.8 Set MAX GPS position time ===
819 -
820 -
821 821  Set max positioning time, default is 150 seconds. TrackerD will try to get location info within this period. If fail to get position data within this time, TrackerD will use 000000 for latitude and longitude.
822 822  
823 823  
... ... @@ -824,60 +824,60 @@
824 824  If AT+FTIME=0. The GPS module will be always powered and positioning. This will highly increase the power consumption (up to 50mA). When AT+FTIME=0, it will improve fix accuracy and shorten the acquire time for next uplink.
825 825  
826 826  
827 -* (% style="color:blue" %)**AT Command:**
621 +* AT Command:
828 828  
829 -(% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
623 +AT+FTIME=xx  à Set to use xx as max fix time.
830 830  
831 -**Example:**  AT+FTIME=150
625 +Example: AT+FTIME=150
832 832  
833 833  
834 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
628 +* Downlink Payload (prefix 0xAA):
835 835  
836 -(% style="color:#037691" %)**0xAA 00 96 ** (%%) ~/~/  Set AT+FTIME=150
630 +0xAA 00 96      ~/~/Set AT+FTIME=150
837 837  
838 838  
839 839  
840 -=== 3.2.9 Set PDOP value for GPS fix accuracy ===
841 841  
635 +=== 3.3.9 Set PDOP value for GPS fix accuracy ===
842 842  
843 -PDOP(Position Dilution of Precision) filter, TrackerD will only accept GPS data with a lower PDOP value than pre-configure PDOP value. If device can't get a valid GPS packet within FTIME timeout, it will use the GPS data with lowest PDOP value to server.
637 +PDOP(Position Dilution of Precision) filter, TrackerD will only accept GPS data with a lower PDOP value than pre-configure PDOP value. If device cant get a valid GPS packet within FTIME timeout, it will use the GPS data with lowest PDOP value to server.
844 844  
845 845  
846 846  A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0
847 847  
848 848  
849 -* (% style="color:blue" %)**AT Command:**
643 +* AT Command:
850 850  
851 -(% style="color:#037691" %)**AT+PDOP=2.5 ** (%%) **~-~->  ** Set PDOP to 2.5
645 +AT+PDOP=2.5  à Set PDOP to 2.5
852 852  
853 853  
854 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAD):**
648 +* Downlink Payload (prefix 0xAD):
855 855  
856 -(% style="color:#037691" %)**0xAD 00 0A**   (%%) ~/~/  Set AT+PDOP=1  (0x0A / 10 =1)
650 +0xAD 00 0A    ~/~/Set AT+PDOP=1    (0x0A / 10 =1)
857 857  
858 -(% style="color:#037691" %)**0xAD 00 19**   (%%) ~/~/  Set AT+PDOP=2.5    (0x19 / 10 =2.5)
652 +0xAD 00 19    ~/~/Set AT+PDOP=2.5    (0x19 / 10 =2.5)
859 859  
860 -(% style="color:#037691" %)**0xAD 00 46**    (%%) ~/~/  Set AT+PDOP=7  (0x46 / 10 =7)
654 +0xAD 00 46    ~/~/Set AT+PDOP=7     (0x46 / 10 =7)
861 861  
656 +Disable/Enable the confirmation mode
862 862  
658 +* AT Command:
863 863  
864 -Disable/Enable the confirmation mode
660 +AT+CFM=xx.
865 865  
866 -* (% style="color:blue" %)**AT Command:**
662 + Example:
867 867  
868 -(% style="color:#037691" %)**AT+CFM=xx. **
664 + AT+ CFM=0    à Disable confirmation
869 869  
666 + AT+ CFM=1    à Enable confirmation
870 870  
871 -**~ Example:**
872 872  
873 - AT+ CFM=0    **~-~->   ** Disable confirmation
669 +* Downlink Payload (prefix 0x05):
874 874  
875 - AT+ CFM=1    **~-~->  ** Enable confirmation
671 +0x05 01      ~/~/ Same as AT+ SMOD =1
876 876  
877 877  
878 -* (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
879 879  
880 -(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+ SMOD =1
881 881  
882 882  
883 883  
... ... @@ -890,42 +890,38 @@
890 890  
891 891  == 5.1 Firmware Change Log ==
892 892  
893 -
894 894  **[[See this link>>url:https://github.com/dragino/TrackerD]]**
895 895  
896 896  
897 -
898 898  == 5.2 How to upgrade firmware ==
899 899  
692 +User can use the TrackerD ’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
900 900  
901 -User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
902 902  
695 +**(% style="color:blue" %)Step1:  **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
903 903  
904 -(% style="color:blue" %)**Step1:  **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
697 +**(% style="color:blue" %)Step2:** (%%) Install CH9102 driver in the PC.
905 905  
906 -
907 -(% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC.
908 -
909 909  After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
910 910  
911 911  
912 -(% 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]]
702 +**(% style="color:blue" %)Step3**(%%) Download and Install Flash Tool:
913 913  
704 +[[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]]
914 914  
915 -(% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
706 +**(% style="color:blue" %)Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
916 916  
917 917  
918 -[[image:1664503563660-578.png]]
709 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png||alt="image-20220712083115-1.png"]]
919 919  
711 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png||alt="image-20220712083115-2.png"]]
920 920  
921 -[[image:1664503574618-659.png]]
922 922  
714 +**(% style="color:blue" %)Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
923 923  
924 -(% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
716 +[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
925 925  
926 -[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
927 927  
928 -
929 929  Users need to use below files:
930 930  
931 931  boot_app0.bin @0e000
... ... @@ -932,17 +932,16 @@
932 932  
933 933  ESP_LORA-eeprom-class.bin @ 0x10000
934 934  
725 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png||alt="image-20220712083115-3.png"]]
935 935  
936 -[[image:1664503593459-435.png]]
727 +After upgrade finish, it will show finish as below:
937 937  
729 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png||alt="image-20220712083115-4.png"]]
938 938  
939 939  
940 -After upgrade finish, it will show finish as below:
941 941  
942 -[[image:1664503611848-385.png]]
943 943  
944 944  
945 -
946 946  = 6. Developer Guide =
947 947  
948 948  
... ... @@ -952,48 +952,49 @@
952 952  === 6.1.1 Set up ARDUINO compile environment ===
953 953  
954 954  
955 -* **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]]**
744 +* Download the latest Arduino software (IDE) from the Arduino official website
956 956  
957 -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]]
746 +[[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]
958 958  
748 +Install IDE on PC, open and click 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]]
959 959  
960 -[[image:1664503635019-941.png]]
750 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
961 961  
752 +* Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it.
962 962  
754 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
963 963  
964 -* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.**
965 965  
966 -[[image:1664503715811-892.png]]
757 +* Download the latest TrackerD from the dragino github
967 967  
759 +[[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
968 968  
969 969  
970 -* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
762 +Put the Library in the TrackerD directory into the libraries file in the Arduino directory
971 971  
972 -Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
764 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]]
973 973  
974 974  
975 -[[image:1664503752288-974.png]]
976 976  
977 977  
978 -
979 979  == 6.2 Source Code ==
980 980  
981 981  
982 -* (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:**
772 +* Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:
983 983  
984 -[[image:1664503794261-827.png]]
774 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
985 985  
776 +* Click to upload
986 986  
778 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
987 987  
988 -* (% style="color:blue" %)**Click to upload**
780 +* Check the result, if the upload is successful, as shown below, open the serial port to view the data
989 989  
990 -[[image:1664503808294-336.png]]
991 991  
783 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]]
992 992  
993 993  
994 -* (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data**
995 995  
996 -[[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
997 997  
998 998  
999 999  
... ... @@ -1000,10 +1000,11 @@
1000 1000  = 7.  FAQ =
1001 1001  
1002 1002  
793 +
1003 1003  == 7.1 How to change the LoRa Frequency Bands/Region? ==
1004 1004  
1005 1005  
1006 -User can follow the introduction for [[how to upgrade image>>||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.
797 +User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
1007 1007  
1008 1008  
1009 1009  
... ... @@ -1014,8 +1014,8 @@
1014 1014  
1015 1015  
1016 1016  
1017 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)
1018 -|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin**
808 +(% border="2" style="background-color:#ffffcc; color:green; width:314px" %)
809 +|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin**
1019 1019  |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
1020 1020  |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
1021 1021  |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
... ... @@ -1025,8 +1025,6 @@
1025 1025  |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
1026 1026  |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
1027 1027  
1028 -
1029 -
1030 1030  = 8.  Order Info =
1031 1031  
1032 1032  
... ... @@ -1035,6 +1035,7 @@
1035 1035  (% style="color:blue" %)**XXX**(%%): The default frequency band
1036 1036  
1037 1037  * (% style="color:red" %)**EU433**(%%): Default frequency band EU433
827 +* (% style="color:red" %)**CN470**(%%): Default frequency band CN470
1038 1038  * (% style="color:red" %)**EU868**(%%): Default frequency band EU868
1039 1039  * (% style="color:red" %)**IN865**(%%): Default frequency band IN865
1040 1040  * (% style="color:red" %)**KR920**(%%): Default frequency band KR920
... ... @@ -1043,30 +1043,32 @@
1043 1043  * (% style="color:red" %)**US915**(%%): Default frequency band US915
1044 1044  
1045 1045  
1046 -
1047 1047  = 9.  Packing Info =
1048 1048  
1049 1049  
1050 -(% style="color:#037691" %)**Package Includes**:
839 +**Package Includes**:
1051 1051  
1052 -* TrackerD LoRaWAN GPS/BLE Tracker x 1
1053 -* USB recharge & program cable x 1
841 +* TrackerD x 1
842 +* Rechargeable cable x 1
843 +* Program Cable x 1
1054 1054  
1055 -(% style="color:#037691" %)**Dimensions and Weight**:
845 +**Dimensions and Weight**:
1056 1056  
1057 -* Device Size: 85 x 48 x 15 cm
1058 -* Weight: 50g
847 +* Device Size: 85 x 48 x 15 mm/pcs
848 +* Weight: 55g/pcs
1059 1059  
1060 1060  
1061 1061  
1062 1062  = 10. Support =
1063 1063  
1064 -
1065 1065  * 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.
1066 -* 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]].
855 +* 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
1067 1067  
857 +[[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]
1068 1068  
1069 1069  
860 +
861 +
1070 1070  = 11.  Reference =
1071 1071  
1072 1072  
... ... @@ -1073,5 +1073,3 @@
1073 1073  * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1074 1074  * **[[Source Code>>https://github.com/dragino/TrackerD]] **
1075 1075  * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
1076 -
1077 -
1664505654417-133.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -27.5 KB
Content
1665301570342-765.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -31.6 KB
Content
1665301636888-168.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -36.6 KB
Content
1665301687277-443.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -22.6 KB
Content
1665301786397-168.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -22.6 KB
Content
image-20221006181316-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -17.7 KB
Content
image-20221006181357-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -88.0 KB
Content
image-20221009160220-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -46.4 KB
Content
image-20221009160309-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -57.2 KB
Content
image-20221009234629-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -222.9 KB
Content
image-20221009234703-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -136.4 KB
Content