Last modified by Xiaoling on 2025/04/14 16:33
<
From version < 50.1 >
edited by Xiaoling
on 2022/09/30 10:10
To version < 50.2 >
edited by Xiaoling
on 2022/09/30 10:10
>
Change comment: There is no comment for this version

Summary

Details

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

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0