Last modified by Xiaoling on 2025/04/27 16:48

From version 81.1
edited by Edwin Chen
on 2022/10/22 00:24
Change comment: There is no comment for this version
To version 51.24
edited by Xiaoling
on 2022/09/30 15:07
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,7 @@
97 97  * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm
98 98  * Tracking: max: 38mA
99 99  
100 +
100 100  == 1.3  Features ==
101 101  
102 102  
... ... @@ -103,7 +103,7 @@
103 103  * LoRaWAN 1.0.3 Class A
104 104  * ESP32 PICO D4
105 105  * SX1276/78 Wireless Chip
106 -* Arduino IDE Compatible
107 +** Arduino IDE Compatible
107 107  * Open source hardware / software
108 108  * Regular/ Real-time GPS,BLE,WIFI tracking
109 109  * Built-in3 axis accelerometer (LIS3DH)
... ... @@ -115,6 +115,7 @@
115 115  * Tri-color LED, Alarm button
116 116  * Datalog
117 117  
119 +
118 118  == 1.4  Applications ==
119 119  
120 120  
... ... @@ -121,6 +121,7 @@
121 121  * Logistics and Supply Chain Management
122 122  * Human tracking
123 123  
126 +
124 124  = 2.1 Use TrackerD =
125 125  
126 126  
... ... @@ -183,130 +183,42 @@
183 183  (% style="color:blue" %)**Step 3:**(%%) TrackerD will auto join to the LoRaWAN network. After join success, TrackerD will start to upload message to IoT server.
184 184  
185 185  
189 +(% style="color:blue" %)**Positioning Mode(SMOD):**
186 186  
187 -== 2.3  Positioning Mode(SMOD) ==
191 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get GPS location info.
192 +* (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking.
193 +* (% style="color:#037691" %)**GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.
188 188  
195 +User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
189 189  
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.
195 195  
196 -Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
199 +== 2.3 Uplink Payload ==
197 197  
198 198  
202 +=== 2.3.1 Uplink FPORT~=5, Device Status ===
199 199  
200 -== 2.4  Uplink Payload ==
201 201  
202 202  
203 -=== 2.4.1 Uplink FPORT~=5, Device Status ===
206 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning ===
204 204  
205 205  
206 -Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours.
209 +The default uplink payload includes totally 11 bytes. (User can use AT+MOD=0 to enable the Temperature and humidity sensor to hum/tem info from accelerometer. When accelerometer info is enable, total payload will be 15 bytes, please note 15 bytes won't work on DR0 on US915/AU915 frequency band. )
207 207  
208 -Use can also get the Device Status uplink through the downlink command: **Downlink:  0x2301**
209 209  
210 -
211 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
212 -|=(% 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
213 -|=(% 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
214 -
215 -[[image:1665301570342-765.png]]
216 -
217 -
218 -(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
219 -
220 -(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
221 -
222 -(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
223 -
224 -(% style="color:#037691" %)**Frequency Band**:
225 -
226 -*0x01: EU868
227 -
228 -*0x02: US915
229 -
230 -*0x03: IN865
231 -
232 -*0x04: AU915
233 -
234 -*0x05: KZ865
235 -
236 -*0x06: RU864
237 -
238 -*0x07: AS923
239 -
240 -*0x08: AS923-1
241 -
242 -*0x09: AS923-2
243 -
244 -*0x0a: AS923-3
245 -
246 -Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
247 -
248 -(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
249 -
250 -
251 -(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
252 -
253 -Use can also get the Device Status uplink through the downlink command:
254 -
255 -
256 -
257 -(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40
258 -
259 -(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
260 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
261 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)BLE_Settings
262 -
263 -(% style="color:blue" %)** SMOD:**
264 -
265 -(% style="color:red" %)** 1 :** (%%) GPS ONLY
266 -
267 -(% style="color:red" %)** 2 :** (%%) BLE ONLY
268 -
269 -(% style="color:red" %)** 3 :**  (%%) GPS/BLE Hybrid
270 -
271 -
272 -(% style="color:blue" %)** GPS_MOD: Define how to send GPS payload**
273 -
274 -(% style="color:red" %)** 0 : ** (%%) Enable uploading on-board Temperature and humidity values
275 -
276 -(% style="color:red" %)** 1 :** (%%) Disable uploading on-board Temperature and humidity values
277 -
278 -
279 -(% style="color:blue" %)** BLE_Settings:**
280 -
281 -(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon
282 -
283 -
284 -
285 -(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
286 -
287 -(% border="1.5" style="background-color:#ffffcc; color:green; width:417px" %)
288 -|(% style="width:77px" %)**Size(bit)**|(% style="width:70px" %)5 Bits|(% style="width:92px" %)1 Bit|(% style="width:48px" %)1 Bit|(% style="width:126px" %)1 Bit
289 -|(% 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"]]
290 -
291 -=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
292 -
293 -
294 -Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes,
295 -
296 -
297 297  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
298 298  |=(% scope="row" style="width: 50px;" %)(((
299 299  **Size(bytes)**
300 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
301 -2
215 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:88px" %)(((
216 +2(optional)
302 302  )))|(% style="width:87px" %)(((
303 -2
218 +2(optional)
304 304  )))
305 305  |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
306 306  [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
307 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
222 +)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
308 308  
309 -[[image:1665301636888-168.png]]
224 +[[image:1664501958445-288.png]]
310 310  
311 311  
312 312  ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ====
... ... @@ -315,11 +315,12 @@
315 315  |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
316 316  |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
317 317  
233 +
318 318  ==== (% style="color:blue" %)**FLAG:**(%%) ====
319 319  
320 320  (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
321 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
322 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
237 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits
238 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 
323 323  
324 324  **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
325 325  
... ... @@ -329,18 +329,23 @@
329 329  * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
330 330  * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
331 331  
248 +
249 +
332 332  (% style="color:red" %)**Important note:**
333 333  
334 334  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.
335 335  
336 -2.  In this mode, the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes payload. In this case, the payload on server will be ignore and shows as below:
254 +2.  In firmware version v1.5, Roll & Pitch is disabled by default.
337 337  
256 +3.  When enable 9-axis motion sensor, the total payload will be 15 bytes, while US915/AU915 DR0 accept only 11 bytes payload. In this case, the payload on server will be ignore and shows as below:
338 338  
258 +
339 339  [[image:1664502116362-706.png]]
340 340  
341 341  
342 -3.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
343 343  
263 +4.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
264 +
344 344  [[image:1664502166010-515.png]]
345 345  
346 346  
... ... @@ -347,17 +347,16 @@
347 347  
348 348  ==== (% style="color:blue" %)**Alarm:**(%%) ====
349 349  
350 -**Example: ** 0x4B & 0x40 >> 6 = 0x01
271 +Example:  0x4B & 0x40 >> 6 = 0x01
351 351  
352 352  
353 353  ==== (% style="color:blue" %)**BAT:**(%%) ====
354 354  
355 -**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
276 +Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
356 356  
357 -(((
358 -The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
359 -)))
278 +The battery info shows the current voltage, for (% style="color:blue" %)**TrackerD**(%%) version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \
360 360  
280 +
361 361  * > 4.0v :  80% ~~ 100%
362 362  * 3.85v ~~3.99v:  60% ~~ 80%
363 363  * 3.70v ~~ 3.84v:  40% ~~ 60%
... ... @@ -364,37 +364,19 @@
364 364  * 3.40v ~~ 3.69v:  20% ~~ 40%
365 365  * < 3.39v:  0~~20%
366 366  
367 -==== (% style="color:blue" %)**MOD:**(%%) ====
368 368  
369 -**Example: ** (0x60>>6) & 0x3f =1
370 370  
371 -**Set the format of GPS data uplink link:**
372 372  
373 -(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values
374 -(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values
375 -
376 -
377 -**Set the format of BLE data uplink link:**
378 -
379 -(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon
380 -
381 -
382 382  ==== (% style="color:blue" %)**LON:**(%%) ====
383 383  
384 -**Example:** (0x60>>5) & 0x01=1.
385 -
292 +
386 386  Enable/Disable LED activity for uplink
387 387  
388 -(((
389 -(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
390 -)))
295 +0x00:  Disable LED indicator.
391 391  
392 -(((
393 -(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
394 -)))
297 +0x01:  Enable LED indicator (Default Value)
395 395  
396 396  
397 -
398 398  ==== (% style="color:blue" %)**Hum:**(%%) ====
399 399  
400 400  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
... ... @@ -406,60 +406,21 @@
406 406  
407 407  
408 408  
409 -=== 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
311 +=== 2.3.3 Uplink FPORT~= , History GNSS Positioning ===
410 410  
411 411  
412 -The default uplink payload includes total 11 bytes (**AT+SMOD=1,1,0**). The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity)
413 413  
315 +=== 2.3.4 BLE positioning Payload(Fport2) ===
414 414  
415 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
416 -|=(% scope="row" style="width: 50px;" %)(((
417 -**Size(bytes)**
418 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
419 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
420 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
421 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
422 422  
423 -(% class="wikigeneratedid" %)
424 -[[image:1665301687277-443.png]]
318 +Different MODE has different payload:
425 425  
320 +**MODE=2**
426 426  
427 -
428 -=== 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
429 -
430 -
431 -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.
432 -
433 -
434 -(% style="color:red" %)**Note for this mode:**
435 -
436 -* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
437 -* 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.
438 -* 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
439 -
440 -The payload is 15 bytes, as below.
441 -
442 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
443 -|=(% scope="row" %)(((
322 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:491px" %)
323 +|=(% scope="row" style="width: 50px;" %)(((
444 444  **Size(bytes)**
445 -)))|4|4|2|1|1|1|1|1
446 -|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen
447 -
448 -[[image:image-20221009160309-2.png]]
449 -
450 -
451 -
452 -=== 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
453 -
454 -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.
455 -
456 -User can set [[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]] so TrackerD will only search the iBeacons which have UUID match the BLEMASK.
457 -
458 -
459 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
460 -|=(% scope="row" style="width: 60px;" %)(((
461 -**Size(bytes)**
462 -)))|(% style="width:30px" %)16|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:120px" %)2|(% style="width:50px" %)4|(% style="width:50px" %)2|(% style="width:30px" %)1
325 +)))|(% style="width:30px" %)16|(% style="width:50px" %)4|(% style="width:50px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)4|(% style="width:50px" %)2|(% style="width:30px" %)1
463 463  |=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
464 464  iBeacon MAJOR
465 465  )))|(% style="width:63px" %)(((
... ... @@ -475,7 +475,7 @@
475 475  [[image:1664502425687-834.png]]
476 476  
477 477  
478 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV).
341 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).
479 479  * (% style="color:#037691" %)**MODE:   **(%%)Define the payload format.
480 480  * (% style="color:#037691" %)**UUID:     **(%%)The uuid from the strongest iBeacon.
481 481  * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon.
... ... @@ -483,7 +483,7 @@
483 483  * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
484 484  * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
485 485  
486 -=== 2.4. Add Payload format in TTN V3 ===
349 +=== 2.3.5 Add Payload format in TTN V3 ===
487 487  
488 488  
489 489  In TTN V3, use can add a custom payload so it shows friendly.
... ... @@ -494,9 +494,8 @@
494 494  [[image:1664502649601-895.png]]
495 495  
496 496  
497 -Add the decoder from this link: 
360 +Add the decoder from this link:
498 498  
499 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]]
500 500  
501 501  Save the change the uplink message will be parsed. As below:
502 502  
... ... @@ -504,84 +504,57 @@
504 504  
505 505  
506 506  
507 -== 2.5 Integrate with Datacake ==
369 +== 2.4 Integrate with Datacake ==
508 508  
371 +
509 509  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.
510 510  
511 511  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]]
512 512  
376 +
513 513  [[image:1664502695771-538.png]]
514 514  
515 515  
516 516  
517 -== 2.6 Integrate with Tago ==
381 +== 2.5 Integrate with Tago ==
518 518  
519 519  
384 +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.
520 520  
521 -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.
522 -
523 523  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]]
524 524  
525 525  
526 -
527 527  [[image:1664502715371-321.png]]
528 528  
529 529  
530 530  
531 -== 2. Datalog Feature ==
393 +== 2.6 Alarm Mode ==
532 532  
533 533  
534 -total 273 entries,by default,
535 -
536 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature.
537 -
538 -Example use case.
539 -
540 -[[image:image-20221009234703-2.png||height="328" width="899"]]
541 -
542 -
543 -[[image:image-20221009234629-1.png||height="390" width="577"]]
544 -
545 -
546 -
547 -== 2.8 Alarm Mode ==
548 -
549 -
550 -(((
551 551  User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode.
552 -)))
553 553  
554 554  
555 -(((
556 -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.
557 -)))
399 +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.
558 558  
559 559  
560 -(((
561 561  Two ways to exit alarm mode:
562 -)))
563 563  
564 -* Server sends a downlink command to exit.
404 +* Server send a downlink command to exit.
565 565  * User fast press the RED button 10 times.
566 566  
567 -(((
568 568  When exit alarm mode, (% style="color:red" %)**RED LED**(%%) will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false.
569 -)))
570 570  
571 571  
572 572  
573 -== 2.9 Transport Mode ==
411 +== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ==
574 574  
575 575  
576 -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.
577 577  
415 +== 2.8 LED Status ==
578 578  
579 579  
580 -== 2.10 LED Status ==
581 -
582 -
583 -(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
584 -|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
418 +(% border="2" style="background-color:#ffffcc; color:green; width:636px" %)
419 +|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off**
585 585  |(% 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
586 586  |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
587 587  |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
... ... @@ -594,10 +594,10 @@
594 594  |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
595 595  |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
596 596  
597 -== 2.11 Button Function ==
432 +== 2.9 Button Function ==
598 598  
599 599  
600 -(% style="color:blue" %)**RESET button:**
435 +(% style="color:green" %)**RESET button:**
601 601  
602 602  [[image:1664502835802-546.png]]
603 603  
... ... @@ -609,13 +609,13 @@
609 609  [[image:1664502854406-763.png]]
610 610  
611 611  
612 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
613 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
447 +(% border="2" style="background-color:#ffffcc; color:green; width:627px" %)
448 +|(% style="width:135px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**
614 614  |(% 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"]]
615 615  |(% 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
616 616  |(% 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.
617 617  
618 -== 2.12 USB Port Function ==
453 +== 2.10 USB Port Function ==
619 619  
620 620  
621 621  The USB interface of TrackerD has below functions:
... ... @@ -649,9 +649,11 @@
649 649  [[image:1664503022490-662.png]]
650 650  
651 651  
487 +
652 652  [[image:1664503035713-500.png]]
653 653  
654 654  
491 +
655 655  [[image:1664503047675-651.png]]
656 656  
657 657  
... ... @@ -695,16 +695,16 @@
695 695  
696 696  
697 697  
698 -=== 3.2.3 Set Transport Mode Packet transmission interval ===
535 +=== 3.2.3 Set Sports Mode Packet transmission interval ===
699 699  
700 700  
701 -Set Transport Mode packet transmit interval
538 +Set sports packet transmit interval
702 702  
703 703  * (% style="color:blue" %)**AT Command:**
704 704  
705 705  (% style="color:#037691" %)**AT+MTDC=xx. **
706 706  
707 -Example:  AT+MTDC=300000  **~-~->    ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000
544 + Example:  AT+MTDC=300000  **~-~->    ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
708 708  
709 709  
710 710  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
... ... @@ -735,7 +735,7 @@
735 735  
736 736  (% style="color:#037691" %)**AT+LON=xx.  (Disable (0), Enable (1), default:1)**
737 737  
738 -Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
575 + Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
739 739  
740 740  
741 741  * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**
... ... @@ -744,16 +744,16 @@
744 744  
745 745  
746 746  
747 -=== 3.2.6 Disable/Enable Transport Mode ===
584 +=== 3.2.6 Disable/Enable movement detect (Debug Only) ===
748 748  
749 749  
750 -Users can use this feature to enable/disable Transport Mode.
587 +User can use this feature to check and set thread hole of movement detect
751 751  
752 752  * (% style="color:blue" %)**AT Command:**
753 753  
754 754  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
755 755  
756 -Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
593 + Example:  AT+ INTWK =1  **~-~->   ** Enable detect movement.
757 757  
758 758  
759 759  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
... ... @@ -765,38 +765,35 @@
765 765  === 3.2.7 Set Positioning Mode ===
766 766  
767 767  
768 -SMOD define how TrackerD scan and uplink data:
605 +SMOD define the how TrackerD scan and uplink date.
769 769  
607 +GPS室外定位模式:  设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。
770 770  
771 -* (% style="color:blue" %)**AT Command:**
609 +BLE室内定位模式:  设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。
772 772  
773 -(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
611 +GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。
774 774  
775 -(% style="color:#037691" %)** aa:**
613 +运动模式:  设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。
776 776  
777 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
778 -* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
779 -* (% 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.
780 780  
781 -(% style="color:#037691" %)**bb:**
782 782  
783 -* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
784 -* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
617 +* (% style="color:blue" %)**AT Command:**
785 785  
786 -(% style="color:#037691" %)**cc:   **
619 +(% style="color:#037691" %)**AT+SMOD=xx. **
787 787  
788 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
789 789  
790 -(% style="color:blue" %)**Example:**
622 + **Example:**
791 791  
792 - AT+ SMOD =1,0,0 ~-~->  GPS+ BAT+ State+Tem&Hum
793 - AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
794 - AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
624 + AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
795 795  
626 + AT+ SMOD =1,1    **~-~->**  GPS +BAT State
796 796  
628 + AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
629 +
630 +
797 797  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
798 798  
799 -(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
633 +(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
800 800  
801 801  
802 802  
... ... @@ -813,7 +813,7 @@
813 813  
814 814  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
815 815  
816 -**Example:**  AT+FTIME=150
650 +Example:  AT+FTIME=150
817 817  
818 818  
819 819  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -822,7 +822,7 @@
822 822  
823 823  
824 824  
825 -=== 3.2.9 Set PDOP value for GPS fix accuracy ===
659 +=== 3.3.9 Set PDOP value for GPS fix accuracy ===
826 826  
827 827  
828 828  PDOP(Position Dilution of Precision) filter, TrackerD will only accept GPS data with a lower PDOP value than pre-configure PDOP value. If device can't get a valid GPS packet within FTIME timeout, it will use the GPS data with lowest PDOP value to server.
... ... @@ -850,7 +850,7 @@
850 850  
851 851  * (% style="color:blue" %)**AT Command:**
852 852  
853 -(% style="color:#037691" %)**AT+CFM=xx**
687 +(% style="color:#037691" %)**AT+CFM=xx. **
854 854  
855 855  
856 856  **~ Example:**
... ... @@ -866,44 +866,6 @@
866 866  
867 867  
868 868  
869 -=== 3.2.10  Auto Send None-ACK messages ===
870 -
871 -
872 -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.
873 -
874 -
875 -* (% style="color:blue" %)**AT Command: AT+PNACKMD**
876 -
877 -The default factory setting is 0.
878 -
879 -
880 -**Command Example Function Response:**
881 -
882 -(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
883 -
884 -
885 -* (% style="color:blue" %)**Downlink Command: 0x34**
886 -
887 -Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
888 -
889 -
890 -=== 3.2.11  Set BLEMASK to filter BLE iBeacon ===
891 -
892 -BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. LBT1 will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID.
893 -
894 -Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.
895 -
896 -(% style="color:blue" %)**AT Command:**(%%)
897 - AT+BLEMASK=123456     ~/~/ Set BLEMASK = 123456
898 - AT+BLEMASK=0  ~/~/ disable BLEMASK
899 -
900 -
901 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)**(%%)
902 -Example:
903 -0xA5010203040506    ~/~/ Set BLEMASK to 123456
904 -
905 -
906 -
907 907  = 4. Setting for Different Scenarios =
908 908  
909 909  
... ... @@ -932,7 +932,7 @@
932 932  After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
933 933  
934 934  
935 -(% style="color:blue" %)**Step3**(%%)Download and Install Flash Tool:  [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]]
731 +(% style="color:blue" %)**Step3**(%%) Download and Install Flash Tool:  [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]]
936 936  
937 937  
938 938  (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
... ... @@ -946,7 +946,7 @@
946 946  
947 947  (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
948 948  
949 -[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
745 +[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
950 950  
951 951  
952 952  Users need to use below files:
... ... @@ -975,7 +975,7 @@
975 975  === 6.1.1 Set up ARDUINO compile environment ===
976 976  
977 977  
978 -* **Download the latest Arduino software (IDE) from the Arduino official website:  [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]**
774 +* Download the latest Arduino software (IDE) from the Arduino official website:  [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]
979 979  
980 980  Install IDE on PC, open and click (% style="color:#037691" %)**File ~-~-> Preference**,(%%) add the following URL:  [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]]
981 981  
... ... @@ -983,14 +983,13 @@
983 983  [[image:1664503635019-941.png]]
984 984  
985 985  
782 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) find the esp32 information and install it.
986 986  
987 -* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.**
988 -
989 989  [[image:1664503715811-892.png]]
990 990  
991 991  
992 992  
993 -* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
788 +* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
994 994  
995 995  Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
996 996  
... ... @@ -1037,8 +1037,8 @@
1037 1037  
1038 1038  
1039 1039  
1040 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)
1041 -|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin**
835 +(% border="2" style="background-color:#ffffcc; color:green; width:314px" %)
836 +|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin**
1042 1042  |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
1043 1043  |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
1044 1044  |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
... ... @@ -1066,12 +1066,12 @@
1066 1066  = 9.  Packing Info =
1067 1067  
1068 1068  
1069 -(% style="color:#037691" %)**Package Includes**:
864 +**Package Includes**:
1070 1070  
1071 1071  * TrackerD LoRaWAN GPS/BLE Tracker x 1
1072 1072  * USB recharge & program cable x 1
1073 1073  
1074 -(% style="color:#037691" %)**Dimensions and Weight**:
869 +**Dimensions and Weight**:
1075 1075  
1076 1076  * Device Size: 85 x 48 x 15 cm
1077 1077  * Weight: 50g
... ... @@ -1080,7 +1080,7 @@
1080 1080  
1081 1081  
1082 1082  * 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.
1083 -* 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]].
878 +* 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]]
1084 1084  
1085 1085  = 11.  Reference =
1086 1086  
... ... @@ -1088,5 +1088,3 @@
1088 1088  * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
1089 1089  * **[[Source Code>>https://github.com/dragino/TrackerD]] **
1090 1090  * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
1091 -
1092 -
1665301570342-765.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -31.6 KB
Content
1665301636888-168.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -36.6 KB
Content
1665301687277-443.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -22.6 KB
Content
1665301786397-168.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -22.6 KB
Content
image-20221006181316-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -17.7 KB
Content
image-20221006181357-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -88.0 KB
Content
image-20221009160220-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -46.4 KB
Content
image-20221009160309-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -57.2 KB
Content
image-20221009234629-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -222.9 KB
Content
image-20221009234703-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -136.4 KB
Content