Wiki source code of TrackerD -LoRaWAN Tracker User Manual

Version 40.1 by Xiaoling on 2022/09/30 10:06

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
19.4	514	=== 3.3.3 Set Sports Mode Packet transmission interval ===
19.2	515
	516	Set sports packet transmit interval
	517
	518	* AT Command:
	519
	520	AT+MTDC=xx.
	521
	522	Example: AT+MTDC=300000 à Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
	523
	524
	525	* Downlink Payload (prefix 0x03):
	526
	527	0x03 00 01 2C ~/~/Same as AT+ MTDC=3000000
	528
	529
	530
19.4	531	=== 3.3.4 Exit Alarm ===
19.2	532
	533	Server send downlink command to exit Alarm mode
	534
	535	* AT Command:
	536
	537	No AT Command
	538
	539
	540	* Downlink Payload (prefix 0x02):
	541
	542	0x02 01 ~/~/ Exit Alarm Mode
	543
	544
19.4	545	=== 3.3.5 Disable/Enable LED flash ===
19.2	546
	547	Disable/Enable LED for position, downlink and uplink
	548
	549	* AT Command:
	550
	551	AT+LON=xx. (Disable (0), Enable (1), default:1)
	552
	553	Example: AT+LON=0 à Disable LED for position, downlink and uplink.
	554
	555
	556	* Downlink Payload (prefix 0xAE):
	557
	558	0xAE 00 ~/~/Same as AT+LON=0
	559
	560
	561
	562
19.4	563	=== 3.3.6 Disable/Enable movement detect (Debug Only) ===
19.2	564
	565	User can use this feature to check and set thread hole of movement detect
	566
	567	* AT Command:
	568
	569	AT+INTWK=xx. (Disable (0), Enable (1), default:0)
	570
	571	Example: AT+ INTWK =1 à Enable detect movement.
	572
	573
	574	* Downlink Payload (prefix 0xAF):
	575
	576	0xAF 01 ~/~/Same as AT+ INTWK =1
	577
	578
	579
19.4	580	=== 3.3.7 Set Positioning Mode ===
19.2	581
	582	SMOD define the how TrackerD scan and uplink date.
	583
	584	GPS室外定位模式：设备默认模式，设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是3分钟定位，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。GPS还有一种logdata模式，在断网的情况下将数据存储下来，等到有网的时候，一次将数据以每10秒上报。
	585
	586	BLE室内定位模式：设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是5秒，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每3分钟发送一次）。
	587
	588	GPS和BLE混动模式：设备入网后会发送device当前模式下的信息，随后立即判断是否在室内，如果是就进行BLE定位，不是就GPS定位。如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。
	589
	590	运动模式：设备入网后会发送device当前模式下的信息，随后发送GPS定位数据，设备判断是否在运动，没有运动传感器没有检测到动作，立即进入静止状态（默认20分钟），如果产生运动，将每5分钟发送一次数据，再第五分钟后检测设备有误运动，无将切换到静止状态，有立即发送数据。
	591
	592
	593
	594
	595	* AT Command:
	596
	597	AT+SMOD=xx.
	598
	599	Example:
	600
	601	AT+ SMOD =1,0 à GPS+ BAT+ State+Tem&Hum
	602
	603	AT+ SMOD =1,1 à GPS +BAT State
	604
	605	AT+ SMOD =2,3 à (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
	606
	607
	608	* Downlink Payload (prefix 0xA5):
	609
	610	0xA5 01 00 ~/~/ Same as AT+ SMOD =1,0
	611
	612
19.4	613	=== 3.3.8 Set MAX GPS position time ===
19.2	614
	615	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.
	616
	617
	618	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.
	619
	620
	621	* AT Command:
	622
	623	AT+FTIME=xx à Set to use xx as max fix time.
	624
	625	Example: AT+FTIME=150
	626
	627
	628	* Downlink Payload (prefix 0xAA):
	629
	630	0xAA 00 96 ~/~/Set AT+FTIME=150
	631
	632
	633
	634
19.4	635	=== 3.3.9 Set PDOP value for GPS fix accuracy ===
19.2	636
	637	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.
	638
	639
	640	A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0
	641
	642
	643	* AT Command:
	644
	645	AT+PDOP=2.5 à Set PDOP to 2.5
	646
	647
	648	* Downlink Payload (prefix 0xAD):
	649
	650	0xAD 00 0A ~/~/Set AT+PDOP=1 (0x0A / 10 =1)
	651
	652	0xAD 00 19 ~/~/Set AT+PDOP=2.5 (0x19 / 10 =2.5)
	653
	654	0xAD 00 46 ~/~/Set AT+PDOP=7 (0x46 / 10 =7)
	655
	656	Disable/Enable the confirmation mode
	657
	658	* AT Command:
	659
	660	AT+CFM=xx.
	661
	662	Example:
	663
	664	AT+ CFM=0 à Disable confirmation
	665
	666	AT+ CFM=1 à Enable confirmation
	667
	668
	669	* Downlink Payload (prefix 0x05):
	670
	671	0x05 01 ~/~/ Same as AT+ SMOD =1
	672
	673
	674
	675
	676
	677
19.4	678	= 4. Setting for Different Scenarios =
19.2	679
	680
	681
19.4	682	= 5. Upload Firmware =
19.2	683
19.4	684
	685	== 5.1 Firmware Change Log ==
	686
19.2	687	[[See this link>>url:https://github.com/dragino/TrackerD]]
	688
	689
19.4	690	== 5.2 How to upgrade firmware ==
19.2	691
	692	User can use the TrackerD ’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below:
	693
	694
19.4	695	(% style="color:blue" %)Step1: (%%)Connect TrackerD and PC via USB cable shipped with TrackerD.
19.2	696
19.4	697	(% style="color:blue" %)Step2: (%%) Install CH9102 driver in the PC.
19.2	698
	699	After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
	700
	701
19.4	702	(% style="color:blue" %)Step3：(%%) Download and Install Flash Tool:
19.2	703
	704	[[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]]
	705
19.4	706	(% style="color:blue" %)Step4: (%%) Run Flash Download Tool and configure chip type to ESP32
19.2	707
	708
	709	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png\|\|alt="image-20220712083115-1.png"]]
	710
	711	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png\|\|alt="image-20220712083115-2.png"]]
	712
	713
