Changes for page TrackerD -- LoRaWAN Tracker User Manual

Summary

• Page properties (1 modified, 0 added, 0 removed)
• Attachments (0 modified, 23 added, 0 removed)
  • 1667288597595-714.png
  • image-20221024105643-1.png
  • image-20221024105643-2.png
  • image-20221102140621-1.png
  • image-20221102140638-2.png
  • image-20221102140704-3.png
  • image-20221102140712-4.png
  • image-20221102140748-5.png
  • image-20221102140801-6.png
  • image-20221107145243-1.png
  • image-20221116111844-1.png
  • image-20221116111844-2.png
  • image-20221116111844-3.png
  • image-20221116111844-4.png
  • image-20221116111844-5.png
  • image-20221118104359-1.png
  • image-20221118105220-2.png
  • image-20221118105249-3.png
  • image-20221118105402-4.png
  • image-20221122100004-1.png
  • image-20221122100004-2.png
  • image-20221122100004-3.png
  • image-20221122100004-4.png

Details

Page properties

Content

...	...	@@ -14,7 +14,6 @@
14	14
15	15	= 1.  Introduction =
16	16
17		-
18	18	== 1.1  What is TrackerD ==
19	19
20	20
...	...	@@ -46,7 +46,6 @@
46	46	(% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.**
47	47
48	48
49		-
50	50	== 1.2 Specifications ==
51	51
52	52
...	...	@@ -97,6 +97,7 @@
97	97	* LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
98	98	* Tracking: max: 38mA
99	99
	98	+
100	100	== 1.3  Features ==
101	101
102	102
...	...	@@ -115,6 +115,7 @@
115	115	* Tri-color LED, Alarm button
116	116	* Datalog
117	117
	117	+
118	118	== 1.4  Applications ==
119	119
120	120
...	...	@@ -121,8 +121,8 @@
121	121	* Logistics and Supply Chain Management
122	122	* Human tracking
123	123
124		-= 2.1 Use TrackerD =
125	125
	125	+= 2.  Use TrackerD =
126	126
127	127	== 2.1 How it works? ==
128	128
...	...	@@ -130,7 +130,6 @@
130	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	131
132	132
133		-
134	134	== 2.2 Quick guide to connect to LoRaWAN server ==
135	135
136	136
...	...	@@ -172,54 +172,56 @@
172	172	**__Add APP KEY and DEV EUI:__**
173	173
174	174
175		-[[image:1664501784668-703.png]]
	174	+[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS02%20-%20LoRaWAN%20Door%20Sensor%20User%20Manual/WebHome/1654671889112-678.png?rev=1.1||alt="1654671889112-678.png"]]
176	176
177	177
178	178
	178	+(% style="color:blue" %)**Step 2**:(%%) Push this button will activate this device.
