Skip to Content
Last modified by Xiaoling on 2025/04/27 16:48
From version 51.22
edited by Xiaoling
on 2022/09/30 14:51
Change comment: There is no comment for this version
To version 75.1
edited by Edwin Chen
on 2022/10/13 23:07
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
Content
... ... @@ -61,13 +61,11 @@
61 61  * EEPROM: 520 KB
62 62  * Clock Speed: 32Mhz
63 63  
64 -
65 65  (% style="color:blue" %)**Common DC Characteristics:**
66 66  
67 67  * Supply Voltage: 5V via USB port or Internal li-on battery
68 68  * Operating Temperature: -40 ~~ 60°C
69 69  
70 -
71 71  (% style="color:blue" %)**LoRa Spec:**
72 72  
73 73  * Frequency Range,
... ... @@ -89,12 +89,10 @@
89 89  * Packet engine up to 256 bytes with CRC.
90 90  * LoRaWAN 1.0.3 Specification
91 91  
92 -
93 93  (% style="color:blue" %)**Battery:**
94 94  
95 95  * 1000mA Li-on Battery power (for model TrackerD)
96 96  
97 -
98 98  (% style="color:blue" %)**Power Consumption**
99 99  
100 100  * Sleeping Mode: 200uA
... ... @@ -102,7 +102,6 @@
102 102  * Tracking: max: 38mA
103 103  
104 104  
105 -
106 106  == 1.3  Features ==
107 107  
108 108  
... ... @@ -109,7 +109,7 @@
109 109  * LoRaWAN 1.0.3 Class A
110 110  * ESP32 PICO D4
111 111  * SX1276/78 Wireless Chip
112 -** Arduino IDE Compatible
107 +* Arduino IDE Compatible
113 113  * Open source hardware / software
114 114  * Regular/ Real-time GPS,BLE,WIFI tracking
115 115  * Built-in3 axis accelerometer (LIS3DH)
... ... @@ -122,7 +122,6 @@
122 122  * Datalog
123 123  
124 124  
125 -
126 126  == 1.4  Applications ==
127 127  
128 128  
... ... @@ -130,7 +130,6 @@
130 130  * Human tracking
131 131  
132 132  
133 -
134 134  = 2.1 Use TrackerD =
135 135  
136 136  
... ... @@ -193,60 +193,152 @@
193 193  (% 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.
194 194  
195 195  
196 -(% style="color:blue" %)**Positioning Mode(SMOD):**
197 197  
198 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings):    **(%%)only get GPS location info.
199 -* (% style="color:#037691" %)**BLE ONLY:              **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking.
200 -* (% style="color:#037691" %)**GPS/BLE Hybrid:   **(%%)Combination for Indoor and Outdoor tracking.
190 +== 2.3  Positioning Mode(SMOD) ==
201 201  
202 -User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
203 203  
193 +Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported.
204 204  
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.
205 205  
206 -== 2.3 Uplink Payload ==
199 +Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]].
207 207  
208 208  
209 -=== 2.3.1 Uplink FPORT~=5, Device Status ===
210 210  
203 +== 2.4  Uplink Payload ==
211 211  
212 212  
213 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning ===
206 +=== 2.4.1 Uplink FPORT~=5, Device Status ===
214 214  
215 215  
216 -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. )
209 +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.
217 217  
218 218  
219 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:520px" %)
220 -|=(% scope="row" style="width: 80px;" %)(((
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
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 +
216 +[[image:1665301570342-765.png]]
217 +
218 +
219 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002
220 +
221 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13
222 +
223 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version
224 +
225 +(% style="color:#037691" %)**Frequency Band**:
226 +
227 +*0x01: EU868
228 +
229 +*0x02: US915
230 +
231 +*0x03: IN865
232 +
233 +*0x04: AU915
234 +
235 +*0x05: KZ865
236 +
237 +*0x06: RU864
238 +
239 +*0x07: AS923
240 +
241 +*0x08: AS923-1
242 +
243 +*0x09: AS923-2
244 +
245 +*0x0a: AS923-3
246 +
247 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF)
248 +
249 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD.
250 +
251 +
252 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV
253 +
254 +Use can also get the Device Status uplink through the downlink command:
255 +
256 +
257 +
258 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%)：0x40
259 +
260 +(% border="1.5" style="background-color:#ffffcc; color:green; width:420px" %)
261 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:137px" %)2bit|(% style="width:142px" %)4bit
262 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:137px" %)GPS_Settings|(% style="width:142px" %)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 +
285 +
286 +(% style="color:#037691" %)**Status Field (total 1 byte)**(%%):  0x02
287 +
288 +(% border="1.5" style="background-color:#ffffcc; color:green; width:450px" %)
289 +|(% style="width:77px" %)**Size(bit)**|(% style="width:82px" %)5 Bits|(% style="width:106px" %)1 Bit|(% style="width:67px" %)1 Bit|(% style="width:121px" %)1 Bit
290 +|(% style="width:77px" %)**Value**|(% style="width:82px" %)Reserve|(% style="width:106px" %)PNACKMD|(% style="width:67px" %)LON|(% style="width:121px" %)Transport** **Mode
291 +
292 +
293 +
294 +
295 +
296 +
297 +=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity ===
298 +
299 +
300 +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.
301 +
302 +
303 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
304 +|=(% scope="row" style="width: 50px;" %)(((
221 221  **Size(bytes)**
222 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:80px" %)(((
223 -2(optional )
224 -)))|(% style="width:80px" %)(((
225 -2(optional)
306 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)(((
307 +2
308 +)))|(% style="width:87px" %)(((
309 +2
226 226  )))
227 227  |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
228 228  [[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
229 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]]
313 +)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]
230 230  
231 -[[image:1664501958445-288.png]]
315 +[[image:1665301636888-168.png]]
232 232  
233 233  
234 -==== (% style="color:blue" %)Alarm & BAT:(%%) ====
318 +==== (% style="color:blue" %)**Alarm & BAT:**(%%) ====
235 235  
236 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:329px" %)
237 -|=(% scope="row" style="width: 72px;" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits
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" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits
238 238  |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 
239 239  
240 -==== (% style="color:blue" %)FLAG:(%%) ====
241 241  
242 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:332px" %)
243 -|=(% scope="row" style="width: 79px;" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits
244 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 
325 +==== (% style="color:blue" %)**FLAG:**(%%) ====
245 245  
327 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %)
328 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit
329 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]
330 +
246 246  **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 
247 247  
248 248  
249 -==== (% style="color:blue" %)Location info:(%%) ====
334 +==== (% style="color:blue" %)**Location info:**(%%) ====
250 250  
251 251  * Latitude: 02863D68  ⇒  //if (0x//02863D68//& 0x80000000 = 0 )~://  //value = 02863D68 /1000000 = 42.351976//
252 252  * Longitude: FAC29BAF  ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~://  //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57//
... ... @@ -255,35 +255,31 @@
255 255  
256 256  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.
257 257  
258 -2.  In firmware version v1.5, Roll & Pitch is disabled by default.
343 +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:
259 259  
260 -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:
261 261  
262 -
263 263  [[image:1664502116362-706.png]]
264 264  
265 265  
349 +3.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
266 266  
267 -4.  While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00:
268 -
269 269  [[image:1664502166010-515.png]]
270 270  
271 271  
272 272  
273 -==== (% style="color:blue" %)Alarm:(%%) ====
355 +==== (% style="color:blue" %)**Alarm:**(%%) ====
274 274  
357 +**Example: ** 0x4B & 0x40 >> 6 = 0x01
275 275  
276 -Example:  0x4B & 0x40 >> 6 = 0x01
277 277  
360 +==== (% style="color:blue" %)**BAT:**(%%) ====
278 278  
279 -==== (% style="color:blue" %)BAT:(%%) ====
362 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV).
280 280  
364 +(((
365 +The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \
366 +)))
281 281  
282 -Example:  0x0CDD & 0x3FFF ⇒ 3293 (mV).
283 -
284 -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: \
285 -
286 -
287 287  * > 4.0v :  80% ~~ 100%
288 288  * 3.85v ~~3.99v:  60% ~~ 80%
289 289  * 3.70v ~~ 3.84v:  40% ~~ 60%
... ... @@ -290,46 +290,99 @@
290 290  * 3.40v ~~ 3.69v:  20% ~~ 40%
291 291  * < 3.39v:  0~~20%
292 292  
293 -==== (% style="color:blue" %)LON:(%%) ====
294 294  
295 -
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 +
390 +==== (% style="color:blue" %)**LON:**(%%) ====
391 +
392 +**Example:** (0x60>>5) & 0x01=1.
393 +
296 296  Enable/Disable LED activity for uplink
297 297  
298 -0x00:  Disable LED indicator.
396 +(((
397 +(% style="color:#037691" %)**0x00:**  (%%) Disable LED indicator.
398 +)))
299 299  
300 -0x01:  Enable LED indicator (Default Value)
400 +(((
401 +(% style="color:#037691" %)**0x01:**  (%%) Enable LED indicator (Default Value)
402 +)))
301 301  
302 302  
303 -==== (% style="color:blue" %)Hum:(%%) ====
304 304  
406 +==== (% style="color:blue" %)**Hum:**(%%) ====
407 +
305 305  0202 = //if (0x0202 & 0x8000 = 0 ):  value =// 0x0202 / 100 = +514 ⇒ 51.4 degree
306 306  
307 307  
308 -==== (% style="color:blue" %)Tem:(%%) ====
411 +==== (% style="color:blue" %)**Tem:**(%%) ====
309 309  
310 310  011A =if (0x011A & 0x8000 = 1 ):  value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree//
311 311  
312 312  
313 313  
417 +=== 2.4.3  Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) ===
314 314  
315 -=== 2.3.3 Uplink FPORT~= , History GNSS Positioning ===
316 316  
420 +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)
317 317  
318 318  
319 -=== 2.3.4 BLE positioning Payload(Fport2) ===
423 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %)
424 +|=(% scope="row" style="width: 50px;" %)(((
425 +**Size(bytes)**
426 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1
427 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)(((
428 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]]
429 +)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]
320 320  
431 +(% class="wikigeneratedid" %)
432 +[[image:1665301687277-443.png]]
321 321  
322 -Different MODE has different payload:
323 323  
324 -**MODE=2**
325 325  
326 -(% border="2" style="background-color:#ffffcc; color:green; width:491px" %)
327 -|(% style="width:70px" %)(((
328 -**Size**
436 +=== 2.4.4  Uplink FPORT~=4, History GNSS Positioning ===
329 329  
330 -**(bytes)**
331 -)))|(% style="width:44px" %)16|(% style="width:61px" %)4|(% style="width:63px" %)4|(% style="width:71px" %)2|(% style="width:50px" %)4|(% style="width:47px" %)2|(% style="width:15px" %)1
332 -|(% style="width:70px" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
438 +
439 +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.
440 +
441 +
442 +(% style="color:red" %)**Note for this mode:**
443 +
444 +* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server.
445 +* 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.
446 +
447 +The payload is 15 bytes, as below.
448 +
449 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
450 +|=(% scope="row" %)(((
451 +**Size(bytes)**
452 +)))|4|4|2|1|1|1|1|1
453 +|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen
454 +
455 +[[image:image-20221009160309-2.png]]
456 +
457 +
458 +
459 +=== 2.4.5  Uplink FPORT~=6, BLE Positioning with Strongest iBeacon ===
460 +
461 +
462 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %)
463 +|=(% scope="row" style="width: 60px;" %)(((
464 +**Size(bytes)**
465 +)))|(% 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
466 +|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)(((
333 333  iBeacon MAJOR
334 334  )))|(% style="width:63px" %)(((
335 335  iBeacon MINOR
... ... @@ -352,9 +352,11 @@
352 352  * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon.
353 353  * (% style="color:#037691" %)**RSSI:  ** (%%) The RSSI from the strongest iBeacon.
354 354  
355 -=== 2.3.5 Add Payload format in TTN V3 ===
356 356  
357 357  
491 +=== 2.4.6  Add Payload format in TTN V3 ===
492 +
493 +
358 358  In TTN V3, use can add a custom payload so it shows friendly.
359 359  
360 360  In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**
... ... @@ -372,12 +372,16 @@
372 372  
373 373  
374 374  
375 -== 2.4 Integrate with Datacake ==
511 +== 2.5 Integrate with Datacake ==
376 376  
377 377  
514 +(((
378 378  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.
516 +)))
379 379  
518 +(((
380 380  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]]
520 +)))
381 381  
382 382  
383 383  [[image:1664502695771-538.png]]
... ... @@ -384,12 +384,16 @@
384 384  
385 385  
386 386  
387 -== 2.5 Integrate with Tago ==
527 +== 2.6 Integrate with Tago ==
388 388  
389 389  
530 +(((
390 390  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.
532 +)))
391 391  
534 +(((
392 392  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]]
536 +)))
393 393  
394 394  
395 395  [[image:1664502715371-321.png]]
... ... @@ -396,33 +396,59 @@
396 396  
397 397  
398 398  
399 -== 2.6 Alarm Mode ==
543 +== 2.7  Datalog Feature ==
400 400  
401 401  
546 +total 273 entries,by default disable
547 +
548 +
549 +Example use case.
550 +
551 +[[image:image-20221009234703-2.png||height="328" width="899"]]
552 +
553 +
554 +[[image:image-20221009234629-1.png||height="390" width="577"]]
555 +
556 +
557 +
558 +== 2.8 Alarm Mode ==
559 +
560 +
561 +(((
402 402  User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode.
563 +)))
403 403  
404 404  
566 +(((
405 405  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.
568 +)))
406 406  
407 407  
571 +(((
408 408  Two ways to exit alarm mode:
573 +)))
409 409  
410 410  * Server send a downlink command to exit.
411 411  * User fast press the RED button 10 times.
412 412  
578 +(((
413 413  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.
580 +)))
414 414  
415 415  
416 416  
417 -== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ==
584 +== 2.9 Transport Mode ==
418 418  
419 419  
587 +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.
420 420  
421 -== 2.8 LED Status ==
422 422  
423 423  
424 -(% border="2" style="background-color:#ffffcc; color:green; width:636px" %)
425 -|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off**
591 +== 2.10 LED Status ==
592 +
593 +
594 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %)
595 +|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off**
426 426  |(% 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
427 427  |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes
428 428  |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A
... ... @@ -435,11 +435,13 @@
435 435  |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes
436 436  |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A
437 437  
438 -== 2.9 Button Function ==
439 439  
440 440  
441 -(% style="color:green" %)**RESET button:**
610 +== 2.11 Button Function ==
442 442  
612 +
613 +(% style="color:blue" %)**RESET button:**
614 +
443 443  [[image:1664502835802-546.png]]
444 444  
445 445  Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server.
... ... @@ -450,16 +450,17 @@
450 450  [[image:1664502854406-763.png]]
451 451  
452 452  
453 -(% border="2" style="background-color:#ffffcc; color:green; width:627px" %)
454 -|(% style="width:135px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**
625 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
626 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description**
455 455  |(% 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"]]
456 456  |(% 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
457 457  |(% 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.
458 458  
459 459  
460 -== 2.10 USB Port Function ==
461 461  
633 +== 2.12 USB Port Function ==
462 462  
635 +
463 463  The USB interface of TrackerD has below functions:
464 464  
465 465  * Power on the device
... ... @@ -468,6 +468,7 @@
468 468  * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]]
469 469  
470 470  
644 +
471 471  = 3. Configure TrackerD via AT command or LoRaWAN downlink =
472 472  
473 473  
... ... @@ -540,16 +540,16 @@
540 540  
541 541  
542 542  
543 -=== 3.2.3 Set Sports Mode Packet transmission interval ===
717 +=== 3.2.3 Set Transport Mode Packet transmission interval ===
544 544  
545 545  
546 -Set sports packet transmit interval
720 +Set Transport Mode packet transmit interval
547 547  
548 548  * (% style="color:blue" %)**AT Command:**
549 549  
550 550  (% style="color:#037691" %)**AT+MTDC=xx. **
551 551  
552 - Example:  AT+MTDC=300000  **~-~->    ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000
726 +Example:  AT+MTDC=300000  **~-~->    ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000
553 553  
554 554  
555 555  * (% style="color:blue" %)**Downlink Payload (prefix 0x03):**
... ... @@ -580,7 +580,7 @@
580 580  
581 581  (% style="color:#037691" %)**AT+LON=xx.  (Disable (0), Enable (1), default:1)**
582 582  
583 - Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
757 +Example: AT+LON=0  **~-~-> ** Disable LED for position, downlink and uplink.
584 584  
585 585  
586 586  * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**
... ... @@ -589,16 +589,16 @@
589 589  
590 590  
591 591  
592 -=== 3.2.6 Disable/Enable movement detect (Debug Only) ===
766 +=== 3.2.6 Disable/Enable Transport Mode ===
593 593  
594 594  
595 -User can use this feature to check and set thread hole of movement detect
769 +Users can use this feature to enable/disable Transport Mode.
596 596  
597 597  * (% style="color:blue" %)**AT Command:**
598 598  
599 599  (% style="color:#037691" %)**AT+INTWK=xx.  (Disable (0), Enable (1), default:0)**
600 600  
601 - Example:  AT+ INTWK =1  **~-~->   ** Enable detect movement.
775 +Example:  AT+ INTWK =1  **~-~->   ** Enable Transport Mode.
602 602  
603 603  
604 604  * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**
... ... @@ -610,35 +610,38 @@
610 610  === 3.2.7 Set Positioning Mode ===
611 611  
612 612  
613 -SMOD define the how TrackerD scan and uplink date.
787 +SMOD define the how TrackerD scan and uplink data:
614 614  
615 -GPS室外定位模式：  设备默认模式，设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是3分钟定位，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。GPS还有一种logdata模式，在断网的情况下将数据存储下来，等到有网的时候，一次将数据以每10秒上报。
616 616  
617 -BLE室内定位模式：  设备入网后会发送device当前模式下的信息，随后立即定位发送数据包（默认是5秒，超过将发送无效数据），如果出现意外情况下，快速按键3下，将会发出报警消息（默认每3分钟发送一次）。
790 +* (% style="color:blue" %)**AT Command:**
618 618  
619 -GPS和BLE混动模式：设备入网后会发送device当前模式下的信息，随后立即判断是否在室内，如果是就进行BLE定位，不是就GPS定位。如果出现意外情况下，快速按键3下，将会发出报警消息（默认每分钟发送一次）。
792 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc**
620 620  
621 -运动模式：  设备入网后会发送device当前模式下的信息，随后发送GPS定位数据，设备判断是否在运动，没有运动传感器没有检测到动作，立即进入静止状态（默认20分钟），如果产生运动，将每5分钟发送一次数据，再第五分钟后检测设备有误运动，无将切换到静止状态，有立即发送数据。
794 +(% style="color:#037691" %)** aa:**
622 622  
796 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings):    **(%%)only get and uplink GPS location info.
797 +* (% style="color:red" %)**2: BLE ONLY:              **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking.
798 +* (% 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.
623 623  
800 +(% style="color:#037691" %)**bb:**
624 624  
625 -* (% style="color:blue" %)**AT Command:**
802 +* (% style="color:red" %)**0 :  **(%%)GPS+ BAT+ State+Tem&Hum
803 +* (% style="color:red" %)**1 :**(%%)  GPS +BAT State
626 626  
627 -(% style="color:#037691" %)**AT+SMOD=xx. **
805 +(% style="color:#037691" %)**cc:   **
628 628  
807 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State  
629 629  
630 - **Example:**
809 +(% style="color:blue" %)**Example:**
631 631  
632 - AT+ SMOD =1,0  **~-~-> ** GPS+ BAT+ State+Tem&Hum
811 + AT+ SMOD =1,0 ,0 ~-~->  GPS+ BAT+ State+Tem&Hum
812 + AT+ SMOD =1,1,0 ~-~->  GPS +BAT State
813 + AT+ SMOD =2,0,1 ~-~->  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State
633 633  
634 - AT+ SMOD =1,1    **~-~->**  GPS +BAT State
635 635  
636 - AT+ SMOD =2,3    **~-~->**  (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。
637 -
638 -
639 639  * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):**
640 640  
641 -(% style="color:#037691" %)**0xA5 01 00**    (%%) ~/~/  Same as AT+ SMOD =1,0
818 +(% style="color:#037691" %)**0xA5 01 00 00**    (%%) ~/~/  Same as AT+ SMOD =1,0,0
642 642  
643 643  
644 644  
... ... @@ -655,7 +655,7 @@
655 655  
656 656  (% style="color:#037691" %)**AT+FTIME=xx**  (%%) **~-~-> ** Set to use xx as max fix time.
657 657  
658 -Example:  AT+FTIME=150
835 +**Example:**  AT+FTIME=150
659 659  
660 660  
661 661  * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**
... ... @@ -664,7 +664,7 @@
664 664  
665 665  
666 666  
667 -=== 3.3.9 Set PDOP value for GPS fix accuracy ===
844 +=== 3.2.9 Set PDOP value for GPS fix accuracy ===
668 668  
669 669  
670 670  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.
... ... @@ -692,7 +692,7 @@
692 692  
693 693  * (% style="color:blue" %)**AT Command:**
694 694  
695 -(% style="color:#037691" %)**AT+CFM=xx. **
872 +(% style="color:#037691" %)**AT+CFM=xx**
696 696  
697 697  
698 698  **~ Example:**
... ... @@ -708,6 +708,27 @@
708 708  
709 709  
710 710  
888 +=== 3.2.10  Auto Send None-ACK messages ===
889 +
890 +
891 +TrackerD will wait for ACK for each uplink, If TrackerD doesn't get ACK from the IoT server, it will consider the message doesn't arrive server and store it. TrackerD keeps sending messages in normal periodically. Once TrackerD gets ACK from a server, it will consider the network is ok and start to send the not-arrive message.
892 +
893 +
894 +* (% style="color:blue" %)**AT Command: AT+PNACKMD**
895 +
896 +The default factory setting is 0.
897 +
898 +
899 +**Command Example Function Response:**
900 +
901 +(% style="color:#037691" %)**AT+PNACKMD=1**  (%%) ~/~/  Poll None-ACK message OK
902 +
903 +
904 +* (% style="color:blue" %)**Downlink Command: 0x34**
905 +
906 +Example: 0x3401  ~/~/  Same as AT+PNACKMD=1
907 +
908 +
711 711  = 4. Setting for Different Scenarios =
712 712  
713 713  
... ... @@ -736,7 +736,7 @@
736 736  After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager.
737 737  
738 738  
739 -(% 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]]
937 +(% 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]]
740 740  
741 741  
742 742  (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32
... ... @@ -750,7 +750,7 @@
750 750  
751 751  (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location:
752 752  
753 -[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
951 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]
754 754  
755 755  
756 756  Users need to use below files:
... ... @@ -779,7 +779,7 @@
779 779  === 6.1.1 Set up ARDUINO compile environment ===
780 780  
781 781  
782 -* 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]]
980 +* **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]]**
783 783  
784 784  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]]
785 785  
... ... @@ -787,13 +787,14 @@
787 787  [[image:1664503635019-941.png]]
788 788  
789 789  
790 -* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) find the esp32 information and install it.
791 791  
989 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.**
990 +
792 792  [[image:1664503715811-892.png]]
793 793  
794 794  
795 795  
796 -* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]
995 +* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**
797 797  
798 798  Put the Library in the TrackerD directory into the libraries file in the Arduino directory:
799 799  
... ... @@ -840,8 +840,8 @@
840 840  
841 841  
842 842  
843 -(% border="2" style="background-color:#ffffcc; color:green; width:314px" %)
844 -|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin**
1042 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)
1043 +|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin**
845 845  |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC
846 846  |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A)
847 847  |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A)
... ... @@ -851,6 +851,8 @@
851 851  |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14
852 852  |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15
853 853  
1053 +
1054 +
854 854  = 8.  Order Info =
855 855  
856 856  
... ... @@ -866,25 +866,31 @@
866 866  * (% style="color:red" %)**AU915**(%%): Default frequency band AU915
867 867  * (% style="color:red" %)**US915**(%%): Default frequency band US915
868 868  
1070 +
1071 +
869 869  = 9.  Packing Info =
870 870  
871 871  
872 -**Package Includes**:
1075 +(% style="color:#037691" %)**Package Includes**:
873 873  
874 874  * TrackerD LoRaWAN GPS/BLE Tracker x 1
875 875  * USB recharge & program cable x 1
876 876  
877 -**Dimensions and Weight**:
1080 +(% style="color:#037691" %)**Dimensions and Weight**:
878 878  
879 879  * Device Size: 85 x 48 x 15 cm
880 880  * Weight: 50g
881 881  
1085 +
1086 +
882 882  = 10. Support =
883 883  
884 884  
885 885  * 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.
886 -* 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]]
1091 +* 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]].
887 887  
1093 +
1094 +
888 888  = 11.  Reference =
889 889  
890 890  
... ... @@ -891,3 +891,5 @@
891 891  * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]
892 892  * **[[Source Code>>https://github.com/dragino/TrackerD]] **
893 893  * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]]
1101 +
1102 +
1665301570342-765.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +31.6 KB
Content
1665301636888-168.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +36.6 KB
Content
1665301687277-443.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.6 KB
Content
1665301786397-168.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.6 KB
Content
image-20221006181316-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +17.7 KB
Content
image-20221006181357-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +88.0 KB
Content
image-20221009160220-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +46.4 KB
Content
image-20221009160309-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +57.2 KB
Content
image-20221009234629-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +222.9 KB
Content
image-20221009234703-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +136.4 KB
Content