19.4	714	(% style="color:blue" %)Step5: (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
19.2	715
	716	[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
	717
	718
	719	Users need to use below files:
	720
	721	boot_app0.bin @0e000
	722
	723	ESP_LORA-eeprom-class.bin @ 0x10000
	724
	725	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png\|\|alt="image-20220712083115-3.png"]]
	726
	727	After upgrade finish, it will show finish as below:
	728
	729	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png\|\|alt="image-20220712083115-4.png"]]
	730
	731
	732
	733
	734
19.4	735	= 6. Developer Guide =
19.2	736
	737
19.4	738	== 6.1 Compile Source Code ==
	739
	740
	741	=== 6.1.1 Set up ARDUINO compile environment ===
	742
	743
19.2	744	* Download the latest Arduino software (IDE) from the Arduino official website
	745
	746	[[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]
	747
	748	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]]
	749
	750	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
	751
	752	* Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it.
	753
	754	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
	755
	756
	757	* Download the latest TrackerD from the dragino github
	758
	759	[[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
	760
	761
	762	Put the Library in the TrackerD directory into the libraries file in the Arduino directory
	763
	764	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]]
	765
	766
	767
	768
19.4	769	== 6.2 Source Code ==
	770
	771
19.2	772	* Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:
	773
	774	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
	775
	776	* Click to upload
	777
	778	[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
	779
	780	* Check the result, if the upload is successful, as shown below, open the serial port to view the data
	781
	782
	783	[[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]]
	784
	785
	786
	787
	788
	789
18.2	790	= 7. FAQ =
15.2	791
	792
14.1	793
18.2	794	== 7.1 How to change the LoRa Frequency Bands/Region? ==
14.1	795
	796
18.2	797	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	798
12.1	799
2.1	800
18.2	801	== 7.2 What is the pin mapping for the USB program cable? ==
2.1	802
7.1	803
18.2	804	[[image:1664499635206-262.png]]
7.1	805
	806
	807
18.2	808	(% border="2" style="background-color:#ffffcc; color:green; width:314px" %)
	809	\|(% style="width:118px" %)Pin\|(% style="width:67px" %)Color\|(% style="width:123px" %)USB Pin
	810	\|(% style="width:118px" %)A4,B4,A9,B9\|(% style="width:67px" %)Red\|(% style="width:123px" %)VCC
	811	\|(% style="width:118px" %)A7,B7\|(% style="width:67px" %)White\|(% style="width:123px" %)D- (N/A)
	812	\|(% style="width:118px" %)A6,B6\|(% style="width:67px" %)Green\|(% style="width:123px" %)D+(N/A)
	813	\|(% style="width:118px" %)A1,B1,A12,B12\|(% style="width:67px" %)Black\|(% style="width:123px" %)GND
	814	\|(% style="width:118px" %)A5\|(% style="width:67px" %)Purple\|(% style="width:123px" %)MTDC/GOIO13
	815	\|(% style="width:118px" %)B5\|(% style="width:67px" %)Blue\|(% style="width:123px" %)MTDC/GPIO12
	816	\|(% style="width:118px" %)A8\|(% style="width:67px" %)Yellow\|(% style="width:123px" %)MTMS/GPIO14
	817	\|(% style="width:118px" %)B8\|(% style="width:67px" %)Grey\|(% style="width:123px" %)MTDO/GPIO15
7.1	818
18.2	819	= 8. Order Info =
7.1	820
	821
15.6	822	Part Number: (% style="color:blue" %)TrackerD-XXX
8.1	823
15.6	824	(% style="color:blue" %)XXX(%%): The default frequency band
8.1	825
15.6	826	* (% style="color:red" %)EU433(%%): Default frequency band EU433
	827	* (% style="color:red" %)CN470(%%): Default frequency band CN470
	828	* (% style="color:red" %)EU868(%%): Default frequency band EU868
	829	* (% style="color:red" %)IN865(%%): Default frequency band IN865
	830	* (% style="color:red" %)KR920(%%): Default frequency band KR920
	831	* (% style="color:red" %)AS923(%%): Default frequency band AS923
	832	* (% style="color:red" %)AU915(%%): Default frequency band AU915
	833	* (% style="color:red" %)US915(%%): Default frequency band US915
15.2	834
	835
18.2	836	= 9. Packing Info =
	837
	838
8.1	839	Package Includes:
	840
11.1	841	* TrackerD x 1
	842	* Rechargeable cable x 1
	843	* Program Cable x 1
12.1	844
15.6	845	Dimensions and Weight:
12.1	846
15.6	847	* Device Size: 85 x 48 x 15 mm/pcs
	848	* Weight: 55g/pcs
	849
	850
	851
18.2	852	= 10. Support =
	853
	854	* 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.
	855	* 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
	856
	857	[[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]
	858
	859
	860
	861
	862	= 11. Reference =
	863
	864
12.1	865	* [[Firmware in Bin format>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
	866	* [[Source Code>>https://github.com/dragino/TrackerD]]
	867	* [[Hardware Source>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]

Wiki source code of TrackerD -LoRaWAN Tracker User Manual

Applications

Navigation