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 ... ... @@ -345,9 +345,11 @@ 345 345 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 346 346 347 347 348 -=== 2.3.5 Add Payload format in TTN V3 === 349 349 350 350 487 +=== 2.4.6 Add Payload format in TTN V3 === 488 + 489 + 351 351 In TTN V3, use can add a custom payload so it shows friendly. 352 352 353 353 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** ... ... @@ -365,12 +365,16 @@ 365 365 366 366 367 367 368 -== 2. 4Integrate with Datacake ==507 +== 2.5 Integrate with Datacake == 369 369 370 370 510 +((( 371 371 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 +))) 372 372 514 +((( 373 373 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 +))) 374 374 375 375 376 376 [[image:1664502695771-538.png]] ... ... @@ -377,12 +377,16 @@ 377 377 378 378 379 379 380 -== 2. 5Integrate with Tago ==523 +== 2.6 Integrate with Tago == 381 381 382 382 526 +((( 383 383 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 +))) 384 384 530 +((( 385 385 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 +))) 386 386 387 387 388 388 [[image:1664502715371-321.png]] ... ... @@ -389,33 +389,59 @@ 389 389 390 390 391 391 392 -== 2. 6Alarm Mode ==539 +== 2.7 Datalog Feature == 393 393 394 394 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 +((( 395 395 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 559 +))) 396 396 397 397 562 +((( 398 398 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 +))) 399 399 400 400 567 +((( 401 401 Two ways to exit alarm mode: 569 +))) 402 402 403 403 * Server send a downlink command to exit. 404 404 * User fast press the RED button 10 times. 405 405 574 +((( 406 406 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 +))) 407 407 408 408 409 409 410 -== 2. 7SportsMode~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--==580 +== 2.9 Transport Mode == 411 411 412 412 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. 413 413 414 -== 2.8 LED Status == 415 415 416 416 417 -(% border="2" style="background-color:#ffffcc; color:green; width:636px" %) 418 -|(% 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** 419 419 |(% 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 420 420 |(% style="width:157px" %)**Join request**|(% style="width:271px" %)(% style="color:green" %)**Green** (%%)led fast blink once (200ms)|(% style="width:202px" %)Yes 421 421 |(% style="width:157px" %)**Join Success**|(% style="width:271px" %)(% style="color:green" %)**Green**(%%) led on 5 second|(% style="width:202px" %)N/A ... ... @@ -430,11 +430,12 @@ 430 430 431 431 432 432 433 -== 2.9 Button Function == 434 434 607 +== 2.11 Button Function == 435 435 436 -(% style="color:green" %)**RESET button:** 437 437 610 +(% style="color:blue" %)**RESET button:** 611 + 438 438 [[image:1664502835802-546.png]] 439 439 440 440 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server. ... ... @@ -445,8 +445,8 @@ 445 445 [[image:1664502854406-763.png]] 446 446 447 447 448 -(% border=" 2" style="background-color:#ffffcc; color:green; width:627px" %)449 -|(% 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** 450 450 |(% 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"]] 451 451 |(% 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 452 452 |(% 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. ... ... @@ -454,10 +454,9 @@ 454 454 455 455 456 456 631 +== 2.12 USB Port Function == 457 457 458 -== 2.10 USB Port Function == 459 459 460 - 461 461 The USB interface of TrackerD has below functions: 462 462 463 463 * Power on the device ... ... @@ -467,8 +467,6 @@ 467 467 468 468 469 469 470 - 471 - 472 472 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 473 473 474 474 ... ... @@ -541,16 +541,16 @@ 541 541 542 542 543 543 544 -=== 3.2.3 Set SportsMode Packet transmission interval ===715 +=== 3.2.3 Set Transport Mode Packet transmission interval === 545 545 546 546 547 -Set sport spacket transmit interval718 +Set Transport Mode packet transmit interval 548 548 549 549 * (% style="color:blue" %)**AT Command:** 550 550 551 551 (% style="color:#037691" %)**AT+MTDC=xx. ** 552 552 553 - 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 554 554 555 555 556 556 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -566,9 +566,6 @@ 566 566 567 567 * (% style="color:blue" %)**AT Command: No AT Command** 568 568 569 - 570 - 571 - 572 572 * (% style="color:blue" %)**Downlink Payload (prefix 0x02):** 573 573 574 574 (% style="color:#037691" %)**0x02 01** (%%) ~/~/ Exit Alarm Mode ... ... @@ -584,7 +584,7 @@ 584 584 585 585 (% style="color:#037691" %)**AT+LON=xx. (Disable (0), Enable (1), default:1)** 586 586 587 - 755 +Example: AT+LON=0 **~-~-> ** Disable LED for position, downlink and uplink. 588 588 589 589 590 590 * (% style="color:blue" %)**Downlink Payload (prefix 0xAE):** ... ... @@ -593,16 +593,16 @@ 593 593 594 594 595 595 596 -=== 3.2.6 Disable/Enable movement detect(Debug Only)===764 +=== 3.2.6 Disable/Enable Transport Mode === 597 597 598 598 599 -User can use this feature to check andet thread holeof movement detect767 +Users can use this feature to enable/disable Transport Mode. 600 600 601 601 * (% style="color:blue" %)**AT Command:** 602 602 603 603 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 604 604 605 - detectmovement.773 +Example: AT+ INTWK =1 **~-~-> ** Enable Transport Mode. 606 606 607 607 608 608 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -614,35 +614,38 @@ 614 614 === 3.2.7 Set Positioning Mode === 615 615 616 616 617 -SMOD define the how TrackerD scan and uplink dat e.785 +SMOD define the how TrackerD scan and uplink data: 618 618 619 -GPS室外定位模式: 设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 620 620 621 - BLE室内定位模式:设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。788 +* (% style="color:blue" %)**AT Command:** 622 622 623 - GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。790 +(% style="color:#037691" %)**AT+SMOD=aa,bb,cc** 624 624 625 - 运动模式:设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。792 +(% style="color:#037691" %)** aa:** 626 626 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. 627 627 798 +(% style="color:#037691" %)**bb:** 628 628 629 -* (% style="color:blue" %)**AT Command:** 800 +* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 801 +* (% style="color:red" %)**1 :**(%%) GPS +BAT State 630 630 631 -(% style="color:#037691" %)** AT+SMOD=xx.**803 +(% style="color:#037691" %)**cc: ** 632 632 805 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 633 633 634 - **Example:** 807 +(% style="color:blue" %)**Example:** 635 635 636 - 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 637 637 638 - AT+ SMOD =1,1 **~-~->** GPS +BAT State 639 639 640 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 641 - 642 - 643 643 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 644 644 645 -(% 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 646 646 647 647 648 648 ... ... @@ -659,7 +659,7 @@ 659 659 660 660 (% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 661 661 662 -Example: AT+FTIME=150 833 +**Example:** AT+FTIME=150 663 663 664 664 665 665 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** ... ... @@ -668,7 +668,7 @@ 668 668 669 669 670 670 671 -=== 3. 3.9 Set PDOP value for GPS fix accuracy ===842 +=== 3.2.9 Set PDOP value for GPS fix accuracy === 672 672 673 673 674 674 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. ... ... @@ -696,7 +696,7 @@ 696 696 697 697 * (% style="color:blue" %)**AT Command:** 698 698 699 -(% style="color:#037691" %)**AT+CFM=xx .**870 +(% style="color:#037691" %)**AT+CFM=xx** 700 700 701 701 702 702 **~ Example:** ... ... @@ -712,6 +712,27 @@ 712 712 713 713 714 714 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 + 715 715 = 4. Setting for Different Scenarios = 716 716 717 717 ... ... @@ -740,11 +740,9 @@ 740 740 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 741 741 742 742 743 -(% 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]] 744 744 745 -[[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]] 746 746 747 - 748 748 (% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 749 749 750 750 ... ... @@ -756,7 +756,7 @@ 756 756 757 757 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 758 758 759 -[[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]] 760 760 761 761 762 762 Users need to use below files: ... ... @@ -785,21 +785,22 @@ 785 785 === 6.1.1 Set up ARDUINO compile environment === 786 786 787 787 788 -* 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]]** 789 789 790 -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]]980 +Install IDE on PC, open and click (% style="color:#037691" %)**File ~-~-> Preference**,(%%) add the following URL: [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]] 791 791 792 792 793 793 [[image:1664503635019-941.png]] 794 794 795 795 796 -(% style="color:#037691" %)* Go to tools ~-~-> Boards ~-~-> Boards Manager,(%%) find the esp32 information and install it. 797 797 987 +* (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 988 + 798 798 [[image:1664503715811-892.png]] 799 799 800 800 801 801 802 -* 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]]** 803 803 804 804 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 805 805 ... ... @@ -811,19 +811,19 @@ 811 811 == 6.2 Source Code == 812 812 813 813 814 -* 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:** 815 815 816 816 [[image:1664503794261-827.png]] 817 817 818 818 819 819 820 -* Click to upload 1011 +* (% style="color:blue" %)**Click to upload** 821 821 822 822 [[image:1664503808294-336.png]] 823 823 824 824 825 825 826 -* 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** 827 827 828 828 [[image:1664503824081-592.png]] [[image:1664503831430-500.png]] 829 829 ... ... @@ -846,8 +846,8 @@ 846 846 847 847 848 848 849 -(% border=" 2" style="background-color:#ffffcc; color:green; width:314px" %)850 -|(% 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** 851 851 |(% style="width:118px" %)A4,B4,A9,B9|(% style="width:67px" %)Red|(% style="width:123px" %)VCC 852 852 |(% style="width:118px" %)A7,B7|(% style="width:67px" %)White|(% style="width:123px" %)D- (N/A) 853 853 |(% style="width:118px" %)A6,B6|(% style="width:67px" %)Green|(% style="width:123px" %)D+(N/A) ... ... @@ -857,6 +857,8 @@ 857 857 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 858 858 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 859 859 1051 + 1052 + 860 860 = 8. Order Info = 861 861 862 862 ... ... @@ -872,25 +872,31 @@ 872 872 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 873 873 * (% style="color:red" %)**US915**(%%): Default frequency band US915 874 874 1068 + 1069 + 875 875 = 9. Packing Info = 876 876 877 877 878 -**Package Includes**: 1073 +(% style="color:#037691" %)**Package Includes**: 879 879 880 880 * TrackerD LoRaWAN GPS/BLE Tracker x 1 881 881 * USB recharge & program cable x 1 882 882 883 -**Dimensions and Weight**: 1078 +(% style="color:#037691" %)**Dimensions and Weight**: 884 884 885 885 * Device Size: 85 x 48 x 15 cm 886 886 * Weight: 50g 887 887 1083 + 1084 + 888 888 = 10. Support = 889 889 890 890 891 891 * 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. 892 -* 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]]. 893 893 1091 + 1092 + 894 894 = 11. Reference = 895 895 896 896 ... ... @@ -897,3 +897,5 @@ 897 897 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 898 898 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 899 899 * [[**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