Skip to Content
Version 51.3 by Xiaoling on 2022/09/30 10:45
Show last authors
1 (% style="text-align:center" %)
2 [[image:1664505654417-133.png]]
3
4
5
6
7 (% class="wikigeneratedid" %)
8 **Table of Contents:**
9
10 {{toc/}}
11
12
13
14
15 = 1.  Introduction =
16
17
18 == 1.1  What is TrackerD ==
19
20
21 (((
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 )))
24
25 (((
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
28 TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution.
29
30 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.
31 )))
32
33 (((
34 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.
35
36
37 )))
38
39 [[image:1664499921684-770.png]]
40
41
42 (% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.**
43
44
45
46 == 1.2 Specifications ==
47
48
49 (% style="color:blue" %)**Micro Controller:**
50
51 * Espressif ESP32 PICO D4
52 * MCU: ESP32 PICO D4
53 * Bluetooth: Bluetooth V4.2 BR/EDR and Bluetooth LE
54 * WiFi : 802.11 b/g/n (802.11n up to 150 Mbps)
55 * Integrated SPI flash : 4 MB
56 * RAM: 448 KB
57 * EEPROM: 520 KB
58 * Clock Speed: 32Mhz
59
60 (% style="color:blue" %)**Common DC Characteristics:**
61
62 * Supply Voltage: 5V via USB port or Internal li-on battery
63 * Operating Temperature: -40 ~~ 60°C
64
65 (% style="color:blue" %)**LoRa Spec:**
66
67 * Frequency Range,
68 ** Band 1 (HF): 862 ~~ 1020 Mhz
69 * 168 dB maximum link budget.
70 * +20 dBm - 100 mW constant RF output vs.
71 * +14 dBm high efficiency PA.
72 * Programmable bit rate up to 300 kbps.
73 * High sensitivity: down to -148 dBm.
74 * Bullet-proof front end: IIP3 = -12.5 dBm.
75 * Excellent blocking immunity.
76 * Low RX current of 10.3 mA, 200 nA register retention.
77 * Fully integrated synthesizer with a resolution of 61 Hz.
78 * FSK, GFSK, MSK, GMSK, LoRaTM and OOK modulation.
79 * Built-in bit synchronizer for clock recovery.
80 * Preamble detection.
81 * 127 dB Dynamic Range RSSI.
82 * Automatic RF Sense and CAD with ultra-fast AFC.
83 * Packet engine up to 256 bytes with CRC.
84 * LoRaWAN 1.0.3 Specification
85
86 (% style="color:blue" %)**Battery:**
87
88 * 1000mA Li-on Battery power (for model TrackerD)
89
90 (% style="color:blue" %)**Power Consumption**
91
92 * Sleeping Mode: 200uA
93 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
94 * Tracking: max: 38mA
95
96
97 == 1.3  Features ==
98
99
100 * LoRaWAN 1.0.3 Class A
101 * ESP32 PICO D4
102 * SX1276/78 Wireless Chip
103 * Arduino IDE Compatible
104 * Open source hardware / software
105 * Regular/ Real-time GPS,BLE,WIFI tracking
106 * Built-in3 axis accelerometer (LIS3DH)
107 * Humidity / temperature sensor : GXCAS Technology GXHT3X
108 * Motion sensing capability
109 * Power Monitoring
110 * Charging circuit via USB port
111 * 1000mA Li-on Battery power
112 * Tri-color LED, Alarm button
113 * Datalog
114
115 == 1.4  Applications ==
116
117
118 * Logistics and Supply Chain Management
119 * Human tracking
120
121
122 = 2.1 Use TrackerD =
123
124
125 == 2.1 How it works? ==
126
127
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
130
131
132 == 2.2 Quick guide to connect to LoRaWAN server ==
133
134
135 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. 
136
137
138 [[image:1664501652064-326.png]]
139
140
141
142 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:
143
144
145 (% style="color:blue" %)**Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD.
146
147 Each TrackerD is shipped with a sticker with the default device EUI as below:
148
149
150 [[image:1664501677253-891.png]]
151
152
153 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot:
154
155
156 **__Add APP EUI in the application:__**
157
158
159 [[image:1664501711466-918.png]]
160
161
162
163 [[image:1664501721248-725.png]]
164
165
166 [[image:1664501734705-405.png]]
167
168
169
170 **__Add APP KEY and DEV EUI:__**
171
172
173 [[image:1664501784668-703.png]]
174
175
176
177
178 (% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
179
180
181 (% 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.
182
183
184 (% style="color:blue" %)**Positioning Mode(SMOD):**
185
186 * **GPS ONLY(Factory Settings): **only get GPS location info.
187 * **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking.
188 * **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking.
189
190 User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
191
192
193
194 == 2.3 Uplink Payload ==
195
196
197 === 2.3.1 Uplink FPORT~=5, Device Status ===
198
199
200
201 === 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning ===
202
203
204 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. )
205
206
207 (% border="2" style="background-color:#ffffcc; color:green; width:537px" %)
208 |(% style="width:69px" %)(((
209 **Size**
210
211 **(bytes)**
212 )))|(% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)(((
213 2
214
215 (optional )
216 )))|(% style="width:83px" %)(((
217 2
218
219 (optional)
220 )))
221 |(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)(((
222 [[Alarm &>>path:#Alarm]]
223
224 [[BAT>>path:#Alarm]]
225 )))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]]
226
227
228 [[image:1664501958445-288.png]]
229
230
231 **Alarm & BAT:**
232
233 (% border="2" style="background-color:#ffffcc; color:green; width:329px" %)
234 |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits
235 |(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]] 
236
237
238 **FLAG:**
239
240 (% border="2" style="background-color:#ffffcc; color:green; width:332px" %)
241 |(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits
242 |(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version 
243
244 **Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A  **
245
246
247 **Location info:**
248
249 * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
250 * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
251
252 **Important note:**
253
254 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.
255
256 2.  In firmware version v1.5, Roll & Pitch is disabled by default.
257
258 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:
259
260
261 [[image:1664502116362-706.png]]
262
263
264
265 4.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
266
267 [[image:1664502166010-515.png]]
268
269
270
271 * **Alarm**:  Example:  0x4B & 0x40 >> 6 = 0x01
272 * **BAT**:  Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
273
274 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: \
275
276
277 * > 4.0v :  80% ~~ 100%
278 * 3.85v ~~3.99v:  60% ~~ 80%
279 * 3.70v ~~ 3.84v:  40% ~~ 60%
280 * 3.40v ~~ 3.69v:  20% ~~ 40%
281 * < 3.39v:  0~~20%
282
283
284 * **LON: **Enable/Disable LED activity for uplink
285
286 0x00:  Disable LED indicator.
287
288 0x01:  Enable LED indicator (Default Value)
289
290
291 * **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
292 * **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree
293
294
295
296
297 === 2.3.3 Uplink FPORT~= , History GNSS Positioning ===
298
299
300
301 === 2.3.4 BLE positioning Payload(Fport2) ===
302
303
304 Different MODE has different payload:
305
306 **MODE=2**
307
308 (% border="2" style="background-color:#ffffcc; color:green; width:620px" %)
309 |(% style="width:70px" %)(((
310 **Size**
311
312 **(bytes)**
313 )))|(% 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
314 |(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)(((
315 iBeacon
316
317 MAJOR
318 )))|(% style="width:71px" %)(((
319 iBeacon
320
321 MINOR
322 )))|(% style="width:145px" %)(((
323 iBeacon Measured
324
325 Power
326 )))|(% style="width:72px" %)(((
327 iBeacon
328
329 RSSI
330 )))|(% style="width:76px" %)(((
331 [[Alarm &>>path:#Alarm]]
332
333 [[BAT>>path:#Alarm]]
334 )))|(% style="width:54px" %)[[FLAG>>path:#Flag]]
335
336 [[image:1664502425687-834.png]]
337
338
339 * **BAT**:  Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
340 * **MODE:   **Define the payload format.
341 * **UUID:     **The uuid from the strongest iBeacon.
342 * **MAJOR**:  The MAJOR from the strongest iBeacon.
343 * **MINOR**:  The MAJOR from the strongest iBeacon.
344 * **Measured** **Power**:  The Measured Power from the strongest iBeacon.
345 * **RSSI**:  The RSSI from the strongest iBeacon.
346
347
348
349
350 === 2.3.5 Add Payload format in TTN V3 ===
351
352
353 In TTN V3, use can add a custom payload so it shows friendly.
354
355 In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder
356
357
358 [[image:1664502649601-895.png]]
359
360 Add the decoder from this link:
361
362
363 Save the change the uplink message will be parsed. As below:
364
365 [[image:1664502676891-606.png]]
366
367
368
369 == 2.4 Integrate with Datacake ==
370
371
372 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.
373
374 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]]
375
376
377 [[image:1664502695771-538.png]]
378
379
380
381 == 2.5 Integrate with Tago ==
382
383
384 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.
385
386 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]]
387
388
389 [[image:1664502715371-321.png]]
390
391
392
393 == 2.6 Alarm Mode ==
394
395
396 User can push the **RED button** by more than 5 seconds to enter Alarm Mode.
397
398
399 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.
400
401
402 Two ways to exit alarm mode:
403
404 * Server send a downlink command to exit.
405 * User fast press the RED button 10 times.
406
407 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.
408
409
410
411 == 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ==
412
413
414
415 == 2.8 LED Status ==
416
417
418 (% border="2" style="background-color:#ffffcc; color:green; width:636px" %)
419 |(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off**
420 |(% style="width:157px" %)**Power On**|(% style="width:271px" %)**BLUE, RED , Green** flash once|(% style="width:202px" %)N/A
421 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)**Green** led fast blink once (200ms)|(% style="width:202px" %)Yes
422 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)**Green** led on 5 second|(% style="width:202px" %)N/A
423 |(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)**BLUE **blinks 200ms per second|(% style="width:202px" %)Yes
424 |(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)**GREEN **blinks twice (200ms per blink)|(% style="width:202px" %)Yes
425 |(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)**RED **blinks twice (200ms per blink)|(% style="width:202px" %)Yes
426 |(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)**RED **on for 3 seconds|(% style="width:202px" %)Yes
427 |(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)**RED **on for 1 second|(% style="width:202px" %)Yes
428 |(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)**BLUE **led on 5 second|(% style="width:202px" %)Yes
429 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)**GREEN** led on 1 second|(% style="width:202px" %)Yes
430 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)**RED **on 500ms|(% style="width:202px" %)N/A
431
432
433
434 == 2.9 Button Function ==
435
436
437 **RESET button:**
438
439 [[image:1664502835802-546.png]]
440
441 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server.
442
443
444 **RED button:**
445
446 [[image:1664502854406-763.png]]
447
448
449 (% border="2" style="background-color:#ffffcc; color:green; width:627px" %)
450 |(% style="width:135px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**
451 |(% 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]]
452 |(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the **RED** button 10 times|(% style="width:265px" %)Exit Alarm Mode
453 |(% 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.
454
455
456 == 2.10 USB Port Function ==
457
458
459 The USB interface of TrackerD has below functions:
460
461 * Power on the device
462 * Recharge the battery
463 * [[Configure Device>>path:#AT_Command]]
464 * [[Upgrade Firmware>>path:#upgrade_image]]
465
466
467
468 = 3. Configure TrackerD via AT command or LoRaWAN downlink =
469
470
471 User can configure TrackerD via AT Command or LoRaWAN Downlink.
472
473 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]]
474
475
476
477 == 3.1 Access AT Command ==
478
479
480 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.
481
482
483 [[image:1664502999401-486.png]]
484
485
486 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:
487
488
489 [[image:1664503022490-662.png]]
490
491
492
493 [[image:1664503035713-500.png]]
494
495
496
497 [[image:1664503047675-651.png]]
498
499
500
501 == 3.2 Command Set ==
502
503
504 === 3.2.1 Set Transmit Interval ===
505
506
507 Set device uplink interval.
508
509 * AT Command:
510
511 AT+TDC=xxx
512
513 Example:  AT+TDC=300000. Means set interval to 5 minutes(300 seconds)
514
515
516 * Downlink Payload (prefix 0x01):
517
518 0x01 00 01 2C     ~/~/  Same as AT+TDC=300000
519
520
521
522 === 3.2.2 Set Alarm Packet transmission interval ===
523
524
525 Set alarm packet transmit interval
526
527 * AT Command:
528
529 AT+ATDC=xx.
530
531 Example:  AT+ATDC=60000  **~-~->    ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
532
533
534 * Downlink Payload (prefix 0xB1):
535
536 0xB1 00 00 3C  ~/~/  Same as AT+ATDC=60000
537
538
539
540 === 3.2.3 Set Sports Mode Packet transmission interval ===
541
542
543 Set sports packet transmit interval
544
545 * AT Command:
546
547 AT+MTDC=xx.
548
549 Example:  AT+MTDC=300000  **~-~->    ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
550
551
552 * Downlink Payload (prefix 0x03):
553
554 0x03 00 01 2C  ~/~/  Same as AT+ MTDC=3000000
555
556
557
558 === 3.2.4 Exit Alarm ===
559
560
561 Server send downlink command to exit Alarm mode
562
563 * AT Command:
564
565 No AT Command
566
567
568 * Downlink Payload (prefix 0x02):
569
570 0x02 01  ~/~/  Exit Alarm Mode
571
572
573
574 === 3.2.5 Disable/Enable LED flash ===
575
576
577 Disable/Enable LED for position, downlink and uplink
578
579 * AT Command:
580
581 AT+LON=xx.  (Disable (0), Enable (1), default:1)
582
583 Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
584
585
586 * Downlink Payload (prefix 0xAE):
587
588 0xAE 00  ~/~/  Same as AT+LON=0
589
590
591
592 === 3.2.6 Disable/Enable movement detect (Debug Only) ===
593
594
595 User can use this feature to check and set thread hole of movement detect
596
597 * AT Command:
598
599 AT+INTWK=xx.  (Disable (0), Enable (1), default:0)
600
601 Example:  AT+ INTWK =1  **~-~->   ** Enable detect movement.
602
603
604 * Downlink Payload (prefix 0xAF):
605
606 0xAF 01  ~/~/  Same as AT+ INTWK =1
607
608
609
610 === 3.2.7 Set Positioning Mode ===
611
612
613 SMOD define the how TrackerD scan and uplink date.
614
615 GPS室外定位模式：  设备默认模式，设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是3分钟定位，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。GPS还有一种logdata模式，在断网的情况下将数据存储下来，等到有网的时候，一次将数据以每10秒上报。
616
617 BLE室内定位模式：  设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是5秒，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每3分钟发送一次）。
618
619 GPS和BLE混动模式：设备入网后会发送device当前模式下的信息，随后立即判断是否在室内，如果是就进行BLE定位，不是就GPS定位。如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。
620
621 运动模式：  设备入网后会发送device当前模式下的信息，随后发送GPS定位数据，设备判断是否在运动，没有运动传感器没有检测到动作，立即进入静止状态（默认20分钟），如果产生运动，将每5分钟发送一次数据，再第五分钟后检测设备有误运动，无将切换到静止状态，有立即发送数据。
622
623
624
625 * AT Command:
626
627 AT+SMOD=xx.
628
629
630 **Example:**
631
632 AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
633
634 AT+ SMOD =1,1    **~-~->**  GPS +BAT State
635
636 AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
637
638
639 * Downlink Payload (prefix 0xA5):
640
641 0xA5 01 00  ~/~/  Same as AT+ SMOD =1,0
642
643
644
645 === 3.2.8 Set MAX GPS position time ===
646
647
648 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.
649
650
651 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.
652
653
654 * AT Command:
655
656 AT+FTIME=xx  **~-~-> ** Set to use xx as max fix time.
657
658 Example:  AT+FTIME=150
659
660
661 * Downlink Payload (prefix 0xAA):
662
663 0xAA 00 96  ~/~/  Set AT+FTIME=150
664
665
666
667 === 3.3.9 Set PDOP value for GPS fix accuracy ===
668
669
670 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.
671
672
673 A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0
674
675
676 * AT Command:
677
678 AT+PDOP=2.5  **~-~->  ** Set PDOP to 2.5
679
680
681 * Downlink Payload (prefix 0xAD):
682
683 0xAD 00 0A  ~/~/  Set AT+PDOP=1  (0x0A / 10 =1)
684
685 0xAD 00 19  ~/~/  Set AT+PDOP=2.5    (0x19 / 10 =2.5)
686
687 0xAD 00 46  ~/~/  Set AT+PDOP=7  (0x46 / 10 =7)
688
689
690 Disable/Enable the confirmation mode
691
692 * AT Command:
693
694 AT+CFM=xx.
695
696
697 **~ Example:**
698
699 AT+ CFM=0    **~-~->   ** Disable confirmation
700
701 AT+ CFM=1    **~-~->  ** Enable confirmation
702
703
704 * Downlink Payload (prefix 0x05):
705
706 0x05 01  ~/~/  Same as AT+ SMOD =1
707
708
709
710 = 4. Setting for Different Scenarios =
711
712
713
714 = 5. Upload Firmware =
715
716
717 == 5.1 Firmware Change Log ==
718
719
720 **[[See this link>>url:https://github.com/dragino/TrackerD]]**
721
722
723
724 == 5.2 How to upgrade firmware ==
725
726
727 User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
728
729
730 (% style="color:blue" %)**Step1:  **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
731
732
733 (% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC.
734
735 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
736
737
738 (% style="color:blue" %)**Step3：**(%%) Download and Install Flash Tool:
739
740 [[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]]
741
742
743 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
744
745
746 [[image:1664503563660-578.png]]
747
748
749 [[image:1664503574618-659.png]]
750
751
752 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
753
754 [[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
755
756
757 Users need to use below files:
758
759 boot_app0.bin @0e000
760
761 ESP_LORA-eeprom-class.bin @ 0x10000
762
763
764 [[image:1664503593459-435.png]]
765
766
767
768 After upgrade finish, it will show finish as below:
769
770 [[image:1664503611848-385.png]]
771
772
773
774 = 6. Developer Guide =
775
776
777 == 6.1 Compile Source Code ==
778
779
780 === 6.1.1 Set up ARDUINO compile environment ===
781
782
783 * 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]]
784
785 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]]
786
787
788 [[image:1664503635019-941.png]]
789
790
791 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it.
792
793
794 [[image:1664503715811-892.png]]
795
796
797
798 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
799
800 Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
801
802
803 [[image:1664503752288-974.png]]
804
805
806
807 == 6.2 Source Code ==
808
809
810 * Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:
811
812 [[image:1664503794261-827.png]]
813
814
815
816 * Click to upload
817
818 [[image:1664503808294-336.png]]
819
820
821
822 * Check the result, if the upload is successful, as shown below, open the serial port to view the data
823
824 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
825
826
827
828 = 7.  FAQ =
829
830
831 == 7.1 How to change the LoRa Frequency Bands/Region? ==
832
833
834 User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
835
836
837
838 == 7.2 What is the pin mapping for the USB program cable? ==
839
840
841 [[image:1664499635206-262.png]]
842
843
844
845 (% border="2" style="background-color:#ffffcc; color:green; width:314px" %)
846 |(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin**
847 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
848 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
849 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
850 |(% style="width:118px" %)A1,B1,A12,B12|(% style="width:67px" %)Black|(% style="width:123px" %)GND
851 |(% style="width:118px" %)A5|(% style="width:67px" %)Purple|(% style="width:123px" %)MTDC/GOIO13
852 |(% style="width:118px" %)B5|(% style="width:67px" %)Blue|(% style="width:123px" %)MTDC/GPIO12
853 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
854 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
855
856
857
858
859 = 8.  Order Info =
860
861
862 Part Number: (% style="color:blue" %)**TrackerD-XXX**
863
864 (% style="color:blue" %)**XXX**(%%): The default frequency band
865
866 * (% style="color:red" %)**EU433**(%%): Default frequency band EU433
867 * (% style="color:red" %)**EU868**(%%): Default frequency band EU868
868 * (% style="color:red" %)**IN865**(%%): Default frequency band IN865
869 * (% style="color:red" %)**KR920**(%%): Default frequency band KR920
870 * (% style="color:red" %)**AS923**(%%): Default frequency band AS923
871 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
872 * (% style="color:red" %)**US915**(%%): Default frequency band US915
873
874
875
876
877 = 9.  Packing Info =
878
879
880 **Package Includes**:
881
882 * TrackerD LoRaWAN GPS/BLE Tracker x 1
883 * USB recharge & program cable x 1
884
885 **Dimensions and Weight**:
886
887 * Device Size: 85 x 48 x 15 cm
888 * Weight: 50g
889
890
891
892 = 10. Support =
893
894
895 * 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.
896 * 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]]
897
898
899
900 = 11.  Reference =
901
902
903 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
904 * **[[Source Code>>https://github.com/dragino/TrackerD]] **
905 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]