179	179
180		-(% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
	180	+(% id="cke_bm_7709S" style="display:none" %) [[image:1664502835802-546.png]]
181	181
	182	+[[image:1664502835802-546.png]]
182	182
	184	+
183	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	184
185	185
186		-
187	187	== 2.3  Positioning Mode(SMOD) ==
188	188
189	189
190	190	Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported.
191	191
192		-* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
193		-* (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
194		-* (% style="color:#037691" %)**GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning.
	193	+* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
	194	+* (% 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.
	195	+* (% 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	195
196	196	Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
197	197
198	198
199		-
200	200	== 2.4  Uplink Payload ==
201	201
202		-
203	203	=== 2.4.1 Uplink FPORT~=5, Device Status ===
204	204
205	205
206	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	207
	207	+Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
208	208
209		-(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
210		-|=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1
	209	+
	210	+(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %)
	211	+|=(% 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
211	211	|=(% 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
212	212
213	213	[[image:1665301570342-765.png]]
214	214
215	215
216		-Example of Device Status:  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT52%20-%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220621105116-11.png?rev=1.1||alt="image-20220621105116-11.png"]]
	217	+(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
217	217
218		-**Sensor Model**: For TrackerD, this value is 0x13.
	219	+(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
219	219
220		-**Firmware Version**: 0x0100, Means: v1.0.0 version.
	221	+(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
221	221
222		-**Frequency Band**:
	223	+(% style="color:#037691" %)**Frequency Band**:
223	223
224	224	*0x01: EU868
225	225
...	...	@@ -241,28 +241,64 @@
241	241
242	242	*0x0a: AS923-3
243	243
244		-**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
	245	+Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
245	245
246		-**BAT**: shows the battery voltage for TrackerD.
	247	+(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
247	247
248		-Ex1: 0x0B3A = 2874mV
249	249
	250	+(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
	251	+
250	250	Use can also get the Device Status uplink through the downlink command:
251	251
252	252
	255	+(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
253	253
	257	+(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %)
	258	+|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit
	259	+|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings
	260	+
	261	+(% style="color:blue" %)** SMOD：**
	262	+
	263	+(% style="color:red" %)** 1 :** (%%) GPS ONLY
	264	+
	265	+(% style="color:red" %)** 2 :** (%%) BLE ONLY
	266	+
	267	+(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
	268	+
	269	+
	270	+(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
	271	+
	272	+(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
	273	+
	274	+(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
	275	+
	276	+
	277	+(% style="color:blue" %)** BLE_Settings:**
	278	+
	279	+(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
	280	+
	281	+(% style="color:red" %)** 2：**  (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%)
	282	+
	283	+
	284	+(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
	285	+
	286	+(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %)
	287	+|=(% 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
	288	+|=(% 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"]]
	289	+
	290	+
254	254	=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
255	255
256	256
257		-User can use **AT+SMOD=1,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, please note that 15 bytes won't work on DR0 on US915/AU915 frequency band.
	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,
258	258
259	259
260		-(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
261		-|=(% scope="row" style="width: 50px;" %)(((
	297	+(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %)
	298	+|=(% scope="row" style="width: 60px;" %)(((
262	262	**Size(bytes)**
263		-)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
	300	+)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)(((
264	264	2
265		-)))|(% style="width:87px" %)(((
	302	+)))|(% style="width:30px" %)(((
266	266	2
267	267	)))
268	268	|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
...	...	@@ -281,8 +281,8 @@
281	281
282	282	==== (% style="color:blue" %)**FLAG:**(%%) ====
283	283
284		-(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
285		-|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
	321	+(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %)
	322	+|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit
286	286	|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
287	287
288	288	**Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A
...	...	@@ -311,12 +311,12 @@
311	311
312	312	==== (% style="color:blue" %)**Alarm:**(%%) ====
313	313
314		-Example:  0x4B & 0x40 >> 6 = 0x01
	351	+**Example: ** 0x4B & 0x40 >> 6 = 0x01
315	315
316	316
317	317	==== (% style="color:blue" %)**BAT:**(%%) ====
318	318
319		-Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
	356	+**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
320	320
321	321	(((
322	322	The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
...	...	@@ -328,16 +328,34 @@
328	328	* 3.40v ~~ 3.69v:  20% ~~ 40%
329	329	* < 3.39v:  0~~20%
330	330
	368	+
	369	+==== (% style="color:blue" %)**MOD:**(%%) ====
	370	+
	371	+**Example: ** (0x60>>6) & 0x3f =1
	372	+
	373	+**Set the format of GPS data uplink link：**
	374	+
	375	+(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
	376	+(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
	377	+
	378	+
	379	+**Set the format of BLE data uplink link：**
	380	+
	381	+(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
	382	+
	383	+
331	331	==== (% style="color:blue" %)**LON:**(%%) ====
332	332
	386	+**Example:** (0x60>>5) & 0x01=1.
	387	+
333	333	Enable/Disable LED activity for uplink
334	334
335	335	(((
336		-0x00:  Disable LED indicator.
	391	+(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
337	337	)))
338	338
339	339	(((
340		-0x01:  Enable LED indicator (Default Value)
	395	+(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
341	341	)))
342	342
343	343
...	...	@@ -351,17 +351,16 @@
351	351	011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
352	352
353	353
354		-
355	355	=== 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
356	356
357	357
358		-The default uplink payload includes totally 11 bytes. The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
	412	+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)
359	359
360	360
361		-(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
362		-|=(% scope="row" style="width: 50px;" %)(((
	415	+(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %)
	416	+|=(% scope="row" style="width: 60px;" %)(((
363	363	**Size(bytes)**
364		-)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
	418	+)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1
365	365	|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
366	366	[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
367	367	)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
...	...	@@ -370,21 +370,21 @@
370	370	[[image:1665301687277-443.png]]
371	371
372	372
373		-
374	374	=== 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
375	375
376	376
377		-Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
	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.
378	378
379	379
380	380	(% style="color:red" %)**Note for this mode:**
381	381
382	382	* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
383		-* 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.
	436	+* b) TrackerD will send data in CONFIRMED Mode when PNACKMD=1 and CFM=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
384	384
385	385	The payload is 15 bytes, as below.
386	386
387		-(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
	441	+(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
388	388	|=(% scope="row" %)(((
389	389	**Size(bytes)**
390	390	)))|4|4|2|1|1|1|1|1
...	...	@@ -393,10 +393,14 @@
393	393	[[image:image-20221009160309-2.png]]
394	394
395	395
396		-
397	397	=== 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
398	398
399	399
	453	+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.
	454	+
	455	+User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
	456	+
	457	+
400	400	(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
401	401	|=(% scope="row" style="width: 60px;" %)(((
402	402	**Size(bytes)**
...	...	@@ -416,19 +416,43 @@
416	416	[[image:1664502425687-834.png]]
417	417
418	418
419		-* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
	477	+* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
420	420	* (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
421	421	* (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
422	422	* (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
423		-* (% style="color:#037691" %)**MINOR:**  (%%)The MAJOR from the strongest iBeacon.
	481	+* (% style="color:#037691" %)**MINOR:**  (%%)The MINOR from the strongest iBeacon.
424	424	* (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
425	425	* (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
426	426
427		-=== 2.4.6  Add Payload format in TTN V3 ===
428	428
	486	+=== 2.4.6  Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID（Since firmware 1.4.1） ===
429	429
430		-In TTN V3, use can add a custom payload so it shows friendly.
431	431
	489	+TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **WiFi** 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	+
	509	+=== 2.4.7  Add Payload format in TTN V3 ===
	510	+
	511	+
	512	+In TTN V3, user can add a custom payload so it shows friendly.
	513	+
432	432	In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
433	433
434	434
...	...	@@ -435,52 +435,44 @@
435	435	[[image:1664502649601-895.png]]
436	436
437	437
438		-Add the decoder from this link:
439	439
	521	+Add the decoder from this link:
440	440
	523	+[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
	524	+
441	441	Save the change the uplink message will be parsed. As below:
442	442
443	443	[[image:1664502676891-606.png]]
444	444
445	445
446		-
447	447	== 2.5 Integrate with Datacake ==
448	448
449	449
450		-(((
451	451	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.
452		-)))
453	453
454		-(((
455	455	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]]
456		-)))
457	457
458	458
459	459	[[image:1664502695771-538.png]]
460	460
461	461
462		-
463	463	== 2.6 Integrate with Tago ==
464	464
465	465
466		-(((
467		-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.
468		-)))
	544	+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.
469	469
470		-(((
471	471	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]]
472		-)))
473	473
474	474
475	475	[[image:1664502715371-321.png]]
476	476
477	477
478		-
479	479	== 2.7  Datalog Feature ==
480	480
481	481
482		-total 273 entries,by default disable
	555	+total 273 entries,by default,
483	483
	557	+User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
484	484
485	485	Example use case.
486	486
...	...	@@ -490,7 +490,6 @@
490	490	[[image:image-20221009234629-1.png||height="390" width="577"]]
491	491
492	492
493		-
494	494	== 2.8 Alarm Mode ==
495	495
496	496
...	...	@@ -500,15 +500,15 @@
500	500
501	501
502	502	(((
503		-Once enter Alarm mode, the (% style="color:green" %)**GREEN LED**(%%) will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send a packet without location info and then send a data packet with GPS positioning information. After that, the device will send 60 packets at 1-minute intervals. The Alarm flag in the payload will be set for the next 60 packets unless exit alert mode.
	576	+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.
504	504	)))
505	505
506	506
507	507	(((
508		-Two ways to exit alarm mode:
	581	+**Two ways to exit alarm mode:**
509	509	)))
510	510
511		-* Server send a downlink command to exit.
	584	+* Server sends a downlink command to exit.
512	512	* User fast press the RED button 10 times.
513	513
514	514	(((
...	...	@@ -516,7 +516,6 @@
516	516	)))
517	517
518	518
519		-
520	520	== 2.9 Transport Mode ==
521	521
522	522
...	...	@@ -523,17 +523,16 @@
523	523	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.
524	524
525	525
526		-
527	527	== 2.10 LED Status ==
528	528
529	529
530		-(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
	601	+(% border="1.5" style="background-color:#ffffcc; width:500px" %)
531	531	|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
532	532	|(% 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
533	533	|(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
534	534	|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
535	535	|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes
536		-|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes
	607	+|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
537	537	|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
538	538	|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes
539	539	|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes
...	...	@@ -541,6 +541,7 @@
541	541	|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
542	542	|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
543	543
	615	+
544	544	== 2.11 Button Function ==
545	545
546	546
...	...	@@ -556,12 +556,13 @@
556	556	[[image:1664502854406-763.png]]
557	557
558	558
559		-(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
560		-|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
561		-|(% 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"]]
	631	+(% border="1" style="background-color:#ffffcc; width:510px" %)
	632	+|=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description**
	633	+|(% 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.8AlarmMode"]]
562	562	|(% 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
563	563	|(% 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.
564	564
	637	+
565	565	== 2.12 USB Port Function ==
566	566
567	567
...	...	@@ -572,6 +572,7 @@
572	572	* [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]
573	573	* [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
574	574
	648	+
575	575	= 3. Configure TrackerD via AT command or LoRaWAN downlink =
576	576
577	577
...	...	@@ -580,7 +580,6 @@
580	580	LoRaWAN Downlink instruction for different platforms:  [[IoT LoRaWAN Server>>doc:Main.WebHome]]
581	581
582	582
583		-
584	584	== 3.1 Access AT Command ==
585	585
586	586
...	...	@@ -596,11 +596,9 @@
596	596	[[image:1664503022490-662.png]]
597	597
598	598
599		-
600	600	[[image:1664503035713-500.png]]
601	601
602	602
603		-
604	604	[[image:1664503047675-651.png]]
605	605
606	606
...	...	@@ -607,7 +607,6 @@
607	607
608	608	== 3.2 Command Set ==
609	609
610		-
611	611	=== 3.2.1 Set Transmit Interval ===
612	612
613	613
...	...	@@ -625,7 +625,6 @@
625	625	(% style="color:#037691" %)**0x01 00 01 2C**  (%%) ~/~/  Same as AT+TDC=300000
626	626
627	627
628		-
629	629	=== 3.2.2 Set Alarm Packet transmission interval ===
630	630
631	631
...	...	@@ -643,7 +643,6 @@
643	643	(% style="color:#037691" %)**0xB1 00 00 3C ** (%%) ~/~/  Same as AT+ATDC=60000
644	644
645	645
646		-
647	647	=== 3.2.3 Set Transport Mode Packet transmission interval ===
648	648
649	649
...	...	@@ -658,10 +658,9 @@
658	658
659	659	* (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
660	660
661		-(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+ MTDC=3000000
	729	+(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+MTDC=3000000
662	662
663	663
664		-
665	665	=== 3.2.4 Exit Alarm ===
666	666
667	667
...	...	@@ -674,7 +674,6 @@
674	674	(% style="color:#037691" %)**0x02 01**    (%%) ~/~/  Exit Alarm Mode
675	675
676	676
677		-
678	678	=== 3.2.5 Disable/Enable LED flash ===
679	679
680	680
...	...	@@ -692,7 +692,6 @@
692	692	(% style="color:#037691" %)**0xAE 00 ** (%%) ~/~/  Same as AT+LON=0
693	693
694	694
695		-
696	696	=== 3.2.6 Disable/Enable Transport Mode ===
697	697
698	698
...	...	@@ -702,57 +702,60 @@
702	702
703	703	(% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
704	704
705		-Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
	770	+Example:  AT+INTWK=1  **~-~->   ** Enable Transport Mode.
706	706
707	707
708	708	* (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
709	709
710		-(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+ INTWK =1
	775	+(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+INTWK=1
711	711
712	712
713		-
714	714	=== 3.2.7 Set Positioning Mode ===
715	715
716	716
717		-SMOD define the how TrackerD scan and uplink data:
	781	+SMOD define how TrackerD scan and uplink data:
718	718
719	719
720	720	* (% style="color:blue" %)**AT Command:**
721	721
722		-(% style="color:#037691" %)**AT+SMOD=aa,bb**
	786	+(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
723	723
724	724	(% style="color:#037691" %)** aa:**
725	725
726		-* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
727		-* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
728		-* (% style="color:#037691" %)**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
	790	+* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
729	729
	792	+* (% 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.
	793	+
	794	+* (% 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.
	795	+
730	730	(% style="color:#037691" %)**bb:**
731	731
732		-(% style="color:#037691" %)** if aa = 1: **
	798	+* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
733	733
734		-* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
735		-* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
	800	+* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
736	736
737		-(% style="color:#037691" %)** if aa = 2: **
	802	+(% style="color:#037691" %)**cc:   **
738	738
739		-* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
	804	+* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
	805	+
	806	+* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%))
740	740
741		- **Example:**
	808	+(% style="color:blue" %)**Example:**
742	742
743		- AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
	810	+ AT+SMOD=1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
744	744
745		- AT+ SMOD =1,1    **~-~->**  GPS +BAT State
	812	+ AT+SMOD=1,1,0 ~-~->  GPS +BAT State
746	746
747		- AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
	814	+ AT+SMOD=2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
748	748
	816	+ AT+SMOD=2,0,2 ~-~->  (WiFi)SSID+Rssi+BAT+State
749	749
	818	+
750	750	* (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
751	751
752		-(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
	821	+(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+SMOD=1,0,0
753	753
754	754
755		-
756	756	=== 3.2.8 Set MAX GPS position time ===
757	757
758	758
...	...	@@ -759,7 +759,7 @@
759	759	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.
760	760
761	761
762		-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.
	830	+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.
763	763
764	764
765	765	* (% style="color:blue" %)**AT Command:**
...	...	@@ -766,7 +766,7 @@
766	766
767	767	(% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
768	768
769		-Example:  AT+FTIME=150
	837	+**Example:**  AT+FTIME=150
770	770
771	771
772	772	* (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
...	...	@@ -774,7 +774,6 @@
774	774	(% style="color:#037691" %)**0xAA 00 96 ** (%%) ~/~/  Set AT+FTIME=150
775	775
776	776
777		-
778	778	=== 3.2.9 Set PDOP value for GPS fix accuracy ===
779	779
780	780
...	...	@@ -799,26 +799,108 @@
799	799
800	800
801	801
802		-Disable/Enable the confirmation mode
	869	+**Disable/Enable the confirmation mode**
803	803
804	804	* (% style="color:blue" %)**AT Command:**
805	805
806		-(% style="color:#037691" %)**AT+CFM=xx. **
	873	+(% style="color:#037691" %)**AT+CFM=xx**
807	807
808	808
809	809	**~ Example:**
810	810
811		- AT+ CFM=0    **~-~->   ** Disable confirmation
	878	+ AT+CFM=0    **~-~->   ** Disable confirmation
812	812
813		- AT+ CFM=1    **~-~->  ** Enable confirmation
	880	+ AT+CFM=1    **~-~->  ** Enable confirmation
814	814
815	815
816	816	* (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
817	817
818		-(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+ SMOD =1
	885	+(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+CFM=1
819	819
820	820
	888	+=== 3.2.10  Auto Send None-ACK messages ===
821	821
	890	+
	891	+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.
	892	+
	893	+
	894	+* (% style="color:blue" %)**AT Command: AT+PNACKMD**
	895	+
	896	+The default factory setting is 0.
	897	+
	898	+
	899	+**Command Example Function Response:**
	900	+
	901	+(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
	902	+
	903	+
	904	+* (% style="color:blue" %)**Downlink Command: 0x34**
	905	+
	906	+Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
	907	+
	908	+
	909	+=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
	910	+
	911	+
	912	+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.
	913	+
	914	+(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.**
	915	+
	916	+(% style="color:blue" %)**AT Command:**
	917	+
	918	+ (% style="color:#037691" %)**AT+BLEMASK=123456**   (%%) ~/~/ Set BLEMASK = 123456
	919	+
	920	+ (% style="color:#037691" %)**AT+BLEMASK=0**  (%%) ~/~/ disable BLEMASK
	921	+
	922	+(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1）**
	923	+
	924	+Example: 0xB2010203040506    ~/~/ Set BLEMASK to 123456
	925	+
	926	+
	927	+=== 3.2.12  Set WiFIMASK to filter WiFi SSID（Since firmware 1.4.1） ===
	928	+
	929	+
	930	+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 as prefix. It will ignore all other WiFi which doesn’t contact 123456 in the SSID.
	931	+
	932	+(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.**
	933	+
	934	+(% style="color:blue" %)**AT Command:**
	935	+
	936	+ (% style="color:#037691" %)**AT+WiFiMASK=123456**    (%%) ~/~/ Set WiFiMASK = 123456
	937	+
	938	+ (% style="color:#037691" %)**AT+WiFiMASK=0**       (%%) ~/~/ disable WiFiMASK
	939	+
	940	+(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1）**
	941	+
	942	+Example: 0xB3010203040506    ~/~/ Set WiFiMASK to 123456
	943	+
	944	+
	945	+=== 3.2.13 Disable/Enable Information printing（Since firmware 1.4.1） ===
	946	+
	947	+
	948	+Users can use this feature to enable/disable Information printing.
	949	+
	950	+(% style="color:blue" %)**AT Command:**
	951	+
	952	+(% style="color:#037691" %)**AT+SHOWID=XX         **(%%) ~/~/(Disable (0), Enable (1), default:0)
	953	+\\Example: AT+SHOWID=1 ~-~-> Enable Information printing.
	954	+
	955	+
	956	+=== 3.2.14 Get or Set Eight Channels Mode, only for us915, AU915（Since firmware 1.4.1） ===
	957	+
	958	+
	959	+The Channels Mode in the LORAWAN LMIC library is from 0 ~~ 7. When CHE = 8, 72 channels will be accessible to the network.
	960	+
	961	+(% style="color:blue" %)**AT Command:**
	962	+
	963	+(% style="color:#037691" %)**AT+CHE=1**(%%) ~/~/ set one channels mode
	964	+
	965	+
	966	+(% style="color:blue" %)**Downlink Payload:0X24**
	967	+
	968	+Example: 0x24 01 ~/~/ Same as AT+CHE=1
	969	+
	970	+
822	822	= 4. Setting for Different Scenarios =
823	823
824	824
...	...	@@ -825,7 +825,6 @@
825	825
826	826	= 5. Upload Firmware =
827	827
828		-
829	829	== 5.1 Firmware Change Log ==
830	830
831	831
...	...	@@ -832,7 +832,6 @@
832	832	**[[See this link>>url:https://github.com/dragino/TrackerD]]**
833	833
834	834
835		-
836	836	== 5.2 How to upgrade firmware ==
837	837
838	838
...	...	@@ -859,34 +859,33 @@
859	859	[[image:1664503574618-659.png]]
860	860
861	861
	1009	+
862	862	(% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
863	863
864	864	[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
865	865
866	866
867		-Users need to use below files:
	1015	+**Users need to use below files:**
868	868
869	869	boot_app0.bin @0e000
870	870
871		-ESP_LORA-eeprom-class.bin @ 0x10000
	1019	+US915.bin @ 0x10000(Select the bin file of the frequency band you need)
872	872
873	873
874		-[[image:1664503593459-435.png]]
	1022	+[[image:image-20221118105220-2.png]]
875	875
876	876
877	877
878	878	After upgrade finish, it will show finish as below:
879	879
880		-[[image:1664503611848-385.png]]
	1028	+[[image:image-20221118105402-4.png]]
881	881
882	882
883	883
884	884	= 6. Developer Guide =
885	885
886		-
887	887	== 6.1 Compile Source Code ==
888	888
889		-
890	890	=== 6.1.1 Set up ARDUINO compile environment ===
891	891
892	892
...	...	@@ -904,7 +904,18 @@
904	904	[[image:1664503715811-892.png]]
905	905
906	906
	1053	+(% 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.
907	907
	1055	+[[image:image-20221024105643-1.png]]
	1056	+
	1057	+**~ Figure1**
	1058	+
	1059	+
	1060	+[[image:image-20221024105643-2.png]]
	1061	+
	1062	+ **Figure2**
	1063	+
	1064	+
908	908	* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
909	909
910	910	Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
...	...	@@ -913,7 +913,6 @@
913	913	[[image:1664503752288-974.png]]
914	914
915	915
916		-
917	917	== 6.2 Source Code ==
918	918
919	919
...	...	@@ -934,10 +934,8 @@
934	934	[[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
935	935
936	936
937		-
938	938	= 7.  FAQ =
939	939
940		-
941	941	== 7.1 How to change the LoRa Frequency Bands/Region? ==
942	942
943	943
...	...	@@ -944,7 +944,6 @@
944	944	User can follow the introduction for [[how to upgrade image>>||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.
945	945
946	946
947		-
948	948	== 7.2 What is the pin mapping for the USB program cable? ==
949	949
950	950
...	...	@@ -963,45 +963,246 @@
963	963	|(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
964	964	|(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
965	965
966		-= 8.  Order Info =
967	967
	1120	+== 7.3 Notes on using different serial port tools for TrackerD ==
968	968
	1122	+=== 7.3.1  Serial port utility ===
	1123	+
	1124	+
	1125	+Serial port utility requires you to automatically add data streams.
	1126	+
	1127	+Need to adjust the data stream to RTS/CTS on physical restart.
	1128	+
	1129	+(% class="wikigeneratedid" %)
	1130	+[[image:image-20221102140621-1.png]]
	1131	+
	1132	+
	1133	+
	1134	+When using AT commands, the data flow needs to be adjusted to XON/XOFF
	1135	+
	1136	+[[image:image-20221102140638-2.png]]
	1137	+
	1138	+
	1139	+=== 7.3.2  SecureCRT ===
	1140	+
	1141	+
	1142	+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.
	1143	+
	1144	+
	1145	+[[image:image-20221102140704-3.png]]
	1146	+
	1147	+
	1148	+[[image:image-20221102140712-4.png]]
	1149	+
	1150	+
	1151	+=== 7.3.3  PUTTY ===
	1152	+
	1153	+
	1154	+[[image:image-20221102140748-5.png]]
	1155	+
	1156	+
	1157	+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.
	1158	+
	1159	+
	1160	+[[image:image-20221102140801-6.png]]
	1161	+
	1162	+
	1163	+== 7.4 How to modify source code to compile different frequency band bin file? ==
	1164	+
	1165	+
	1166	+(% class="box infomessage" %)
	1167	+(((
	1168	+(% style="color:red" %)**Important**(%%): Developer **MUST** follow the Arduino Environment Instruction exactly include change the SPI pin mappings.
	1169	+See : [[**Set Up Arduino Compile Environment for TrackerD**. >>||anchor="H6.1.1SetupARDUINOcompileenvironment"]]
	1170	+)))
	1171	+
	1172	+**~1. When compiling the frequency band, you need to find LMIC_PROJECT_CONFIG.H file.**
	1173	+
	1174	+
	1175	+[[image:image-20221116111844-1.png||height="227" width="782"]]
	1176	+
	1177	+
	1178	+
	1179	+**2. Open LMIC_PROJECT_CONFIG.H, find the corresponding macro definition and open it(AS923_2,AS923_3,AS923_4 except).**
	1180	+
	1181	+
	1182	+[[image:image-20221116111844-2.png||height="262" width="781"]]
	1183	+
	1184	+
	1185	+
	1186	+**3. Compile the AS923_JP band, please refer to the intention shown**
	1187	+
	1188	+
	1189	+[[image:image-20221116111844-3.png||height="338" width="746"]]
	1190	+
	1191	+
	1192	+
	1193	+**4. In other frequency bands in AS923, you need to find Lorabase_as923.H, path arduino-lmic \ src \ lmic, as shown in the figure below.**
	1194	+
	1195	+
	1196	+[[image:image-20221116111844-4.png||height="641" width="739"]]
	1197	+
	1198	+
	1199	+[[image:image-20221116111844-5.png||height="551" width="708"]]
	1200	+
	1201	+
	1202	+= 8  Trouble Shooting =
	1203	+
	1204	+== 8.1  TDC is changed to 4294947296 and cause no uplink. ==
	1205	+
	1206	+
	1207	+(((
	1208	+Before firmware v1.4.0: When the Transport Mode is enabled (**AT+INTWK=1**), the **TDC** needs to be greater than **MTDC**, otherwise, TDC setting will because 4294947296 after wakre up from motion. This bug is fixed in firmware v1.4.1
	1209	+)))
	1210	+
	1211	+
	1212	+== 8.2  Device not able get AT Command or show output after wake up from deep sleep mode ==
	1213	+
	1214	+
	1215	+(((
	1216	+ESP32 is not able to accept the Interrupt from UART after wake up from deep sleep mode. User need to press the button (one click) and trackerD will be able to accept UART command, it there is no action in UART for 15 seconds. it will go to deep sleep mode.
	1217	+)))
	1218	+
	1219	+
	1220	+== 8.3  Problem after Upgrading Firmware ==
	1221	+
	1222	+=== 8.3.1 Continue Restart after upgrading ===
	1223	+
	1224	+
	1225	+(((
	1226	+If it is V1.4.0 and the previous version, new partitions need to be loaded when upgrading. The new version of the software is stored in the partition package. The upgrade method is shown in the figure
	1227	+)))
	1228	+
	1229	+
	1230	+[[image:image-20221118105249-3.png]]
	1231	+
	1232	+
	1233	+=== 8.3.2 TrackerD's led light is always GREEN on after upgrading ===
	1234	+
	1235	+
	1236	+It is because the partitions are different when upgrading versions above 1.4.1, and a new partition file needs to be added. Please refer to the operation steps in chapter 8.3.1
	1237	+
	1238	+
	1239	+=== 8.3.3 "flash read err" after upgrade firmware ===
	1240	+
	1241	+Error shows below, user might erase the entire flash include u-boot partition which cause this issue.
	1242	+
	1243	+[[image:image-20221122100004-1.png||height="497" width="534"]]
	1244	+
	1245	+
	1246	+User need to upgrade again with below four files to solve this issue.
	1247	+
	1248	+ [[image:image-20221122100004-2.png||height="619" width="389"]]
	1249	+
	1250	+ **Figure 2**
	1251	+
	1252	+
	1253	+=== 8.3.3 "Device Key become ff ff ff ff ff ff ff ff " after upgrade firmware ===
	1254	+
	1255	+User might erase the entire flash include keys and default settings which cause this issue.
	1256	+
	1257	+After the upgrade is completed, enter AT+CFG as shown in the figure below.
	1258	+
	1259	+[[image:image-20221122100004-3.png]]
	1260	+
	1261	+Please **AT+FDR** which will reset all settings to factory settings. , and then input the following keys by the information on the label.
	1262	+
	1263	+
	1264	+Example:
	1265	+
	1266	+AT+DEUI=70B3D57ED0053981
	1267	+
	1268	+AT+APPEUI=D23345667BCBCCAF
	1269	+
	1270	+AT+APPKEY=F402A1A7A350445A7CD2DEA95511BFA1
	1271	+
	1272	+AT+DADDR=260b4dce    ( no need for OTAA)
	1273	+
	1274	+AT+NWKSKEY=71cb7672441f573a53d4f34d307fc61d  ( no need for OTAA)
	1275	+
	1276	+AT+APPSKEY=dacce2299ecd97a73ee3f80b5a46a559   ( no need for OTAA)
	1277	+
	1278	+
	1279	+
	1280	+==== 8.3.4  If there is a situation in Figure 1, and a new partition file needs to be added. Please refer to the operation steps in chapter 8.3.1 ====
	1281	+
	1282	+
	1283	+[[image:image-20221122100004-4.png]]
	1284	+
	1285	+
	1286	+== 8.4  When positioning, it will restart or the PDOP setting is unsuccessful ==
	1287	+
	1288	+
	1289	+Please download version 1.4.2 again
	1290	+
	1291	+
	1292	+== 8.5  How to deal with unsuccessful GPS positioning? ==
	1293	+
	1294	+
	1295	+1） Make Sure the device is in Open Area where can see the sky.
	1296	+
	1297	+2)  Set PDOP to a higher value.
	1298	+
	1299	+* (% style="color:blue" %)**AT+PDOP=2 **(%%)(can be positioned precisely.）
	1300	+
	1301	+* (% style="color:blue" %)**AT+PDOP=7 **(%%)(Quickly locate in open spaces）
	1302	+
	1303	+* (% style="color:blue" %)**AT+PDOP=14.7** (%%)(Positioning can be acquired in complex environments）
	1304	+
	1305	+Please refer to this [[link>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/TrackerD/#H3.2.9SetPDOPvalueforGPSfixaccuracy]] on how to set up PDOP
	1306	+
	1307	+
	1308	+= 9.  Order Info =
	1309	+
	1310	+
969	969	Part Number: (% style="color:blue" %)**TrackerD-XXX**
970	970
971	971	(% style="color:blue" %)**XXX**(%%): The default frequency band
972	972
973	973	* (% style="color:red" %)**EU433**(%%): Default frequency band EU433
	1316	+
974	974	* (% style="color:red" %)**EU868**(%%): Default frequency band EU868
	1318	+
975	975	* (% style="color:red" %)**IN865**(%%): Default frequency band IN865
	1320	+
976	976	* (% style="color:red" %)**KR920**(%%): Default frequency band KR920
	1322	+
977	977	* (% style="color:red" %)**AS923**(%%): Default frequency band AS923
	1324	+
978	978	* (% style="color:red" %)**AU915**(%%): Default frequency band AU915
	1326	+
979	979	* (% style="color:red" %)**US915**(%%): Default frequency band US915
980	980
981		-= 9.  Packing Info =
982	982
	1330	+= 10.  Packing Info =
983	983
	1332	+
984	984	(% style="color:#037691" %)**Package Includes**:
985	985
986	986	* TrackerD LoRaWAN GPS/BLE Tracker x 1
	1336	+
987	987	* USB recharge & program cable x 1
988	988
989	989	(% style="color:#037691" %)**Dimensions and Weight**:
990	990
991		-* Device Size: 85 x 48 x 15 cm
	1341	+* Device Size: 85 x 48 x 15 mm
	1342	+
992	992	* Weight: 50g
993	993
994		-= 10. Support =
995	995
	1346	+= 11. Support =
996	996
	1348	+
997	997	* 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.
	1350	+
998	998	* 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]].
999	999
1000		-= 11.  Reference =
1001	1001
	1354	+= 12.  Reference =
1002	1002
	1356	+
1003	1003	* [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
	1358	+
1004	1004	* **[[Source Code>>https://github.com/dragino/TrackerD]] **
1005		-* [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
1006	1006
1007		-
	1361	+* [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]

1667288597595-714.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+27.9 KB

Content

image-20221024105643-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+11.3 KB

Content

image-20221024105643-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+64.5 KB

Content

image-20221102140621-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+46.1 KB

Content

image-20221102140638-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+40.8 KB

Content

image-20221102140704-3.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+15.5 KB

Content

image-20221102140712-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+73.2 KB

Content

image-20221102140748-5.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+56.0 KB

Content

image-20221102140801-6.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Kilight

Size

...	...	@@ -1,0 +1,1 @@
	1	+21.0 KB

Content

image-20221107145243-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+107.3 KB

Content

image-20221116111844-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+15.8 KB

Content

image-20221116111844-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+32.6 KB

Content

image-20221116111844-3.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+37.0 KB

Content

image-20221116111844-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+96.8 KB

Content

image-20221116111844-5.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+78.0 KB

Content

image-20221118104359-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+38.0 KB

Content

image-20221118105220-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+40.2 KB

Content

image-20221118105249-3.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+40.2 KB

Content

image-20221118105402-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+43.7 KB

Content

image-20221122100004-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+18.0 KB

Content

image-20221122100004-2.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+127.2 KB

Content

image-20221122100004-3.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+12.5 KB

Content

image-20221122100004-4.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Bei

Size

...	...	@@ -1,0 +1,1 @@
	1	+22.3 KB

Content