Wiki source code of TrackerD -LoRaWAN Tracker User Manual

Version 19.3 by Xiaoling on 2022/09/30 09:23

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

Wiki source code of TrackerD -LoRaWAN Tracker User Manual

Applications