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, 10 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -25,10 +25,14 @@ 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 +((( 28 28 TrackerD is program friendly. Developers can use Arduino IDE to customize the software of TrackerD to fit their IoT solution. 30 +))) 29 29 32 +((( 30 30 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. 31 31 ))) 35 +))) 32 32 33 33 ((( 34 34 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. ... ... @@ -93,6 +93,8 @@ 93 93 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 94 94 * Tracking: max: 38mA 95 95 100 + 101 + 96 96 == 1.3 Features == 97 97 98 98 ... ... @@ -99,7 +99,7 @@ 99 99 * LoRaWAN 1.0.3 Class A 100 100 * ESP32 PICO D4 101 101 * SX1276/78 Wireless Chip 102 -* 108 +* Arduino IDE Compatible 103 103 * Open source hardware / software 104 104 * Regular/ Real-time GPS,BLE,WIFI tracking 105 105 * Built-in3 axis accelerometer (LIS3DH) ... ... @@ -111,6 +111,8 @@ 111 111 * Tri-color LED, Alarm button 112 112 * Datalog 113 113 120 + 121 + 114 114 == 1.4 Applications == 115 115 116 116 ... ... @@ -117,6 +117,8 @@ 117 117 * Logistics and Supply Chain Management 118 118 * Human tracking 119 119 128 + 129 + 120 120 = 2.1 Use TrackerD = 121 121 122 122 ... ... @@ -179,66 +179,152 @@ 179 179 (% 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. 180 180 181 181 182 -(% style="color:blue" %)**Positioning Mode(SMOD):** 183 183 184 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get GPS location info. 185 -* (% style="color:#037691" %)**BLE ONLY: **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking. 186 -* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking. 193 +== 2.3 Positioning Mode(SMOD) == 187 187 188 -User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 189 189 196 +Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 190 190 198 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 199 +* (% style="color:#037691" %)**BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 200 +* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 191 191 192 - ==2.3UplinkPayload==202 +Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 193 193 194 194 195 -=== 2.3.1 Uplink FPORT~=5, Device Status === 196 196 206 +== 2.4 Uplink Payload == 197 197 198 198 199 -=== 2. 3.2Uplink FPORT~=RealtimeGNSS Positioning===209 +=== 2.4.1 Uplink FPORT~=5, Device Status === 200 200 201 201 202 - 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.)212 +Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours. 203 203 204 204 205 -(% border=" 2" style="background-color:#ffffcc; color:green; width:537px" %)206 -|(% style="width: 69px" %)(((207 -** Size**215 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 216 +|=(% 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 217 +|=(% 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 208 208 209 -**(bytes)** 210 -)))|(% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)((( 211 -2 219 +[[image:1665301570342-765.png]] 212 212 213 -(optional ) 214 -)))|(% style="width:83px" %)((( 215 -2 216 216 217 -(optional) 222 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002 223 + 224 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13 225 + 226 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version 227 + 228 +(% style="color:#037691" %)**Frequency Band**: 229 + 230 +*0x01: EU868 231 + 232 +*0x02: US915 233 + 234 +*0x03: IN865 235 + 236 +*0x04: AU915 237 + 238 +*0x05: KZ865 239 + 240 +*0x06: RU864 241 + 242 +*0x07: AS923 243 + 244 +*0x08: AS923-1 245 + 246 +*0x09: AS923-2 247 + 248 +*0x0a: AS923-3 249 + 250 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF) 251 + 252 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD. 253 + 254 + 255 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 256 + 257 +Use can also get the Device Status uplink through the downlink command: 258 + 259 +TrackerD Model:0x40 260 + 261 +(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %) 262 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit 263 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD 264 + 265 +(% style="color:blue" %)**SMOD:** 266 + 267 +(% style="color:red" %)**1 :** (%%) GPS ONLY 268 + 269 +(% style="color:red" %)**2 :** (%%) BLE ONLY 270 + 271 +(% style="color:red" %)**3 :** (%%) GPS/BLE Hybrid 272 + 273 + 274 +(% style="color:blue" %)**GPS MOD:** 275 + 276 +(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values 277 + 278 +(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values 279 + 280 + 281 +(% style="color:blue" %)**BLE MOD:** 282 + 283 +(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon 284 + 285 +TrackerD Status: 0x02 286 + 287 +(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %) 288 +|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit 289 +|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode 290 + 291 +(% style="color:red" %)**0 : **(%%) Transport Mode 292 + 293 +(% style="color:red" %)**1 : **(%%) AT+LON 294 + 295 +(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable 296 + 297 + 298 + 299 +=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 300 + 301 + 302 +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. 303 + 304 + 305 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 306 +|=(% scope="row" style="width: 50px;" %)((( 307 +**Size(bytes)** 308 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:73px" %)1|(% style="width:40px" %)((( 309 +2 310 +)))|(% style="width:87px" %)((( 311 +2 218 218 ))) 219 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 313 +|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 220 220 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 221 -)))|(% style="width: 52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]]315 +)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 222 222 223 -[[image:166 4501958445-288.png]]317 +[[image:1665301636888-168.png]] 224 224 225 225 226 -==== (% style="color:blue" %)Alarm & BAT:(%%) ==== 320 +==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== 227 227 228 -(% border="2" style="background-color:#ffffcc; color:green; width: 329px" %)229 -|(% style="width: 72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14230 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 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" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 324 +|=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 231 231 232 -==== (% style="color:blue" %)FLAG:(%%) ==== 233 233 234 -(% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 235 -|(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 236 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 237 237 328 +==== (% style="color:blue" %)**FLAG:**(%%) ==== 329 + 330 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 331 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 332 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 333 + 238 238 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 239 239 240 240 241 -==== (% style="color:blue" %)Location info:(%%) ==== 337 +==== (% style="color:blue" %)**Location info:**(%%) ==== 242 242 243 243 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 244 244 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// ... ... @@ -247,35 +247,31 @@ 247 247 248 248 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. 249 249 250 -2. In firmwareversionv1.5,Roll&Pitchdisabled bydefault.346 +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: 251 251 252 -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: 253 253 254 - 255 255 [[image:1664502116362-706.png]] 256 256 257 257 352 +3. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 258 258 259 -4. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 260 - 261 261 [[image:1664502166010-515.png]] 262 262 263 263 264 264 265 -==== (% style="color:blue" %)Alarm:(%%) ==== 358 +==== (% style="color:blue" %)**Alarm:**(%%) ==== 266 266 267 - 268 268 Example: 0x4B & 0x40 >> 6 = 0x01 269 269 270 270 271 -==== (% style="color:blue" %)BAT:(%%) ==== 363 +==== (% style="color:blue" %)**BAT:**(%%) ==== 272 272 273 - 274 274 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 275 275 276 -The battery info shows the current voltage, for (% style="color:blue" %)**TrackerD**(%%) version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \ 367 +((( 368 +The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ 369 +))) 277 277 278 - 279 279 * > 4.0v : 80% ~~ 100% 280 280 * 3.85v ~~3.99v: 60% ~~ 80% 281 281 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -282,46 +282,91 @@ 282 282 * 3.40v ~~ 3.69v: 20% ~~ 40% 283 283 * < 3.39v: 0~~20% 284 284 285 -==== (% style="color:blue" %)LON:(%%) ==== 286 286 287 - 378 + 379 +==== (% style="color:blue" %)**MOD:**(%%) ==== 380 + 381 +Set the format of GPS data uplink link 382 + 383 +0x00: Enable uploading on-board Temperature and humidity values 384 + 385 +0x01: Disable uploading on-board Temperature and humidity values 386 + 387 + 388 +==== (% style="color:blue" %)**LON:**(%%) ==== 389 + 288 288 Enable/Disable LED activity for uplink 289 289 392 +((( 290 290 0x00: Disable LED indicator. 394 +))) 291 291 396 +((( 292 292 0x01: Enable LED indicator (Default Value) 398 +))) 293 293 294 294 295 -==== (% style="color:blue" %)Hum:(%%) ==== 401 +==== (% style="color:blue" %)**Hum:**(%%) ==== 296 296 297 297 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 298 298 299 299 300 -==== (% style="color:blue" %)Tem:(%%) ==== 406 +==== (% style="color:blue" %)**Tem:**(%%) ==== 301 301 302 302 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 303 303 304 304 305 305 412 +=== 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 306 306 307 -=== 2.3.3 Uplink FPORT~= , History GNSS Positioning === 308 308 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) 309 309 310 310 311 -=== 2.3.4 BLE positioning Payload(Fport2) === 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:"]] 312 312 426 +(% class="wikigeneratedid" %) 427 +[[image:1665301687277-443.png]] 313 313 314 -Different MODE has different payload: 315 315 316 -**MODE=2** 317 317 318 -(% border="2" style="background-color:#ffffcc; color:green; width:491px" %) 319 -|(% style="width:70px" %)((( 320 -**Size** 431 +=== 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 321 321 322 -**(bytes)** 323 -)))|(% style="width:44px" %)16|(% style="width:61px" %)4|(% style="width:63px" %)4|(% style="width:71px" %)2|(% style="width:50px" %)4|(% style="width:47px" %)2|(% style="width:15px" %)1 324 -|(% style="width:70px" %)**Value**|(% style="width:44px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:61px" %)((( 433 + 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. 435 + 436 + 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" %)((( 325 325 iBeacon MAJOR 326 326 )))|(% style="width:63px" %)((( 327 327 iBeacon MINOR ... ... @@ -344,9 +344,12 @@ 344 344 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 345 345 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 346 346 347 -=== 2.3.5 Add Payload format in TTN V3 === 348 348 349 349 486 + 487 +=== 2.4.6 Add Payload format in TTN V3 === 488 + 489 + 350 350 In TTN V3, use can add a custom payload so it shows friendly. 351 351 352 352 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** ... ... @@ -364,12 +364,16 @@ 364 364 365 365 366 366 367 -== 2. 4Integrate with Datacake ==507 +== 2.5 Integrate with Datacake == 368 368 369 369 510 +((( 370 370 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. 512 +))) 371 371 514 +((( 372 372 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]] 516 +))) 373 373 374 374 375 375 [[image:1664502695771-538.png]] ... ... @@ -376,12 +376,16 @@ 376 376 377 377 378 378 379 -== 2. 5Integrate with Tago ==523 +== 2.6 Integrate with Tago == 380 380 381 381 526 +((( 382 382 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. 528 +))) 383 383 530 +((( 384 384 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]] 532 +))) 385 385 386 386 387 387 [[image:1664502715371-321.png]] ... ... @@ -388,33 +388,59 @@ 388 388 389 389 390 390 391 -== 2. 6Alarm Mode ==539 +== 2.7 Datalog Feature == 392 392 393 393 542 +total 273 entries,by default disable 543 + 544 + 545 +Example use case. 546 + 547 +[[image:image-20221009234703-2.png||height="328" width="899"]] 548 + 549 + 550 +[[image:image-20221009234629-1.png||height="390" width="577"]] 551 + 552 + 553 + 554 +== 2.8 Alarm Mode == 555 + 556 + 557 +((( 394 394 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 559 +))) 395 395 396 396 562 +((( 397 397 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. 564 +))) 398 398 399 399 567 +((( 400 400 Two ways to exit alarm mode: 569 +))) 401 401 402 402 * Server send a downlink command to exit. 403 403 * User fast press the RED button 10 times. 404 404 574 +((( 405 405 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. 576 +))) 406 406 407 407 408 408 409 -== 2. 7SportsMode~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--==580 +== 2.9 Transport Mode == 410 410 411 411 583 +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. 412 412 413 -== 2.8 LED Status == 414 414 415 415 416 -(% border="2" style="background-color:#ffffcc; color:green; width:636px" %) 417 -|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off** 587 +== 2.10 LED Status == 588 + 589 + 590 +(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 591 +|=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 418 418 |(% 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 419 419 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes 420 420 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A ... ... @@ -428,11 +428,13 @@ 428 428 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 429 429 430 430 431 -== 2.9 Button Function == 432 432 433 433 434 - (%style="color:green"%)**RESET button:**607 +== 2.11 Button Function == 435 435 609 + 610 +(% style="color:blue" %)**RESET button:** 611 + 436 436 [[image:1664502835802-546.png]] 437 437 438 438 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server. ... ... @@ -443,8 +443,8 @@ 443 443 [[image:1664502854406-763.png]] 444 444 445 445 446 -(% border=" 2" style="background-color:#ffffcc; color:green; width:627px" %)447 -|(% style="width:1 35px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description**622 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 623 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 448 448 |(% 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"]] 449 449 |(% 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 450 450 |(% 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. ... ... @@ -452,7 +452,7 @@ 452 452 453 453 454 454 455 -== 2.1 0USB Port Function ==631 +== 2.12 USB Port Function == 456 456 457 457 458 458 The USB interface of TrackerD has below functions: ... ... @@ -464,7 +464,6 @@ 464 464 465 465 466 466 467 - 468 468 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 469 469 470 470 ... ... @@ -537,16 +537,16 @@ 537 537 538 538 539 539 540 -=== 3.2.3 Set SportsMode Packet transmission interval ===715 +=== 3.2.3 Set Transport Mode Packet transmission interval === 541 541 542 542 543 -Set sport spacket transmit interval718 +Set Transport Mode packet transmit interval 544 544 545 545 * (% style="color:blue" %)**AT Command:** 546 546 547 547 (% style="color:#037691" %)**AT+MTDC=xx. ** 548 548 549 - SportsMode Packet Interval to 300 seconds. TrackerD will send every 300 seconds inSportsmode, Default Value: 300000724 +Example: AT+MTDC=300000 **~-~-> ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Transport mode, Default Value: 300000 550 550 551 551 552 552 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -562,8 +562,6 @@ 562 562 563 563 * (% style="color:blue" %)**AT Command: No AT Command** 564 564 565 - 566 - 567 567 * (% style="color:blue" %)**Downlink Payload (prefix 0x02):** 568 568 569 569 (% style="color:#037691" %)**0x02 01** (%%) ~/~/ Exit Alarm Mode ... ... @@ -579,7 +579,7 @@ 579 579 580 580 (% style="color:#037691" %)**AT+LON=xx. (Disable (0), Enable (1), default:1)** 581 581 582 - 755 +Example: AT+LON=0 **~-~-> ** Disable LED for position, downlink and uplink. 583 583 584 584 585 585 * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):** ... ... @@ -588,16 +588,16 @@ 588 588 589 589 590 590 591 -=== 3.2.6 Disable/Enable movement detect(Debug Only)===764 +=== 3.2.6 Disable/Enable Transport Mode === 592 592 593 593 594 -User can use this feature to check andet thread holeof movement detect767 +Users can use this feature to enable/disable Transport Mode. 595 595 596 596 * (% style="color:blue" %)**AT Command:** 597 597 598 598 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 599 599 600 - detectmovement.773 +Example: AT+ INTWK =1 **~-~-> ** Enable Transport Mode. 601 601 602 602 603 603 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -609,35 +609,38 @@ 609 609 === 3.2.7 Set Positioning Mode === 610 610 611 611 612 -SMOD define the how TrackerD scan and uplink dat e.785 +SMOD define the how TrackerD scan and uplink data: 613 613 614 -GPS室外定位模式: 设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 615 615 616 - BLE室内定位模式:设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。788 +* (% style="color:blue" %)**AT Command:** 617 617 618 - GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。790 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc** 619 619 620 - 运动模式:设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。792 +(% style="color:#037691" %)** aa:** 621 621 794 +* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 795 +* (% style="color:red" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 796 +* (% 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. 622 622 798 +(% style="color:#037691" %)**bb:** 623 623 624 -* (% style="color:blue" %)**AT Command:** 800 +* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 801 +* (% style="color:red" %)**1 :**(%%) GPS +BAT State 625 625 626 -(% style="color:#037691" %)** AT+SMOD=xx.**803 +(% style="color:#037691" %)**cc: ** 627 627 805 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 628 628 629 - **Example:** 807 +(% style="color:blue" %)**Example:** 630 630 631 - AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum 809 + AT+ SMOD =1,0 ,0 ~-~-> GPS+ BAT+ State+Tem&Hum 810 + AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 811 + AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 632 632 633 - AT+ SMOD =1,1 **~-~->** GPS +BAT State 634 634 635 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 636 - 637 - 638 638 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 639 639 640 -(% style="color:#037691" %)**0xA5 01 00** (%%) ~/~/ Same as AT+ SMOD =1,0 816 +(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ SMOD =1,0,0 641 641 642 642 643 643 ... ... @@ -654,7 +654,7 @@ 654 654 655 655 (% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 656 656 657 -Example: AT+FTIME=150 833 +**Example:** AT+FTIME=150 658 658 659 659 660 660 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** ... ... @@ -663,7 +663,7 @@ 663 663 664 664 665 665 666 -=== 3. 3.9 Set PDOP value for GPS fix accuracy ===842 +=== 3.2.9 Set PDOP value for GPS fix accuracy === 667 667 668 668 669 669 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. ... ... @@ -691,7 +691,7 @@ 691 691 692 692 * (% style="color:blue" %)**AT Command:** 693 693 694 -(% style="color:#037691" %)**AT+CFM=xx .**870 +(% style="color:#037691" %)**AT+CFM=xx** 695 695 696 696 697 697 **~ Example:** ... ... @@ -707,6 +707,27 @@ 707 707 708 708 709 709 886 +=== 3.2.10 Auto Send None-ACK messages === 887 + 888 + 889 +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. 890 + 891 + 892 +* (% style="color:blue" %)**AT Command: AT+PNACKMD** 893 + 894 +The default factory setting is 0. 895 + 896 + 897 +**Command Example Function Response:** 898 + 899 +(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 900 + 901 + 902 +* (% style="color:blue" %)**Downlink Command: 0x34** 903 + 904 +Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 905 + 906 + 710 710 = 4. Setting for Different Scenarios = 711 711 712 712 ... ... @@ -735,11 +735,9 @@ 735 735 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 736 736 737 737 738 -(% style="color:blue" %)**Step3 :**(%%)935 +(% style="color:blue" %)**Step3: **(%%)Download and Install Flash Tool: [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]] 739 739 740 -[[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]] 741 741 742 - 743 743 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 744 744 745 745 ... ... @@ -751,7 +751,7 @@ 751 751 752 752 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 753 753 754 -[[https:~~/~~/ www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]949 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] 755 755 756 756 757 757 Users need to use below files: ... ... @@ -780,7 +780,7 @@ 780 780 === 6.1.1 Set up ARDUINO compile environment === 781 781 782 782 783 -* 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]] 978 +* **Download the latest Arduino software (IDE) from the Arduino official website: [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]** 784 784 785 785 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]] 786 786 ... ... @@ -788,13 +788,14 @@ 788 788 [[image:1664503635019-941.png]] 789 789 790 790 791 -(% style="color:#037691" %)* Go to tools ~-~-> Boards ~-~-> Boards Manager,(%%) find the esp32 information and install it. 792 792 987 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 988 + 793 793 [[image:1664503715811-892.png]] 794 794 795 795 796 796 797 -* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 993 +* **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 798 798 799 799 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 800 800 ... ... @@ -806,19 +806,19 @@ 806 806 == 6.2 Source Code == 807 807 808 808 809 -* Open the example in the TrackerD file, please select the correct port in the IDE, as shown below: 1005 +* (% style="color:blue" %)**Open the example in the TrackerD file, please select the correct port in the IDE, as shown below:** 810 810 811 811 [[image:1664503794261-827.png]] 812 812 813 813 814 814 815 -* Click to upload 1011 +* (% style="color:blue" %)**Click to upload** 816 816 817 817 [[image:1664503808294-336.png]] 818 818 819 819 820 820 821 -* Check the result, if the upload is successful, as shown below, open the serial port to view the data 1017 +* (% style="color:blue" %)**Check the result, if the upload is successful, as shown below, open the serial port to view the data** 822 822 823 823 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]] 824 824 ... ... @@ -841,8 +841,8 @@ 841 841 842 842 843 843 844 -(% border=" 2" style="background-color:#ffffcc; color:green; width:314px" %)845 -|(% style="width:118px" %)**Pin**|(% style="width:67px" %)**Color**|(% style="width:123px" %)**USB Pin** 1040 +(% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:314px" %) 1041 +|=(% style="width: 118px;" %)**Pin**|=(% style="width: 67px;" %)**Color**|=(% style="width: 123px;" %)**USB Pin** 846 846 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC 847 847 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A) 848 848 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A) ... ... @@ -852,6 +852,8 @@ 852 852 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 853 853 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 854 854 1051 + 1052 + 855 855 = 8. Order Info = 856 856 857 857 ... ... @@ -867,25 +867,31 @@ 867 867 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 868 868 * (% style="color:red" %)**US915**(%%): Default frequency band US915 869 869 1068 + 1069 + 870 870 = 9. Packing Info = 871 871 872 872 873 -**Package Includes**: 1073 +(% style="color:#037691" %)**Package Includes**: 874 874 875 875 * TrackerD LoRaWAN GPS/BLE Tracker x 1 876 876 * USB recharge & program cable x 1 877 877 878 -**Dimensions and Weight**: 1078 +(% style="color:#037691" %)**Dimensions and Weight**: 879 879 880 880 * Device Size: 85 x 48 x 15 cm 881 881 * Weight: 50g 882 882 1083 + 1084 + 883 883 = 10. Support = 884 884 885 885 886 886 * 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. 887 -* 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]] 1089 +* 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]]. 888 888 1091 + 1092 + 889 889 = 11. Reference = 890 890 891 891 ... ... @@ -892,3 +892,5 @@ 892 892 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 893 893 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 894 894 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1099 + 1100 +
- 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