Skip to Content
Last modified by Xiaoling on 2025/04/27 16:48
From version 50.2
edited by Xiaoling
on 2022/09/30 10:10
Change comment: There is no comment for this version
To version 47.1
edited by Xiaoling
on 2022/09/30 10:09
Change comment: Uploaded new attachment "1664503794261-827.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -7,10 +7,9 @@
7 7  
8 8  = 1.  Introduction =
9 9  
10 +== 1.1  OverView ==
10 10  
11 -== 1.1  What is TrackerD ==
12 12  
13 -
14 14  (((
15 15  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**.
16 16  )))
... ... @@ -35,7 +35,6 @@
35 35  (% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.**
36 36  
37 37  
38 -
39 39  == 1.2 Specifications ==
40 40  
41 41  
... ... @@ -50,11 +50,13 @@
50 50  * EEPROM: 520 KB
51 51  * Clock Speed: 32Mhz
52 52  
51 +
53 53  (% style="color:blue" %)**Common DC Characteristics:**
54 54  
55 55  * Supply Voltage: 5V via USB port or Internal li-on battery
56 56  * Operating Temperature: -40 ~~ 60°C
57 57  
57 +
58 58  (% style="color:blue" %)**LoRa Spec:**
59 59  
60 60  * Frequency Range,
... ... @@ -76,10 +76,12 @@
76 76  * Packet engine up to 256 bytes with CRC.
77 77  * LoRaWAN 1.0.3 Specification
78 78  
79 +
79 79  (% style="color:blue" %)**Battery:**
80 80  
81 81  * 1000mA Li-on Battery power (for model TrackerD)
82 82  
84 +
83 83  (% style="color:blue" %)**Power Consumption**
84 84  
85 85  * Sleeping Mode: 200uA
... ... @@ -88,6 +88,7 @@
88 88  
89 89  
90 90  
93 +
91 91  == 1.3  Features ==
92 92  
93 93  
... ... @@ -107,6 +107,7 @@
107 107  * Datalog
108 108  
109 109  
113 +
110 110  == 1.4  Applications ==
111 111  
112 112  
... ... @@ -115,9 +115,9 @@
115 115  
116 116  
117 117  
122 +
118 118  = 2.1 Use TrackerD =
119 119  
120 -
121 121  == 2.1 How it works? ==
122 122  
123 123  
... ... @@ -124,25 +124,21 @@
124 124  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.
125 125  
126 126  
127 -
128 128  == 2.2 Quick guide to connect to LoRaWAN server ==
129 129  
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.
130 130  
131 -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. 
132 132  
136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
133 133  
134 -[[image:1664501652064-326.png]]
135 135  
136 -
137 -
138 138  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:
139 139  
141 +**(% style="color:blue" %)Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD.
140 140  
141 -(% style="color:blue" %)**Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD.
142 -
143 143  Each TrackerD is shipped with a sticker with the default device EUI as below:
144 144  
145 -[[image:1664501677253-891.png]]
145 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
146 146  
147 147  
148 148  
... ... @@ -150,36 +150,32 @@
150 150  Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot:
151 151  
152 152  
153 -**__Add APP EUI in the application:__**
153 +Add APP EUI in the application
154 154  
155 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
155 155  
156 -[[image:1664501711466-918.png]]
157 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
157 157  
158 158  
160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
159 159  
160 -[[image:1664501721248-725.png]]
161 161  
162 162  
163 -[[image:1664501734705-405.png]]
164 +Add APP KEY and DEV EUI
164 164  
166 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
165 165  
166 166  
167 -**__Add APP KEY and DEV EUI:__**
168 168  
169 169  
170 -[[image:1664501784668-703.png]]
171 +**(% style="color:blue" %)Step 2**:(%%) Power on TrackerD by using the on board switch.
171 171  
172 172  
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.
173 173  
174 174  
175 -(% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
177 +**(% style="color:blue" %)Positioning Mode(SMOD):**
176 176  
177 -
178 -(% 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.
179 -
180 -
181 -(% style="color:blue" %)**Positioning Mode(SMOD):**
182 -
183 183  * **GPS ONLY(Factory Settings): **only get GPS location info.
184 184  * **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking.
185 185  * **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking.
... ... @@ -187,63 +187,56 @@
187 187  User can switch modes by [[changing SMOD>>path:#Positioning_Mode]].
188 188  
189 189  
190 -
191 191  == 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- ==
192 192  
193 193  
194 -=== 2.3.1 Uplink FPORT~=5, Device Status ===
189 +=== 2.3.1 Uplink FPORT=5, Device Status ===
195 195  
196 196  
197 197  
198 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning ===
193 +=== 2.3.2 Uplink FPORT= , Realtime GNSS Positioning ===
199 199  
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. )
200 200  
201 -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. )
202 202  
203 -
204 -(% border="2" style="background-color:#ffffcc; color:green; width:537px" %)
205 -|(% style="width:69px" %)(((
198 +|(((
206 206  **Size**
207 207  
208 208  **(bytes)**
209 -)))|(% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)(((
202 +)))|4|4|2|1|(((
210 210  2
211 211  
212 212  (optional )
213 -)))|(% style="width:83px" %)(((
206 +)))|(((
214 214  2
215 215  
216 216  (optional)
217 217  )))
218 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)(((
211 +|**Value**|[[Latitude>>path:#Location]]|[[Longitude>>path:#Location]]|(((
219 219  [[Alarm &>>path:#Alarm]]
220 220  
221 221  [[BAT>>path:#Alarm]]
222 -)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]]
215 +)))|[[FLAG>>path:#Flag]]|Hum|[[Tem>>path:#Pitch]]
223 223  
224 224  
218 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
225 225  
226 -[[image:1664501958445-288.png]]
227 227  
228 -
229 229  **Alarm & BAT:**
230 230  
231 -(% border="2" style="background-color:#ffffcc; color:green; width:329px" %)
232 -|(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits
233 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]] 
223 +|**Size(bit)**|1 bit|1bit|14 bits
224 +|**Value**|reserve|Alarm Indicate|[[BAT>>path:#BAT]]
234 234  
235 -
236 -
237 237  **FLAG:**
238 238  
239 -(% border="2" style="background-color:#ffffcc; color:green; width:332px" %)
240 -|(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits
241 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version 
228 +|**Size(bit)**|2 bits|1bit|5 bits
229 +|**Value**|[[MOD>>path:#MD]]|[[LON>>path:#LON]]|Firmware version
242 242  
243 243  
244 -**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A  **
245 245  
233 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A **
246 246  
235 +
247 247  **Location info:**
248 248  
249 249  * Latitude: 02863D68⇒ //if (0x//02863D68//& 0x80000000 = 0 )~://
... ... @@ -250,33 +250,27 @@
250 250  
251 251  //value = 02863D68 /1000000 = 42.351976//
252 252  
253 -* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://
242 +* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://
254 254  
255 -//value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
244 +//value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
256 256  
257 257  
258 -**Important note:**
247 +Important note:
259 259  
260 -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.
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:
261 261  
262 -2.  In firmware version v1.5, Roll & Pitch is disabled by default.
253 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
263 263  
264 -3.  When enable 9-axis motion sensor, the total payload will be 15 bytes, while US915/AU915 DR0 accept only 11 bytes payload. In this case, the payload on server will be ignore and shows as below:
265 265  
256 +1. While GPS can’t get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
266 266  
267 -[[image:1664502116362-706.png]]
258 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
268 268  
260 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01
261 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV).
269 269  
270 -
271 -4.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
272 -
273 -[[image:1664502166010-515.png]]
274 -
275 -
276 -
277 -* **Alarm**:  Example: 0x4B & 0x40 >> 6 = 0x01
278 -* **BAT**:  Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV).
279 -
280 280  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: \
281 281  
282 282  
... ... @@ -287,12 +287,11 @@
287 287  * < 3.39v: 0~~20%
288 288  
289 289  
290 -
291 291  * **LON: **Enable/Disable LED activity for uplink
292 292  
293 -0x00:  Disable LED indicator.
275 +0x00: Disable LED indicator.
294 294  
295 -0x01:  Enable LED indicator (Default Value)
277 +0x01: Enable LED indicator (Default Value)
296 296  
297 297  
298 298  * **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -300,93 +300,86 @@
300 300  
301 301  
302 302  
285 +=== 2.3.3 Uplink FPORT= , History GNSS Positioning ===
303 303  
304 304  
305 -=== 2.3.3 Uplink FPORT~= , History GNSS Positioning ===
306 306  
289 +=== 2.3.4 BLE positioning Payload(Fport=2) ===
307 307  
308 -
309 -=== 2.3.4 BLE positioning Payload(Fport2) ===
310 -
311 -
312 312  Different MODE has different payload:
313 313  
314 314  **MODE=2**
315 315  
316 -(% border="2" style="background-color:#ffffcc; color:green; width:620px" %)
317 -|(% style="width:70px" %)(((
295 +|(((
318 318  **Size**
319 319  
320 320  **(bytes)**
321 -)))|(% style="width:54px" %)16|(% style="width:72px" %)4|(% style="width:71px" %)4|(% style="width:145px" %)2|(% style="width:72px" %)4|(% style="width:76px" %)2|(% style="width:54px" %)1
322 -|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)(((
299 +)))|16|4|4|2|4|2|1
300 +|**Value**|[[UUID>>path:#Location]]|(((
323 323  iBeacon
324 324  
325 325  MAJOR
326 -)))|(% style="width:71px" %)(((
304 +)))|(((
327 327  iBeacon
328 328  
329 329  MINOR
330 -)))|(% style="width:145px" %)(((
308 +)))|(((
331 331  iBeacon Measured
332 332  
333 333  Power
334 -)))|(% style="width:72px" %)(((
312 +)))|(((
335 335  iBeacon
336 336  
337 337  RSSI
338 -)))|(% style="width:76px" %)(((
316 +)))|(((
339 339  [[Alarm &>>path:#Alarm]]
340 340  
341 341  [[BAT>>path:#Alarm]]
342 -)))|(% style="width:54px" %)[[FLAG>>path:#Flag]]
320 +)))|[[FLAG>>path:#Flag]]
343 343  
344 -[[image:1664502425687-834.png]]
345 345  
323 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
346 346  
347 -* **BAT**:  Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
348 -* **MODE:  **Define the payload format.
349 -* **UUID:  **The uuid from the strongest iBeacon.
350 -* **MAJOR**:  The MAJOR from the strongest iBeacon.
351 -* **MINOR**:  The MAJOR from the strongest iBeacon.
352 -* **Measured** **Power**:  The Measured Power from the strongest iBeacon.
353 -* **RSSI**:  The RSSI from the strongest iBeacon.
354 354  
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.
355 355  
356 356  
357 357  
358 -
359 359  === 2.3.5 Add Payload format in TTN V3 ===
360 360  
361 -
362 362  In TTN V3, use can add a custom payload so it shows friendly.
363 363  
364 364  In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder
365 365  
342 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
366 366  
367 -[[image:1664502649601-895.png]]
368 -
369 369  Add the decoder from this link:
370 370  
371 371  
372 372  Save the change the uplink message will be parsed. As below:
373 373  
374 -[[image:1664502676891-606.png]]
349 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
375 375  
376 376  
377 377  
353 +
354 +
378 378  == 2.4 Integrate with Datacake ==
379 379  
380 380  
381 381  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.
382 382  
383 -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]]
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]]
384 384  
362 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
385 385  
386 -[[image:1664502695771-538.png]]
387 387  
388 -
389 -
390 390  == 2.5 Integrate with Tago ==
391 391  
392 392  
... ... @@ -394,8 +394,8 @@
394 394  
395 395  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]]
396 396  
372 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
397 397  
398 -[[image:1664502715371-321.png]]
399 399  
400 400  
401 401  
... ... @@ -416,7 +416,6 @@
416 416  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.
417 417  
418 418  
419 -
420 420  == 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ==
421 421  
422 422  
... ... @@ -424,29 +424,28 @@
424 424  == 2.8 LED Status ==
425 425  
426 426  
427 -(% border="2" style="background-color:#ffffcc; color:green; width:636px" %)
428 -|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off**
429 -|(% style="width:157px" %)**Power On**|(% style="width:271px" %)**BLUE, RED , Green** flash once|(% style="width:202px" %)N/A
430 -|(% style="width:157px" %)**Join request**|(% style="width:271px" %)**Green** led fast blink once (200ms)|(% style="width:202px" %)Yes
431 -|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)**Green** led on 5 second|(% style="width:202px" %)N/A
432 -|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)**BLUE **blinks 200ms per second|(% style="width:202px" %)Yes
433 -|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)**GREEN **blinks twice (200ms per blink)|(% style="width:202px" %)Yes
434 -|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)**RED **blinks twice (200ms per blink)|(% style="width:202px" %)Yes
435 -|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)**RED **on for 3 seconds|(% style="width:202px" %)Yes
436 -|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)**RED **on for 1 second|(% style="width:202px" %)Yes
437 -|(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)**BLUE **led on 5 second|(% style="width:202px" %)Yes
438 -|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)**GREEN** led on 1 second|(% style="width:202px" %)Yes
439 -|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)**RED **on 500ms|(% style="width:202px" %)N/A
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
440 440  
441 441  
442 442  
443 443  
417 +
444 444  == 2.9 Button Function ==
445 445  
446 -
447 447  **RESET button:**
448 448  
449 -[[image:1664502835802-546.png]]
422 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
450 450  
451 451  Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server.
452 452  
... ... @@ -453,20 +453,18 @@
453 453  
454 454  **RED button:**
455 455  
456 -[[image:1664502854406-763.png]]
429 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
457 457  
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.
458 458  
459 -(% border="2" style="background-color:#ffffcc; color:green; width:627px" %)
460 -|(% style="width:135px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**
461 -|(% style="width:135px" %)Send Alarm|(% style="width:220px" %)Keep Pressing **RED** button for more than 5 seconds|(% style="width:265px" %)Enter Alarm Mode.  See [[Alarm Mode>>path:#Alarm_Mode]]
462 -|(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the **RED** button 10 times|(% style="width:265px" %)Exit Alarm Mode
463 -|(% 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.
464 464  
465 465  
466 466  
467 467  == 2.10 USB Port Function ==
468 468  
469 -
470 470  The USB interface of TrackerD has below functions:
471 471  
472 472  * Power on the device
... ... @@ -477,6 +477,7 @@
477 477  
478 478  
479 479  
451 +
480 480  = 3. Configure TrackerD via AT command or LoRaWAN downlink =
481 481  
482 482  
... ... @@ -485,37 +485,30 @@
485 485  LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]]
486 486  
487 487  
488 -
489 489  == 3.1 Access AT Command ==
490 490  
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. ...
491 491  
492 -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]]
493 493  
494 494  
495 -[[image:1664502999401-486.png]]
496 -
497 -
498 498  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:
499 499  
500 500  
501 -[[image:1664503022490-662.png]]
470 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
502 502  
503 503  
504 504  
505 -[[image:1664503035713-500.png]]
474 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
506 506  
476 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
507 507  
508 508  
509 -[[image:1664503047675-651.png]]
510 -
511 -
512 -
513 513  == 3.2 Command Set ==
514 514  
515 515  
516 516  === 3.2.1 Set Transmit Interval ===
517 517  
518 -
519 519  Set device uplink interval.
520 520  
521 521  * AT Command:
... ... @@ -522,18 +522,16 @@
522 522  
523 523  AT+TDC=xxx
524 524  
525 -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)
526 526  
527 527  
528 528  * Downlink Payload (prefix 0x01):
529 529  
530 -0x01 00 01 2C     ~/~/  Same as AT+TDC=300000
495 +0x01 00 01 2C     ~/~/ Same as AT+TDC=300000
531 531  
532 532  
533 -
534 534  === 3.2.2 Set Alarm Packet transmission interval ===
535 535  
536 -
537 537  Set alarm packet transmit interval
538 538  
539 539  * AT Command:
... ... @@ -540,18 +540,16 @@
540 540  
541 541  AT+ATDC=xx.
542 542  
543 -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
544 544  
545 545  
546 546  * Downlink Payload (prefix 0xB1):
547 547  
548 -0xB1 00 00 3C  ~/~/  Same as AT+ATDC=60000
511 +0xB1 00 00 3C    ~/~/Same as AT+ATDC=60000
549 549  
550 550  
514 +=== 3.3.3 Set Sports Mode Packet transmission interval ===
551 551  
552 -=== 3.2.3 Set Sports Mode Packet transmission interval ===
553 -
554 -
555 555  Set sports packet transmit interval
556 556  
557 557  * AT Command:
... ... @@ -558,18 +558,17 @@
558 558  
559 559  AT+MTDC=xx.
560 560  
561 - Example:  AT+MTDC=300000  à Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
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
562 562  
563 563  
564 564  * Downlink Payload (prefix 0x03):
565 565  
566 -0x03 00 01 2C  ~/~/  Same as AT+ MTDC=3000000
527 +0x03 00 01 2C    ~/~/Same as AT+ MTDC=3000000
567 567  
568 568  
569 569  
570 -=== 3.2.4 Exit Alarm ===
531 +=== 3.3.4 Exit Alarm ===
571 571  
572 -
573 573  Server send downlink command to exit Alarm mode
574 574  
575 575  * AT Command:
... ... @@ -579,13 +579,11 @@
579 579  
580 580  * Downlink Payload (prefix 0x02):
581 581  
582 -0x02 01  ~/~/  Exit Alarm Mode
542 +0x02 01     ~/~/ Exit Alarm Mode
583 583  
584 584  
545 +=== 3.3.5 Disable/Enable LED flash ===
585 585  
586 -=== 3.2.5 Disable/Enable LED flash ===
587 -
588 -
589 589  Disable/Enable LED for position, downlink and uplink
590 590  
591 591  * AT Command:
... ... @@ -592,17 +592,17 @@
592 592  
593 593  AT+LON=xx.  (Disable (0), Enable (1), default:1)
594 594  
595 - Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
553 + Example: AT+LON=0 à Disable LED for position, downlink and uplink.
596 596  
597 597  
598 598  * Downlink Payload (prefix 0xAE):
599 599  
600 -0xAE 00  ~/~/  Same as AT+LON=0
558 +0xAE 00    ~/~/Same as AT+LON=0
601 601  
602 602  
603 603  
604 -=== 3.2.6 Disable/Enable movement detect (Debug Only) ===
605 605  
563 +=== 3.3.6 Disable/Enable movement detect (Debug Only) ===
606 606  
607 607  User can use this feature to check and set thread hole of movement detect
608 608  
... ... @@ -610,53 +610,50 @@
610 610  
611 611  AT+INTWK=xx.  (Disable (0), Enable (1), default:0)
612 612  
613 - Example:  AT+ INTWK =1  **~-~->  ** Enable detect movement.
571 + Example: AT+ INTWK =1 à Enable detect movement.
614 614  
615 615  
616 616  * Downlink Payload (prefix 0xAF):
617 617  
618 -0xAF 01  ~/~/  Same as AT+ INTWK =1
576 +0xAF 01    ~/~/Same as AT+ INTWK =1
619 619  
620 620  
621 621  
622 -=== 3.2.7 Set Positioning Mode ===
580 +=== 3.3.7 Set Positioning Mode ===
623 623  
624 -
625 625  SMOD define the how TrackerD scan and uplink date.
626 626  
627 -GPS室外定位模式：  设备默认模式，设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是3分钟定位，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。GPS还有一种logdata模式，在断网的情况下将数据存储下来，等到有网的时候，一次将数据以每10秒上报。
584 +GPS室外定位模式：设备默认模式，设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是3分钟定位，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。GPS还有一种logdata模式，在断网的情况下将数据存储下来，等到有网的时候，一次将数据以每10秒上报。
628 628  
629 -BLE室内定位模式：  设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是5秒，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每3分钟发送一次）。
586 + BLE室内定位模式：设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是5秒，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每3分钟发送一次）。
630 630  
631 -GPS和BLE混动模式：设备入网后会发送device当前模式下的信息，随后立即判断是否在室内，如果是就进行BLE定位，不是就GPS定位。如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。
588 + GPS和BLE混动模式：设备入网后会发送device当前模式下的信息，随后立即判断是否在室内，如果是就进行BLE定位，不是就GPS定位。如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。
632 632  
633 -运动模式：  设备入网后会发送device当前模式下的信息，随后发送GPS定位数据，设备判断是否在运动，没有运动传感器没有检测到动作，立即进入静止状态（默认20分钟），如果产生运动，将每5分钟发送一次数据，再第五分钟后检测设备有误运动，无将切换到静止状态，有立即发送数据。
590 +运动模式：设备入网后会发送device当前模式下的信息，随后发送GPS定位数据，设备判断是否在运动，没有运动传感器没有检测到动作，立即进入静止状态（默认20分钟），如果产生运动，将每5分钟发送一次数据，再第五分钟后检测设备有误运动，无将切换到静止状态，有立即发送数据。
634 634  
635 635  
636 636  
594 +
637 637  * AT Command:
638 638  
639 639  AT+SMOD=xx.
640 640  
599 + Example:
641 641  
642 - **Example:**
601 + AT+ SMOD =1,0    à GPS+ BAT+ State+Tem&Hum
643 643  
644 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
603 + AT+ SMOD =1,1    à GPS +BAT State
645 645  
646 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
605 + AT+ SMOD =2,3    à (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
647 647  
648 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
649 649  
650 -
651 651  * Downlink Payload (prefix 0xA5):
652 652  
653 -0xA5 01 00  ~/~/  Same as AT+ SMOD =1,0
610 +0xA5 01 00     ~/~/ Same as AT+ SMOD =1,0
654 654  
655 655  
613 +=== 3.3.8 Set MAX GPS position time ===
656 656  
657 -=== 3.2.8 Set MAX GPS position time ===
658 -
659 -
660 660  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.
661 661  
662 662  
... ... @@ -665,40 +665,39 @@
665 665  
666 666  * AT Command:
667 667  
668 -AT+FTIME=xx  **~-~-> ** Set to use xx as max fix time.
623 +AT+FTIME=xx  à Set to use xx as max fix time.
669 669  
670 -Example:  AT+FTIME=150
625 +Example: AT+FTIME=150
671 671  
672 672  
673 673  * Downlink Payload (prefix 0xAA):
674 674  
675 -0xAA 00 96  ~/~/  Set AT+FTIME=150
630 +0xAA 00 96      ~/~/Set AT+FTIME=150
676 676  
677 677  
678 678  
634 +
679 679  === 3.3.9 Set PDOP value for GPS fix accuracy ===
680 680  
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 can’t get a valid GPS packet within FTIME timeout, it will use the GPS data with lowest PDOP value to server.
681 681  
682 -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.
683 683  
684 -
685 685  A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0
686 686  
687 687  
688 688  * AT Command:
689 689  
690 -AT+PDOP=2.5  **~-~->  ** Set PDOP to 2.5
645 +AT+PDOP=2.5  à Set PDOP to 2.5
691 691  
692 692  
693 693  * Downlink Payload (prefix 0xAD):
694 694  
695 -0xAD 00 0A  ~/~/  Set AT+PDOP=1  (0x0A / 10 =1)
650 +0xAD 00 0A    ~/~/Set AT+PDOP=1    (0x0A / 10 =1)
696 696  
697 -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)
698 698  
699 -0xAD 00 46  ~/~/  Set AT+PDOP=7  (0x46 / 10 =7)
654 +0xAD 00 46    ~/~/Set AT+PDOP=7     (0x46 / 10 =7)
700 700  
701 -
702 702  Disable/Enable the confirmation mode
703 703  
704 704  * AT Command:
... ... @@ -705,20 +705,22 @@
705 705  
706 706  AT+CFM=xx.
707 707  
662 + Example:
708 708  
709 -**~ Example:**
664 + AT+ CFM=0    à Disable confirmation
710 710  
711 - AT+ CFM=0    **~-~->  ** Disable confirmation
666 + AT+ CFM=1    à Enable confirmation
712 712  
713 - AT+ CFM=1    **~-~->  ** Enable confirmation
714 714  
715 -
716 716  * Downlink Payload (prefix 0x05):
717 717  
718 -0x05 01  ~/~/  Same as AT+ SMOD =1
671 +0x05 01      ~/~/ Same as AT+ SMOD =1
719 719  
720 720  
721 721  
675 +
676 +
677 +
722 722  = 4. Setting for Different Scenarios =
723 723  
724 724  
... ... @@ -728,41 +728,35 @@
728 728  
729 729  == 5.1 Firmware Change Log ==
730 730  
731 -
732 732  **[[See this link>>url:https://github.com/dragino/TrackerD]]**
733 733  
734 734  
735 -
736 736  == 5.2 How to upgrade firmware ==
737 737  
692 +User can use the TrackerD ’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
738 738  
739 -User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
740 740  
695 +**(% style="color:blue" %)Step1:  **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
741 741  
742 -(% 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.
743 743  
744 -
745 -(% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC.
746 -
747 747  After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
748 748  
749 749  
750 -(% style="color:blue" %)**Step3：**(%%) Download and Install Flash Tool:
702 +**(% style="color:blue" %)Step3：**(%%) Download and Install Flash Tool:
751 751  
752 752  [[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]]
753 753  
706 +**(% style="color:blue" %)Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
754 754  
755 -(% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
756 756  
709 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png||alt="image-20220712083115-1.png"]]
757 757  
758 -[[image:1664503563660-578.png]]
711 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png||alt="image-20220712083115-2.png"]]
759 759  
760 760  
761 -[[image:1664503574618-659.png]]
714 +**(% style="color:blue" %)Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
762 762  
763 -
764 -(% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
765 -
766 766  [[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
767 767  
768 768  
... ... @@ -772,17 +772,16 @@
772 772  
773 773  ESP_LORA-eeprom-class.bin @ 0x10000
774 774  
725 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png||alt="image-20220712083115-3.png"]]
775 775  
776 -[[image:1664503593459-435.png]]
727 +After upgrade finish, it will show finish as below:
777 777  
729 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png||alt="image-20220712083115-4.png"]]
778 778  
779 779  
780 -After upgrade finish, it will show finish as below:
781 781  
782 -[[image:1664503611848-385.png]]
783 783  
784 784  
785 -
786 786  = 6. Developer Guide =
787 787  
788 788  
... ... @@ -792,50 +792,49 @@
792 792  === 6.1.1 Set up ARDUINO compile environment ===
793 793  
794 794  
795 -* 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
796 796  
797 -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]]
746 +[[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]
798 798  
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]]
799 799  
800 -[[image:1664503635019-941.png]]
750 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
801 801  
802 -
803 803  * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it.
804 804  
754 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
805 805  
806 806  
807 -[[image:1664503715811-892.png]]
757 +* Download the latest TrackerD from the dragino github
808 808  
759 +[[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
809 809  
810 810  
811 -* 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
812 812  
764 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]]
813 813  
814 -Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
815 815  
816 816  
817 -[[image:1664503752288-974.png]]
818 818  
819 -
820 -
821 821  == 6.2 Source Code ==
822 822  
823 823  
824 824  * Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:
825 825  
826 -[[image:1664503794261-827.png]]
774 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
827 827  
776 +* Click to upload
828 828  
778 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
829 829  
830 -* Click to upload
780 +* Check the result, if the upload is successful, as shown below, open the serial port to view the data
831 831  
832 -[[image:1664503808294-336.png]]
833 833  
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]]
834 834  
835 835  
836 -* Check the result, if the upload is successful, as shown below, open the serial port to view the data
837 837  
838 -[[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
839 839  
840 840  
841 841  
... ... @@ -884,6 +884,7 @@
884 884  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
885 885  * (% style="color:red" %)**US915**(%%): Default frequency band US915
886 886  
835 +
887 887  = 9.  Packing Info =
888 888  
889 889  
... ... @@ -899,6 +899,7 @@
899 899  * Weight: 55g/pcs
900 900  
901 901  
851 +
902 902  = 10. Support =
903 903  
904 904  * 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.
1664503808294-336.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -161.6 KB
Content
1664503824081-592.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -77.4 KB
Content
1664503831430-500.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -147.8 KB
Content