Skip to Content
Last modified by Bei Jinggeng on 2025/08/01 17:45
From version 71.1
edited by Edwin Chen
on 2022/10/09 23:47
Change comment: There is no comment for this version
To version 143.2
edited by Xiaoling
on 2022/11/22 10:54
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
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  
... ... @@ -98,6 +98,7 @@
98 98  * Tracking: max: 38mA
99 99  
100 100  
99 +
101 101  == 1.3  Features ==
102 102  
103 103  
... ... @@ -117,6 +117,7 @@
117 117  * Datalog
118 118  
119 119  
119 +
120 120  == 1.4  Applications ==
121 121  
122 122  
... ... @@ -124,8 +124,8 @@
124 124  * Human tracking
125 125  
126 126  
127 -= 2.1 Use TrackerD =
128 128  
128 += 2.  Use TrackerD =
129 129  
130 130  == 2.1 How it works? ==
131 131  
... ... @@ -133,7 +133,6 @@
133 133  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.
134 134  
135 135  
136 -
137 137  == 2.2 Quick guide to connect to LoRaWAN server ==
138 138  
139 139  
... ... @@ -175,54 +175,56 @@
175 175  **__Add APP KEY and DEV EUI:__**
176 176  
177 177  
178 -[[image:1664501784668-703.png]]
177 +[[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"]]
179 179  
180 180  
181 181  
181 +(% style="color:blue" %)**Step 2**:(%%) Push this button will activate this device.
182 182  
183 -(% style="color:blue" %)**Step 2**:(%%) Power on TrackerD by using the on board switch.
183 +(% id="cke_bm_7709S" style="display:none" %) [[image:1664502835802-546.png]]
184 184  
185 +[[image:1664502835802-546.png]]
185 185  
187 +
186 186  (% 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.
187 187  
188 188  
189 -
190 190  == 2.3  Positioning Mode(SMOD) ==
191 191  
192 192  
193 193  Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported.
194 194  
195 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
196 -* (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
197 -* (% 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.
196 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
197 +* (% 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.
198 +* (% 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.
198 198  
199 199  Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
200 200  
201 201  
202 -
203 203  == 2.4  Uplink Payload ==
204 204  
205 -
206 206  === 2.4.1 Uplink FPORT~=5, Device Status ===
207 207  
208 208  
209 -Uplink the device configures with FPORT=5. Once LGT92 Joined the network, it will uplink this message to the server. After first uplink, LHT52 will uplink Device Status every 12 hours.
208 +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.
210 210  
210 +Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
211 211  
212 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
213 -|=(% 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
212 +
213 +(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %)
214 +|=(% 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
214 214  |=(% 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
215 215  
216 216  [[image:1665301570342-765.png]]
217 217  
218 218  
219 -Example Payload (FPort=5):  [[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"]]
220 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
220 220  
221 -**Sensor Model**: For TrackerD, this value is 0x13.
222 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
222 222  
223 -**Firmware Version**: 0x0100, Means: v1.0.0 version.
224 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
224 224  
225 -**Frequency Band**:
226 +(% style="color:#037691" %)**Frequency Band**:
226 226  
227 227  *0x01: EU868
228 228  
... ... @@ -244,28 +244,65 @@
244 244  
245 245  *0x0a: AS923-3
246 246  
247 -**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
248 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
248 248  
249 -**BAT**: shows the battery voltage for TrackerD.
250 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
250 250  
251 -Ex1: 0x0B3A = 2874mV
252 252  
253 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
254 +
253 253  Use can also get the Device Status uplink through the downlink command:
254 254  
255 255  
258 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
256 256  
260 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %)
261 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit
262 +|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings
263 +
264 +(% style="color:blue" %)** SMOD：**
265 +
266 +(% style="color:red" %)** 1 :** (%%) GPS ONLY
267 +
268 +(% style="color:red" %)** 2 :** (%%) BLE ONLY
269 +
270 +(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
271 +
272 +
273 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
274 +
275 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
276 +
277 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
278 +
279 +
280 +(% style="color:blue" %)** BLE_Settings:**
281 +
282 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
283 +
284 +(% style="color:red" %)** 2：**  (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%)  
285 +
286 +
287 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
288 +
289 +(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %)
290 +|=(% 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
291 +|=(% 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"]]
292 +
293 +
294 +
257 257  === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
258 258  
259 259  
260 -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.
298 +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,
261 261  
262 262  
263 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
264 -|=(% scope="row" style="width: 50px;" %)(((
301 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %)
302 +|=(% scope="row" style="width: 60px;" %)(((
265 265  **Size(bytes)**
266 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
304 +)))|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)(((
267 267  2
268 -)))|(% style="width:87px" %)(((
306 +)))|(% style="width:30px" %)(((
269 269  2
270 270  )))
271 271  |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
... ... @@ -281,14 +281,12 @@
281 281  |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
282 282  |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
283 283  
284 -==== ====
285 285  
286 -==== ====
287 287  
288 288  ==== (% style="color:blue" %)**FLAG:**(%%) ====
289 289  
290 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
291 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
326 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %)
327 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit
292 292  |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
293 293  
294 294  **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
... ... @@ -299,7 +299,6 @@
299 299  * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
300 300  * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
301 301  
302 -
303 303  (% style="color:red" %)**Important note:**
304 304  
305 305  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.
... ... @@ -318,13 +318,12 @@
318 318  
319 319  ==== (% style="color:blue" %)**Alarm:**(%%) ====
320 320  
321 -Example:  0x4B & 0x40 >> 6 = 0x01
356 +**Example: ** 0x4B & 0x40 >> 6 = 0x01
322 322  
323 323  
324 -
325 325  ==== (% style="color:blue" %)**BAT:**(%%) ====
326 326  
327 -Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
361 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
328 328  
329 329  (((
330 330  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -337,16 +337,34 @@
337 337  * < 3.39v:  0~~20%
338 338  
339 339  
374 +
375 +==== (% style="color:blue" %)**MOD:**(%%) ====
376 +
377 +**Example: ** (0x60>>6) & 0x3f =1
378 +
379 +**Set the format of GPS data uplink link：**
380 +
381 +(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
382 +(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
383 +
384 +
385 +**Set the format of BLE data uplink link：**
386 +
387 +(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
388 +
389 +
340 340  ==== (% style="color:blue" %)**LON:**(%%) ====
341 341  
392 +**Example:** (0x60>>5) & 0x01=1.
393 +
342 342  Enable/Disable LED activity for uplink
343 343  
344 344  (((
345 -0x00:  Disable LED indicator.
397 +(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
346 346  )))
347 347  
348 348  (((
349 -0x01:  Enable LED indicator (Default Value)
401 +(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
350 350  )))
351 351  
352 352  
... ... @@ -360,17 +360,16 @@
360 360  011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
361 361  
362 362  
363 -
364 364  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
365 365  
366 366  
367 -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)
418 +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)
368 368  
369 369  
370 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
371 -|=(% scope="row" style="width: 50px;" %)(((
421 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %)
422 +|=(% scope="row" style="width: 60px;" %)(((
372 372  **Size(bytes)**
373 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
424 +)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1
374 374  |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
375 375  [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
376 376  )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
... ... @@ -379,21 +379,21 @@
379 379  [[image:1665301687277-443.png]]
380 380  
381 381  
382 -
383 383  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
384 384  
385 385  
386 -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.
436 +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.
387 387  
388 388  
389 389  (% style="color:red" %)**Note for this mode:**
390 390  
391 391  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
392 -* 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.
442 +* 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.
443 +* 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
393 393  
394 394  The payload is 15 bytes, as below.
395 395  
396 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
447 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
397 397  |=(% scope="row" %)(((
398 398  **Size(bytes)**
399 399  )))|4|4|2|1|1|1|1|1
... ... @@ -402,10 +402,14 @@
402 402  [[image:image-20221009160309-2.png]]
403 403  
404 404  
405 -
406 406  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
407 407  
408 408  
459 +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.
460 +
461 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
462 +
463 +
409 409  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
410 410  |=(% scope="row" style="width: 60px;" %)(((
411 411  **Size(bytes)**
... ... @@ -425,21 +425,45 @@
425 425  [[image:1664502425687-834.png]]
426 426  
427 427  
428 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
483 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
429 429  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
430 430  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
431 431  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
432 -* (% style="color:#037691" %)**MINOR:**  (%%)The MAJOR from the strongest iBeacon.
487 +* (% style="color:#037691" %)**MINOR:**  (%%)The MINOR from the strongest iBeacon.
433 433  * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
434 434  * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
435 435  
436 436  
437 437  
438 -=== 2.4.6  Add Payload format in TTN V3 ===
493 +=== 2.4.6  Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID（Since firmware 1.4.1） ===
439 439  
440 440  
441 -In TTN V3, use can add a custom payload so it shows friendly.
496 +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.
442 442  
498 +
499 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %)
500 +|=(% scope="row" style="width: 60px;" %)(((
501 +**Size(bytes)**
502 +)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1
503 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)(((
504 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
505 +)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]]
506 +
507 +(% class="wikigeneratedid" %)
508 +[[image:1667288597595-714.png||height="212" width="1151"]]
509 +
510 +
511 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
512 +* (% style="color:#037691" %)**SSID:      **(%%)WiFi name.
513 +* (% style="color:#037691" %)**RSSI:      **(%%)The RSSI from the strongest WiFi.
514 +
515 +
516 +
517 +=== 2.4.7  Add Payload format in TTN V3 ===
518 +
519 +
520 +In TTN V3, user can add a custom payload so it shows friendly.
521 +
443 443  In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
444 444  
445 445  
... ... @@ -446,62 +446,53 @@
446 446  [[image:1664502649601-895.png]]
447 447  
448 448  
449 -Add the decoder from this link:
450 450  
529 +Add the decoder from this link: 
451 451  
531 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
532 +
452 452  Save the change the uplink message will be parsed. As below:
453 453  
454 454  [[image:1664502676891-606.png]]
455 455  
456 456  
457 -
458 458  == 2.5 Integrate with Datacake ==
459 459  
460 460  
461 -(((
462 462  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.
463 -)))
464 464  
465 -(((
466 466  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]]
467 -)))
468 468  
469 469  
470 470  [[image:1664502695771-538.png]]
471 471  
472 472  
473 -
474 474  == 2.6 Integrate with Tago ==
475 475  
476 476  
477 -(((
478 -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.
479 -)))
552 +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.
480 480  
481 -(((
482 482  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]]
483 -)))
484 484  
485 485  
486 486  [[image:1664502715371-321.png]]
487 487  
488 488  
489 -
490 490  == 2.7  Datalog Feature ==
491 491  
492 492  
493 -total 273 entries,by default disable
563 +total 273 entries,by default,
494 494  
565 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
495 495  
496 496  Example use case.
497 497  
498 -[[image:image-20221009234703-2.png]]
569 +[[image:image-20221009234703-2.png||height="328" width="899"]]
499 499  
500 500  
501 -[[image:image-20221009234629-1.png||height="441" width="652"]]
572 +[[image:image-20221009234629-1.png||height="390" width="577"]]
502 502  
503 503  
504 -
505 505  == 2.8 Alarm Mode ==
506 506  
507 507  
... ... @@ -511,15 +511,15 @@
511 511  
512 512  
513 513  (((
514 -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.
584 +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.
515 515  )))
516 516  
517 517  
518 518  (((
519 -Two ways to exit alarm mode:
589 +**Two ways to exit alarm mode:**
520 520  )))
521 521  
522 -* Server send a downlink command to exit.
592 +* Server sends a downlink command to exit.
523 523  * User fast press the RED button 10 times.
524 524  
525 525  (((
... ... @@ -527,7 +527,6 @@
527 527  )))
528 528  
529 529  
530 -
531 531  == 2.9 Transport Mode ==
532 532  
533 533  
... ... @@ -534,17 +534,16 @@
534 534  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.
535 535  
536 536  
537 -
538 538  == 2.10 LED Status ==
539 539  
540 540  
541 -(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
609 +(% border="1.5" style="background-color:#ffffcc; width:500px" %)
542 542  |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
543 543  |(% 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
544 544  |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
545 545  |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
546 546  |(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes
547 -|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes
615 +|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
548 548  |(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes
549 549  |(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes
550 550  |(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes
... ... @@ -569,9 +569,9 @@
569 569  [[image:1664502854406-763.png]]
570 570  
571 571  
572 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
573 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
574 -|(% 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"]]
640 +(% border="1" style="background-color:#ffffcc; width:510px" %)
641 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description**
642 +|(% 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"]]
575 575  |(% 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
576 576  |(% 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.
577 577  
... ... @@ -597,7 +597,6 @@
597 597  LoRaWAN Downlink instruction for different platforms:  [[IoT LoRaWAN Server>>doc:Main.WebHome]]
598 598  
599 599  
600 -
601 601  == 3.1 Access AT Command ==
602 602  
603 603  
... ... @@ -613,11 +613,9 @@
613 613  [[image:1664503022490-662.png]]
614 614  
615 615  
616 -
617 617  [[image:1664503035713-500.png]]
618 618  
619 619  
620 -
621 621  [[image:1664503047675-651.png]]
622 622  
623 623  
... ... @@ -624,7 +624,6 @@
624 624  
625 625  == 3.2 Command Set ==
626 626  
627 -
628 628  === 3.2.1 Set Transmit Interval ===
629 629  
630 630  
... ... @@ -642,7 +642,6 @@
642 642  (% style="color:#037691" %)**0x01 00 01 2C**  (%%) ~/~/  Same as AT+TDC=300000
643 643  
644 644  
645 -
646 646  === 3.2.2 Set Alarm Packet transmission interval ===
647 647  
648 648  
... ... @@ -660,7 +660,6 @@
660 660  (% style="color:#037691" %)**0xB1 00 00 3C ** (%%) ~/~/  Same as AT+ATDC=60000
661 661  
662 662  
663 -
664 664  === 3.2.3 Set Transport Mode Packet transmission interval ===
665 665  
666 666  
... ... @@ -675,10 +675,9 @@
675 675  
676 676  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
677 677  
678 -(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+ MTDC=3000000
740 +(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+MTDC=3000000
679 679  
680 680  
681 -
682 682  === 3.2.4 Exit Alarm ===
683 683  
684 684  
... ... @@ -691,7 +691,6 @@
691 691  (% style="color:#037691" %)**0x02 01**    (%%) ~/~/  Exit Alarm Mode
692 692  
693 693  
694 -
695 695  === 3.2.5 Disable/Enable LED flash ===
696 696  
697 697  
... ... @@ -709,7 +709,6 @@
709 709  (% style="color:#037691" %)**0xAE 00 ** (%%) ~/~/  Same as AT+LON=0
710 710  
711 711  
712 -
713 713  === 3.2.6 Disable/Enable Transport Mode ===
714 714  
715 715  
... ... @@ -719,57 +719,60 @@
719 719  
720 720  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
721 721  
722 -Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
781 +Example:  AT+INTWK=1  **~-~->   ** Enable Transport Mode.
723 723  
724 724  
725 725  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
726 726  
727 -(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+ INTWK =1
786 +(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+INTWK=1
728 728  
729 729  
730 -
731 731  === 3.2.7 Set Positioning Mode ===
732 732  
733 733  
734 -SMOD define the how TrackerD scan and uplink data:
792 +SMOD define how TrackerD scan and uplink data:
735 735  
736 736  
737 737  * (% style="color:blue" %)**AT Command:**
738 738  
739 -(% style="color:#037691" %)**AT+SMOD=aa,bb**
797 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
740 740  
741 741  (% style="color:#037691" %)** aa:**
742 742  
743 -* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
744 -* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
745 -* (% 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
801 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
746 746  
803 +* (% 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.
804 +
805 +* (% 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.
806 +
747 747  (% style="color:#037691" %)**bb:**
748 748  
749 -(% style="color:#037691" %)** if aa = 1: **
809 +* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
750 750  
751 -* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
752 -* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
811 +* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
753 753  
754 -(% style="color:#037691" %)** if aa = 2: **
813 +(% style="color:#037691" %)**cc:   **
755 755  
756 -* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
815 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
816 +
817 +* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%))  
757 757  
758 - **Example:**
819 +(% style="color:blue" %)**Example:**
759 759  
760 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
821 + AT+SMOD=1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
761 761  
762 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
823 + AT+SMOD=1,1,0 ~-~->  GPS +BAT State
763 763  
764 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
825 + AT+SMOD=2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
765 765  
827 + AT+SMOD=2,0,2 ~-~->  (WiFi)SSID+Rssi+BAT+State
766 766  
829 +
767 767  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
768 768  
769 -(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
832 +(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+SMOD=1,0,0
770 770  
771 771  
772 -
773 773  === 3.2.8 Set MAX GPS position time ===
774 774  
775 775  
... ... @@ -776,7 +776,7 @@
776 776  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.
777 777  
778 778  
779 -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.
841 +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.
780 780  
781 781  
782 782  * (% style="color:blue" %)**AT Command:**
... ... @@ -783,7 +783,7 @@
783 783  
784 784  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
785 785  
786 -Example:  AT+FTIME=150
848 +**Example:**  AT+FTIME=150
787 787  
788 788  
789 789  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -791,7 +791,6 @@
791 791  (% style="color:#037691" %)**0xAA 00 96 ** (%%) ~/~/  Set AT+FTIME=150
792 792  
793 793  
794 -
795 795  === 3.2.9 Set PDOP value for GPS fix accuracy ===
796 796  
797 797  
... ... @@ -816,26 +816,108 @@
816 816  
817 817  
818 818  
819 -Disable/Enable the confirmation mode
880 +**Disable/Enable the confirmation mode**
820 820  
821 821  * (% style="color:blue" %)**AT Command:**
822 822  
823 -(% style="color:#037691" %)**AT+CFM=xx. **
884 +(% style="color:#037691" %)**AT+CFM=xx**
824 824  
825 825  
826 826  **~ Example:**
827 827  
828 - AT+ CFM=0    **~-~->   ** Disable confirmation
889 + AT+CFM=0    **~-~->   ** Disable confirmation
829 829  
830 - AT+ CFM=1    **~-~->  ** Enable confirmation
891 + AT+CFM=1    **~-~->  ** Enable confirmation
831 831  
832 832  
833 833  * (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
834 834  
835 -(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+ SMOD =1
896 +(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+CFM=1
836 836  
837 837  
899 +=== 3.2.10  Auto Send None-ACK messages ===
838 838  
901 +
902 +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.
903 +
904 +
905 +* (% style="color:blue" %)**AT Command: AT+PNACKMD**
906 +
907 +The default factory setting is 0.
908 +
909 +
910 +**Command Example Function Response:**
911 +
912 +(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
913 +
914 +
915 +* (% style="color:blue" %)**Downlink Command: 0x34**
916 +
917 +Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
918 +
919 +
920 +=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
921 +
922 +
923 +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.
924 +
925 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.**
926 +
927 +(% style="color:blue" %)**AT Command:**
928 +
929 + (% style="color:#037691" %)**AT+BLEMASK=123456**   (%%) ~/~/ Set BLEMASK = 123456
930 +
931 + (% style="color:#037691" %)**AT+BLEMASK=0**  (%%) ~/~/ disable BLEMASK
932 +
933 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1）**
934 +
935 +Example: 0xB2010203040506    ~/~/ Set BLEMASK to 123456
936 +
937 +
938 +=== 3.2.12  Set WiFIMASK to filter WiFi SSID（Since firmware 1.4.1） ===
939 +
940 +
941 +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.
942 +
943 +(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.**
944 +
945 +(% style="color:blue" %)**AT Command:**
946 +
947 + (% style="color:#037691" %)**AT+WiFiMASK=123456**    (%%) ~/~/ Set WiFiMASK = 123456
948 +
949 + (% style="color:#037691" %)**AT+WiFiMASK=0**       (%%) ~/~/ disable WiFiMASK
950 +
951 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1）**
952 +
953 +Example: 0xB3010203040506    ~/~/ Set WiFiMASK to 123456
954 +
955 +
956 +=== 3.2.13 Disable/Enable Information printing（Since firmware 1.4.1） ===
957 +
958 +
959 +Users can use this feature to enable/disable Information printing.
960 +
961 +(% style="color:blue" %)**AT Command:**
962 +
963 +(% style="color:#037691" %)**AT+SHOWID=XX         **(%%) ~/~/(Disable (0), Enable (1), default:0)
964 +\\Example: AT+SHOWID=1 ~-~-> Enable Information printing.
965 +
966 +
967 +=== 3.2.14 Get or Set Eight Channels Mode, only for us915, AU915（Since firmware 1.4.1） ===
968 +
969 +
970 +The Channels Mode in the LORAWAN LMIC library is from 0 ~~ 7. When CHE = 8, 72 channels will be accessible to the network.
971 +
972 +(% style="color:blue" %)**AT Command:**
973 +
974 +(% style="color:#037691" %)**AT+CHE=1**(%%) ~/~/ set one channels mode
975 +
976 +
977 +(% style="color:blue" %)**Downlink Payload:0X24**
978 +
979 +Example: 0x24 01 ~/~/ Same as AT+CHE=1
980 +
981 +
839 839  = 4. Setting for Different Scenarios =
840 840  
841 841  
... ... @@ -842,7 +842,6 @@
842 842  
843 843  = 5. Upload Firmware =
844 844  
845 -
846 846  == 5.1 Firmware Change Log ==
847 847  
848 848  
... ... @@ -849,7 +849,6 @@
849 849  **[[See this link>>url:https://github.com/dragino/TrackerD]]**
850 850  
851 851  
852 -
853 853  == 5.2 How to upgrade firmware ==
854 854  
855 855  
... ... @@ -876,34 +876,33 @@
876 876  [[image:1664503574618-659.png]]
877 877  
878 878  
1020 +
879 879  (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
880 880  
881 -[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1023 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
882 882  
883 883  
884 -Users need to use below files:
1026 +**Users need to use below files:**
885 885  
886 886  boot_app0.bin @0e000
887 887  
888 -ESP_LORA-eeprom-class.bin @ 0x10000
1030 +US915.bin @ 0x10000(Select the bin file of the frequency band you need)
889 889  
890 890  
891 -[[image:1664503593459-435.png]]
1033 +[[image:image-20221118105220-2.png]]
892 892  
893 893  
894 894  
895 895  After upgrade finish, it will show finish as below:
896 896  
897 -[[image:1664503611848-385.png]]
1039 +[[image:image-20221118105402-4.png]]
898 898  
899 899  
900 900  
901 901  = 6. Developer Guide =
902 902  
903 -
904 904  == 6.1 Compile Source Code ==
905 905  
906 -
907 907  === 6.1.1 Set up ARDUINO compile environment ===
908 908  
909 909  
... ... @@ -921,7 +921,18 @@
921 921  [[image:1664503715811-892.png]]
922 922  
923 923  
1064 +(% 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.
924 924  
1066 +[[image:image-20221024105643-1.png]]
1067 +
1068 +**~ Figure1**
1069 +
1070 +
1071 +[[image:image-20221024105643-2.png]]
1072 +
1073 + **Figure2**
1074 +
1075 +
925 925  * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
926 926  
927 927  Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
... ... @@ -930,7 +930,6 @@
930 930  [[image:1664503752288-974.png]]
931 931  
932 932  
933 -
934 934  == 6.2 Source Code ==
935 935  
936 936  
... ... @@ -951,10 +951,8 @@
951 951  [[image:1664503824081-592.png]] [[image:1664503831430-500.png]]
952 952  
953 953  
954 -
955 955  = 7.  FAQ =
956 956  
957 -
958 958  == 7.1 How to change the LoRa Frequency Bands/Region? ==
959 959  
960 960  
... ... @@ -961,7 +961,6 @@
961 961  User can follow the introduction for [[how to upgrade image>>||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.
962 962  
963 963  
964 -
965 965  == 7.2 What is the pin mapping for the USB program cable? ==
966 966  
967 967  
... ... @@ -982,49 +982,243 @@
982 982  
983 983  
984 984  
985 -= 8.  Order Info =
1132 +== 7.3 Notes on using different serial port tools for TrackerD ==
986 986  
1134 +=== 7.3.1  Serial port utility ===
987 987  
1136 +
1137 +Serial port utility requires you to automatically add data streams.
1138 +
1139 +Need to adjust the data stream to RTS/CTS on physical restart.
1140 +
1141 +(% class="wikigeneratedid" %)
1142 +[[image:image-20221102140621-1.png]]
1143 +
1144 +
1145 +
1146 +When using AT commands, the data flow needs to be adjusted to XON/XOFF
1147 +
1148 +[[image:image-20221102140638-2.png]]
1149 +
1150 +
1151 +=== 7.3.2  SecureCRT ===
1152 +
1153 +
1154 +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.
1155 +
1156 +
1157 +[[image:image-20221102140704-3.png]]
1158 +
1159 +
1160 +[[image:image-20221102140712-4.png]]
1161 +
1162 +
1163 +=== 7.3.3  PUTTY ===
1164 +
1165 +
1166 +[[image:image-20221102140748-5.png]]
1167 +
1168 +
1169 +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.
1170 +
1171 +
1172 +[[image:image-20221102140801-6.png]]
1173 +
1174 +
1175 +== 7.4 How to modify source code to compile different frequency band bin file? ==
1176 +
1177 +
1178 +(% class="box infomessage" %)
1179 +(((
1180 +(% style="color:red" %)**Important**(%%): Developer **MUST** follow the Arduino Environment Instruction exactly include change the SPI pin mappings.
1181 +See : [[**Set Up Arduino Compile Environment for TrackerD**. >>||anchor="H6.1.1SetupARDUINOcompileenvironment"]]
1182 +)))
1183 +
1184 +**~1. When compiling the frequency band, you need to find LMIC_PROJECT_CONFIG.H file.**
1185 +
1186 +
1187 +[[image:image-20221116111844-1.png||height="227" width="782"]]
1188 +
1189 +
1190 +
1191 +**2. Open LMIC_PROJECT_CONFIG.H, find the corresponding macro definition and open it(AS923_2,AS923_3,AS923_4 except).**
1192 +
1193 +
1194 +[[image:image-20221116111844-2.png||height="262" width="781"]]
1195 +
1196 +
1197 +
1198 +**3. Compile the AS923_JP band, please refer to the intention shown**
1199 +
1200 +
1201 +[[image:image-20221116111844-3.png||height="338" width="746"]]
1202 +
1203 +
1204 +
1205 +**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.**
1206 +
1207 +
1208 +[[image:image-20221116111844-4.png||height="641" width="739"]]
1209 +
1210 +
1211 +[[image:image-20221116111844-5.png||height="551" width="708"]]
1212 +
1213 +
1214 += 8  Trouble Shooting =
1215 +
1216 +== 8.1  TDC is changed to 4294947296 and cause no uplink. ==
1217 +
1218 +
1219 +(((
1220 +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
1221 +)))
1222 +
1223 +
1224 +== 8.2  Device not able get AT Command or show output after wake up from deep sleep mode ==
1225 +
1226 +
1227 +(((
1228 +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.
1229 +)))
1230 +
1231 +
1232 +== 8.3  Problem after Upgrading Firmware ==
1233 +
1234 +=== 8.3.1 Continue Restart after upgrading ===
1235 +
1236 +
1237 +(((
1238 +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
1239 +)))
1240 +
1241 +
1242 +[[image:image-20221118105249-3.png]]
1243 +
1244 +
1245 +=== 8.3.2 TrackerD's led light is always GREEN on after upgrading ===
1246 +
1247 +
1248 +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
1249 +
1250 +
1251 +
1252 +==== 8.3.2.1 If there is a situation in Figure 1,and a new partition file and bootloader file needs to be added. Please refer to the operation steps in Figure 2 ====
1253 +
1254 +
1255 +[[image:image-20221122100004-1.png||height="497" width="534"]]
1256 +
1257 + ** Figure 1  **
1258 +
1259 +
1260 + [[image:image-20221122100004-2.png||height="619" width="389"]]
1261 +
1262 + **Figure 2**
1263 +
1264 +
1265 +
1266 +After the upgrade is completed, enter AT+CFG as shown in the figure below.
1267 +
1268 +
1269 +[[image:image-20221122100004-3.png]]
1270 +
1271 +Please AT+FDR, and then enter the following instructions by the information on the label
1272 +
1273 +AT+DEUI=70B3D57ED0053981
1274 +
1275 +AT+APPEUI=D23345667BCBCCAF
1276 +
1277 +AT+APPKEY=F402A1A7A350445A7CD2DEA95511BFA1
1278 +
1279 +AT+DADDR=260b4dce
1280 +
1281 +AT+NWKSKEY=71cb7672441f573a53d4f34d307fc61d
1282 +
1283 +AT+APPSKEY=dacce2299ecd97a73ee3f80b5a46a559
1284 +
1285 +
1286 +
1287 +==== 8.3.2.2 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 ====
1288 +
1289 +
1290 +[[image:image-20221122100004-4.png]]
1291 +
1292 +
1293 +== 8.4  When positioning, it will restart or the PDOP setting is unsuccessful ==
1294 +
1295 +
1296 +Please download version 1.4.2 again
1297 +
1298 +
1299 +== 8.5  How to deal with unsuccessful GPS positioning? ==
1300 +
1301 +
1302 +1） Make Sure the device is in Open Area where can see the sky.
1303 +
1304 +2)  Set PDOP to a higher value.
1305 +
1306 +* (% style="color:blue" %)**AT+PDOP=2 **(%%)(can be positioned precisely.）
1307 +
1308 +* (% style="color:blue" %)**AT+PDOP=7 **(%%)(Quickly locate in open spaces）
1309 +
1310 +* (% style="color:blue" %)**AT+PDOP=14.7** (%%)(Positioning can be acquired in complex environments）
1311 +
1312 +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
1313 +
1314 +
1315 += 9.  Order Info =
1316 +
1317 +
988 988  Part Number: (% style="color:blue" %)**TrackerD-XXX**
989 989  
990 990  (% style="color:blue" %)**XXX**(%%): The default frequency band
991 991  
992 992  * (% style="color:red" %)**EU433**(%%): Default frequency band EU433
1323 +
993 993  * (% style="color:red" %)**EU868**(%%): Default frequency band EU868
1325 +
994 994  * (% style="color:red" %)**IN865**(%%): Default frequency band IN865
1327 +
995 995  * (% style="color:red" %)**KR920**(%%): Default frequency band KR920
1329 +
996 996  * (% style="color:red" %)**AS923**(%%): Default frequency band AS923
1331 +
997 997  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
1333 +
998 998  * (% style="color:red" %)**US915**(%%): Default frequency band US915
999 999  
1000 1000  
1001 1001  
1002 -= 9.  Packing Info =
1338 += 10.  Packing Info =
1003 1003  
1004 1004  
1005 1005  (% style="color:#037691" %)**Package Includes**:
1006 1006  
1007 1007  * TrackerD LoRaWAN GPS/BLE Tracker x 1
1344 +
1008 1008  * USB recharge & program cable x 1
1009 1009  
1010 1010  (% style="color:#037691" %)**Dimensions and Weight**:
1011 1011  
1012 -* Device Size: 85 x 48 x 15 cm
1349 +* Device Size: 85 x 48 x 15 mm
1350 +
1013 1013  * Weight: 50g
1014 1014  
1015 1015  
1016 -= 10. Support =
1017 1017  
1355 += 11. Support =
1018 1018  
1357 +
1019 1019  * 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.
1359 +
1020 1020  * 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]].
1021 1021  
1022 1022  
1023 -= 11.  Reference =
1024 1024  
1364 += 12.  Reference =
1025 1025  
1366 +
1026 1026  * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1368 +
1027 1027  * **[[Source Code>>https://github.com/dragino/TrackerD]] **
1028 -* [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
1029 1029  
1030 -
1371 +* [[**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