Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 51.1
edited by Xiaoling
on 2022/09/30 10:40
on 2022/09/30 10:40
Change comment:
Uploaded new attachment "1664505654417-133.png", version {1}
To version 76.1
edited by Edwin Chen
on 2022/10/13 23:11
on 2022/10/13 23:11
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 10 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - Content
-
... ... @@ -1,6 +1,13 @@ 1 +(% style="text-align:center" %) 2 +[[image:1664505654417-133.png]] 3 + 4 + 5 + 6 + 1 1 (% class="wikigeneratedid" %) 2 2 **Table of Contents:** 3 3 10 +{{toc/}} 4 4 5 5 6 6 ... ... @@ -18,10 +18,14 @@ 18 18 ((( 19 19 In TrackerD, there are various sensors such as GPS, WiFi, BLE, Temperature, Humidity, Motion Detection, and Buzzer. User can use TrackerD for different tracking scenario. 20 20 28 +((( 21 21 TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution. 30 +))) 22 22 32 +((( 23 23 The LoRa wireless technology used in TrackerD allows the user to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional tracking services. 24 24 ))) 35 +))) 25 25 26 26 ((( 27 27 TrackerD is equipped with a (% style="color:blue" %)**1000mAh Li-on rechargeable battery**(%%). Each TrackerD has a worldwide unique OTAA keys to join the LoRaWAN network. ... ... @@ -86,8 +86,6 @@ 86 86 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 87 87 * Tracking: max: 38mA 88 88 89 - 90 - 91 91 == 1.3 Features == 92 92 93 93 ... ... @@ -94,7 +94,7 @@ 94 94 * LoRaWAN 1.0.3 Class A 95 95 * ESP32 PICO D4 96 96 * SX1276/78 Wireless Chip 97 -* 106 +* Arduino IDE Compatible 98 98 * Open source hardware / software 99 99 * Regular/ Real-time GPS,BLE,WIFI tracking 100 100 * Built-in3 axis accelerometer (LIS3DH) ... ... @@ -106,7 +106,6 @@ 106 106 * Tri-color LED, Alarm button 107 107 * Datalog 108 108 109 - 110 110 == 1.4 Applications == 111 111 112 112 ... ... @@ -113,8 +113,6 @@ 113 113 * Logistics and Supply Chain Management 114 114 * Human tracking 115 115 116 - 117 - 118 118 = 2.1 Use TrackerD = 119 119 120 120 ... ... @@ -142,11 +142,10 @@ 142 142 143 143 Each TrackerD is shipped with a sticker with the default device EUI as below: 144 144 151 + 145 145 [[image:1664501677253-891.png]] 146 146 147 147 148 - 149 - 150 150 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 151 151 152 152 ... ... @@ -178,103 +178,184 @@ 178 178 (% 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. 179 179 180 180 181 -(% style="color:blue" %)**Positioning Mode(SMOD):** 182 182 183 -* **GPS ONLY(Factory Settings): **only get GPS location info. 184 -* **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking. 185 -* **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking. 187 +== 2.3 Positioning Mode(SMOD) == 186 186 187 -User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 188 188 190 +Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 189 189 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. 190 190 191 - ==2.3UplinkPayload~-~-~-~-~-~-~-~-~-~-~-~-~-~-==196 +Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 192 192 193 193 194 -=== 2.3.1 Uplink FPORT~=5, Device Status === 195 195 200 +== 2.4 Uplink Payload == 196 196 197 197 198 -=== 2. 3.2Uplink FPORT~=RealtimeGNSS Positioning203 +=== 2.4.1 Uplink FPORT~=5, Device Status === 199 199 200 200 201 - The default uplinkpayloadincludes totally11 bytes.(User canuseAT+MOD=0toenable theTemperatureandhumiditysensortohum/teminfo from accelerometer.When accelerometerinfoisenable,totalpayloadwillbe 15 bytes,pleasenote 15 byteswon't workon DR0 on US915/AU915frequency band.)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. 202 202 208 +Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 203 203 204 -(% border="2" style="background-color:#ffffcc; color:green; width:537px" %) 205 -|(% style="width:69px" %)((( 206 -**Size** 207 207 208 - **(bytes)**209 - )))|(% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)(((210 -2 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 211 211 212 -(optional ) 213 -)))|(% style="width:83px" %)((( 214 -2 215 +[[image:1665301570342-765.png]] 215 215 216 -(optional) 217 -))) 218 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)((( 219 -[[Alarm &>>path:#Alarm]] 220 220 221 -[[BAT>>path:#Alarm]] 222 -)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]] 218 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002 223 223 220 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13 224 224 222 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version 225 225 226 - [[image:1664501958445-288.png]]224 +(% style="color:#037691" %)**Frequency Band**: 227 227 226 +*0x01: EU868 228 228 229 -* *Alarm & BAT:**228 +*0x02: US915 230 230 231 -(% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 232 -|(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 233 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]] 230 +*0x03: IN865 234 234 232 +*0x04: AU915 235 235 234 +*0x05: KZ865 236 236 237 -* *FLAG:**236 +*0x06: RU864 238 238 239 -(% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 240 -|(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 241 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version 238 +*0x07: AS923 242 242 240 +*0x08: AS923-1 243 243 244 -* *Example: Payload:0x02863D68FAC29BAF 4B45 60 0202011A **242 +*0x09: AS923-2 245 245 244 +*0x0a: AS923-3 246 246 247 - **Locationinfo:**246 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF) 248 248 249 -* Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 250 -* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 248 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD. 251 251 252 252 253 - **Importantnote:**251 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 254 254 255 - 1. Whenpower is low (<2.84v), GPS won'tbeable to getlocationinfoand GPSfeaturewill be disabled andthe locationfieldwill be filledwith 0x0FFFFFFF, 0x0FFFFFFF.253 +Use can also get the Device Status uplink through the downlink command: 256 256 257 -2. In firmware version v1.5, Roll & Pitch is disabled by default. 258 258 259 -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: 260 260 257 +(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 261 261 262 -[[image:1664502116362-706.png]] 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 263 263 263 +(% style="color:blue" %)** SMOD:** 264 264 265 +(% style="color:red" %)** 1 :** (%%) GPS ONLY 265 265 266 - 4.WhileGPScan't getlocation info aftertimeout(FTIME Parameter),thelatitudeandlongitudewillbefilledwithall0x00:267 +(% style="color:red" %)** 2 :** (%%) BLE ONLY 267 267 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:450px" %) 288 +|(% 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 289 +|(% style="width:77px" %)**Value**|(% style="width:82px" %)Reserve|(% style="width:106px" %)PNACKMD|(% style="width:67px" %)LON|(% style="width:121px" %)Transport** **Mode 290 + 291 + 292 + 293 + 294 +=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 295 + 296 + 297 +User can use **AT+SMOD=1,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, please note that 15 bytes won't work on DR0 on US915/AU915 frequency band. 298 + 299 + 300 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 301 +|=(% scope="row" style="width: 50px;" %)((( 302 +**Size(bytes)** 303 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 304 +2 305 +)))|(% style="width:87px" %)((( 306 +2 307 +))) 308 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 309 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 310 +)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 311 + 312 +[[image:1665301636888-168.png]] 313 + 314 + 315 +==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== 316 + 317 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 318 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 319 +|=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 320 + 321 +==== (% style="color:blue" %)**FLAG:**(%%) ==== 322 + 323 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 324 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 325 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 326 + 327 +**Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 328 + 329 + 330 +==== (% style="color:blue" %)**Location info:**(%%) ==== 331 + 332 +* Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 333 +* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 334 + 335 +(% style="color:red" %)**Important note:** 336 + 337 +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. 338 + 339 +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: 340 + 341 + 342 +[[image:1664502116362-706.png]] 343 + 344 + 345 +3. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 346 + 268 268 [[image:1664502166010-515.png]] 269 269 270 270 271 271 272 -* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 273 -* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 351 +==== (% style="color:blue" %)**Alarm:**(%%) ==== 274 274 275 - The battery info shows the current voltage, for**TrackerD** version whichpowered byli-on battery.Usercanusebelowmappingtoindicatethe battery in percentage: \353 +**Example: ** 0x4B & 0x40 >> 6 = 0x01 276 276 277 277 356 +==== (% style="color:blue" %)**BAT:**(%%) ==== 357 + 358 +**Example: ** 0x4B45 & 0x3FFF ⇒ 2885 (mV). 359 + 360 +((( 361 +The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ 362 +))) 363 + 278 278 * > 4.0v : 80% ~~ 100% 279 279 * 3.85v ~~3.99v: 60% ~~ 80% 280 280 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -281,86 +281,132 @@ 281 281 * 3.40v ~~ 3.69v: 20% ~~ 40% 282 282 * < 3.39v: 0~~20% 283 283 370 +==== (% style="color:blue" %)**MOD:**(%%) ==== 284 284 372 +**Example: ** (0x60>>6)& 0x3f =1. 285 285 286 -* *LON: **Enable/DisableLED activityfor uplink374 +**Set the format of GPS data uplink link:** 287 287 288 -0x00: Disable LED indicator. 376 +(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values 377 +(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values 289 289 290 -0x01: Enable LED indicator (Default Value) 291 291 380 +**Set the format of BLE data uplink link:** 292 292 293 -* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 294 -* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 382 +(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon 295 295 296 296 385 +==== (% style="color:blue" %)**LON:**(%%) ==== 297 297 387 +**Example:** (0x60>>5) & 0x01=1. 298 298 389 +Enable/Disable LED activity for uplink 299 299 300 -=== 2.3.3 Uplink FPORT~= , History GNSS Positioning === 391 +((( 392 +(% style="color:#037691" %)**0x00:** (%%) Disable LED indicator. 393 +))) 301 301 395 +((( 396 +(% style="color:#037691" %)**0x01:** (%%) Enable LED indicator (Default Value) 397 +))) 302 302 303 303 304 -=== 2.3.4 BLE positioning Payload(Fport2) === 305 305 401 +==== (% style="color:blue" %)**Hum:**(%%) ==== 306 306 307 - DifferentMODEhasdifferent payload:403 +0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 308 308 309 -**MODE=2** 310 310 311 -(% border="2" style="background-color:#ffffcc; color:green; width:620px" %) 312 -|(% style="width:70px" %)((( 313 -**Size** 406 +==== (% style="color:blue" %)**Tem:**(%%) ==== 314 314 315 -**(bytes)** 316 -)))|(% style="width:54px" %)16|(% style="width:72px" %)4|(% style="width:71px" %)4|(% style="width:145px" %)2|(% style="width:72px" %)4|(% style="width:76px" %)2|(% style="width:54px" %)1 317 -|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)((( 318 -iBeacon 408 +011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 319 319 320 -MAJOR 321 -)))|(% style="width:71px" %)((( 322 -iBeacon 323 323 324 -MINOR 325 -)))|(% style="width:145px" %)((( 326 -iBeacon Measured 327 327 328 -Power 329 -)))|(% style="width:72px" %)((( 330 -iBeacon 412 +=== 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 331 331 332 -RSSI 333 -)))|(% style="width:76px" %)((( 334 -[[Alarm &>>path:#Alarm]] 335 335 336 -[[BAT>>path:#Alarm]] 337 -)))|(% style="width:54px" %)[[FLAG>>path:#Flag]] 415 +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) 338 338 339 -[[image:1664502425687-834.png]] 340 340 418 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 419 +|=(% scope="row" style="width: 50px;" %)((( 420 +**Size(bytes)** 421 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1 422 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 423 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 424 +)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] 341 341 342 -* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 343 -* **MODE: **Define the payload format. 344 -* **UUID: **The uuid from the strongest iBeacon. 345 -* **MAJOR**: The MAJOR from the strongest iBeacon. 346 -* **MINOR**: The MAJOR from the strongest iBeacon. 347 -* **Measured** **Power**: The Measured Power from the strongest iBeacon. 348 -* **RSSI**: The RSSI from the strongest iBeacon. 426 +(% class="wikigeneratedid" %) 427 +[[image:1665301687277-443.png]] 349 349 350 350 351 351 431 +=== 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 352 352 353 353 354 - ===2.3.5AddPayload format inTTNV3===434 +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. 355 355 356 356 437 +(% style="color:red" %)**Note for this mode:** 438 + 439 +* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 440 +* 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. 441 + 442 +The payload is 15 bytes, as below. 443 + 444 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 445 +|=(% scope="row" %)((( 446 +**Size(bytes)** 447 +)))|4|4|2|1|1|1|1|1 448 +|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen 449 + 450 +[[image:image-20221009160309-2.png]] 451 + 452 + 453 + 454 +=== 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 455 + 456 + 457 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 458 +|=(% scope="row" style="width: 60px;" %)((( 459 +**Size(bytes)** 460 +)))|(% 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 461 +|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 462 +iBeacon MAJOR 463 +)))|(% style="width:63px" %)((( 464 +iBeacon MINOR 465 +)))|(% style="width:71px" %)((( 466 +iBeacon Measured Power 467 +)))|(% style="width:50px" %)((( 468 +iBeacon RSSI 469 +)))|(% style="width:47px" %)((( 470 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 471 +)))|(% style="width:15px" %)[[FLAG>>||anchor="HFLAG:"]] 472 + 473 +[[image:1664502425687-834.png]] 474 + 475 + 476 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 477 +* (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 478 +* (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 479 +* (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. 480 +* (% style="color:#037691" %)**MINOR:** (%%)The MAJOR from the strongest iBeacon. 481 +* (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 482 +* (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 483 + 484 + 485 +=== 2.4.6 Add Payload format in TTN V3 === 486 + 487 + 357 357 In TTN V3, use can add a custom payload so it shows friendly. 358 358 359 -In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 490 +In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 360 360 361 361 362 362 [[image:1664502649601-895.png]] 363 363 495 + 364 364 Add the decoder from this link: 365 365 366 366 ... ... @@ -370,12 +370,16 @@ 370 370 371 371 372 372 373 -== 2. 4Integrate with Datacake ==505 +== 2.5 Integrate with Datacake == 374 374 375 375 508 +((( 376 376 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 +))) 377 377 512 +((( 378 378 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]] 514 +))) 379 379 380 380 381 381 [[image:1664502695771-538.png]] ... ... @@ -382,12 +382,16 @@ 382 382 383 383 384 384 385 -== 2. 5Integrate with Tago ==521 +== 2.6 Integrate with Tago == 386 386 387 387 524 +((( 388 388 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. 526 +))) 389 389 528 +((( 390 390 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]] 530 +))) 391 391 392 392 393 393 [[image:1664502715371-321.png]] ... ... @@ -394,52 +394,76 @@ 394 394 395 395 396 396 397 -== 2. 6Alarm Mode ==537 +== 2.7 Datalog Feature == 398 398 399 399 400 - User can pushthe **RED button** by morethan5secondstoenterAlarm Mode.540 +total 273 entries,by default disable 401 401 402 402 403 - Once enter Alarm mode, the **GREEN LED** will flash 3 times, the buzzer will alarm for 5 seconds, then TrackerD will immediately send apacket withoutlocation info and thensenda data packet with GPS positioning information. After that, the device willsend 60 packets at 1-minute intervals.The Alarm flag in the payload will be set for the next 60 packets unless exit alert mode.543 +Example use case. 404 404 545 +[[image:image-20221009234703-2.png||height="328" width="899"]] 405 405 547 + 548 +[[image:image-20221009234629-1.png||height="390" width="577"]] 549 + 550 + 551 + 552 +== 2.8 Alarm Mode == 553 + 554 + 555 +((( 556 +User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 557 +))) 558 + 559 + 560 +((( 561 +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. 562 +))) 563 + 564 + 565 +((( 406 406 Two ways to exit alarm mode: 567 +))) 407 407 408 408 * Server send a downlink command to exit. 409 409 * User fast press the RED button 10 times. 410 410 411 -When exit alarm mode, **RED LED** will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false. 572 +((( 573 +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. 574 +))) 412 412 413 413 414 414 415 -== 2. 7SportsMode~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--==578 +== 2.9 Transport Mode == 416 416 417 417 581 +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. 418 418 419 -== 2.8 LED Status == 420 420 421 421 422 -(% border="2" style="background-color:#ffffcc; color:green; width:636px" %) 423 -|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off** 424 -|(% style="width:157px" %)**Power On**|(% style="width:271px" %)**BLUE, RED , Green** flash once|(% style="width:202px" %)N/A 425 -|(% style="width:157px" %)**Join request**|(% style="width:271px" %)**Green** led fast blink once (200ms)|(% style="width:202px" %)Yes 426 -|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)**Green** led on 5 second|(% style="width:202px" %)N/A 427 -|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)**BLUE **blinks 200ms per second|(% style="width:202px" %)Yes 428 -|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)**GREEN **blinks twice (200ms per blink)|(% style="width:202px" %)Yes 429 -|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)**RED **blinks twice (200ms per blink)|(% style="width:202px" %)Yes 430 -|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)**RED **on for 3 seconds|(% style="width:202px" %)Yes 431 -|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)**RED **on for 1 second|(% style="width:202px" %)Yes 432 -|(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)**BLUE **led on 5 second|(% style="width:202px" %)Yes 433 -|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)**GREEN** led on 1 second|(% style="width:202px" %)Yes 434 -|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)**RED **on 500ms|(% style="width:202px" %)N/A 585 +== 2.10 LED Status == 435 435 436 436 588 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 589 +|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 590 +|(% 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 591 +|(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes 592 +|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A 593 +|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes 594 +|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes 595 +|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes 596 +|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes 597 +|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes 598 +|(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)led on 5 second|(% style="width:202px" %)Yes 599 +|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 600 +|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 437 437 438 438 439 -== 2. 9Button Function ==603 +== 2.11 Button Function == 440 440 441 441 442 -**RESET button:** 606 +(% style="color:blue" %)**RESET button:** 443 443 444 444 [[image:1664502835802-546.png]] 445 445 ... ... @@ -446,38 +446,35 @@ 446 446 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server. 447 447 448 448 449 -**RED button:** 613 +(% style="color:red" %)**RED button:** 450 450 451 451 [[image:1664502854406-763.png]] 452 452 453 453 454 -(% border=" 2" style="background-color:#ffffcc; color:green; width:627px" %)455 -|(% style="width:1 35px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**456 -|(% style="width:135px" %)Send Alarm|(% style="width:220px" %)Keep Pressing **RED** button for more than 5 seconds|(% style="width:265px" %)Enter Alarm Mode. See [[Alarm Mode>> path:#Alarm_Mode]]457 -|(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the **RED** button 10 times|(% style="width:265px" %)Exit Alarm Mode 618 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 619 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 620 +|(% 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"]] 621 +|(% 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 458 458 |(% 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. 459 459 460 460 625 +== 2.12 USB Port Function == 461 461 462 -== 2.10 USB Port Function == 463 463 464 - 465 465 The USB interface of TrackerD has below functions: 466 466 467 467 * Power on the device 468 468 * Recharge the battery 469 -* [[Configure Device>> path:#AT_Command]]470 -* [[Upgrade Firmware>> path:#upgrade_image]]632 +* [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 633 +* [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 471 471 472 472 473 - 474 - 475 475 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 476 476 477 477 478 478 User can configure TrackerD via AT Command or LoRaWAN Downlink. 479 479 480 -LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>> url:http://wiki.dragino.com/xwiki/bin/view/Main/]]641 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]] 481 481 482 482 483 483 ... ... @@ -490,7 +490,7 @@ 490 490 [[image:1664502999401-486.png]] 491 491 492 492 493 -In PC, User needs to set serial tool baud rate to **115200** to access serial console for TrackerD. TrackerD will output system info once power on and user will be able to send AT commands: 654 +In PC, User needs to set serial tool baud rate to (% style="color:green" %)**115200**(%%) to access serial console for TrackerD. TrackerD will output system info once power on and user will be able to send AT commands: 494 494 495 495 496 496 [[image:1664503022490-662.png]] ... ... @@ -513,16 +513,16 @@ 513 513 514 514 Set device uplink interval. 515 515 516 -* AT Command: 677 +* (% style="color:blue" %)**AT Command:** 517 517 518 -AT+TDC=xxx 679 +(% style="color:#037691" %)**AT+TDC=xxx ** 519 519 520 520 Example: AT+TDC=300000. Means set interval to 5 minutes(300 seconds) 521 521 522 522 523 -* Downlink Payload (prefix 0x01): 684 +* (% style="color:blue" %)**Downlink Payload (prefix 0x01):** 524 524 525 -0x01 00 01 2C 686 +(% style="color:#037691" %)**0x01 00 01 2C** (%%) ~/~/ Same as AT+TDC=300000 526 526 527 527 528 528 ... ... @@ -531,34 +531,34 @@ 531 531 532 532 Set alarm packet transmit interval 533 533 534 -* AT Command: 695 +* (% style="color:blue" %)**AT Command:** 535 535 536 -AT+ATDC=xx. 697 +(% style="color:#037691" %)**AT+ATDC=xx. ** 537 537 538 -Example: AT+ATDC=60000 **~-~-> 699 +Example: AT+ATDC=60000 **~-~-> ** Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000 539 539 540 540 541 -* Downlink Payload (prefix 0xB1): 702 +* (% style="color:blue" %)**Downlink Payload (prefix 0xB1):** 542 542 543 -0xB1 00 00 3C 704 +(% style="color:#037691" %)**0xB1 00 00 3C ** (%%) ~/~/ Same as AT+ATDC=60000 544 544 545 545 546 546 547 -=== 3.2.3 Set SportsMode Packet transmission interval ===708 +=== 3.2.3 Set Transport Mode Packet transmission interval === 548 548 549 549 550 -Set sport spacket transmit interval711 +Set Transport Mode packet transmit interval 551 551 552 -* AT Command: 713 +* (% style="color:blue" %)**AT Command:** 553 553 554 -AT+MTDC=xx. 715 +(% style="color:#037691" %)**AT+MTDC=xx. ** 555 555 556 - SportsMode Packet Interval to 300 seconds. TrackerD will send every 300 seconds inSportsmode, Default Value: 300000717 +Example: AT+MTDC=300000 **~-~-> ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000 557 557 558 558 559 -* Downlink Payload (prefix 0x03): 720 +* (% style="color:blue" %)**Downlink Payload (prefix 0x03):** 560 560 561 -0x03 00 01 2C ~/~/ Same as AT+ MTDC=3000000 722 +(% style="color:#037691" %)**0x03 00 01 2C** (%%) ~/~/ Same as AT+ MTDC=3000000 562 562 563 563 564 564 ... ... @@ -567,50 +567,47 @@ 567 567 568 568 Server send downlink command to exit Alarm mode 569 569 570 -* AT Command: 731 +* (% style="color:blue" %)**AT Command: No AT Command** 571 571 572 - NoATCommand733 +* (% style="color:blue" %)**Downlink Payload (prefix 0x02):** 573 573 735 +(% style="color:#037691" %)**0x02 01** (%%) ~/~/ Exit Alarm Mode 574 574 575 -* Downlink Payload (prefix 0x02): 576 576 577 -0x02 01 ~/~/ Exit Alarm Mode 578 578 579 - 580 - 581 581 === 3.2.5 Disable/Enable LED flash === 582 582 583 583 584 584 Disable/Enable LED for position, downlink and uplink 585 585 586 -* AT Command: 744 +* (% style="color:blue" %)**AT Command:** 587 587 588 -AT+LON=xx. (Disable (0), Enable (1), default:1) 746 +(% style="color:#037691" %)**AT+LON=xx. (Disable (0), Enable (1), default:1)** 589 589 590 - 748 +Example: AT+LON=0 **~-~-> ** Disable LED for position, downlink and uplink. 591 591 592 592 593 -* Downlink Payload (prefix 0xAE): 751 +* (% style="color:blue" %)**Downlink Payload (prefix 0xAE):** 594 594 595 -0xAE 00 753 +(% style="color:#037691" %)**0xAE 00 ** (%%) ~/~/ Same as AT+LON=0 596 596 597 597 598 598 599 -=== 3.2.6 Disable/Enable movement detect(Debug Only)===757 +=== 3.2.6 Disable/Enable Transport Mode === 600 600 601 601 602 -User can use this feature to check andet thread holeof movement detect760 +Users can use this feature to enable/disable Transport Mode. 603 603 604 -* AT Command: 762 +* (% style="color:blue" %)**AT Command:** 605 605 606 -AT+INTWK=xx. (Disable (0), Enable (1), default:0) 764 +(% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 607 607 608 - detectmovement.766 +Example: AT+ INTWK =1 **~-~-> ** Enable Transport Mode. 609 609 610 610 611 -* Downlink Payload (prefix 0xAF): 769 +* (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** 612 612 613 -0xAF 01 771 +(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/ Same as AT+ INTWK =1 614 614 615 615 616 616 ... ... @@ -617,38 +617,41 @@ 617 617 === 3.2.7 Set Positioning Mode === 618 618 619 619 620 -SMOD define the how TrackerD scan and uplink dat e.778 +SMOD define the how TrackerD scan and uplink data: 621 621 622 -GPS室外定位模式: 设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 623 623 624 - BLE室内定位模式:设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。781 +* (% style="color:blue" %)**AT Command:** 625 625 626 - GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。783 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc** 627 627 628 - 运动模式:设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。785 +(% style="color:#037691" %)** aa:** 629 629 787 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 788 +* (% style="color:red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 789 +* (% 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. 630 630 791 +(% style="color:#037691" %)**bb:** 631 631 632 -* AT Command: 793 +* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 794 +* (% style="color:red" %)**1 :**(%%) GPS +BAT State 633 633 634 - AT+SMOD=xx.796 +(% style="color:#037691" %)**cc: ** 635 635 798 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 636 636 637 - **Example:** 800 +(% style="color:blue" %)**Example:** 638 638 639 - AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum 802 + AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 803 + AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 804 + AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 640 640 641 - AT+ SMOD =1,1 **~-~->** GPS +BAT State 642 642 643 - AT+ SMOD =2,3**~-~->**(iBeacon)UUID+ Major+ Minor+Power+Rssi+BAT+State。807 +* (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 644 644 809 +(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ SMOD =1,0,0 645 645 646 -* Downlink Payload (prefix 0xA5): 647 647 648 -0xA5 01 00 ~/~/ Same as AT+ SMOD =1,0 649 649 650 - 651 - 652 652 === 3.2.8 Set MAX GPS position time === 653 653 654 654 ... ... @@ -658,20 +658,20 @@ 658 658 If AT+FTIME=0. The GPS module will be always powered and positioning. This will highly increase the power consumption (up to 50mA). When AT+FTIME=0, it will improve fix accuracy and shorten the acquire time for next uplink. 659 659 660 660 661 -* AT Command: 822 +* (% style="color:blue" %)**AT Command:** 662 662 663 -AT+FTIME=xx **~-~-> ** Set to use xx as max fix time. 824 +(% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 664 664 665 -Example: AT+FTIME=150 826 +**Example:** AT+FTIME=150 666 666 667 667 668 -* Downlink Payload (prefix 0xAA): 829 +* (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** 669 669 670 -0xAA 00 96 831 +(% style="color:#037691" %)**0xAA 00 96 ** (%%) ~/~/ Set AT+FTIME=150 671 671 672 672 673 673 674 -=== 3. 3.9 Set PDOP value for GPS fix accuracy ===835 +=== 3.2.9 Set PDOP value for GPS fix accuracy === 675 675 676 676 677 677 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. ... ... @@ -680,40 +680,62 @@ 680 680 A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0 681 681 682 682 683 -* AT Command: 844 +* (% style="color:blue" %)**AT Command:** 684 684 685 -AT+PDOP=2.5 846 +(% style="color:#037691" %)**AT+PDOP=2.5 ** (%%) **~-~-> ** Set PDOP to 2.5 686 686 687 687 688 -* Downlink Payload (prefix 0xAD): 849 +* (% style="color:blue" %)**Downlink Payload (prefix 0xAD):** 689 689 690 -0xAD 00 0A 851 +(% style="color:#037691" %)**0xAD 00 0A** (%%) ~/~/ Set AT+PDOP=1 (0x0A / 10 =1) 691 691 692 -0xAD 00 19 853 +(% style="color:#037691" %)**0xAD 00 19** (%%) ~/~/ Set AT+PDOP=2.5 (0x19 / 10 =2.5) 693 693 694 -0xAD 00 46 855 +(% style="color:#037691" %)**0xAD 00 46** (%%) ~/~/ Set AT+PDOP=7 (0x46 / 10 =7) 695 695 696 696 858 + 697 697 Disable/Enable the confirmation mode 698 698 699 -* AT Command: 861 +* (% style="color:blue" %)**AT Command:** 700 700 701 -AT+CFM=xx .863 +(% style="color:#037691" %)**AT+CFM=xx** 702 702 703 703 704 704 **~ Example:** 705 705 706 - AT+ CFM=0 **~-~-> 868 + AT+ CFM=0 **~-~-> ** Disable confirmation 707 707 708 708 AT+ CFM=1 **~-~-> ** Enable confirmation 709 709 710 710 711 -* Downlink Payload (prefix 0x05): 873 +* (% style="color:blue" %)**Downlink Payload (prefix 0x05):** 712 712 713 -0x05 01 875 +(% style="color:#037691" %)**0x05 01 **(%%) ~/~/ Same as AT+ SMOD =1 714 714 715 715 716 716 879 +=== 3.2.10 Auto Send None-ACK messages === 880 + 881 + 882 +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. 883 + 884 + 885 +* (% style="color:blue" %)**AT Command: AT+PNACKMD** 886 + 887 +The default factory setting is 0. 888 + 889 + 890 +**Command Example Function Response:** 891 + 892 +(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 893 + 894 + 895 +* (% style="color:blue" %)**Downlink Command: 0x34** 896 + 897 +Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 898 + 899 + 717 717 = 4. Setting for Different Scenarios = 718 718 719 719 ... ... @@ -742,11 +742,9 @@ 742 742 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 743 743 744 744 745 -(% style="color:blue" %)**Step3 :**(%%)928 +(% 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]] 746 746 747 -[[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]] 748 748 749 - 750 750 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 751 751 752 752 ... ... @@ -758,7 +758,7 @@ 758 758 759 759 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 760 760 761 -[[https:~~/~~/ www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]942 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] 762 762 763 763 764 764 Users need to use below files: ... ... @@ -787,25 +787,23 @@ 787 787 === 6.1.1 Set up ARDUINO compile environment === 788 788 789 789 790 -* 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]] 971 +* **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]]** 791 791 792 -Install IDE on PC, open and click **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]] 973 +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]] 793 793 794 794 795 795 [[image:1664503635019-941.png]] 796 796 797 797 798 -* Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 799 799 980 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 800 800 801 - 802 802 [[image:1664503715811-892.png]] 803 803 804 804 805 805 806 -* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 986 +* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 807 807 808 - 809 809 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 810 810 811 811 ... ... @@ -816,19 +816,19 @@ 816 816 == 6.2 Source Code == 817 817 818 818 819 -* Open the example in the TrackerD file, please select the correct port in the IDE, as shown below: 998 +* (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:** 820 820 821 821 [[image:1664503794261-827.png]] 822 822 823 823 824 824 825 -* Click to upload 1004 +* (% style="color:blue" %)**Click to upload** 826 826 827 827 [[image:1664503808294-336.png]] 828 828 829 829 830 830 831 -* Check the result, if the upload is successful, as shown below, open the serial port to view the data 1010 +* (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data** 832 832 833 833 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]] 834 834 ... ... @@ -840,7 +840,7 @@ 840 840 == 7.1 How to change the LoRa Frequency Bands/Region? == 841 841 842 842 843 -User can follow the introduction for [[how to upgrade image>> path:#upgrade_image]]. When download the images, choose the required image file for download.1022 +User can follow the introduction for [[how to upgrade image>>||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download. 844 844 845 845 846 846 ... ... @@ -851,8 +851,8 @@ 851 851 852 852 853 853 854 -(% border=" 2" style="background-color:#ffffcc; color:green; width:314px" %)855 -|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin** 1033 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %) 1034 +|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin** 856 856 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC 857 857 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A) 858 858 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A) ... ... @@ -863,9 +863,6 @@ 863 863 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 864 864 865 865 866 - 867 - 868 - 869 869 = 8. Order Info = 870 870 871 871 ... ... @@ -882,34 +882,27 @@ 882 882 * (% style="color:red" %)**US915**(%%): Default frequency band US915 883 883 884 884 885 - 886 - 887 - 888 888 = 9. Packing Info = 889 889 890 890 891 -**Package Includes**: 1064 +(% style="color:#037691" %)**Package Includes**: 892 892 893 893 * TrackerD LoRaWAN GPS/BLE Tracker x 1 894 894 * USB recharge & program cable x 1 895 895 896 -**Dimensions and Weight**: 1069 +(% style="color:#037691" %)**Dimensions and Weight**: 897 897 898 898 * Device Size: 85 x 48 x 15 cm 899 899 * Weight: 50g 900 900 901 901 902 - 903 - 904 904 = 10. Support = 905 905 906 906 907 907 * 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. 908 -* 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]] 1079 +* 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]]. 909 909 910 910 911 - 912 - 913 913 = 11. Reference = 914 914 915 915 ... ... @@ -916,3 +916,5 @@ 916 916 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 917 917 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 918 918 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1088 + 1089 +
- 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