Skip to Content
Version 77.1 by Edwin Chen on 2022/10/13 23:15
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 (((
29 TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution.
30 )))
31
32 (((
33 The LoRa wireless technology used in TrackerD allows the user to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional tracking services.
34 )))
35 )))
36
37 (((
38 TrackerD is equipped with a (% style="color:blue" %)**1000mAh Li-on rechargeable battery**(%%). Each TrackerD has a worldwide unique OTAA keys to join the LoRaWAN network.
39
40
41 )))
42
43 [[image:1664499921684-770.png]]
44
45
46 (% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.**
47
48
49
50 == 1.2 Specifications ==
51
52
53 (% style="color:blue" %)**Micro Controller:**
54
55 * Espressif ESP32 PICO D4
56 * MCU: ESP32 PICO D4
57 * Bluetooth: Bluetooth V4.2 BR/EDR and Bluetooth LE
58 * WiFi : 802.11 b/g/n (802.11n up to 150 Mbps)
59 * Integrated SPI flash : 4 MB
60 * RAM: 448 KB
61 * EEPROM: 520 KB
62 * Clock Speed: 32Mhz
63
64 (% style="color:blue" %)**Common DC Characteristics:**
65
66 * Supply Voltage: 5V via USB port or Internal li-on battery
67 * Operating Temperature: -40 ~~ 60°C
68
69 (% style="color:blue" %)**LoRa Spec:**
70
71 * Frequency Range,
72 ** Band 1 (HF): 862 ~~ 1020 Mhz
73 * 168 dB maximum link budget.
74 * +20 dBm - 100 mW constant RF output vs.
75 * +14 dBm high efficiency PA.
76 * Programmable bit rate up to 300 kbps.
77 * High sensitivity: down to -148 dBm.
78 * Bullet-proof front end: IIP3 = -12.5 dBm.
79 * Excellent blocking immunity.
80 * Low RX current of 10.3 mA, 200 nA register retention.
81 * Fully integrated synthesizer with a resolution of 61 Hz.
82 * FSK, GFSK, MSK, GMSK, LoRaTM and OOK modulation.
83 * Built-in bit synchronizer for clock recovery.
84 * Preamble detection.
85 * 127 dB Dynamic Range RSSI.
86 * Automatic RF Sense and CAD with ultra-fast AFC.
87 * Packet engine up to 256 bytes with CRC.
88 * LoRaWAN 1.0.3 Specification
89
90 (% style="color:blue" %)**Battery:**
91
92 * 1000mA Li-on Battery power (for model TrackerD)
93
94 (% style="color:blue" %)**Power Consumption**
95
96 * Sleeping Mode: 200uA
97 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
98 * Tracking: max: 38mA
99
100 == 1.3  Features ==
101
102
103 * LoRaWAN 1.0.3 Class A
104 * ESP32 PICO D4
105 * SX1276/78 Wireless Chip
106 * Arduino IDE Compatible
107 * Open source hardware / software
108 * Regular/ Real-time GPS,BLE,WIFI tracking
109 * Built-in3 axis accelerometer (LIS3DH)
110 * Humidity / temperature sensor : GXCAS Technology GXHT3X
111 * Motion sensing capability
112 * Power Monitoring
113 * Charging circuit via USB port
114 * 1000mA Li-on Battery power
115 * Tri-color LED, Alarm button
116 * Datalog
117
118 == 1.4  Applications ==
119
120
121 * Logistics and Supply Chain Management
122 * Human tracking
123
124 = 2.1 Use TrackerD =
125
126
127 == 2.1 How it works? ==
128
129
130 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.
131
132
133
134 == 2.2 Quick guide to connect to LoRaWAN server ==
135
136
137 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. 
138
139
140 [[image:1664501652064-326.png]]
141
142
143
144 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:
145
146
147 (% style="color:blue" %)**Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD.
148
149 Each TrackerD is shipped with a sticker with the default device EUI as below:
150
151
152 [[image:1664501677253-891.png]]
153
154
155 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot:
156
157
158 **__Add APP EUI in the application:__**
159
160
161 [[image:1664501711466-918.png]]
162
163
164
165 [[image:1664501721248-725.png]]
166
167
168 [[image:1664501734705-405.png]]
169
170
171
172 **__Add APP KEY and DEV EUI:__**
173
174
175 [[image:1664501784668-703.png]]
176
177
178
179
180 (% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
181
182
183 (% style="color:blue" %)**Step 3:**(%%) TrackerD will auto join to the LoRaWAN network. After join success, TrackerD will start to upload message to IoT server.
184
185
186
187 == 2.3  Positioning Mode(SMOD) ==
188
189
190 Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported.
191
192 * (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
193 * (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
194 * (% style="color:#037691" %)**GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning.
195
196 Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
197
198
199
200 == 2.4  Uplink Payload ==
201
202
203 === 2.4.1 Uplink FPORT~=5, Device Status ===
204
205
206 Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours.
207
208 Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
209
210
211 (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
212 |=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1
213 |=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status
214
215 [[image:1665301570342-765.png]]
216
217
218 (% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
219
220 (% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
221
222 (% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
223
224 (% style="color:#037691" %)**Frequency Band**:
225
226 *0x01: EU868
227
228 *0x02: US915
229
230 *0x03: IN865
231
232 *0x04: AU915
233
234 *0x05: KZ865
235
236 *0x06: RU864
237
238 *0x07: AS923
239
240 *0x08: AS923-1
241
242 *0x09: AS923-2
243
244 *0x0a: AS923-3
245
246 Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
247
248 (% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
249
250
251 (% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
252
253 Use can also get the Device Status uplink through the downlink command:
254
255
256
257 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
258
259 (% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
260 |(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
261 |(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings
262
263 (% style="color:blue" %)** SMOD：**
264
265 (% style="color:red" %)** 1 :** (%%) GPS ONLY
266
267 (% style="color:red" %)** 2 :** (%%) BLE ONLY
268
269 (% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
270
271
272 (% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
273
274 (% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
275
276 (% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
277
278
279 (% style="color:blue" %)** BLE_Settings:**
280
281 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
282
283
284
285 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
286
287 (% border="1.5" style="background-color:#ffffcc; color:green; width:450px" %)
288 |(% style="width:77px" %)**Size(bit)**|(% style="width:82px" %)5 Bits|(% style="width:106px" %)1 Bit|(% style="width:67px" %)1 Bit|(% style="width:121px" %)1 Bit
289 |(% style="width:77px" %)**Value**|(% style="width:82px" %)Reserve|(% style="width:106px" %)PNACKMD|(% style="width:67px" %)LON|(% style="width:121px" %)Transport** **Mode
290
291
292
293 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
294
295
296 Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes,
297
298 (% style="color:red" %)Please note that 15 bytes won't work on DR0 on US915/AU915 frequency band. IoT server will see NULL payload in this case.(%%)
299
300
301 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
302 |=(% scope="row" style="width: 50px;" %)(((
303 **Size(bytes)**
304 )))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
305 2
306 )))|(% style="width:87px" %)(((
307 2
308 )))
309 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
310 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
311 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
312
313 [[image:1665301636888-168.png]]
314
315
316 ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ====
317
318 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
319 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
320 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
321
322 ==== (% style="color:blue" %)**FLAG:**(%%) ====
323
324 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
325 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
326 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
327
328 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
329
330
331 ==== (% style="color:blue" %)**Location info:**(%%) ====
332
333 * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
334 * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
335
336 (% style="color:red" %)**Important note:**
337
338 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.
339
340 2.  In this mode, the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes payload. In this case, the payload on server will be ignore and shows as below:
341
342
343 [[image:1664502116362-706.png]]
344
345
346 3.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
347
348 [[image:1664502166010-515.png]]
349
350
351
352 ==== (% style="color:blue" %)**Alarm:**(%%) ====
353
354 **Example: ** 0x4B & 0x40 >> 6 = 0x01
355
356
357 ==== (% style="color:blue" %)**BAT:**(%%) ====
358
359 **Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
360
361 (((
362 The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
363 )))
364
365 * > 4.0v :  80% ~~ 100%
366 * 3.85v ~~3.99v:  60% ~~ 80%
367 * 3.70v ~~ 3.84v:  40% ~~ 60%
368 * 3.40v ~~ 3.69v:  20% ~~ 40%
369 * < 3.39v:  0~~20%
370
371 ==== (% style="color:blue" %)**MOD:**(%%) ====
372
373 **Example: ** (0x60>>6)& 0x3f =1.
374
375 **Set the format of GPS data uplink link：**
376
377 (% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
378 (% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
379
380
381 **Set the format of BLE data uplink link：**
382
383 (% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
384
385
386 ==== (% style="color:blue" %)**LON:**(%%) ====
387
388 **Example:** (0x60>>5) & 0x01=1.
389
390 Enable/Disable LED activity for uplink
391
392 (((
393 (% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
394 )))
395
396 (((
397 (% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
398 )))
399
400
401
402 ==== (% style="color:blue" %)**Hum:**(%%) ====
403
404 0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
405
406
407 ==== (% style="color:blue" %)**Tem:**(%%) ====
408
409 011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
410
411
412
413 === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
414
415
416 The default uplink payload includes totally 11 bytes. The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
417
418
419 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
420 |=(% scope="row" style="width: 50px;" %)(((
421 **Size(bytes)**
422 )))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
423 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
424 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
425 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
426
427 (% class="wikigeneratedid" %)
428 [[image:1665301687277-443.png]]
429
430
431
432 === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
433
434
435 Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
436
437
438 (% style="color:red" %)**Note for this mode:**
439
440 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
441 * b) TrackerD will send data in (% style="color:blue" %)**CONFIRMED Mode**(%%) when PNACKMD=1, but TrackerD won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink, if TrackerD gets an ACK, TrackerD will consider there is a network connection and resend all NONE-ACK Messages.
442
443 The payload is 15 bytes, as below.
444
445 (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
446 |=(% scope="row" %)(((
447 **Size(bytes)**
448 )))|4|4|2|1|1|1|1|1
449 |=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen
450
451 [[image:image-20221009160309-2.png]]
452
453
454
455 === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
456
457
458 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
459 |=(% scope="row" style="width: 60px;" %)(((
460 **Size(bytes)**
461 )))|(% style="width:30px" %)16|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:120px" %)2|(% style="width:50px" %)4|(% style="width:50px" %)2|(% style="width:30px" %)1
462 |=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
463 iBeacon MAJOR
464 )))|(% style="width:63px" %)(((
465 iBeacon MINOR
466 )))|(% style="width:71px" %)(((
467 iBeacon Measured Power
468 )))|(% style="width:50px" %)(((
469 iBeacon RSSI
470 )))|(% style="width:47px" %)(((
471 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
472 )))|(% style="width:15px" %)[[FLAG>>||anchor="HFLAG:"]]
473
474 [[image:1664502425687-834.png]]
475
476
477 * (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
478 * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
479 * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
480 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
481 * (% style="color:#037691" %)**MINOR:**  (%%)The MAJOR from the strongest iBeacon.
482 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
483 * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
484
485 === 2.4.6  Add Payload format in TTN V3 ===
486
487
488 In TTN V3, use can add a custom payload so it shows friendly.
489
490 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
491
492
493 [[image:1664502649601-895.png]]
494
495
496 Add the decoder from this link:
497
498
499 Save the change the uplink message will be parsed. As below:
500
501 [[image:1664502676891-606.png]]
502
503
504
505 == 2.5 Integrate with Datacake ==
506
507
508 (((
509 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.
510 )))
511
512 (((
513 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]]
514 )))
515
516
517 [[image:1664502695771-538.png]]
518
519
520
521 == 2.6 Integrate with Tago ==
522
523
524 (((
525 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.
526 )))
527
528 (((
529 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]]
530 )))
531
532
533 [[image:1664502715371-321.png]]
534
535
536
537 == 2.7  Datalog Feature ==
538
539
540 total 273 entries,by default disable
541
542
543 Example use case.
544
545 [[image:image-20221009234703-2.png||height="328" width="899"]]
546
547
548 [[image:image-20221009234629-1.png||height="390" width="577"]]
549
550
551
552 == 2.8 Alarm Mode ==
553
554
555 (((
556 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode.
557 )))
558
559
560 (((
561 Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exit alert mode.
562 )))
563
564
565 (((
566 Two ways to exit alarm mode:
567 )))
568
569 * Server send a downlink command to exit.
570 * User fast press the RED button 10 times.
571
572 (((
573 When exit alarm mode, (% style="color:red" %)**RED LED**(%%) will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false.
574 )))
575
576
577
578 == 2.9 Transport Mode ==
579
580
581 In Transport Mode, TrackerD will check if there is motion. If there is no motion, device will send uplinks every 20 minutes. If there is motion, device will send uplink every 5 minutes.
582
583
584
585 == 2.10 LED Status ==
586
587
588 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
589 |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
590 |(% style="width:157px" %)**Power On**|(% style="width:271px" %)(% style="color:blue" %)**BLUE, **(% style="color:red" %)**RED , **(% style="color:green" %)**Green** flash once|(% style="width:202px" %)N/A
591 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
592 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
593 |(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes
594 |(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes
595 |(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
596 |(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes
597 |(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes
598 |(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)led on 5 second|(% style="width:202px" %)Yes
599 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
600 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
601
602 == 2.11 Button Function ==
603
604
605 (% style="color:blue" %)**RESET button:**
606
607 [[image:1664502835802-546.png]]
608
609 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server.
610
611
612 (% style="color:red" %)**RED button:**
613
614 [[image:1664502854406-763.png]]
615
616
617 (% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
618 |=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
619 |(% style="width:135px" %)Send Alarm|(% style="width:220px" %)Keep Pressing (% style="color:red" %)**RED**(%%) button for more than 5 seconds|(% style="width:265px" %)Enter Alarm Mode.  See [[Alarm Mode>>||anchor="H2.6AlarmMode"]]
620 |(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the (% style="color:red" %)**RED** (%%)button 10 times|(% style="width:265px" %)Exit Alarm Mode
621 |(% 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.
622
623 == 2.12 USB Port Function ==
624
625
626 The USB interface of TrackerD has below functions:
627
628 * Power on the device
629 * Recharge the battery
630 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
631 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
632
633 = 3. Configure TrackerD via AT command or LoRaWAN downlink =
634
635
636 User can configure TrackerD via AT Command or LoRaWAN Downlink.
637
638 LoRaWAN Downlink instruction for different platforms:  [[IoT LoRaWAN Server>>doc:Main.WebHome]]
639
640
641
642 == 3.1 Access AT Command ==
643
644
645 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.
646
647
648 [[image:1664502999401-486.png]]
649
650
651 In PC, User needs to set serial tool baud rate to (% style="color:green" %)**115200**(%%) to access serial console for TrackerD. TrackerD will output system info once power on and user will be able to send AT commands:
652
653
654 [[image:1664503022490-662.png]]
655
656
657
658 [[image:1664503035713-500.png]]
659
660
661
662 [[image:1664503047675-651.png]]
663
664
665
666 == 3.2 Command Set ==
667
668
669 === 3.2.1 Set Transmit Interval ===
670
671
672 Set device uplink interval.
673
674 * (% style="color:blue" %)**AT Command:**
675
676 (% style="color:#037691" %)**AT+TDC=xxx **
677
678 Example:  AT+TDC=300000. Means set interval to 5 minutes(300 seconds)
679
680
681 * (% style="color:blue" %)**Downlink Payload (prefix 0x01):**
682
683 (% style="color:#037691" %)**0x01 00 01 2C**  (%%) ~/~/  Same as AT+TDC=300000
684
685
686
687 === 3.2.2 Set Alarm Packet transmission interval ===
688
689
690 Set alarm packet transmit interval
691
692 * (% style="color:blue" %)**AT Command:**
693
694 (% style="color:#037691" %)**AT+ATDC=xx. **
695
696 Example:  AT+ATDC=60000  **~-~->    ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
697
698
699 * (% style="color:blue" %)**Downlink Payload (prefix 0xB1):**
700
701 (% style="color:#037691" %)**0xB1 00 00 3C ** (%%) ~/~/  Same as AT+ATDC=60000
702
703
704
705 === 3.2.3 Set Transport Mode Packet transmission interval ===
706
707
708 Set Transport Mode packet transmit interval
709
710 * (% style="color:blue" %)**AT Command:**
711
712 (% style="color:#037691" %)**AT+MTDC=xx. **
713
714 Example:  AT+MTDC=300000  **~-~->    ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000
715
716
717 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
718
719 (% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+ MTDC=3000000
720
721
722
723 === 3.2.4 Exit Alarm ===
724
725
726 Server send downlink command to exit Alarm mode
727
728 * (% style="color:blue" %)**AT Command: No AT Command**
729
730 * (% style="color:blue" %)**Downlink Payload (prefix 0x02):**
731
732 (% style="color:#037691" %)**0x02 01**    (%%) ~/~/  Exit Alarm Mode
733
734
735
736 === 3.2.5 Disable/Enable LED flash ===
737
738
739 Disable/Enable LED for position, downlink and uplink
740
741 * (% style="color:blue" %)**AT Command:**
742
743 (% style="color:#037691" %)**AT+LON=xx.  (Disable (0), Enable (1), default:1)**
744
745 Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
746
747
748 * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**
749
750 (% style="color:#037691" %)**0xAE 00 ** (%%) ~/~/  Same as AT+LON=0
751
752
753
754 === 3.2.6 Disable/Enable Transport Mode ===
755
756
757 Users can use this feature to enable/disable Transport Mode.
758
759 * (% style="color:blue" %)**AT Command:**
760
761 (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
762
763 Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
764
765
766 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
767
768 (% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+ INTWK =1
769
770
771
772 === 3.2.7 Set Positioning Mode ===
773
774
775 SMOD define the how TrackerD scan and uplink data:
776
777
778 * (% style="color:blue" %)**AT Command:**
779
780 (% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
781
782 (% style="color:#037691" %)** aa:**
783
784 * (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
785 * (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
786 * (% style="color:red" %)**3: GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning.
787
788 (% style="color:#037691" %)**bb:**
789
790 * (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
791 * (% style="color:red" %)**1 :**(%%)  GPS +BAT State
792
793 (% style="color:#037691" %)**cc:   **
794
795 * (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
796
797 (% style="color:blue" %)**Example:**
798
799 AT+ SMOD =1,0 ,0 ~-~->  GPS+ BAT+ State+Tem&Hum
800 AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
801 AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
802
803
804 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
805
806 (% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
807
808
809
810 === 3.2.8 Set MAX GPS position time ===
811
812
813 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.
814
815
816 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.
817
818
819 * (% style="color:blue" %)**AT Command:**
820
821 (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
822
823 **Example:**  AT+FTIME=150
824
825
826 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
827
828 (% style="color:#037691" %)**0xAA 00 96 ** (%%) ~/~/  Set AT+FTIME=150
829
830
831
832 === 3.2.9 Set PDOP value for GPS fix accuracy ===
833
834
835 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.
836
837
838 A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0
839
840
841 * (% style="color:blue" %)**AT Command:**
842
843 (% style="color:#037691" %)**AT+PDOP=2.5 ** (%%) **~-~->  ** Set PDOP to 2.5
844
845
846 * (% style="color:blue" %)**Downlink Payload (prefix 0xAD):**
847
848 (% style="color:#037691" %)**0xAD 00 0A**   (%%) ~/~/  Set AT+PDOP=1  (0x0A / 10 =1)
849
850 (% style="color:#037691" %)**0xAD 00 19**   (%%) ~/~/  Set AT+PDOP=2.5    (0x19 / 10 =2.5)
851
852 (% style="color:#037691" %)**0xAD 00 46**    (%%) ~/~/  Set AT+PDOP=7  (0x46 / 10 =7)
853
854
855
856 Disable/Enable the confirmation mode
857
858 * (% style="color:blue" %)**AT Command:**
859
860 (% style="color:#037691" %)**AT+CFM=xx**
861
862
863 **~ Example:**
864
865 AT+ CFM=0    **~-~->   ** Disable confirmation
866
867 AT+ CFM=1    **~-~->  ** Enable confirmation
868
869
870 * (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
871
872 (% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+ SMOD =1
873
874
875
876 === 3.2.10  Auto Send None-ACK messages ===
877
878
879 TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message.
880
881
882 * (% style="color:blue" %)**AT Command: AT+PNACKMD**
883
884 The default factory setting is 0.
885
886
887 **Command Example Function Response:**
888
889 (% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
890
891
892 * (% style="color:blue" %)**Downlink Command: 0x34**
893
894 Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
895
896
897 = 4. Setting for Different Scenarios =
898
899
900
901 = 5. Upload Firmware =
902
903
904 == 5.1 Firmware Change Log ==
905
906
907 **[[See this link>>url:https://github.com/dragino/TrackerD]]**
908
909
910
911 == 5.2 How to upgrade firmware ==
912
913
914 User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
915
916
917 (% style="color:blue" %)**Step1:  **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
918
919
920 (% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC.
921
922 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
923
924
925 (% style="color:blue" %)**Step3:  **(%%)Download and Install Flash Tool:  [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]]
926
927
928 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
929
930
931 [[image:1664503563660-578.png]]
932
933
934 [[image:1664503574618-659.png]]
935
936
937 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
938
939 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
940
941
942 Users need to use below files:
943
944 boot_app0.bin @0e000
945
946 ESP_LORA-eeprom-class.bin @ 0x10000
947
948
949 [[image:1664503593459-435.png]]
950
951
952
953 After upgrade finish, it will show finish as below:
954
955 [[image:1664503611848-385.png]]
956
957
958
959 = 6. Developer Guide =
960
961
962 == 6.1 Compile Source Code ==
963
964
965 === 6.1.1 Set up ARDUINO compile environment ===
966
967
968 * **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]]**
969
970 Install IDE on PC, open and click (% style="color:#037691" %)**File ~-~-> Preference**,(%%) add the following URL:  [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]]
971
972
973 [[image:1664503635019-941.png]]
974
975
976
977 * (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.**
978
979 [[image:1664503715811-892.png]]
980
981
982
983 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
984
985 Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
986
987
988 [[image:1664503752288-974.png]]
989
990
991
992 == 6.2 Source Code ==
993
994
995 * (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:**
996
997 [[image:1664503794261-827.png]]
998
999
1000
1001 * (% style="color:blue" %)**Click to upload**
1002
1003 [[image:1664503808294-336.png]]
1004
1005
1006
1007 * (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data**
1008
1009 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
1010
1011
1012
1013 = 7.  FAQ =
1014
1015
1016 == 7.1 How to change the LoRa Frequency Bands/Region? ==
1017
1018
1019 User can follow the introduction for [[how to upgrade image>>||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.
1020
1021
1022
1023 == 7.2 What is the pin mapping for the USB program cable? ==
1024
1025
1026 [[image:1664499635206-262.png]]
1027
1028
1029
1030 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)
1031 |=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin**
1032 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
1033 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
1034 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
1035 |(% style="width:118px" %)A1,B1,A12,B12|(% style="width:67px" %)Black|(% style="width:123px" %)GND
1036 |(% style="width:118px" %)A5|(% style="width:67px" %)Purple|(% style="width:123px" %)MTDC/GOIO13
1037 |(% style="width:118px" %)B5|(% style="width:67px" %)Blue|(% style="width:123px" %)MTDC/GPIO12
1038 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
1039 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
1040
1041 = 8.  Order Info =
1042
1043
1044 Part Number: (% style="color:blue" %)**TrackerD-XXX**
1045
1046 (% style="color:blue" %)**XXX**(%%): The default frequency band
1047
1048 * (% style="color:red" %)**EU433**(%%): Default frequency band EU433
1049 * (% style="color:red" %)**EU868**(%%): Default frequency band EU868
1050 * (% style="color:red" %)**IN865**(%%): Default frequency band IN865
1051 * (% style="color:red" %)**KR920**(%%): Default frequency band KR920
1052 * (% style="color:red" %)**AS923**(%%): Default frequency band AS923
1053 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
1054 * (% style="color:red" %)**US915**(%%): Default frequency band US915
1055
1056 = 9.  Packing Info =
1057
1058
1059 (% style="color:#037691" %)**Package Includes**:
1060
1061 * TrackerD LoRaWAN GPS/BLE Tracker x 1
1062 * USB recharge & program cable x 1
1063
1064 (% style="color:#037691" %)**Dimensions and Weight**:
1065
1066 * Device Size: 85 x 48 x 15 cm
1067 * Weight: 50g
1068
1069 = 10. Support =
1070
1071
1072 * 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.
1073 * 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]].
1074
1075 = 11.  Reference =
1076
1077
1078 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1079 * **[[Source Code>>https://github.com/dragino/TrackerD]] **
1080 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
1081
1082