Wiki source code of TrackerD -LoRaWAN Tracker User Manual

Version 50.4 by Xiaoling on 2022/09/30 10:25

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

Wiki source code of TrackerD -LoRaWAN Tracker User Manual

Applications