Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 99.1
edited by Bei Jinggeng
on 2022/11/03 08:49
on 2022/11/03 08:49
Change comment:
There is no comment for this version
To version 54.1
edited by Edwin Chen
on 2022/10/06 18:13
on 2022/10/06 18:13
Change comment:
Uploaded new attachment "image-20221006181357-2.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 17 removed)
- 1665301570342-765.png
- 1665301636888-168.png
- 1665301687277-443.png
- 1665301786397-168.png
- 1667288597595-714.png
- image-20221009160220-1.png
- image-20221009160309-2.png
- image-20221009234629-1.png
- image-20221009234703-2.png
- image-20221024105643-1.png
- image-20221024105643-2.png
- image-20221102140621-1.png
- image-20221102140638-2.png
- image-20221102140704-3.png
- image-20221102140712-4.png
- image-20221102140748-5.png
- image-20221102140801-6.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Bei1 +XWiki.Edwin - Content
-
... ... @@ -186,131 +186,42 @@ 186 186 (% 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. 187 187 188 188 189 += 2.3 Positioning Mode(SMOD) = 189 189 190 -== 2.3 Positioning Mode(SMOD) == 191 +* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get GPS location info. 192 +* (% style="color:#037691" %)**BLE ONLY: **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking. 193 +* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking. 191 191 195 +User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 192 192 193 -Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 194 194 195 -* (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 196 -* (% style="color:#037691" %)**BLE or WiFi ONLY: **(%%)** **Only obtain iBeacon info via BLE and uplink or obtain wifi ssid info via WiFi and uplink. Design for Indoor tracking. 197 -* (% style="color:#037691" %)**GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking. Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning. 198 198 199 - Userscanswitchmodes by [[changingSMOD>>||anchor="H3.2.7SetPositioningMode"]].199 +== 2.3 Uplink Payload == 200 200 201 201 202 +=== 2.3.1 Uplink FPORT~=5, Device Status === 202 202 203 -== 2.4 Uplink Payload == 204 204 205 205 206 -=== 2. 4.1Uplink FPORT~=5,Device Status ===206 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 207 207 208 208 209 - Uplink the deviceconfigureswithFPORT=5.OnceTrackerDJoinedthenetwork, itwilluplinkthismessage totheserver.Afterthe firstuplink,TrackerDwilluplink DeviceStatusevery12hours.209 +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. ) 210 210 211 -Use can also get the Device Status uplink through the downlink command: **Downlink: 0x2301** 212 212 213 - 214 -(% border="1.5" style="background-color:#ffffcc; color:green; width:440px" %) 215 -|=(% style="width: 60px;" %)**Size(bytes)**|=(% style="width: 70px;" %)**1**|=(% style="width: 70px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 50px;" %)**1**|=(% style="width: 30px;" %)2|=(% style="width: 40px;" %)**2**|=(% style="width: 40px;" %)1 216 -|=(% 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 217 - 218 -[[image:1665301570342-765.png]] 219 - 220 - 221 -(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002 222 - 223 -(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13 224 - 225 -(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version 226 - 227 -(% style="color:#037691" %)**Frequency Band**: 228 - 229 -*0x01: EU868 230 - 231 -*0x02: US915 232 - 233 -*0x03: IN865 234 - 235 -*0x04: AU915 236 - 237 -*0x05: KZ865 238 - 239 -*0x06: RU864 240 - 241 -*0x07: AS923 242 - 243 -*0x08: AS923-1 244 - 245 -*0x09: AS923-2 246 - 247 -*0x0a: AS923-3 248 - 249 -Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF) 250 - 251 -(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD. 252 - 253 - 254 -(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 255 - 256 -Use can also get the Device Status uplink through the downlink command: 257 - 258 - 259 -(% style="color:#037691" %)**SMOD Field (total 1 byte)**(%%):0x40 260 - 261 -(% border="1.5" style="background-color:#ffffcc; color:green; width:270px" %) 262 -|=(% scope="row" style="width: 60px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:80px" %)2bit|(% style="width:80px" %)4bit 263 -|=(% style="width: 75px;" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:104px" %)GPS_Settings|(% style="width:103px" %)BLE_Settings 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: Define how to send GPS payload** 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_Settings:** 282 - 283 -(% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 284 - 285 -(% style="color:red" %)** 2:** (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%) 286 - 287 - 288 -(% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 289 - 290 -(% border="1.5" style="background-color:#ffffcc; color:green; width:260px" %) 291 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)5 Bits|(% style="width:60px" %)1 Bit|(% style="width:20px" %)1 Bit|(% style="width:80px" %)1 Bit 292 -|=(% style="width: 77px;" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:92px" %)[[PNACKMD>>||anchor="H2.4.4A0UplinkFPORT3D42CHistoryGNSSPositioning"]]|(% style="width:48px" %)[[LON>>||anchor="H3.2.5Disable2FEnableLEDflash"]]|(% style="width:126px" %)[[Transport Mode>>||anchor="H2.9TransportMode"]] 293 - 294 - 295 -=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 296 - 297 - 298 -Users can use **AT+SMOD=1,0,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, 299 - 300 - 301 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:320px" %) 302 -|=(% scope="row" style="width: 60px;" %)((( 212 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 213 +|=(% scope="row" style="width: 50px;" %)((( 303 303 **Size(bytes)** 304 -)))|(% style="width: 50px" %)4|(% style="width:50px" %)4|(% style="width:70px" %)2|(% style="width:30px" %)1|(% style="width:30px" %)(((305 -2 306 -)))|(% style="width: 30px" %)(((307 -2 215 +)))|(% style="width:60px" %)4|(% style="width:70px" %)4|(% style="width:80px" %)2|(% style="width:50px" %)1|(% style="width:88px" %)((( 216 +2(optional) 217 +)))|(% style="width:87px" %)((( 218 +2(optional) 308 308 ))) 309 309 |=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 310 310 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 311 -)))|(% style="width: 73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]]222 +)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 312 312 313 -[[image:1665 301636888-168.png]]224 +[[image:1664501958445-288.png]] 314 314 315 315 316 316 ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== ... ... @@ -321,9 +321,9 @@ 321 321 322 322 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 323 323 324 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width: 120px" %)325 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width: 30px" %)2bits|(% style="width:30px" %)1bit326 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 235 +(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 236 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit|(% style="width:100px" %)5 bits 237 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]]|(% style="width:140px" %)Firmware version 327 327 328 328 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 329 329 ... ... @@ -333,18 +333,22 @@ 333 333 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 334 334 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 335 335 247 + 336 336 (% style="color:red" %)**Important note:** 337 337 338 338 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. 339 339 340 -2. In thismode, the total payloadwill be15 bytes, whileUS915/AU915DR0 acceptsonly 11 bytes payload.Inthiscase, the payloadon server willbeignore andshows as below:252 +2. In firmware version v1.5, Roll & Pitch is disabled by default. 341 341 254 +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: 342 342 256 + 343 343 [[image:1664502116362-706.png]] 344 344 345 345 346 -3. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 347 347 261 +4. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 262 + 348 348 [[image:1664502166010-515.png]] 349 349 350 350 ... ... @@ -351,15 +351,15 @@ 351 351 352 352 ==== (% style="color:blue" %)**Alarm:**(%%) ==== 353 353 354 - **Example:**0x4B & 0x40 >> 6 = 0x01269 +Example: 0x4B & 0x40 >> 6 = 0x01 355 355 356 356 357 357 ==== (% style="color:blue" %)**BAT:**(%%) ==== 358 358 359 - **Example:**0x4B45& 0x3FFF ⇒ 2885(mV).274 +Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 360 360 361 361 ((( 362 -The battery info shows the battery voltage,User can usethebelow mapping to indicate the battery in percentage: \277 +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: \ 363 363 ))) 364 364 365 365 * > 4.0v : 80% ~~ 100% ... ... @@ -369,33 +369,17 @@ 369 369 * < 3.39v: 0~~20% 370 370 371 371 372 -==== (% style="color:blue" %)**MOD:**(%%) ==== 373 - 374 -**Example: ** (0x60>>6) & 0x3f =1 375 - 376 -**Set the format of GPS data uplink link:** 377 - 378 -(% style="color:#037691" %)**0x00:** (%%) Enable uploading on-board Temperature and humidity values 379 -(% style="color:#037691" %)**0x01: ** (%%) Disable uploading on-board Temperature and humidity values 380 - 381 - 382 -**Set the format of BLE data uplink link:** 383 - 384 -(% style="color:#037691" %)**0x01: ** (%%) BLE Positioning with Strongest iBeacon 385 - 386 - 387 387 ==== (% style="color:blue" %)**LON:**(%%) ==== 388 388 389 -**Example:** (0x60>>5) & 0x01=1. 390 390 391 391 Enable/Disable LED activity for uplink 392 392 393 393 ((( 394 - (% style="color:#037691" %)**0x00:**(%%)Disable LED indicator.293 +0x00: Disable LED indicator. 395 395 ))) 396 396 397 397 ((( 398 - (% style="color:#037691" %)**0x01:**(%%)Enable LED indicator (Default Value)297 +0x01: Enable LED indicator (Default Value) 399 399 ))) 400 400 401 401 ... ... @@ -410,57 +410,15 @@ 410 410 411 411 412 412 413 -=== 2. 4.33,RealtimeGNSS Positioning(Default Mode)===312 +=== 2.3.3 Uplink FPORT~= , History GNSS Positioning === 414 414 415 415 416 -The default uplink payload includes total 11 bytes (**AT+SMOD=1,1,0**). The payload is the first 11 bytes of Uplink FPORT=2, real-time GNSS positioning, (remove the temp and humidity) 417 417 316 +=== 2.3.4 BLE positioning Payload(Fport2) === 418 418 419 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:300px" %) 420 -|=(% scope="row" style="width: 60px;" %)((( 421 -**Size(bytes)** 422 -)))|(% style="width:60px" %)4|(% style="width:60px" %)4|(% style="width:60px" %)2|(% style="width:50px" %)1 423 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 424 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 425 -)))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] 426 426 427 -(% class="wikigeneratedid" %) 428 -[[image:1665301687277-443.png]] 319 +Different MODE has different payload: (% style="color:blue" %)**MODE=2** 429 429 430 - 431 - 432 -=== 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 433 - 434 - 435 -Set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-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. 436 - 437 - 438 -(% style="color:red" %)**Note for this mode:** 439 - 440 -* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 441 -* 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. 442 -* c) the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes of payload. In this case (DR0 of US915/AU915), the payload on server will show NULL 443 - 444 -The payload is 15 bytes, as below. 445 - 446 -(% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 447 -|=(% scope="row" %)((( 448 -**Size(bytes)** 449 -)))|4|4|2|1|1|1|1|1 450 -|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen 451 - 452 -[[image:image-20221009160309-2.png]] 453 - 454 - 455 - 456 -=== 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 457 - 458 - 459 -TrackerD supports BLE scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **BLE pure** or **GPS/BLE hybrid** so TrackerD will scan BLE iBeacon and find the strongest iBeacon info and uplink. 460 - 461 -User can set **[[BLEMASK>>||anchor="H3.2.11A0SetBLEMASKtofilterBLEiBeacon"]]** so TrackerD will only search the iBeacons which have UUID that match the BLEMASK settings. 462 - 463 - 464 464 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 465 465 |=(% scope="row" style="width: 60px;" %)((( 466 466 **Size(bytes)** ... ... @@ -480,7 +480,7 @@ 480 480 [[image:1664502425687-834.png]] 481 481 482 482 483 -* (% style="color:#037691" %)**BAT: ** (%%) 340 +* (% style="color:#037691" %)**BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 484 484 * (% style="color:#037691" %)**MODE: **(%%)Define the payload format. 485 485 * (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon. 486 486 * (% style="color:#037691" %)**MAJOR:** (%%) The MAJOR from the strongest iBeacon. ... ... @@ -489,34 +489,11 @@ 489 489 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 490 490 491 491 492 -=== 2. 4.6UplinkFPORT~=8,WiFiPositioningwith StrongestWiFiSSID===349 +=== 2.3.5 Add Payload format in TTN V3 === 493 493 494 494 495 - TrackerD supports WiFi scansforindoorpositioning. Usercanset[[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]]to **BLEpure** or **GPS/BLE hybrid**soTrackerD will scan WiFi and findthestrongestWiFi info anduplink.352 +In TTN V3, use can add a custom payload so it shows friendly. 496 496 497 - 498 -(% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %) 499 -|=(% scope="row" style="width: 60px;" %)((( 500 -**Size(bytes)** 501 -)))|(% style="width:60px" %)6|(% style="width:60px" %)4|(% style="width:79px" %)2|(% style="width:66px" %)1 502 -|=(% style="width: 69px;" %)**Value**|(% style="width:76px" %)SSID|(% style="width:87px" %)RSSI|(% style="width:79px" %)((( 503 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 504 -)))|(% style="width:66px" %)[[FLAG>>||anchor="HFLAG:"]] 505 - 506 -(% class="wikigeneratedid" %) 507 -[[image:1667288597595-714.png||height="212" width="1151"]] 508 - 509 - 510 -* (% style="color:#037691" %)**BAT: ** (%%) Ex1:0x4B45 & 0x3FFF ⇒ 3901 (mV). 511 -* (% style="color:#037691" %)**SSID: **(%%)WiFi name. 512 -* (% style="color:#037691" %)**RSSI: **(%%)The RSSI from the strongest WiFi. 513 - 514 - 515 -=== 2.4.7 Add Payload format in TTN V3 === 516 - 517 - 518 -In TTN V3, user can add a custom payload so it shows friendly. 519 - 520 520 In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder** 521 521 522 522 ... ... @@ -523,9 +523,8 @@ 523 523 [[image:1664502649601-895.png]] 524 524 525 525 526 -Add the decoder from this link: 360 +Add the decoder from this link: 527 527 528 -[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD>>https://github.com/dragino/dragino-end-node-decoder/tree/main/TrackerD]] 529 529 530 530 Save the change the uplink message will be parsed. As below: 531 531 ... ... @@ -533,49 +533,41 @@ 533 533 534 534 535 535 536 -== 2. 5Integrate with Datacake ==369 +== 2.4 Integrate with Datacake == 537 537 538 538 372 +((( 539 539 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. 374 +))) 540 540 376 +((( 541 541 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]] 378 +))) 542 542 380 + 543 543 [[image:1664502695771-538.png]] 544 544 545 545 546 546 547 -== 2. 6Integrate with Tago ==385 +== 2.5 Integrate with Tago == 548 548 549 549 550 -After TrackerD sends data to LoRaWAN server such as TTN, user can pass the data to Datacake and plot out, currently only support GPS plot. 388 +((( 389 +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. 390 +))) 551 551 392 +((( 552 552 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]] 394 +))) 553 553 554 554 555 - 556 556 [[image:1664502715371-321.png]] 557 557 558 558 559 559 560 -== 2. 7DatalogFeature ==401 +== 2.6 Alarm Mode == 561 561 562 562 563 -total 273 entries,by default, 564 - 565 -User can set [[PNACKMD=1>>||anchor="H3.2.10A0A0AutoSendNone-ACKmessages"]], to enable Datalog feature. 566 - 567 -Example use case. 568 - 569 -[[image:image-20221009234703-2.png||height="328" width="899"]] 570 - 571 - 572 -[[image:image-20221009234629-1.png||height="390" width="577"]] 573 - 574 - 575 - 576 -== 2.8 Alarm Mode == 577 - 578 - 579 579 ((( 580 580 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 581 581 ))) ... ... @@ -582,7 +582,7 @@ 582 582 583 583 584 584 ((( 585 -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 salert mode.410 +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. 586 586 ))) 587 587 588 588 ... ... @@ -590,7 +590,7 @@ 590 590 Two ways to exit alarm mode: 591 591 ))) 592 592 593 -* Server send sa downlink command to exit.418 +* Server send a downlink command to exit. 594 594 * User fast press the RED button 10 times. 595 595 596 596 ((( ... ... @@ -599,16 +599,13 @@ 599 599 600 600 601 601 602 -== 2. 9Transport Mode ==427 +== 2.7 Sports Mode == 603 603 604 604 605 -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. 606 606 431 +== 2.8 LED Status == 607 607 608 608 609 -== 2.10 LED Status == 610 - 611 - 612 612 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 613 613 |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 614 614 |(% 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 ... ... @@ -624,7 +624,7 @@ 624 624 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 625 625 626 626 627 -== 2. 11Button Function ==449 +== 2.9 Button Function == 628 628 629 629 630 630 (% style="color:blue" %)**RESET button:** ... ... @@ -639,14 +639,14 @@ 639 639 [[image:1664502854406-763.png]] 640 640 641 641 642 -(% border="1" style="background-color:#ffffcc; color:green; width:5 10px" %)643 -|=(% style="width: 100px;" %)**Function**|=(% style="width: 20 5px;" %)**Action**|=(% style="width: 205px;" %)**Description**464 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 465 +|=(% style="width: 100px;" %)**Function**|=(% style="width: 210px;" %)**Action**|=(% style="width: 210px;" %)**Description** 644 644 |(% 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"]] 645 645 |(% 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 646 646 |(% 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. 647 647 648 648 649 -== 2.1 2USB Port Function ==471 +== 2.10 USB Port Function == 650 650 651 651 652 652 The USB interface of TrackerD has below functions: ... ... @@ -681,9 +681,11 @@ 681 681 [[image:1664503022490-662.png]] 682 682 683 683 506 + 684 684 [[image:1664503035713-500.png]] 685 685 686 686 510 + 687 687 [[image:1664503047675-651.png]] 688 688 689 689 ... ... @@ -727,16 +727,16 @@ 727 727 728 728 729 729 730 -=== 3.2.3 Set Transport Mode Packet transmission interval ===554 +=== 3.2.3 Set Sports Mode Packet transmission interval === 731 731 732 732 733 -Set TransportModepacket transmit interval557 +Set sports packet transmit interval 734 734 735 735 * (% style="color:blue" %)**AT Command:** 736 736 737 737 (% style="color:#037691" %)**AT+MTDC=xx. ** 738 738 739 -Example: AT+MTDC=300000 **~-~-> ** Set Transport Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds inTransport mode, Default Value: 300000563 +Example: AT+MTDC=300000 **~-~-> ** Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 740 740 741 741 742 742 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** ... ... @@ -776,16 +776,16 @@ 776 776 777 777 778 778 779 -=== 3.2.6 Disable/Enable TransportMode ===603 +=== 3.2.6 Disable/Enable movement detect (Debug Only) === 780 780 781 781 782 -User scan use this feature to enable/disableTransportMode.606 +User can use this feature to check and set thread hole of movement detect 783 783 784 784 * (% style="color:blue" %)**AT Command:** 785 785 786 786 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 787 787 788 -Example: AT+ INTWK =1 **~-~-> ** Enable TransportMode.612 +Example: AT+ INTWK =1 **~-~-> ** Enable detect movement. 789 789 790 790 791 791 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** ... ... @@ -797,40 +797,35 @@ 797 797 === 3.2.7 Set Positioning Mode === 798 798 799 799 800 -SMOD define how TrackerD scan and uplink dat a:624 +SMOD define the how TrackerD scan and uplink date. 801 801 626 +GPS室外定位模式: 设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 802 802 803 - *(%style="color:blue" %)**AT Command:**628 +BLE室内定位模式: 设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。 804 804 805 - (% style="color:#037691" %)**AT+SMOD=aa,bb,cc**630 +GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。 806 806 807 - (%style="color:#037691" %)** aa:**632 +运动模式: 设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。 808 808 809 -* (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 810 -* (% style="color:red" %)**2: BLE or WiFi ONLY: **(%%)Only obtain iBeacon info via BLE and uplink or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking. 811 -* (% 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. 812 812 813 -(% style="color:#037691" %)**bb:** 814 814 815 -* (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 816 -* (% style="color:red" %)**1 :**(%%) GPS +BAT State 636 +* (% style="color:blue" %)**AT Command:** 817 817 818 -(% style="color:#037691" %)** cc:**638 +(% style="color:#037691" %)**AT+SMOD=xx. ** 819 819 820 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 821 -* (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%)) 822 822 823 - (%style="color:blue" %)**Example:**641 + **Example:** 824 824 825 - AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 826 - AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 827 - AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 828 - AT+ SMOD =2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 643 + AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum 829 829 645 + AT+ SMOD =1,1 **~-~->** GPS +BAT State 830 830 647 + AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 648 + 649 + 831 831 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 832 832 833 -(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ SMOD =1,0,0652 +(% style="color:#037691" %)**0xA5 01 00** (%%) ~/~/ Same as AT+ SMOD =1,0 834 834 835 835 836 836 ... ... @@ -847,7 +847,7 @@ 847 847 848 848 (% style="color:#037691" %)**AT+FTIME=xx** (%%) **~-~-> ** Set to use xx as max fix time. 849 849 850 - **Example:**AT+FTIME=150669 +Example: AT+FTIME=150 851 851 852 852 853 853 * (% style="color:blue" %)**Downlink Payload (prefix 0xAA):** ... ... @@ -856,7 +856,7 @@ 856 856 857 857 858 858 859 -=== 3. 2.9 Set PDOP value for GPS fix accuracy ===678 +=== 3.3.9 Set PDOP value for GPS fix accuracy === 860 860 861 861 862 862 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. ... ... @@ -884,7 +884,7 @@ 884 884 885 885 * (% style="color:blue" %)**AT Command:** 886 886 887 -(% style="color:#037691" %)**AT+CFM=xx** 706 +(% style="color:#037691" %)**AT+CFM=xx. ** 888 888 889 889 890 890 **~ Example:** ... ... @@ -900,79 +900,6 @@ 900 900 901 901 902 902 903 -=== 3.2.10 Auto Send None-ACK messages === 904 - 905 - 906 -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. 907 - 908 - 909 -* (% style="color:blue" %)**AT Command: AT+PNACKMD** 910 - 911 -The default factory setting is 0. 912 - 913 - 914 -**Command Example Function Response:** 915 - 916 -(% style="color:#037691" %)**AT+PNACKMD=1** (%%) ~/~/ Poll None-ACK message OK 917 - 918 - 919 -* (% style="color:blue" %)**Downlink Command: 0x34** 920 - 921 -Example: 0x3401 ~/~/ Same as AT+PNACKMD=1 922 - 923 - 924 - 925 -=== 3.2.11 Set BLEMASK to filter BLE iBeacon === 926 - 927 - 928 -BLEMASK is to filter the unwanted BLE iBeacons during scan. For example, if BLEMASK is 123456. TrackerD will only uplink UUID info which includes 123456. It will ignore all other iBeacons which doesn’t contact 123456 in the UUID. 929 - 930 -(% style="color:red" %)**Note: BLEMASK range is 6 ~~ 10 bytes. If AT+BLEMASK < 6 bytes, BLEMASK will be disabled.** 931 - 932 -(% style="color:blue" %)**AT Command:** 933 - 934 - (% style="color:#037691" %)**AT+BLEMASK=123456** (%%) ~/~/ Set BLEMASK = 123456 935 - 936 - (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 937 - 938 - 939 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 940 - 941 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 942 - 943 - 944 -=== 3.2.12 Set WiFIMASK to filter WiFi SSID === 945 - 946 - 947 -WiFiMASK is to filter the unwanted WiFi SSID during scan. For example, if WiFiMASK is 123456. TrackerD will only uplink SSID info which includes 123456. It will ignore all other WiFi which doesn’t contact 123456 in the SSID. 948 - 949 -(% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.** 950 - 951 -(% style="color:blue" %)**AT Command:** 952 - 953 - (% style="color:#037691" %)**AT+ WiFiMASK =123456** (%%) ~/~/ Set WiFiMASK = 123456 954 - 955 - (% style="color:#037691" %)**AT+ WiFiMASK =0** (%%) ~/~/ disable WiFiMASK 956 - 957 - 958 -(% style="color:blue" %)**Downlink Payload: (Prefix : 0xA5)** 959 - 960 -Example: 0xA5010203040506 ~/~/ Set WiFiMASK to 123456 961 - 962 - 963 -=== 3.2.13 Disable/Enable Information printing(Since firmware 1.4.1) === 964 - 965 - 966 -Users can use this feature to enable/disable Information printing. 967 - 968 -(% style="color:blue" %)**AT Command:** 969 - 970 - 971 -(% style="color:#037691" %)**AT+ SHOWID=XX **(%%) ~/~/(Disable (0), Enable (1), default:0) 972 - 973 -Example: AT+ SHOWID =1 ~-~-> Enable Information printing. 974 - 975 - 976 976 = 4. Setting for Different Scenarios = 977 977 978 978 ... ... @@ -1013,10 +1013,9 @@ 1013 1013 [[image:1664503574618-659.png]] 1014 1014 1015 1015 1016 - 1017 1017 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 1018 1018 1019 -[[https:~~/~~/ github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]]764 +[[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1020 1020 1021 1021 1022 1022 Users need to use below files: ... ... @@ -1053,24 +1053,12 @@ 1053 1053 [[image:1664503635019-941.png]] 1054 1054 1055 1055 1056 - 1057 1057 * (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 1058 1058 1059 1059 [[image:1664503715811-892.png]] 1060 1060 1061 1061 1062 -(% id="cke_bm_4554S" style="display:none" %) (%%)Find the path of SP32 installation, find the file as shown in Figure 1, and change the SPI pin to the shown in Figure 2. 1063 1063 1064 -[[image:image-20221024105643-1.png]] 1065 - 1066 -**~ Figure1** 1067 - 1068 - 1069 -[[image:image-20221024105643-2.png]] 1070 - 1071 - **Figure2** 1072 - 1073 - 1074 1074 * **Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]]** 1075 1075 1076 1076 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: ... ... @@ -1129,54 +1129,8 @@ 1129 1129 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 1130 1130 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 1131 1131 1132 -== 7.3 Notes on using different serial port tools for TrackerD == 1133 1133 1134 1134 1135 -=== **Serial port utility** === 1136 - 1137 - 1138 -Serial port utility requires you to automatically add data streams. 1139 - 1140 -Need to adjust the data stream to RTS/CTS on physical restart. 1141 - 1142 - 1143 -(% class="wikigeneratedid" %) 1144 -[[image:image-20221102140621-1.png]] 1145 - 1146 - 1147 -When using AT commands, the data flow needs to be adjusted to XON/XOFF 1148 - 1149 - 1150 -[[image:image-20221102140638-2.png]] 1151 - 1152 - 1153 - 1154 -=== **SecureCRT** === 1155 - 1156 - 1157 -The default command window of SecureCRT is not displayed. Entering a command requires a complete input of the entire command. You can open the command window in the view. 1158 - 1159 - 1160 -[[image:image-20221102140704-3.png]] 1161 - 1162 - 1163 -[[image:image-20221102140712-4.png]] 1164 - 1165 - 1166 - 1167 -=== **PUTTY** === 1168 - 1169 - 1170 -[[image:image-20221102140748-5.png]] 1171 - 1172 - 1173 -Since putty does not have a command window, you need to fill in the complete command externally, and then copy it to putty.The information copied outside can be pasted by right-clicking the mouse in putty. 1174 - 1175 - 1176 -[[image:image-20221102140801-6.png]] 1177 - 1178 - 1179 - 1180 1180 = 8. Order Info = 1181 1181 1182 1182 ... ... @@ -1203,7 +1203,7 @@ 1203 1203 1204 1204 (% style="color:#037691" %)**Dimensions and Weight**: 1205 1205 1206 -* Device Size: 85 x 48 x 15 m m893 +* Device Size: 85 x 48 x 15 cm 1207 1207 * Weight: 50g 1208 1208 1209 1209 ... ... @@ -1220,3 +1220,5 @@ 1220 1220 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1221 1221 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1222 1222 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 910 + 911 +
- 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
- 1667288597595-714.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.9 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
- image-20221024105643-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -11.3 KB - Content
- image-20221024105643-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.5 KB - Content
- image-20221102140621-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.1 KB - Content
- image-20221102140638-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -40.8 KB - Content
- image-20221102140704-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -15.5 KB - Content
- image-20221102140712-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -73.2 KB - Content
- image-20221102140748-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -56.0 KB - Content
- image-20221102140801-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -21.0 KB - Content