Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 11 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,13 +7,6 @@ 1 -(% style="text-align:center" %) 2 -[[image:1664505654417-133.png]] 3 - 4 - 5 - 6 - 7 7 (% class="wikigeneratedid" %) 8 8 **Table of Contents:** 9 9 10 -{{toc/}} 11 11 12 12 13 13 ... ... @@ -14,10 +14,9 @@ 14 14 15 15 = 1. Introduction = 16 16 10 +== 1.1 OverView == 17 17 18 -== 1.1 What is TrackerD == 19 19 20 - 21 21 ((( 22 22 TrackerD is an (% style="color:blue" %)**Open Source LoRaWAN Tracker**(%%) based on (% style="color:blue" %)**ESP32 MCU**(%%) and (% style="color:blue" %)**Semtech LoRa Wireless Chip**. 23 23 ))) ... ... @@ -25,14 +25,10 @@ 25 25 ((( 26 26 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. 27 27 28 -((( 29 29 TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution. 30 -))) 31 31 32 -((( 33 33 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. 34 34 ))) 35 -))) 36 36 37 37 ((( 38 38 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. ... ... @@ -46,7 +46,6 @@ 46 46 (% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.** 47 47 48 48 49 - 50 50 == 1.2 Specifications == 51 51 52 52 ... ... @@ -61,11 +61,13 @@ 61 61 * EEPROM: 520 KB 62 62 * Clock Speed: 32Mhz 63 63 51 + 64 64 (% style="color:blue" %)**Common DC Characteristics:** 65 65 66 66 * Supply Voltage: 5V via USB port or Internal li-on battery 67 67 * Operating Temperature: -40 ~~ 60°C 68 68 57 + 69 69 (% style="color:blue" %)**LoRa Spec:** 70 70 71 71 * Frequency Range, ... ... @@ -87,10 +87,12 @@ 87 87 * Packet engine up to 256 bytes with CRC. 88 88 * LoRaWAN 1.0.3 Specification 89 89 79 + 90 90 (% style="color:blue" %)**Battery:** 91 91 92 92 * 1000mA Li-on Battery power (for model TrackerD) 93 93 84 + 94 94 (% style="color:blue" %)**Power Consumption** 95 95 96 96 * Sleeping Mode: 200uA ... ... @@ -97,6 +97,9 @@ 97 97 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 98 98 * Tracking: max: 38mA 99 99 91 + 92 + 93 + 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 100 +* 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,8 @@ 115 115 * Tri-color LED, Alarm button 116 116 * Datalog 117 117 112 + 113 + 118 118 == 1.4 Applications == 119 119 120 120 ... ... @@ -121,9 +121,11 @@ 121 121 * Logistics and Supply Chain Management 122 122 * Human tracking 123 123 124 -= 2.1 Use TrackerD = 125 125 126 126 122 + 123 += 2.1 Use TrackerD = 124 + 127 127 == 2.1 How it works? == 128 128 129 129 ... ... @@ -130,670 +130,490 @@ 130 130 TrackerD is configured as LoRaWAN OTAA Class A GPS tracker by default. It has OTAA keys to join LoRaWAN network. To connect a LoRaWAN network, user need to input the OTAA keys in the LoRaWAN IoT server and push reset button of TrackerD (next to USB port). TrackerD will wake up and auto join the network via OTAA. 131 131 132 132 133 - 134 134 == 2.2 Quick guide to connect to LoRaWAN server == 135 135 133 +Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example. 136 136 137 -Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example. 138 138 136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 139 139 140 -[[image:1664501652064-326.png]] 141 141 142 - 143 - 144 144 The LPS8N is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. What the rest need to is register this device in TTN V3: 145 145 141 +**(% style="color:blue" %)Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD. 146 146 147 -(% style="color:blue" %)**Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD. 148 - 149 149 Each TrackerD is shipped with a sticker with the default device EUI as below: 150 150 145 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]] 151 151 152 -[[image:1664501677253-891.png]] 153 153 154 154 149 + 155 155 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 156 156 157 157 158 - **__Add APP EUI in the application:__**153 +Add APP EUI in the application 159 159 155 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]] 160 160 161 -[[image: 1664501711466-918.png]]157 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] 162 162 163 163 160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]] 164 164 165 -[[image:1664501721248-725.png]] 166 166 167 167 168 - [[image:1664501734705-405.png]]164 +Add APP KEY and DEV EUI 169 169 166 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]] 170 170 171 171 172 -**__Add APP KEY and DEV EUI:__** 173 173 174 174 175 - [[image:1664501784668-703.png]]171 +**(% style="color:blue" %)Step 2**:(%%) Power on TrackerD by using the on board switch. 176 176 177 177 174 +**(% 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. 178 178 179 179 180 -(% style="color:blue" %) **Step 2**:(%%)PoweronTrackerD by usingtheon boardswitch.177 +**(% style="color:blue" %)Positioning Mode(SMOD):** 181 181 179 +* **GPS ONLY(Factory Settings): **only get GPS location info. 180 +* **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking. 181 +* **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking. 182 182 183 - (%style="color:blue"%)**Step 3:**(%%) TrackerDwill autojointothe LoRaWANnetwork. After joinsuccess, TrackerDwill starttoupload messagetoIoT server.183 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 184 184 185 185 186 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 186 186 187 -== 2.3 Positioning Mode(SMOD) == 188 188 189 +=== 2.3.1 Uplink FPORT=5, Device Status === 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 - Userscanswitchmodesby[[changingSMOD>>||anchor="H3.2.7SetPositioningMode"]].193 +=== 2.3.2 Uplink FPORT= , Realtime GNSS Positioning === 197 197 195 +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. ) 198 198 199 199 200 -== 2.4 Uplink Payload == 198 +|((( 199 +**Size** 201 201 201 +**(bytes)** 202 +)))|4|4|2|1|((( 203 +2 202 202 203 -=== 2.4.1 Uplink FPORT~=5, Device Status === 204 - 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. 207 - 208 - 209 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 210 -|=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1 211 -|=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status 212 - 213 -[[image:1665301570342-765.png]] 214 - 215 - 216 -(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002 217 - 218 -(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13 219 - 220 -(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version 221 - 222 -(% style="color:#037691" %)**Frequency Band**: 223 - 224 -*0x01: EU868 225 - 226 -*0x02: US915 227 - 228 -*0x03: IN865 229 - 230 -*0x04: AU915 231 - 232 -*0x05: KZ865 233 - 234 -*0x06: RU864 235 - 236 -*0x07: AS923 237 - 238 -*0x08: AS923-1 239 - 240 -*0x09: AS923-2 241 - 242 -*0x0a: AS923-3 243 - 244 -Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF) 245 - 246 -(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD. 247 - 248 - 249 -(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 250 - 251 -Use can also get the Device Status uplink through the downlink command: 252 - 253 -TrackerD Model:0x40 254 - 255 -(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %) 256 -|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit 257 -|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD 258 - 259 -(% style="color:blue" %)**SMOD:** 260 - 261 -(% style="color:red" %)**1 :** (%%) GPS ONLY 262 - 263 -(% style="color:red" %)**2 :** (%%) BLE ONLY 264 - 265 -(% style="color:red" %)**3 :** (%%) GPS/BLE Hybrid 266 - 267 - 268 -(% style="color:blue" %)**GPS MOD:** 269 - 270 -(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values 271 - 272 -(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values 273 - 274 - 275 -(% style="color:blue" %)**BLE MOD:** 276 - 277 -(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon 278 - 279 -TrackerD Status: 0x02 280 - 281 -(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %) 282 -|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit 283 -|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode 284 - 285 -(% style="color:red" %)**0 : **(%%) Transport Mode 286 - 287 -(% style="color:red" %)**1 : **(%%) AT+LON 288 - 289 -(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable 290 - 291 - 292 - 293 -=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 294 - 295 - 296 -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. 297 - 298 - 299 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 300 -|=(% scope="row" style="width: 50px;" %)((( 301 -**Size(bytes)** 302 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 205 +(optional ) 206 +)))|((( 303 303 2 304 - )))|(% style="width:87px" %)(((305 - 2208 + 209 +(optional) 306 306 ))) 307 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 308 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 309 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 211 +|**Value**|[[Latitude>>path:#Location]]|[[Longitude>>path:#Location]]|((( 212 +[[Alarm &>>path:#Alarm]] 310 310 311 -[[image:1665301636888-168.png]] 214 +[[BAT>>path:#Alarm]] 215 +)))|[[FLAG>>path:#Flag]]|Hum|[[Tem>>path:#Pitch]] 312 312 313 313 314 - ==== (%style="color:blue" %)**Alarm& BAT:**(%%) ====218 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]] 315 315 316 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 317 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 318 -|=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 319 319 320 - ==== (% style="color:blue"%)**FLAG:**(%%) ====221 +**Alarm & BAT:** 321 321 322 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 323 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 324 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 223 +|**Size(bit)**|1 bit|1bit|14 bits 224 +|**Value**|reserve|Alarm Indicate|[[BAT>>path:#BAT]] 325 325 326 -** Example:**Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A226 +**FLAG:** 327 327 228 +|**Size(bit)**|2 bits|1bit|5 bits 229 +|**Value**|[[MOD>>path:#MD]]|[[LON>>path:#LON]]|Firmware version 328 328 329 -==== (% style="color:blue" %)**Location info:**(%%) ==== 330 330 331 -* Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 332 -* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 333 333 334 - (% style="color:red" %)**Importantnote:**233 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 335 335 336 -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. 337 337 338 - 2. In this mode, the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes payload. Inthis case, the payload onserver will be ignore and shows as below:236 +**Location info:** 339 339 238 +* Latitude: 02863D68⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// 340 340 341 - [[image:1664502116362-706.png]]240 +//value = 02863D68 /1000000 = 42.351976// 342 342 242 +* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// 343 343 344 - 3. While GPS can't getlocation info aftertimeout(FTIMEParameter),the latitude and longitude will be filled with all0x00:244 +//value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 345 345 346 -[[image:1664502166010-515.png]] 347 347 247 +Important note: 348 348 249 +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. 250 +1. In firmware version v1.5, Roll & Pitch is disabled by default. 251 +1. 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: 349 349 350 - ==== (%style="color:blue" %)**Alarm:**(%%) ====253 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]] 351 351 352 -Example: 0x4B & 0x40 >> 6 = 0x01 353 353 256 +1. While GPS can’t get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 354 354 355 - ==== (%style="color:blue" %)**BAT:**(%%) ====258 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]] 356 356 357 -Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 260 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 261 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 358 358 359 -((( 360 -The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ 361 -))) 263 +The battery info shows the current voltage, for **TrackerD** version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \ 362 362 363 -* > 4.0v : 80% ~~ 100% 364 -* 3.85v ~~3.99v: 60% ~~ 80% 365 -* 3.70v ~~ 3.84v: 40% ~~ 60% 366 -* 3.40v ~~ 3.69v: 20% ~~ 40% 367 -* < 3.39v: 0~~20% 368 368 369 -==== (% style="color:blue" %)**LON:**(%%) ==== 266 +* > 4.0v : 80% ~~ 100% 267 +* 3.85v ~~3.99v: 60% ~~ 80% 268 +* 3.70v ~~ 3.84v: 40% ~~ 60% 269 +* 3.40v ~~ 3.69v: 20% ~~ 40% 270 +* < 3.39v: 0~~20% 370 370 371 -Enable/Disable LED activity for uplink 372 372 373 -((( 374 -0x00: Disable LED indicator. 375 -))) 273 +* **LON: **Enable/Disable LED activity for uplink 376 376 377 -((( 378 -0x01: Enable LED indicator (Default Value) 379 -))) 275 +0x00: Disable LED indicator. 380 380 277 +0x01: Enable LED indicator (Default Value) 381 381 382 -==== (% style="color:blue" %)**Hum:**(%%) ==== 383 383 384 -0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 280 +* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 281 +* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 385 385 386 386 387 -==== (% style="color:blue" %)**Tem:**(%%) ==== 388 388 389 - 011A=if (0x011A & 0x8000=1):value=(0x011A-0x10000)/10(dec)⇒ -//28.2 degree//285 +=== 2.3.3 Uplink FPORT= , History GNSS Positioning === 390 390 391 391 392 392 393 -=== 2. 4.3UplinkFPORT~=3,Realtime GNSS Positioning(Default Mode) ===289 +=== 2.3.4 BLE positioning Payload(Fport=2) === 394 394 291 +Different MODE has different payload: 395 395 396 - 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)293 +**MODE=2** 397 397 295 +|((( 296 +**Size** 398 398 399 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 400 -|=(% scope="row" style="width: 50px;" %)((( 401 -**Size(bytes)** 402 -)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1 403 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 404 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 405 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] 298 +**(bytes)** 299 +)))|16|4|4|2|4|2|1 300 +|**Value**|[[UUID>>path:#Location]]|((( 301 +iBeacon 406 406 407 -(% class="wikigeneratedid" %) 408 -[[image:1665301687277-443.png]] 303 +MAJOR 304 +)))|((( 305 +iBeacon 409 409 307 +MINOR 308 +)))|((( 309 +iBeacon Measured 410 410 311 +Power 312 +)))|((( 313 +iBeacon 411 411 412 -=== 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 315 +RSSI 316 +)))|((( 317 +[[Alarm &>>path:#Alarm]] 413 413 319 +[[BAT>>path:#Alarm]] 320 +)))|[[FLAG>>path:#Flag]] 414 414 415 -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. 416 416 323 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]] 417 417 418 -(% style="color:red" %)**Note for this mode:** 419 419 420 -* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 421 -* 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. 326 +* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 327 +* **MODE: **Define the payload format. 328 +* **UUID: **The uuid from the strongest iBeacon. 329 +* **MAJOR**: The MAJOR from the strongest iBeacon. 330 +* **MINOR**: The MAJOR from the strongest iBeacon. 331 +* **Measured** **Power**: The Measured Power from the strongest iBeacon. 332 +* **RSSI**: The RSSI from the strongest iBeacon. 422 422 423 -The payload is 15 bytes, as below. 424 424 425 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 426 -|=(% scope="row" %)((( 427 -**Size(bytes)** 428 -)))|4|4|2|1|1|1|1|1 429 -|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen 430 430 431 - [[image:image-20221009160309-2.png]]336 +=== 2.3.5 Add Payload format in TTN V3 === 432 432 433 - 434 - 435 -=== 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 436 - 437 - 438 -(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 439 -|=(% scope="row" style="width: 60px;" %)((( 440 -**Size(bytes)** 441 -)))|(% 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 442 -|=(% style="width: 50px;" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 443 -iBeacon MAJOR 444 -)))|(% style="width:63px" %)((( 445 -iBeacon MINOR 446 -)))|(% style="width:71px" %)((( 447 -iBeacon Measured Power 448 -)))|(% style="width:50px" %)((( 449 -iBeacon RSSI 450 -)))|(% style="width:47px" %)((( 451 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 452 -)))|(% style="width:15px" %)[[FLAG>>||anchor="HFLAG:"]] 453 - 454 -[[image:1664502425687-834.png]] 455 - 456 - 457 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 458 -* (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 459 -* (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 460 -* (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. 461 -* (% style="color:#037691" %)**MINOR:** (%%)The MAJOR from the strongest iBeacon. 462 -* (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 463 -* (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 464 - 465 -=== 2.4.6 Add Payload format in TTN V3 === 466 - 467 - 468 468 In TTN V3, use can add a custom payload so it shows friendly. 469 469 470 -In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**340 +In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 471 471 342 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]] 472 472 473 -[[image:1664502649601-895.png]] 474 - 475 - 476 476 Add the decoder from this link: 477 477 478 478 479 479 Save the change the uplink message will be parsed. As below: 480 480 481 -[[image: 1664502676891-606.png]]349 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]] 482 482 483 483 484 484 485 -== 2.5 Integrate with Datacake == 486 486 487 487 488 -((( 489 -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. 490 -))) 355 +== 2.4 Integrate with Datacake == 491 491 492 -((( 493 -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]] 494 -))) 495 495 358 +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. 496 496 497 -[[image: 1664502695771-538.png]]360 +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]] 498 498 362 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] 499 499 500 500 501 -== 2. 6Integrate with Tago ==365 +== 2.5 Integrate with Tago == 502 502 503 503 504 -((( 505 505 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. 506 -))) 507 507 508 -((( 509 509 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]] 510 -))) 511 511 372 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]] 512 512 513 -[[image:1664502715371-321.png]] 514 514 515 515 516 516 517 -== 2. 7DatalogFeature ==377 +== 2.6 Alarm Mode == 518 518 519 519 520 - total273entries,bydefault disable380 +User can push the **RED button** by more than 5 seconds to enter Alarm Mode. 521 521 522 522 523 -E xample use case.383 +Once enter Alarm mode, the **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. 524 524 525 -[[image:image-20221009234703-2.png||height="328" width="899"]] 526 526 527 - 528 -[[image:image-20221009234629-1.png||height="390" width="577"]] 529 - 530 - 531 - 532 -== 2.8 Alarm Mode == 533 - 534 - 535 -((( 536 -User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 537 -))) 538 - 539 - 540 -((( 541 -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. 542 -))) 543 - 544 - 545 -((( 546 546 Two ways to exit alarm mode: 547 -))) 548 548 549 549 * Server send a downlink command to exit. 550 550 * User fast press the RED button 10 times. 551 551 552 -((( 553 -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. 554 -))) 391 +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. 555 555 556 556 394 +== 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- == 557 557 558 -== 2.9 Transport Mode == 559 559 560 560 561 - InTransportMode,TrackerDwill check ifthere is motion. If there is no motion, device will senduplinksevery 20 minutes. If there is motion, device will send uplink every 5 minutes.398 +== 2.8 LED Status == 562 562 563 563 401 +|**Event**|**Action**|**AT+LON to control on/off** 402 +|**Power On**|**BLUE, RED , Green** flash once|N/A 403 +|**Join request**|**Green** led fast blink once (200ms)|Yes 404 +|**Join Success**|**Green** led on 5 second|N/A 405 +|**Fixing Location**|**BLUE **blinks 200ms per second|Yes 406 +|**Fixed and uplink**|**GREEN **blinks twice (200ms per blink)|Yes 407 +|**Fail Fix and uplink**|**RED **blinks twice (200ms per blink)|Yes 408 +|**Enter Alarm mode**|**RED **on for 3 seconds|Yes 409 +|**Uplink under Alarm**|**RED **on for 1 second|Yes 410 +|**Exit Alarm**|**BLUE **led on 5 second|Yes 411 +|**Get Downlink**|**GREEN** led on 1 second|Yes 412 +|**Movement Detect**|**RED **on 500ms|N/A 564 564 565 -== 2.10 LED Status == 566 566 567 567 568 -(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 569 -|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 570 -|(% 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 571 -|(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes 572 -|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A 573 -|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)blinks 200ms per second|(% style="width:202px" %)Yes 574 -|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)(% style="color:green" %)**GREEN ***(%%)***blinks twice (200ms per blink)**|(% style="width:202px" %)Yes 575 -|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)blinks twice (200ms per blink)|(% style="width:202px" %)Yes 576 -|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 3 seconds|(% style="width:202px" %)Yes 577 -|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)on for 1 second|(% style="width:202px" %)Yes 578 -|(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)(% style="color:blue" %)**BLUE **(%%)led on 5 second|(% style="width:202px" %)Yes 579 -|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 580 -|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 581 581 582 -== 2.11 Button Function == 583 583 418 +== 2.9 Button Function == 584 584 585 - (% style="color:blue" %)**RESET button:**420 +**RESET button:** 586 586 587 -[[image: 1664502835802-546.png]]422 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] 588 588 589 589 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server. 590 590 591 591 592 - (% style="color:red" %)**RED button:**427 +**RED button:** 593 593 594 -[[image: 1664502854406-763.png]]429 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]] 595 595 431 +|**Function**|**Action**|**Description** 432 +|Send Alarm|Keep Pressing **RED** button for more than 5 seconds|Enter Alarm Mode. See [[Alarm Mode>>path:#Alarm_Mode]] 433 +|Exit Alarm Mode|Fast press the **RED** button 10 times|Exit Alarm Mode 434 +|Enter Deep Sleep Mode|Press and hold the button for 10 seconds, then quickly press the device 3 times to enter deep sleep|This is the mode ship out from factory. CPU will be complete in sleep mode and no LoRa activity, only use before deploy. 596 596 597 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 598 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 599 -|(% 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"]] 600 -|(% 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 601 -|(% 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. 602 602 603 -== 2.12 USB Port Function == 604 604 605 605 439 +== 2.10 USB Port Function == 440 + 606 606 The USB interface of TrackerD has below functions: 607 607 608 608 * Power on the device 609 609 * Recharge the battery 610 -* [[Configure Device>> ||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]]611 -* [[Upgrade Firmware>> ||anchor="H5.UploadFirmware"]]445 +* [[Configure Device>>path:#AT_Command]] 446 +* [[Upgrade Firmware>>path:#upgrade_image]] 612 612 613 -= 3. Configure TrackerD via AT command or LoRaWAN downlink = 614 614 615 615 616 -User can configure TrackerD via AT Command or LoRaWAN Downlink. 617 617 618 -LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]] 619 619 452 += 3. Configure TrackerD via AT command or LoRaWAN downlink = 620 620 621 621 622 - ==3.1AccessAT Command==455 +User can configure TrackerD via AT Command or LoRaWAN Downlink. 623 623 457 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]] 624 624 625 -TrackerD supports the AT command set in stock firmware. User can connect to TrackerD with TYPE-C cable to use AT commands as shown below. 626 626 460 +== 3.1 Access AT Command == 627 627 628 - [[image:1664502999401-486.png]]462 +TrackerD supports the AT command set in stock firmware. User can connect to TrackerD with TYPE-C cable to use AT commands as shown below. ... 629 629 464 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]] 630 630 631 -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: 632 632 467 +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: 633 633 634 -[[image:1664503022490-662.png]] 635 635 470 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]] 636 636 637 637 638 -[[image:1664503035713-500.png]] 639 639 474 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]] 640 640 476 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]] 641 641 642 -[[image:1664503047675-651.png]] 643 643 644 - 645 - 646 646 == 3.2 Command Set == 647 647 648 648 649 649 === 3.2.1 Set Transmit Interval === 650 650 651 - 652 652 Set device uplink interval. 653 653 654 -* (% style="color:blue" %)**AT Command:**486 +* AT Command: 655 655 656 - (% style="color:#037691" %)**AT+TDC=xxx**488 +AT+TDC=xxx 657 657 658 -Example: 490 +Example: AT+TDC=300000. Means set interval to 5 minutes(300 seconds) 659 659 660 660 661 -* (% style="color:blue" %)**Downlink Payload (prefix 0x01):**493 +* Downlink Payload (prefix 0x01): 662 662 663 - (% style="color:#037691" %)**0x01 00 01 2C**(%%)~/~/495 +0x01 00 01 2C ~/~/ Same as AT+TDC=300000 664 664 665 665 666 - 667 667 === 3.2.2 Set Alarm Packet transmission interval === 668 668 669 - 670 670 Set alarm packet transmit interval 671 671 672 -* (% style="color:blue" %)**AT Command:**502 +* AT Command: 673 673 674 - (% style="color:#037691" %)**AT+ATDC=xx.**504 +AT+ATDC=xx. 675 675 676 -Example: **~-~-> **Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000506 +Example: AT+ATDC=60000 à Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000 677 677 678 678 679 -* (% style="color:blue" %)**Downlink Payload (prefix 0xB1):**509 +* Downlink Payload (prefix 0xB1): 680 680 681 - (% style="color:#037691" %)**0xB1 00 00 3C** (%%)~/~/511 +0xB1 00 00 3C ~/~/Same as AT+ATDC=60000 682 682 683 683 514 +=== 3.3.3 Set Sports Mode Packet transmission interval === 684 684 685 - === 3.2.3SetTransportMode Packet transmissioninterval===516 +Set sports packet transmit interval 686 686 518 +* AT Command: 687 687 688 - SetTransportModepacket transmit interval520 +AT+MTDC=xx. 689 689 690 - *(%style="color:blue"%)**ATCommand:**522 + Example: AT+MTDC=300000 à Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 691 691 692 -(% style="color:#037691" %)**AT+MTDC=xx. ** 693 693 694 - Example: AT+MTDC=300000**~-~->** Set Transport Mode Packet Intervalto 300 seconds. TrackerDwill send every300 secondsin Transport mode, DefaultValue: 300000525 +* Downlink Payload (prefix 0x03): 695 695 527 +0x03 00 01 2C ~/~/Same as AT+ MTDC=3000000 696 696 697 -* (% style="color:blue" %)**Downlink Payload (prefix 0x03):** 698 698 699 -(% style="color:#037691" %)**0x03 00 01 2C** (%%) ~/~/ Same as AT+ MTDC=3000000 700 700 531 +=== 3.3.4 Exit Alarm === 701 701 702 - 703 -=== 3.2.4 Exit Alarm === 704 - 705 - 706 706 Server send downlink command to exit Alarm mode 707 707 708 -* (% style="color:blue" %)**AT Command:No AT Command**535 +* AT Command: 709 709 710 - * (% style="color:blue"%)**DownlinkPayload(prefix 0x02):**537 +No AT Command 711 711 712 -(% style="color:#037691" %)**0x02 01** (%%) ~/~/ Exit Alarm Mode 713 713 540 +* Downlink Payload (prefix 0x02): 714 714 542 +0x02 01 ~/~/ Exit Alarm Mode 715 715 716 -=== 3.2.5 Disable/Enable LED flash === 717 717 545 +=== 3.3.5 Disable/Enable LED flash === 718 718 719 719 Disable/Enable LED for position, downlink and uplink 720 720 721 -* (% style="color:blue" %)**AT Command:**549 +* AT Command: 722 722 723 - (% style="color:#037691" %)**AT+LON=xx. (Disable (0), Enable (1), default:1)**551 +AT+LON=xx. (Disable (0), Enable (1), default:1) 724 724 725 -Example: AT+LON=0 **~-~-> **Disable LED for position, downlink and uplink.553 + Example: AT+LON=0 à Disable LED for position, downlink and uplink. 726 726 727 727 728 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAE):**556 +* Downlink Payload (prefix 0xAE): 729 729 730 - (% style="color:#037691" %)**0xAE 00** (%%)~/~/558 +0xAE 00 ~/~/Same as AT+LON=0 731 731 732 732 733 733 734 -=== 3.2.6 Disable/Enable Transport Mode === 735 735 563 +=== 3.3.6 Disable/Enable movement detect (Debug Only) === 736 736 737 -User scan use this feature to enable/disableTransportMode.565 +User can use this feature to check and set thread hole of movement detect 738 738 739 -* (% style="color:blue" %)**AT Command:**567 +* AT Command: 740 740 741 - (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)**569 +AT+INTWK=xx. (Disable (0), Enable (1), default:0) 742 742 743 -Example: **~-~-> **EnableTransportMode.571 + Example: AT+ INTWK =1 à Enable detect movement. 744 744 745 745 746 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAF):**574 +* Downlink Payload (prefix 0xAF): 747 747 748 - (% style="color:#037691" %)**0xAF 01** (%%)~/~/576 +0xAF 01 ~/~/Same as AT+ INTWK =1 749 749 750 750 751 751 752 -=== 3. 2.7 Set Positioning Mode ===580 +=== 3.3.7 Set Positioning Mode === 753 753 582 +SMOD define the how TrackerD scan and uplink date. 754 754 755 -S MODdefine the how TrackerD scan and uplinkdata:584 +GPS室外定位模式:设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 756 756 586 + BLE室内定位模式:设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。 757 757 758 - *(%style="color:blue"%)**ATCommand:**588 + GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。 759 759 760 - (% style="color:#037691" %)**AT+SMOD=aa,bb**590 +运动模式:设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。 761 761 762 -(% style="color:#037691" %)** aa:** 763 763 764 -* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 765 -* (% style="color:#037691" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 766 -* (% style="color:#037691" %)**3: GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning 767 767 768 -(% style="color:#037691" %)**bb:** 769 769 770 - (% style="color:#037691" %)**ifaa = 1:**595 +* AT Command: 771 771 772 -* (% style="color:#037691" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 773 -* (% style="color:#037691" %)**1 :**(%%) GPS +BAT State 597 +AT+SMOD=xx. 774 774 775 - (%style="color:#037691" %)** if aa = 2: **599 + Example: 776 776 777 - *(%style="color:#037691" %)**3 : **(%%)(iBeacon)UUID+ Major+Minor+Power+Rssi+BAT+State601 + AT+ SMOD =1,0 à GPS+ BAT+ State+Tem&Hum 778 778 779 - **Example:**603 + AT+ SMOD =1,1 à GPS +BAT State 780 780 781 - AT+ SMOD = 1,0**~-~->**GPS++Tem&Hum605 + AT+ SMOD =2,3 à (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 782 782 783 - AT+ SMOD =1,1 **~-~->** GPS +BAT State 784 784 785 - AT+ SMOD =2,3**~-~->**(iBeacon)UUID+Major+ Minor+Power+Rssi+BAT+State608 +* Downlink Payload (prefix 0xA5): 786 786 610 +0xA5 01 00 ~/~/ Same as AT+ SMOD =1,0 787 787 788 -* (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 789 789 790 - (% style="color:#037691"%)**0xA501 00** (%%) ~/~/SameasAT+SMOD=1,0613 +=== 3.3.8 Set MAX GPS position time === 791 791 792 - 793 - 794 -=== 3.2.8 Set MAX GPS position time === 795 - 796 - 797 797 Set max positioning time, default is 150 seconds. TrackerD will try to get location info within this period. If fail to get position data within this time, TrackerD will use 000000 for latitude and longitude. 798 798 799 799 ... ... @@ -800,60 +800,60 @@ 800 800 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. 801 801 802 802 803 -* (% style="color:blue" %)**AT Command:**621 +* AT Command: 804 804 805 - (% style="color:#037691" %)**AT+FTIME=xx**(%%)**~-~-> **Set to use xx as max fix time.623 +AT+FTIME=xx à Set to use xx as max fix time. 806 806 807 -Example: 625 +Example: AT+FTIME=150 808 808 809 809 810 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAA):**628 +* Downlink Payload (prefix 0xAA): 811 811 812 - (% style="color:#037691" %)**0xAA 00 96** (%%)~/~/630 +0xAA 00 96 ~/~/Set AT+FTIME=150 813 813 814 814 815 815 816 -=== 3.2.9 Set PDOP value for GPS fix accuracy === 817 817 635 +=== 3.3.9 Set PDOP value for GPS fix accuracy === 818 818 819 -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.637 +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. 820 820 821 821 822 822 A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0 823 823 824 824 825 -* (% style="color:blue" %)**AT Command:**643 +* AT Command: 826 826 827 - (% style="color:#037691" %)**AT+PDOP=2.5** (%%) **~-~->**Set PDOP to 2.5645 +AT+PDOP=2.5 à Set PDOP to 2.5 828 828 829 829 830 -* (% style="color:blue" %)**Downlink Payload (prefix 0xAD):**648 +* Downlink Payload (prefix 0xAD): 831 831 832 - (% style="color:#037691" %)**0xAD 00 0A**(%%)~/~/650 +0xAD 00 0A ~/~/Set AT+PDOP=1 (0x0A / 10 =1) 833 833 834 - (% style="color:#037691" %)**0xAD 00 19**(%%)~/~/652 +0xAD 00 19 ~/~/Set AT+PDOP=2.5 (0x19 / 10 =2.5) 835 835 836 - (% style="color:#037691" %)**0xAD 00 46**(%%)654 +0xAD 00 46 ~/~/Set AT+PDOP=7 (0x46 / 10 =7) 837 837 656 +Disable/Enable the confirmation mode 838 838 658 +* AT Command: 839 839 840 - Disable/Enablethe confirmation mode660 +AT+CFM=xx. 841 841 842 - *(% style="color:blue" %)**AT Command:**662 + Example: 843 843 844 - (%style="color:#037691"%)**AT+CFM=xx.**664 + AT+ CFM=0 à Disable confirmation 845 845 666 + AT+ CFM=1 à Enable confirmation 846 846 847 -**~ Example:** 848 848 849 - AT+ CFM=0**~-~->**Disable confirmation669 +* Downlink Payload (prefix 0x05): 850 850 851 - AT+ CFM=1**~-~->** Enableconfirmation671 +0x05 01 ~/~/ Same as AT+ SMOD =1 852 852 853 853 854 -* (% style="color:blue" %)**Downlink Payload (prefix 0x05):** 855 855 856 -(% style="color:#037691" %)**0x05 01 **(%%) ~/~/ Same as AT+ SMOD =1 857 857 858 858 859 859 ... ... @@ -866,42 +866,38 @@ 866 866 867 867 == 5.1 Firmware Change Log == 868 868 869 - 870 870 **[[See this link>>url:https://github.com/dragino/TrackerD]]** 871 871 872 872 873 - 874 874 == 5.2 How to upgrade firmware == 875 875 692 +User can use the TrackerD ’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below: 876 876 877 -User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below: 878 878 695 +**(% style="color:blue" %)Step1: **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD. 879 879 880 -(% style="color:blue" %) **Step1:ConnectTrackerDand PCvia USB cableshippedwithTrackerD.697 +**(% style="color:blue" %)Step2:** (%%) Install CH9102 driver in the PC. 881 881 882 - 883 -(% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC. 884 - 885 885 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 886 886 887 887 888 -(% 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]]702 +**(% style="color:blue" %)Step3:**(%%) Download and Install Flash Tool: 889 889 704 +[[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]] 890 890 891 -(% style="color:blue" %) **Step4:**706 +**(% style="color:blue" %)Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 892 892 893 893 894 -[[image: 1664503563660-578.png]]709 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png||alt="image-20220712083115-1.png"]] 895 895 711 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png||alt="image-20220712083115-2.png"]] 896 896 897 -[[image:1664503574618-659.png]] 898 898 714 +**(% style="color:blue" %)Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 899 899 900 - (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format),comportnder SPI configure.Clink Start.Bin file location:716 +[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 901 901 902 -[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] 903 903 904 - 905 905 Users need to use below files: 906 906 907 907 boot_app0.bin @0e000 ... ... @@ -908,17 +908,16 @@ 908 908 909 909 ESP_LORA-eeprom-class.bin @ 0x10000 910 910 725 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png||alt="image-20220712083115-3.png"]] 911 911 912 - [[image:1664503593459-435.png]]727 +After upgrade finish, it will show finish as below: 913 913 729 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png||alt="image-20220712083115-4.png"]] 914 914 915 915 916 -After upgrade finish, it will show finish as below: 917 917 918 -[[image:1664503611848-385.png]] 919 919 920 920 921 - 922 922 = 6. Developer Guide = 923 923 924 924 ... ... @@ -928,48 +928,49 @@ 928 928 === 6.1.1 Set up ARDUINO compile environment === 929 929 930 930 931 -* **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]]**744 +* Download the latest Arduino software (IDE) from the Arduino official website 932 932 933 - 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]]746 +[[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]] 934 934 748 +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]] 935 935 936 -[[image: 1664503635019-941.png]]750 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]] 937 937 752 +* Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 938 938 754 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]] 939 939 940 -* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 941 941 942 - [[image:1664503715811-892.png]]757 +* Download the latest TrackerD from the dragino github 943 943 759 +[[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 944 944 945 945 946 - ***DownloadthelatestTrackerDfrom thedraginogithub: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]**762 +Put the Library in the TrackerD directory into the libraries file in the Arduino directory 947 947 948 - Put the Libraryin theTrackerDdirectory intothelibraries filein the Arduino directory:764 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]] 949 949 950 950 951 -[[image:1664503752288-974.png]] 952 952 953 953 954 - 955 955 == 6.2 Source Code == 956 956 957 957 958 -* (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:**772 +* Open the example in the TrackerD file, please select the correct port in the IDE, as shown below: 959 959 960 -[[image: 1664503794261-827.png]]774 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]] 961 961 776 +* Click to upload 962 962 778 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]] 963 963 964 -* (%style="color:blue"%)**Clicktoupload**780 +* Check the result, if the upload is successful, as shown below, open the serial port to view the data 965 965 966 -[[image:1664503808294-336.png]] 967 967 783 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]] 968 968 969 969 970 -* (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data** 971 971 972 -[[image:1664503824081-592.png]] [[image:1664503831430-500.png]] 973 973 974 974 975 975 ... ... @@ -976,10 +976,11 @@ 976 976 = 7. FAQ = 977 977 978 978 793 + 979 979 == 7.1 How to change the LoRa Frequency Bands/Region? == 980 980 981 981 982 -User can follow the introduction for [[how to upgrade image>> ||anchor="H5.UploadFirmware"]]. When download the images, choose the required image file for download.797 +User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download. 983 983 984 984 985 985 ... ... @@ -990,8 +990,8 @@ 990 990 991 991 992 992 993 -(% border=" 1.5"cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %)994 -| =(% style="width:;" %)**Pin**|=(% style="width:;" %)**Color**|=(% style="width:;" %)**USB Pin**808 +(% border="2" style="background-color:#ffffcc; color:green; width:314px" %) 809 +|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin** 995 995 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC 996 996 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A) 997 997 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A) ... ... @@ -1009,6 +1009,7 @@ 1009 1009 (% style="color:blue" %)**XXX**(%%): The default frequency band 1010 1010 1011 1011 * (% style="color:red" %)**EU433**(%%): Default frequency band EU433 827 +* (% style="color:red" %)**CN470**(%%): Default frequency band CN470 1012 1012 * (% style="color:red" %)**EU868**(%%): Default frequency band EU868 1013 1013 * (% style="color:red" %)**IN865**(%%): Default frequency band IN865 1014 1014 * (% style="color:red" %)**KR920**(%%): Default frequency band KR920 ... ... @@ -1016,25 +1016,33 @@ 1016 1016 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 1017 1017 * (% style="color:red" %)**US915**(%%): Default frequency band US915 1018 1018 835 + 1019 1019 = 9. Packing Info = 1020 1020 1021 1021 1022 - (% style="color:#037691" %)**Package Includes**:839 +**Package Includes**: 1023 1023 1024 -* TrackerD LoRaWAN GPS/BLE Tracker x 1 1025 -* USB recharge & program cable x 1 841 +* TrackerD x 1 842 +* Rechargeable cable x 1 843 +* Program Cable x 1 1026 1026 1027 - (% style="color:#037691" %)**Dimensions and Weight**:845 +**Dimensions and Weight**: 1028 1028 1029 -* Device Size: 85 x 48 x 15 cm1030 -* Weight: 5 0g847 +* Device Size: 85 x 48 x 15 mm/pcs 848 +* Weight: 55g/pcs 1031 1031 1032 -= 10. Support = 1033 1033 1034 1034 852 += 10. Support = 853 + 1035 1035 * 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. 1036 -* 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]].855 +* 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 1037 1037 857 +[[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]] 858 + 859 + 860 + 861 + 1038 1038 = 11. Reference = 1039 1039 1040 1040 ... ... @@ -1041,5 +1041,3 @@ 1041 1041 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1042 1042 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1043 1043 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1044 - 1045 -
- 1664505654417-133.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.5 KB - Content
- 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