Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 59.2
edited by Edwin Chen
on 2022/10/08 17:55
on 2022/10/08 17:55
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 8 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.Xiaoling - Content
-
... ... @@ -1,5 +3,3 @@ 1 -== == 2 - 3 3 (% style="text-align:center" %) 4 4 [[image:1664505654417-133.png]] 5 5 ... ... @@ -185,8 +185,10 @@ 185 185 (% 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. 186 186 187 187 188 -== 2.3 Positioning Mode(SMOD) == 189 189 187 +== 2.3 Positioning Mode(SMOD) == 188 + 189 + 190 190 Users can set TrackerD to different Positioning Mode for different applications. Below mod are supported. 191 191 192 192 * (% style="color:#037691" %)**GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. ... ... @@ -196,26 +196,31 @@ 196 196 Users can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 197 197 198 198 199 -== 2.3 Uplink Payload == 200 200 200 +== 2.4 Uplink Payload == 201 201 202 -=== 2.3.1 Uplink FPORT~=5, Device Status === 203 203 204 -Uplink the device configures withFPORT=5. Once LGT92 Joined the network,it will uplink this message to the server. After first uplink, LHT52 will uplinkDevice Statusevery 12 hours.203 +=== 2.4.1 Uplink FPORT~=5, Device Status === 205 205 206 -|=(% style="width: 150px;" %)**Size (bytes)**|=(% style="width: 233px;" %)**1**|=(% style="width: 150px;" %)**2**|=(% style="width: 164px;" %)**1**|=(% style="width: 215px;" %)**1**|=(% style="width: 94px;" %)2|=(% style="width: 516px;" %)**2**|=(% style="width: 516px;" %)1 207 -|(% style="width:150px" %)**Value**|(% style="width:233px" %)Sensor Model|(% style="width:150px" %)Firmware Version|(% style="width:164px" %)Frequency Band|(% style="width:215px" %)Sub-band|(% style="width:94px" %)BAT|(% style="width:516px" %)SMOD|(% style="width:516px" %)Status 208 208 209 - [[image:image-20221006181357-2.png]]206 +Uplink the device configures with FPORT=5. Once TrackerD Joined the network, it will uplink this message to the server. After the first uplink, TrackerD will uplink Device Status every 12 hours. 210 210 211 -Example Payload (FPort=5): [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT52%20-%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220621105116-11.png?rev=1.1||alt="image-20220621105116-11.png"]] 212 212 213 -**Sensor Model**: For TrackerD, this value is 0x13. 209 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 210 +|=(% scope="row" style="width: 108px;" %)**Size(bytes)**|=(% style="width: 82px;" %)**1**|=(% style="width: 83px;" %)**2**|=(% style="width: 94px;" %)**1**|=(% style="width: 84px;" %)**1**|=(% style="width: 44px;" %)2|=(% style="width: 63px;" %)**2**|=(% style="width: 60px;" %)1 211 +|=(% style="width: 108px;" %)**Value**|(% style="width:82px" %)Sensor Model|(% style="width:83px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:84px" %)Sub-band|(% style="width:44px" %)BAT|(% style="width:63px" %)SMOD|(% style="width:60px" %)Status 214 214 215 - **FirmwareVersion**:0x0100, Means: v1.0.0 version.213 +[[image:1665301570342-765.png]] 216 216 217 -**Frequency Band**: 218 218 216 +(% style="color:#037691" %)**Example of Device Status:**(%%) 13014001FF0FA24002 217 + 218 +(% style="color:#037691" %)**Sensor Model:** (%%) For TrackerD,this value is 0x13 219 + 220 +(% style="color:#037691" %)**Firmware Version: **(%%) 0x0140,Means:v1.4.0 version 221 + 222 +(% style="color:#037691" %)**Frequency Band**: 223 + 219 219 *0x01: EU868 220 220 221 221 *0x02: US915 ... ... @@ -236,21 +236,61 @@ 236 236 237 237 *0x0a: AS923-3 238 238 239 - **Sub-Band**:CN470,AU915,US915.Others are0x00)244 +Sub- Band:value 0x00~~0x08(only forAU915,US915,Others are 0xFF) 240 240 241 -**BAT** :shows the battery voltage for TrackerD.246 +(% style="color:#037691" %)**BAT:**(%%) shows the battery voltage for TrackerD. 242 242 243 -Ex1: 0x0B3A = 2874mV 244 244 249 +(% style="color:#037691" %)**Ex1:**(%%) 0x0FA2 = 4002mV 250 + 245 245 Use can also get the Device Status uplink through the downlink command: 246 246 253 +TrackerD Model:0x40 247 247 248 -=== 2.3.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 255 +(% border="1.5" style="background-color:#ffffcc; color:green; width:314px" %) 256 +|(% style="width:75px" %)**Size(bit)**|(% style="width:64px" %)2bits|(% style="width:88px" %)2bit|(% style="width:84px" %)4bit 257 +|(% style="width:75px" %)**Value**|(% style="width:64px" %)SMOD|(% style="width:88px" %)GPS_MOD|(% style="width:84px" %)BLE_MOD 249 249 259 +(% style="color:blue" %)**SMOD:** 250 250 251 -( Usercan useAT+SMOD=1,0 toenable uploading on-board Temperatureandhumidity value, and total payload will be15bytes,pleasenote15 bytes won't work on DR0 on US915/AU915frequency band. )261 +(% style="color:red" %)**1 :** (%%) GPS ONLY 252 252 263 +(% style="color:red" %)**2 :** (%%) BLE ONLY 253 253 265 +(% style="color:red" %)**3 :** (%%) GPS/BLE Hybrid 266 + 267 + 268 +(% style="color:blue" %)**GPS MOD:** 269 + 270 +(% style="color:red" %)**0 : ** (%%) Enable uploading on-board Temperature and humidity values 271 + 272 +(% style="color:red" %)**1 :** (%%) Disable uploading on-board Temperature and humidity values 273 + 274 + 275 +(% style="color:blue" %)**BLE MOD:** 276 + 277 +(% style="color:red" %)**1: ** (%%) BLE Positioning with Strongest iBeacon 278 + 279 +TrackerD Status: 0x02 280 + 281 +(% border="1.5" style="background-color:#ffffcc; color:green; width:345px" %) 282 +|(% style="width:77px" %)**Size(bit)**|(% style="width:91px" %)1bits|(% style="width:48px" %)1bit|(% style="width:126px" %)1bit 283 +|(% style="width:77px" %)**Value**|(% style="width:91px" %)PNACKMD|(% style="width:48px" %)LON|(% style="width:126px" %)Transport** **Mode 284 + 285 +(% style="color:red" %)**0 : **(%%) Transport Mode 286 + 287 +(% style="color:red" %)**1 : **(%%) AT+LON 288 + 289 +(% style="color:red" %)**2 : **(%%) Datalog Enable/Disable 290 + 291 + 292 + 293 +=== 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 294 + 295 + 296 +User can use **AT+SMOD=1,0** to enable uploading on-board Temperature and humidity values, and the total payload will be 15 bytes, please note that 15 bytes won't work on DR0 on US915/AU915 frequency band. 297 + 298 + 254 254 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:480px" %) 255 255 |=(% scope="row" style="width: 50px;" %)((( 256 256 **Size(bytes)** ... ... @@ -263,7 +263,7 @@ 263 263 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 264 264 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:40px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:87px" %)[[Tem>>||anchor="HTem:"]] 265 265 266 -[[image:166 4501958445-288.png]]311 +[[image:1665301636888-168.png]] 267 267 268 268 269 269 ==== (% style="color:blue" %)**Alarm & BAT:**(%%) ==== ... ... @@ -275,8 +275,8 @@ 275 275 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 276 276 277 277 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:250px" %) 278 -|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit |(% style="width:100px" %)5 bits279 -|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] |(% style="width:140px" %)Firmware version323 +|=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)2bits|(% style="width:50px" %)1bit 324 +|=(% style="width: 79px;" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H3.2.7SetPositioningMode"]]|(% style="width:47px" %)[[LON>>||anchor="HLON:"]] 280 280 281 281 **Example:** Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A 282 282 ... ... @@ -290,15 +290,14 @@ 290 290 291 291 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. 292 292 293 -2. Whenenable 9-axis motion sensor, 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:338 +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: 294 294 295 295 296 296 [[image:1664502116362-706.png]] 297 297 298 298 344 +3. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 299 299 300 -4. While GPS can't get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 301 - 302 302 [[image:1664502166010-515.png]] 303 303 304 304 ... ... @@ -313,7 +313,7 @@ 313 313 Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 314 314 315 315 ((( 316 -The battery info shows the currentvoltage, for(% style="color:blue"%)**TrackerD**(%%)version which powered byli-on battery.User can use below mapping to indicate the battery in percentage: \360 +The battery info shows the battery voltage, User can use the below mapping to indicate the battery in percentage: \ 317 317 ))) 318 318 319 319 * > 4.0v : 80% ~~ 100% ... ... @@ -345,8 +345,10 @@ 345 345 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 346 346 347 347 348 -=== 2.3.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 349 349 393 +=== 2.4.3 Uplink FPORT~=3, Realtime GNSS Positioning (Default Mode) === 394 + 395 + 350 350 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) 351 351 352 352 ... ... @@ -358,17 +358,37 @@ 358 358 [[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 359 359 )))|(% style="width:73px" %)[[FLAG>>||anchor="HFLAG:"]] 360 360 407 +(% class="wikigeneratedid" %) 408 +[[image:1665301687277-443.png]] 361 361 362 362 363 -=== 2.3. Uplink FPORT~= , History GNSS Positioning === 364 364 412 +=== 2.4.4 Uplink FPORT~=4, History GNSS Positioning === 365 365 366 366 367 - ===2.3.4 BLEpositioningPayload(Fport2)===415 +Set [[PNACKMD=1>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/#H4.13AutoSendNone-ACKmessages]], and TrackerD will wait for ACK for every uplink, when there is no LoRaWAN network, TrackerD will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery. 368 368 369 369 370 - Different MODE has different payload:(% style="color:blue" %)**MODE=2**418 +(% style="color:red" %)**Note for this mode:** 371 371 420 +* a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 421 +* b) TrackerD will send data in (% style="color:blue" %)**CONFIRMED Mode**(%%) when PNACKMD=1, but TrackerD won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink, if TrackerD gets an ACK, TrackerD will consider there is a network connection and resend all NONE-ACK Messages. 422 + 423 +The payload is 15 bytes, as below. 424 + 425 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 426 +|=(% scope="row" %)((( 427 +**Size(bytes)** 428 +)))|4|4|2|1|1|1|1|1 429 +|=**Value**|Latitude|Longitude|Year|Month|Day|Hous|Min|Sen 430 + 431 +[[image:image-20221009160309-2.png]] 432 + 433 + 434 + 435 +=== 2.4.5 Uplink FPORT~=6, BLE Positioning with Strongest iBeacon === 436 + 437 + 372 372 (% border="1.5" cellspacing="3" style="background-color:#ffffcc; color:green; width:450px" %) 373 373 |=(% scope="row" style="width: 60px;" %)((( 374 374 **Size(bytes)** ... ... @@ -396,7 +396,7 @@ 396 396 * (% style="color:#037691" %)**Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 397 397 * (% style="color:#037691" %)**RSSI: ** (%%) The RSSI from the strongest iBeacon. 398 398 399 -=== 2. 3.5465 +=== 2.4.6 Add Payload format in TTN V3 === 400 400 401 401 402 402 In TTN V3, use can add a custom payload so it shows friendly. ... ... @@ -416,7 +416,7 @@ 416 416 417 417 418 418 419 -== 2. 4Integrate with Datacake ==485 +== 2.5 Integrate with Datacake == 420 420 421 421 422 422 ((( ... ... @@ -432,7 +432,7 @@ 432 432 433 433 434 434 435 -== 2. 5Integrate with Tago ==501 +== 2.6 Integrate with Tago == 436 436 437 437 438 438 ((( ... ... @@ -448,12 +448,24 @@ 448 448 449 449 450 450 451 -== 2. 6Datalog Feature ==517 +== 2.7 Datalog Feature == 452 452 453 453 454 - ==2.6AlarmMode==520 +total 273 entries,by default disable 455 455 456 456 523 +Example use case. 524 + 525 +[[image:image-20221009234703-2.png||height="328" width="899"]] 526 + 527 + 528 +[[image:image-20221009234629-1.png||height="390" width="577"]] 529 + 530 + 531 + 532 +== 2.8 Alarm Mode == 533 + 534 + 457 457 ((( 458 458 User can push the (% style="color:red" %)**RED button**(%%) by more than 5 seconds to enter Alarm Mode. 459 459 ))) ... ... @@ -477,15 +477,16 @@ 477 477 478 478 479 479 480 -== 2. 7Transport Mode ==558 +== 2.9 Transport Mode == 481 481 482 482 483 483 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. 484 484 485 485 486 -== 2.8 LED Status == 487 487 565 +== 2.10 LED Status == 488 488 567 + 489 489 (% border="1.5" style="background-color:#ffffcc; color:green; width:500px" %) 490 490 |=(% style="width: 150px;" %)**Event**|=(% style="width: 200px;" %)**Action**|=(% style="width: 150px;" %)**AT+LON to control on/off** 491 491 |(% 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 ... ... @@ -500,7 +500,7 @@ 500 500 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 501 501 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 502 502 503 -== 2. 9Button Function ==582 +== 2.11 Button Function == 504 504 505 505 506 506 (% style="color:blue" %)**RESET button:** ... ... @@ -521,7 +521,7 @@ 521 521 |(% 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 522 522 |(% 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. 523 523 524 -== 2.1 0USB Port Function ==603 +== 2.12 USB Port Function == 525 525 526 526 527 527 The USB interface of TrackerD has below functions: ... ... @@ -678,9 +678,25 @@ 678 678 679 679 * (% style="color:blue" %)**AT Command:** 680 680 681 -(% style="color:#037691" %)**AT+SMOD= xx.**760 +(% style="color:#037691" %)**AT+SMOD=aa,bb** 682 682 762 +(% style="color:#037691" %)** aa:** 683 683 764 +* (% style="color:#037691" %)**1: GPS ONLY(Factory Settings): **(%%)only get and uplink GPS location info. 765 +* (% style="color:#037691" %)**2: BLE ONLY: **(%%)Only obtain iBeacon info via BLE and uplink. Design for Indoor tracking. 766 +* (% style="color:#037691" %)**3: GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking.Devices will try to search BLE iBeacon first. If device can't find the iBeacon, it will use GPS for positioning 767 + 768 +(% style="color:#037691" %)**bb:** 769 + 770 +(% style="color:#037691" %)** if aa = 1: ** 771 + 772 +* (% style="color:#037691" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 773 +* (% style="color:#037691" %)**1 :**(%%) GPS +BAT State 774 + 775 +(% style="color:#037691" %)** if aa = 2: ** 776 + 777 +* (% style="color:#037691" %)**3 : **(%%)(iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 778 + 684 684 **Example:** 685 685 686 686 AT+ SMOD =1,0 **~-~-> ** GPS+ BAT+ State+Tem&Hum ... ... @@ -687,7 +687,7 @@ 687 687 688 688 AT+ SMOD =1,1 **~-~->** GPS +BAT State 689 689 690 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 。785 + AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 691 691 692 692 693 693 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** ... ... @@ -718,7 +718,7 @@ 718 718 719 719 720 720 721 -=== 3. 3.9 Set PDOP value for GPS fix accuracy ===816 +=== 3.2.9 Set PDOP value for GPS fix accuracy === 722 722 723 723 724 724 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. ... ... @@ -804,7 +804,7 @@ 804 804 805 805 (% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 806 806 807 -[[https:~~/~~/ www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]]902 +[[https:~~/~~/github.com/dragino/TrackerD/releases>>https://github.com/dragino/TrackerD/releases]] 808 808 809 809 810 810 Users need to use below files: ... ... @@ -841,6 +841,7 @@ 841 841 [[image:1664503635019-941.png]] 842 842 843 843 939 + 844 844 * (% style="color:#037691" %)**Go to tools ~-~-> Boards ~-~-> Boards Manager**,(%%) **find the esp32 information and install it.** 845 845 846 846 [[image:1664503715811-892.png]]
- 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-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