Skip to Content
Last modified by Bei Jinggeng on 2025/07/23 11:03
From version 72.1
edited by Edwin Chen
on 2022/10/09 23:47
Change comment: There is no comment for this version
To version 113.2
edited by Xiaoling
on 2022/11/09 15:43
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
... ... @@ -97,6 +97,8 @@
97 97  * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
98 98  * Tracking: max: 38mA
99 99  
100 +
101 +
100 100  == 1.3  Features ==
101 101  
102 102  
... ... @@ -115,6 +115,8 @@
115 115  * Tri-color LED, Alarm button
116 116  * Datalog
117 117  
120 +
121 +
118 118  == 1.4  Applications ==
119 119  
120 120  
... ... @@ -121,9 +121,11 @@
121 121  * Logistics and Supply Chain Management
122 122  * Human tracking
123 123  
124 -= 2.1 Use TrackerD =
125 125  
126 126  
130 += 2.  Use TrackerD =
131 +
132 +
127 127  == 2.1 How it works? ==
128 128  
129 129  
... ... @@ -189,9 +189,9 @@
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.
198 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
199 +* (% 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.
200 +* (% 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  
... ... @@ -203,23 +203,25 @@
203 203  === 2.4.1 Uplink FPORT~=5, Device Status ===
204 204  
205 205  
206 -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.
212 +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  
214 +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
216 +
217 +(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %)
218 +|=(% 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 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"]]
224 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
217 217  
218 -**Sensor Model**: For TrackerD, this value is 0x13.
226 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
219 219  
220 -**Firmware Version**: 0x0100, Means: v1.0.0 version.
228 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
221 221  
222 -**Frequency Band**:
230 +(% style="color:#037691" %)**Frequency Band**:
223 223  
224 224  *0x01: EU868
225 225  
... ... @@ -241,28 +241,65 @@
241 241  
242 242  *0x0a: AS923-3
243 243  
244 -**Sub-Band**: value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
252 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
245 245  
246 -**BAT**: shows the battery voltage for TrackerD.
254 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
247 247  
248 -Ex1: 0x0B3A = 2874mV
249 249  
257 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
258 +
250 250  Use can also get the Device Status uplink through the downlink command:
251 251  
252 252  
262 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
253 253  
264 +(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %)
265 +|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit
266 +|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings
267 +
268 +(% style="color:blue" %)** SMOD：**
269 +
270 +(% style="color:red" %)** 1 :** (%%) GPS ONLY
271 +
272 +(% style="color:red" %)** 2 :** (%%) BLE ONLY
273 +
274 +(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
275 +
276 +
277 +(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
278 +
279 +(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
280 +
281 +(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
282 +
283 +
284 +(% style="color:blue" %)** BLE_Settings:**
285 +
286 +(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
287 +
288 +(% style="color:red" %)** 2：**  (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%)  
289 +
290 +
291 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
292 +
293 +(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %)
294 +|=(% 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
295 +|=(% 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"]]
296 +
297 +
298 +
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.
302 +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;" %)(((
305 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %)
306 +|=(% 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" %)(((
308 +)))|(% 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" %)(((
310 +)))|(% 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" %)(((
... ... @@ -278,14 +278,12 @@
278 278  |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
279 279  |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
280 280  
281 -==== ====
282 282  
283 -==== ====
284 284  
285 285  ==== (% style="color:blue" %)**FLAG:**(%%) ====
286 286  
287 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
288 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
330 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %)
331 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:30px" %)2bits|(% style="width:30px" %)1bit
289 289  |=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
290 290  
291 291  **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
... ... @@ -314,13 +314,12 @@
314 314  
315 315  ==== (% style="color:blue" %)**Alarm:**(%%) ====
316 316  
317 -Example:  0x4B & 0x40 >> 6 = 0x01
360 +**Example: ** 0x4B & 0x40 >> 6 = 0x01
318 318  
319 319  
320 -
321 321  ==== (% style="color:blue" %)**BAT:**(%%) ====
322 322  
323 -Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
365 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
324 324  
325 325  (((
326 326  The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
... ... @@ -332,16 +332,35 @@
332 332  * 3.40v ~~ 3.69v:  20% ~~ 40%
333 333  * < 3.39v:  0~~20%
334 334  
377 +
378 +
379 +==== (% style="color:blue" %)**MOD:**(%%) ====
380 +
381 +**Example: ** (0x60>>6) & 0x3f =1
382 +
383 +**Set the format of GPS data uplink link：**
384 +
385 +(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
386 +(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
387 +
388 +
389 +**Set the format of BLE data uplink link：**
390 +
391 +(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
392 +
393 +
335 335  ==== (% style="color:blue" %)**LON:**(%%) ====
336 336  
396 +**Example:** (0x60>>5) & 0x01=1.
397 +
337 337  Enable/Disable LED activity for uplink
338 338  
339 339  (((
340 -0x00:  Disable LED indicator.
401 +(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
341 341  )))
342 342  
343 343  (((
344 -0x01:  Enable LED indicator (Default Value)
405 +(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
345 345  )))
346 346  
347 347  
... ... @@ -359,13 +359,13 @@
359 359  === 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
360 360  
361 361  
362 -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)
423 +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)
363 363  
364 364  
365 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
366 -|=(% scope="row" style="width: 50px;" %)(((
426 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %)
427 +|=(% scope="row" style="width: 60px;" %)(((
367 367  **Size(bytes)**
368 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
429 +)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1
369 369  |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
370 370  [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
371 371  )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
... ... @@ -378,17 +378,18 @@
378 378  === 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
379 379  
380 380  
381 -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.
442 +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.
382 382  
383 383  
384 384  (% style="color:red" %)**Note for this mode:**
385 385  
386 386  * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
387 -* 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.
448 +* 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.
449 +* 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
388 388  
389 389  The payload is 15 bytes, as below.
390 390  
391 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
453 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
392 392  |=(% scope="row" %)(((
393 393  **Size(bytes)**
394 394  )))|4|4|2|1|1|1|1|1
... ... @@ -401,6 +401,11 @@
401 401  === 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
402 402  
403 403  
466 +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.
467 +
468 +User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings.
469 +
470 +
404 404  (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
405 405  |=(% scope="row" style="width: 60px;" %)(((
406 406  **Size(bytes)**
... ... @@ -420,7 +420,7 @@
420 420  [[image:1664502425687-834.png]]
421 421  
422 422  
423 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
490 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
424 424  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
425 425  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
426 426  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -429,11 +429,36 @@
429 429  * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
430 430  
431 431  
432 -=== 2.4.6  Add Payload format in TTN V3 ===
433 433  
500 +=== 2.4.6  Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID（Since firmware 1.4.1） ===
434 434  
435 -In TTN V3, use can add a custom payload so it shows friendly.
436 436  
503 +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.
504 +
505 +
506 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %)
507 +|=(% scope="row" style="width: 60px;" %)(((
508 +**Size(bytes)**
509 +)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1
510 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)(((
511 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
512 +)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]]
513 +
514 +(% class="wikigeneratedid" %)
515 +[[image:1667288597595-714.png||height="212" width="1151"]]
516 +
517 +
518 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
519 +* (% style="color:#037691" %)**SSID:      **(%%)WiFi name.
520 +* (% style="color:#037691" %)**RSSI:      **(%%)The RSSI from the strongest WiFi.
521 +
522 +
523 +
524 +=== 2.4.7  Add Payload format in TTN V3 ===
525 +
526 +
527 +In TTN V3, user can add a custom payload so it shows friendly.
528 +
437 437  In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
438 438  
439 439  
... ... @@ -440,8 +440,9 @@
440 440  [[image:1664502649601-895.png]]
441 441  
442 442  
443 -Add the decoder from this link:
535 +Add the decoder from this link: 
444 444  
537 +[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
445 445  
446 446  Save the change the uplink message will be parsed. As below:
447 447  
... ... @@ -452,15 +452,10 @@
452 452  == 2.5 Integrate with Datacake ==
453 453  
454 454  
455 -(((
456 456  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.
457 -)))
458 458  
459 -(((
460 460  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]]
461 -)))
462 462  
463 -
464 464  [[image:1664502695771-538.png]]
465 465  
466 466  
... ... @@ -468,15 +468,12 @@
468 468  == 2.6 Integrate with Tago ==
469 469  
470 470  
471 -(((
472 -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.
473 -)))
559 +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.
474 474  
475 -(((
476 476  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]]
477 -)))
478 478  
479 479  
564 +
480 480  [[image:1664502715371-321.png]]
481 481  
482 482  
... ... @@ -484,8 +484,9 @@
484 484  == 2.7  Datalog Feature ==
485 485  
486 486  
487 -total 273 entries,by default disable
572 +total 273 entries,by default,
488 488  
574 +User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
489 489  
490 490  Example use case.
491 491  
... ... @@ -505,7 +505,7 @@
505 505  
506 506  
507 507  (((
508 -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.
594 +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.
509 509  )))
510 510  
511 511  
... ... @@ -513,7 +513,7 @@
513 513  Two ways to exit alarm mode:
514 514  )))
515 515  
516 -* Server send a downlink command to exit.
602 +* Server sends a downlink command to exit.
517 517  * User fast press the RED button 10 times.
518 518  
519 519  (((
... ... @@ -547,6 +547,7 @@
547 547  |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
548 548  
549 549  
636 +
550 550  == 2.11 Button Function ==
551 551  
552 552  
... ... @@ -562,13 +562,14 @@
562 562  [[image:1664502854406-763.png]]
563 563  
564 564  
565 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
566 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
652 +(% border="1" style="background-color:#ffffcc; color:green; width:510px" %)
653 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 205px;" %)**Action**|=(% style="width: 205px;" %)**Description**
567 567  |(% 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"]]
568 568  |(% 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
569 569  |(% 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.
570 570  
571 571  
659 +
572 572  == 2.12 USB Port Function ==
573 573  
574 574  
... ... @@ -580,6 +580,7 @@
580 580  * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
581 581  
582 582  
671 +
583 583  = 3. Configure TrackerD via AT command or LoRaWAN downlink =
584 584  
585 585  
... ... @@ -604,11 +604,9 @@
604 604  [[image:1664503022490-662.png]]
605 605  
606 606  
607 -
608 608  [[image:1664503035713-500.png]]
609 609  
610 610  
611 -
612 612  [[image:1664503047675-651.png]]
613 613  
614 614  
... ... @@ -666,7 +666,7 @@
666 666  
667 667  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
668 668  
669 -(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+ MTDC=3000000
756 +(% style="color:#037691" %)**0x03 00 01 2C**  (%%) ~/~/  Same as AT+MTDC=3000000
670 670  
671 671  
672 672  
... ... @@ -710,12 +710,12 @@
710 710  
711 711  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
712 712  
713 -Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
800 +Example:  AT+INTWK=1  **~-~->   ** Enable Transport Mode.
714 714  
715 715  
716 716  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
717 717  
718 -(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+ INTWK =1
805 +(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/  Same as AT+INTWK=1
719 719  
720 720  
721 721  
... ... @@ -722,42 +722,45 @@
722 722  === 3.2.7 Set Positioning Mode ===
723 723  
724 724  
725 -SMOD define the how TrackerD scan and uplink data:
812 +SMOD define how TrackerD scan and uplink data:
726 726  
727 727  
728 728  * (% style="color:blue" %)**AT Command:**
729 729  
730 -(% style="color:#037691" %)**AT+SMOD=aa,bb**
817 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
731 731  
732 732  (% style="color:#037691" %)** aa:**
733 733  
734 -* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
735 -* (% style="color:#037691" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
736 -* (% 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
821 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)Only get and uplink GPS location info.
822 +* (% 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.
823 +* (% 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.
737 737  
738 738  (% style="color:#037691" %)**bb:**
739 739  
740 -(% style="color:#037691" %)** if aa = 1: **
827 +* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
741 741  
742 -* (% style="color:#037691" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
743 -* (% style="color:#037691" %)**1 :**(%%)  GPS +BAT State
829 +* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
744 744  
745 -(% style="color:#037691" %)** if aa = 2: **
831 +(% style="color:#037691" %)**cc:   **
746 746  
747 -* (% style="color:#037691" %)**3 :  **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
833 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
834 +
835 +* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%))  
748 748  
749 - **Example:**
837 +(% style="color:blue" %)**Example:**
750 750  
751 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
839 + AT+SMOD=1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
752 752  
753 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
841 + AT+SMOD=1,1,0 ~-~->  GPS +BAT State
754 754  
755 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
843 + AT+SMOD=2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
756 756  
845 + AT+SMOD=2,0,2 ~-~->  (WiFi)SSID+Rssi+BAT+State
757 757  
847 +
758 758  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
759 759  
760 -(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
850 +(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+SMOD=1,0,0
761 761  
762 762  
763 763  
... ... @@ -774,7 +774,7 @@
774 774  
775 775  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
776 776  
777 -Example:  AT+FTIME=150
867 +**Example:**  AT+FTIME=150
778 778  
779 779  
780 780  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -811,22 +811,110 @@
811 811  
812 812  * (% style="color:blue" %)**AT Command:**
813 813  
814 -(% style="color:#037691" %)**AT+CFM=xx. **
904 +(% style="color:#037691" %)**AT+CFM=xx**
815 815  
816 816  
817 817  **~ Example:**
818 818  
819 - AT+ CFM=0    **~-~->   ** Disable confirmation
909 + AT+CFM=0    **~-~->   ** Disable confirmation
820 820  
821 - AT+ CFM=1    **~-~->  ** Enable confirmation
911 + AT+CFM=1    **~-~->  ** Enable confirmation
822 822  
823 823  
824 824  * (% style="color:blue" %)**Downlink Payload (prefix 0x05):**
825 825  
826 -(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+ SMOD =1
916 +(% style="color:#037691" %)**0x05 01 **(%%) ~/~/  Same as AT+CFM=1
827 827  
828 828  
829 829  
920 +=== 3.2.10  Auto Send None-ACK messages ===
921 +
922 +
923 +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.
924 +
925 +
926 +* (% style="color:blue" %)**AT Command: AT+PNACKMD**
927 +
928 +The default factory setting is 0.
929 +
930 +
931 +**Command Example Function Response:**
932 +
933 +(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
934 +
935 +
936 +* (% style="color:blue" %)**Downlink Command: 0x34**
937 +
938 +Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
939 +
940 +
941 +
942 +=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
943 +
944 +
945 +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.
946 +
947 +(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.**
948 +
949 +(% style="color:blue" %)**AT Command:**
950 +
951 + (% style="color:#037691" %)**AT+BLEMASK=123456**   (%%) ~/~/ Set BLEMASK = 123456
952 +
953 + (% style="color:#037691" %)**AT+BLEMASK=0**  (%%) ~/~/ disable BLEMASK
954 +
955 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1）**
956 +
957 +Example: 0xB2010203040506    ~/~/ Set BLEMASK to 123456
958 +
959 +
960 +
961 +=== 3.2.12  Set WiFIMASK to filter WiFi SSID（Since firmware 1.4.1） ===
962 +
963 +
964 +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.
965 +
966 +(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.**
967 +
968 +(% style="color:blue" %)**AT Command:**
969 +
970 + (% style="color:#037691" %)**AT+WiFiMASK=123456**    (%%) ~/~/ Set WiFiMASK = 123456
971 +
972 + (% style="color:#037691" %)**AT+WiFiMASK=0**       (%%) ~/~/ disable WiFiMASK
973 +
974 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1）**
975 +
976 +Example: 0xB3010203040506    ~/~/ Set WiFiMASK to 123456
977 +
978 +
979 +
980 +=== 3.2.13 Disable/Enable Information printing（Since firmware 1.4.1） ===
981 +
982 +
983 +Users can use this feature to enable/disable Information printing.
984 +
985 +(% style="color:blue" %)**AT Command:**
986 +
987 +(% style="color:#037691" %)**AT+SHOWID=XX         **(%%) ~/~/(Disable (0), Enable (1), default:0)
988 +\\Example: AT+SHOWID=1 ~-~-> Enable Information printing.
989 +
990 +
991 +
992 +=== 3.2.14 Get or Set Eight Channels Mode, only for us915, AU915（Since firmware 1.4.1） ===
993 +
994 +
995 +The Channels Mode in the LORAWAN LMIC library is from 0 ~~ 7. When CHE = 8, 72 channels will be accessible to the network.
996 +
997 +(% style="color:blue" %)**AT Command:**
998 +
999 +(% style="color:#037691" %)**AT+CHE=1**(%%) ~/~/ set one channels mode
1000 +
1001 +
1002 +(% style="color:blue" %)**Downlink Payload:0X24**(%%)
1003 +
1004 +Example: 0x24 01 ~/~/ Same as AT+CHE=1
1005 +
1006 +
1007 +
830 830  = 4. Setting for Different Scenarios =
831 831  
832 832  
... ... @@ -867,9 +867,10 @@
867 867  [[image:1664503574618-659.png]]
868 868  
869 869  
1048 +
870 870  (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
871 871  
872 -[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1051 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
873 873  
874 874  
875 875  Users need to use below files:
... ... @@ -912,7 +912,18 @@
912 912  [[image:1664503715811-892.png]]
913 913  
914 914  
1094 +(% 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.
915 915  
1096 +[[image:image-20221024105643-1.png]]
1097 +
1098 +**~ Figure1**
1099 +
1100 +
1101 +[[image:image-20221024105643-2.png]]
1102 +
1103 + **Figure2**
1104 +
1105 +
916 916  * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
917 917  
918 918  Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
... ... @@ -971,10 +971,75 @@
971 971  |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
972 972  |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
973 973  
1164 +== 7.3 Notes on using different serial port tools for TrackerD ==
974 974  
975 -= 8.  Order Info =
976 976  
1167 +=== **Serial port utility** ===
977 977  
1169 +
1170 +Serial port utility requires you to automatically add data streams.
1171 +
1172 +Need to adjust the data stream to RTS/CTS on physical restart.
1173 +
1174 +
1175 +(% class="wikigeneratedid" %)
1176 +[[image:image-20221102140621-1.png]]
1177 +
1178 +
1179 +When using AT commands, the data flow needs to be adjusted to XON/XOFF
1180 +
1181 +
1182 +[[image:image-20221102140638-2.png]]
1183 +
1184 +
1185 +
1186 +=== **SecureCRT** ===
1187 +
1188 +
1189 +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.
1190 +
1191 +
1192 +[[image:image-20221102140704-3.png]]
1193 +
1194 +
1195 +[[image:image-20221102140712-4.png]]
1196 +
1197 +
1198 +
1199 +=== **PUTTY** ===
1200 +
1201 +
1202 +[[image:image-20221102140748-5.png]]
1203 +
1204 +
1205 +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.
1206 +
1207 +
1208 +[[image:image-20221102140801-6.png]]
1209 +
1210 +
1211 += 8  Trouble Shooting =
1212 +
1213 +== 8.1 TDC is changed to 4294947296 and cause no uplink. ==
1214 +
1215 +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
1216 +
1217 +
1218 +== 8.2 Device not able get AT Command or show output after wake up from deep sleep mode ==
1219 +
1220 +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.
1221 +
1222 +
1223 +== 8.3 The reason why it has been restarted after upgrading（V.1.4.1） ==
1224 +
1225 +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
1226 +
1227 +[[image:image-20221107145243-1.png||height="695" width="443"]]
1228 +
1229 +
1230 += 9.  Order Info =
1231 +
1232 +
978 978  Part Number: (% style="color:blue" %)**TrackerD-XXX**
979 979  
980 980  (% style="color:blue" %)**XXX**(%%): The default frequency band
... ... @@ -987,10 +987,9 @@
987 987  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
988 988  * (% style="color:red" %)**US915**(%%): Default frequency band US915
989 989  
1245 += 10.  Packing Info =
990 990  
991 -= 9.  Packing Info =
992 992  
993 -
994 994  (% style="color:#037691" %)**Package Includes**:
995 995  
996 996  * TrackerD LoRaWAN GPS/BLE Tracker x 1
... ... @@ -998,16 +998,16 @@
998 998  
999 999  (% style="color:#037691" %)**Dimensions and Weight**:
1000 1000  
1001 -* Device Size: 85 x 48 x 15 cm
1255 +* Device Size: 85 x 48 x 15 mm
1002 1002  * Weight: 50g
1003 1003  
1004 -= 10. Support =
1258 += 11. Support =
1005 1005  
1006 1006  
1007 1007  * 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.
1008 1008  * 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]].
1009 1009  
1010 -= 11.  Reference =
1264 += 12.  Reference =
1011 1011  
1012 1012  
1013 1013  * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?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