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 or WiFi ONLY:            **(%%)** **Only obtain iBeacon info via BLE and uplink  or obtain wifi ssid info via WiFi 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:440px" %)
212 |=(% style="width: 60px;" %)**Size(bytes)**|=(% style="width: 70px;" %)**1**|=(% style="width: 70px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 50px;" %)**1**|=(% style="width: 30px;" %)2|=(% style="width: 40px;" %)**2**|=(% style="width: 40px;" %)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 (% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40
257
258 (% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %)
259 |=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit
260 |=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings
261
262 (% style="color:blue" %)** SMOD:**
263
264 (% style="color:red" %)** 1 :** (%%) GPS ONLY
265
266 (% style="color:red" %)** 2 :** (%%) BLE ONLY
267
268 (% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
269
270
271 (% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
272
273 (% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
274
275 (% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
276
277
278 (% style="color:blue" %)** BLE_Settings:**
279
280 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
281
282 (% style="color:red" %)** 2:**  (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%)  
283
284
285 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
286
287 (% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %)
288 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)5 Bits|(% style="width:60px" %)1 Bit|(% style="width:20px" %)1 Bit|(% style="width:80px" %)1 Bit
289 |=(% style="width: 77px;" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:92px" %)[[PNACKMD>>||anchor="H2.4.4A0UplinkFPORT3D42CHistoryGNSSPositioning"]]|(% style="width:48px" %)[[LON>>||anchor="H3.2.5Disable2FEnableLEDflash"]]|(% style="width:126px" %)[[Transport Mode>>||anchor="H2.9TransportMode"]]
290
291 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
292
293
294 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,
295
296
297 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %)
298 |=(% scope="row" style="width: 60px;" %)(((
299 **Size(bytes)**
300 )))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)(((
301 2
302 )))|(% style="width:30px" %)(((
303 2
304 )))
305 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
306 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
307 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
308
309 [[image:1665301636888-168.png]]
310
311
312 ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ====
313
314 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
315 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
316 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
317
318 ==== (% style="color:blue" %)**FLAG:**(%%) ====
319
320 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %)
321 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit
322 |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
323
324 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
325
326
327 ==== (% style="color:blue" %)**Location info:**(%%) ====
328
329 * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
330 * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
331
332 (% style="color:red" %)**Important note:**
333
334 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.
335
336 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:
337
338
339 [[image:1664502116362-706.png]]
340
341
342 3.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
343
344 [[image:1664502166010-515.png]]
345
346
347
348 ==== (% style="color:blue" %)**Alarm:**(%%) ====
349
350 **Example: ** 0x4B & 0x40 >> 6 = 0x01
351
352
353 ==== (% style="color:blue" %)**BAT:**(%%) ====
354
355 **Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
356
357 (((
358 The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
359 )))
360
361 * > 4.0v :  80% ~~ 100%
362 * 3.85v ~~3.99v:  60% ~~ 80%
363 * 3.70v ~~ 3.84v:  40% ~~ 60%
364 * 3.40v ~~ 3.69v:  20% ~~ 40%
365 * < 3.39v:  0~~20%
366
367 ==== (% style="color:blue" %)**MOD:**(%%) ====
368
369 **Example: ** (0x60>>6) & 0x3f =1
370
371 **Set the format of GPS data uplink link:**
372
373 (% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
374 (% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
375
376
377 **Set the format of BLE data uplink link:**
378
379 (% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
380
381
382 ==== (% style="color:blue" %)**LON:**(%%) ====
383
384 **Example:** (0x60>>5) & 0x01=1.
385
386 Enable/Disable LED activity for uplink
387
388 (((
389 (% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
390 )))
391
392 (((
393 (% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
394 )))
395
396
397 ==== (% style="color:blue" %)**Hum:**(%%) ====
398
399 0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
400
401
402 ==== (% style="color:blue" %)**Tem:**(%%) ====
403
404 011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
405
406
407
408 === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
409
410
411 The default uplink payload includes total 11 bytes (**AT+SMOD=1,1,0**). The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
412
413
414 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %)
415 |=(% scope="row" style="width: 60px;" %)(((
416 **Size(bytes)**
417 )))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1
418 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
419 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
420 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
421
422 (% class="wikigeneratedid" %)
423 [[image:1665301687277-443.png]]
424
425
426
427 === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
428
429
430 Set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-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.
431
432
433 (% style="color:red" %)**Note for this mode:**
434
435 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
436 * 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.
437 * c) the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes of payload. In this case (DR0 of US915/AU915), the payload on server will show NULL
438
439 The payload is 15 bytes, as below.
440
441 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
442 |=(% scope="row" %)(((
443 **Size(bytes)**
444 )))|4|4|2|1|1|1|1|1
445 |=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen
446
447 [[image:image-20221009160309-2.png]]
448
449
450
451 === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
452
453
454 TrackerD supports BLE scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon and find the strongest iBeacon info and uplink.
455
456 User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
457
458
459 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
460 |=(% scope="row" style="width: 60px;" %)(((
461 **Size(bytes)**
462 )))|(% 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
463 |=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
464 iBeacon MAJOR
465 )))|(% style="width:63px" %)(((
466 iBeacon MINOR
467 )))|(% style="width:71px" %)(((
468 iBeacon Measured Power
469 )))|(% style="width:50px" %)(((
470 iBeacon RSSI
471 )))|(% style="width:47px" %)(((
472 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
473 )))|(% style="width:15px" %)[[FLAG>>||anchor="HFLAG:"]]
474
475 [[image:1664502425687-834.png]]
476
477
478 * (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
479 * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
480 * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
481 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
482 * (% style="color:#037691" %)**MINOR:**  (%%)The MAJOR from the strongest iBeacon.
483 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
484 * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
485
486 === 2.4.6  Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID ===
487
488
489 TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan WiFi and find the strongest WiFi info and uplink.
490
491
492 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %)
493 |=(% scope="row" style="width: 60px;" %)(((
494 **Size(bytes)**
495 )))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1
496 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)(((
497 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
498 )))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]]
499
500 (% class="wikigeneratedid" %)
501 [[image:1667288597595-714.png||height="212" width="1151"]]
502
503
504 * (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
505 * (% style="color:#037691" %)**SSID:      **(%%)WiFi name.
506 * (% style="color:#037691" %)**RSSI:      **(%%)The RSSI from the strongest WiFi.
507
508 === 2.4.7  Add Payload format in TTN V3 ===
509
510
511 In TTN V3, user can add a custom payload so it shows friendly.
512
513 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
514
515
516 [[image:1664502649601-895.png]]
517
518
519 Add the decoder from this link: 
520
521 [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
522
523 Save the change the uplink message will be parsed. As below:
524
525 [[image:1664502676891-606.png]]
526
527
528
529 == 2.5 Integrate with Datacake ==
530
531
532 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.
533
534 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]]
535
536 [[image:1664502695771-538.png]]
537
538
539
540 == 2.6 Integrate with Tago ==
541
542
543 After TrackerD sends data to LoRaWAN server such as TTN, user can pass the data to Datacake and plot out, currently only support GPS plot.
544
545 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]]
546
547
548
549 [[image:1664502715371-321.png]]
550
551
552
553 == 2.7  Datalog Feature ==
554
555
556 total 273 entries,by default,
557
558 User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
559
560 Example use case.
561
562 [[image:image-20221009234703-2.png||height="328" width="899"]]
563
564
565 [[image:image-20221009234629-1.png||height="390" width="577"]]
566
567
568
569 == 2.8 Alarm Mode ==
570
571
572 (((
573 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode.
574 )))
575
576
577 (((
578 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 exits alert mode.
579 )))
580
581
582 (((
583 Two ways to exit alarm mode:
584 )))
585
586 * Server sends a downlink command to exit.
587 * User fast press the RED button 10 times.
588
589 (((
590 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.
591 )))
592
593
594
595 == 2.9 Transport Mode ==
596
597
598 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.
599
600
601
602 == 2.10 LED Status ==
603
604
605 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
606 |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
607 |(% 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
608 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
609 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
610 |(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes
611 |(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes
612 |(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
613 |(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes
614 |(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes
615 |(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)led on 5 second|(% style="width:202px" %)Yes
616 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
617 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
618
619 == 2.11 Button Function ==
620
621
622 (% style="color:blue" %)**RESET button:**
623
624 [[image:1664502835802-546.png]]
625
626 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server.
627
628
629 (% style="color:red" %)**RED button:**
630
631 [[image:1664502854406-763.png]]
632
633
634 (% border="1" style="background-color:#ffffcc; color:green; width:510px" %)
635 |=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description**
636 |(% 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"]]
637 |(% 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
638 |(% 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.
639
640 == 2.12 USB Port Function ==
641
642
643 The USB interface of TrackerD has below functions:
644
645 * Power on the device
646 * Recharge the battery
647 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
648 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
649
650 = 3. Configure TrackerD via AT command or LoRaWAN downlink =
651
652
653 User can configure TrackerD via AT Command or LoRaWAN Downlink.
654
655 LoRaWAN Downlink instruction for different platforms:  [[IoT LoRaWAN Server>>doc:Main.WebHome]]
656
657
658
659 == 3.1 Access AT Command ==
660
661
662 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.
663
664
665 [[image:1664502999401-486.png]]
666
667
668 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:
669
670
671 [[image:1664503022490-662.png]]
672
673
674 [[image:1664503035713-500.png]]
675
676
677 [[image:1664503047675-651.png]]
678
679
680
681 == 3.2 Command Set ==
682
683
684 === 3.2.1 Set Transmit Interval ===
685
686
687 Set device uplink interval.
688
689 * (% style="color:blue" %)**AT Command:**
690
691 (% style="color:#037691" %)**AT+TDC=xxx **
692
693 Example:  AT+TDC=300000. Means set interval to 5 minutes(300 seconds)
694
695
696 * (% style="color:blue" %)**Downlink Payload (prefix 0x01):**
697
698 (% style="color:#037691" %)**0x01 00 01 2C**  (%%) ~/~/  Same as AT+TDC=300000
699
700
701
702 === 3.2.2 Set Alarm Packet transmission interval ===
703
704
705 Set alarm packet transmit interval
706
707 * (% style="color:blue" %)**AT Command:**
708
709 (% style="color:#037691" %)**AT+ATDC=xx. **
710
711 Example:  AT+ATDC=60000  **~-~->    ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000
712
713
714 * (% style="color:blue" %)**Downlink Payload (prefix 0xB1):**
715
716 (% style="color:#037691" %)**0xB1 00 00 3C ** (%%) ~/~/  Same as AT+ATDC=60000
717
718
719
720 === 3.2.3 Set Transport Mode Packet transmission interval ===
721
722
723 Set Transport Mode packet transmit interval
724
725 * (% style="color:blue" %)**AT Command:**
726
727 (% style="color:#037691" %)**AT+MTDC=xx. **
728
729 Example:  AT+MTDC=300000  **~-~->    ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000
730
731
732 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
733
734 (% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+ MTDC=3000000
735
736
737
738 === 3.2.4 Exit Alarm ===
739
740
741 Server send downlink command to exit Alarm mode
742
743 * (% style="color:blue" %)**AT Command: No AT Command**
744
745 * (% style="color:blue" %)**Downlink Payload (prefix 0x02):**
746
747 (% style="color:#037691" %)**0x02 01**    (%%) ~/~/  Exit Alarm Mode
748
749
750
751 === 3.2.5 Disable/Enable LED flash ===
752
753
754 Disable/Enable LED for position, downlink and uplink
755
756 * (% style="color:blue" %)**AT Command:**
757
758 (% style="color:#037691" %)**AT+LON=xx.  (Disable (0), Enable (1), default:1)**
759
760 Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
761
762
763 * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**
764
765 (% style="color:#037691" %)**0xAE 00 ** (%%) ~/~/  Same as AT+LON=0
766
767
768
769 === 3.2.6 Disable/Enable Transport Mode ===
770
771
772 Users can use this feature to enable/disable Transport Mode.
773
774 * (% style="color:blue" %)**AT Command:**
775
776 (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
777
778 Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
779
780
781 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
782
783 (% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+ INTWK =1
784
785
786
787 === 3.2.7 Set Positioning Mode ===
788
789
790 SMOD define how TrackerD scan and uplink data:
791
792
793 * (% style="color:blue" %)**AT Command:**
794
795 (% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
796
797 (% style="color:#037691" %)** aa:**
798
799 * (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
800 * (% style="color:red" %)**2: BLE or WiFi ONLY:                     **(%%)Only obtain iBeacon info via BLE and uplink  or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking.
801 * (% 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.
802
803 (% style="color:#037691" %)**bb:**
804
805 * (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
806 * (% style="color:red" %)**1 :**(%%)  GPS +BAT State
807
808 (% style="color:#037691" %)**cc:   **
809
810 * (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
811 * (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%))  
812
813 (% style="color:blue" %)**Example:**
814
815 AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
816 AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
817 AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
818 AT+ SMOD =2,0,2 ~-~->  (WiFi)SSID+Rssi+BAT+State
819
820
821 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
822
823 (% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
824
825
826
827 === 3.2.8 Set MAX GPS position time ===
828
829
830 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.
831
832
833 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.
834
835
836 * (% style="color:blue" %)**AT Command:**
837
838 (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
839
840 **Example:**  AT+FTIME=150
841
842
843 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
844
845 (% style="color:#037691" %)**0xAA 00 96 ** (%%) ~/~/  Set AT+FTIME=150
846
847
848
849 === 3.2.9 Set PDOP value for GPS fix accuracy ===
850
851
852 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.
853
854
855 A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0
856
857
858 * (% style="color:blue" %)**AT Command:**
859
860 (% style="color:#037691" %)**AT+PDOP=2.5 ** (%%) **~-~->  ** Set PDOP to 2.5
861
862
863 * (% style="color:blue" %)**Downlink Payload (prefix 0xAD):**
864
865 (% style="color:#037691" %)**0xAD 00 0A**   (%%) ~/~/  Set AT+PDOP=1  (0x0A / 10 =1)
866
867 (% style="color:#037691" %)**0xAD 00 19**   (%%) ~/~/  Set AT+PDOP=2.5    (0x19 / 10 =2.5)
868
869 (% style="color:#037691" %)**0xAD 00 46**    (%%) ~/~/  Set AT+PDOP=7  (0x46 / 10 =7)
870
871
872
873 Disable/Enable the confirmation mode
874
875 * (% style="color:blue" %)**AT Command:**
876
877 (% style="color:#037691" %)**AT+CFM=xx**
878
879
880 **~ Example:**
881
882 AT+ CFM=0    **~-~->   ** Disable confirmation
883
884 AT+ CFM=1    **~-~->  ** Enable confirmation
885
886
887 * (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
888
889 (% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+ CFM =1
890
891
892
893 === 3.2.10  Auto Send None-ACK messages ===
894
895
896 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.
897
898
899 * (% style="color:blue" %)**AT Command: AT+PNACKMD**
900
901 The default factory setting is 0.
902
903
904 **Command Example Function Response:**
905
906 (% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
907
908
909 * (% style="color:blue" %)**Downlink Command: 0x34**
910
911 Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
912
913
914
915 === 3.2.11  Set BLEMASK to filter BLE iBeacon ===
916
917
918 BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. TrackerD will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID.
919
920 (% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.**
921
922 (% style="color:blue" %)**AT Command:**
923
924 (% style="color:#037691" %)**AT+BLEMASK=123456**   (%%) ~/~/ Set BLEMASK = 123456
925
926 (% style="color:#037691" %)**AT+BLEMASK=0**  (%%) ~/~/ disable BLEMASK
927
928 (% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1)**
929
930 Example: 0xB2010203040506    ~/~/ Set BLEMASK to 123456
931
932 === 3.2.12  Set WiFIMASK to filter WiFi SSID ===
933
934
935 WiFiMASK is to filter the unwanted WiFi SSID during scan. For example, if WiFiMASK is 123456. TrackerD will only uplink SSID info which includes 123456. It will ignore all other WiFi which doesn’t contact 123456 in the SSID.
936
937 (% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.**
938
939 (% style="color:blue" %)**AT Command:**
940
941 (% style="color:#037691" %)**AT+ WiFiMASK =123456**    (%%) ~/~/ Set WiFiMASK = 123456
942
943 (% style="color:#037691" %)**AT+ WiFiMASK =0**       (%%) ~/~/ disable WiFiMASK
944
945 (% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1)**
946
947 Example: 0xB3010203040506    ~/~/ Set WiFiMASK to 123456
948
949 === 3.2.13 Disable/Enable Information printing(Since firmware 1.4.1) ===
950
951
952 Users can use this feature to enable/disable Information printing.
953
954 (% style="color:blue" %)**AT Command:**
955
956
957 (% style="color:#037691" %)**AT+ SHOWID=XX         **(%%) ~/~/(Disable (0), Enable (1), default:0)
958
959 Example: AT+ SHOWID =1 ~-~-> Enable Information printing.
960
961
962 = 4. Setting for Different Scenarios =
963
964
965
966 = 5. Upload Firmware =
967
968
969 == 5.1 Firmware Change Log ==
970
971
972 **[[See this link>>url:https://github.com/dragino/TrackerD]]**
973
974
975
976 == 5.2 How to upgrade firmware ==
977
978
979 User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
980
981
982 (% style="color:blue" %)**Step1:  **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
983
984
985 (% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC.
986
987 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
988
989
990 (% 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]]
991
992
993 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
994
995
996 [[image:1664503563660-578.png]]
997
998
999 [[image:1664503574618-659.png]]
1000
1001
1002
1003 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
1004
1005 [[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
1006
1007
1008 Users need to use below files:
1009
1010 boot_app0.bin @0e000
1011
1012 ESP_LORA-eeprom-class.bin @ 0x10000
1013
1014
1015 [[image:1664503593459-435.png]]
1016
1017
1018
1019 After upgrade finish, it will show finish as below:
1020
1021 [[image:1664503611848-385.png]]
1022
1023
1024
1025 = 6. Developer Guide =
1026
1027
1028 == 6.1 Compile Source Code ==
1029
1030
1031 === 6.1.1 Set up ARDUINO compile environment ===
1032
1033
1034 * **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]]**
1035
1036 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]]
1037
1038
1039 [[image:1664503635019-941.png]]
1040
1041
1042
1043 * (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.**
1044
1045 [[image:1664503715811-892.png]]
1046
1047
1048 (% id="cke_bm_4554S" style="display:none" %) (%%)Find the path of SP32 installation, find the file as shown in Figure 1, and change the SPI pin to the shown in Figure 2.
1049
1050 [[image:image-20221024105643-1.png]]
1051
1052 **~ Figure1**
1053
1054
1055 [[image:image-20221024105643-2.png]]
1056
1057 **Figure2**
1058
1059
1060 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
1061
1062 Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
1063
1064
1065 [[image:1664503752288-974.png]]
1066
1067
1068
1069 == 6.2 Source Code ==
1070
1071
1072 * (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:**
1073
1074 [[image:1664503794261-827.png]]
1075
1076
1077
1078 * (% style="color:blue" %)**Click to upload**
1079
1080 [[image:1664503808294-336.png]]
1081
1082
1083
1084 * (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data**
1085
1086 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
1087
1088
1089
1090 = 7.  FAQ =
1091
1092
1093 == 7.1 How to change the LoRa Frequency Bands/Region? ==
1094
1095
1096 User can follow the introduction for [[how to upgrade image>>||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.
1097
1098
1099
1100 == 7.2 What is the pin mapping for the USB program cable? ==
1101
1102
1103 [[image:1664499635206-262.png]]
1104
1105
1106
1107 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)
1108 |=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin**
1109 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
1110 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
1111 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
1112 |(% style="width:118px" %)A1,B1,A12,B12|(% style="width:67px" %)Black|(% style="width:123px" %)GND
1113 |(% style="width:118px" %)A5|(% style="width:67px" %)Purple|(% style="width:123px" %)MTDC/GOIO13
1114 |(% style="width:118px" %)B5|(% style="width:67px" %)Blue|(% style="width:123px" %)MTDC/GPIO12
1115 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
1116 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
1117
1118 == 7.3 Notes on using different serial port tools for TrackerD ==
1119
1120
1121 === **Serial port utility** ===
1122
1123
1124 Serial port utility requires you to automatically add data streams.
1125
1126 Need to adjust the data stream to RTS/CTS on physical restart.
1127
1128
1129 (% class="wikigeneratedid" %)
1130 [[image:image-20221102140621-1.png]]
1131
1132
1133 When using AT commands, the data flow needs to be adjusted to XON/XOFF
1134
1135
1136 [[image:image-20221102140638-2.png]]
1137
1138
1139
1140 === **SecureCRT** ===
1141
1142
1143 The default command window of SecureCRT is not displayed. Entering a command requires a complete input of the entire command. You can open the command window in the view.
1144
1145
1146 [[image:image-20221102140704-3.png]]
1147
1148
1149 [[image:image-20221102140712-4.png]]
1150
1151
1152
1153 === **PUTTY** ===
1154
1155
1156 [[image:image-20221102140748-5.png]]
1157
1158
1159 Since putty does not have a command window, you need to fill in the complete command externally, and then copy it to putty.The information copied outside can be pasted by right-clicking the mouse in putty.
1160
1161
1162 [[image:image-20221102140801-6.png]]
1163
1164
1165
1166 = 8.  Order Info =
1167
1168
1169 Part Number: (% style="color:blue" %)**TrackerD-XXX**
1170
1171 (% style="color:blue" %)**XXX**(%%): The default frequency band
1172
1173 * (% style="color:red" %)**EU433**(%%): Default frequency band EU433
1174 * (% style="color:red" %)**EU868**(%%): Default frequency band EU868
1175 * (% style="color:red" %)**IN865**(%%): Default frequency band IN865
1176 * (% style="color:red" %)**KR920**(%%): Default frequency band KR920
1177 * (% style="color:red" %)**AS923**(%%): Default frequency band AS923
1178 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
1179 * (% style="color:red" %)**US915**(%%): Default frequency band US915
1180
1181 = 9.  Packing Info =
1182
1183
1184 (% style="color:#037691" %)**Package Includes**:
1185
1186 * TrackerD LoRaWAN GPS/BLE Tracker x 1
1187 * USB recharge & program cable x 1
1188
1189 (% style="color:#037691" %)**Dimensions and Weight**:
1190
1191 * Device Size: 85 x 48 x 15 mm
1192 * Weight: 50g
1193
1194 = 10. Support =
1195
1196
1197 * 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.
1198 * 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]].
1199
1200 = 11.  Reference =
1201
1202
1203 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1204 * **[[Source Code>>https://github.com/dragino/TrackerD]] **
1205 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0