Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/14 16:33
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -93,6 +93,8 @@ 93 93 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 94 94 * Tracking: max: 38mA 95 95 96 + 97 + 96 96 == 1.3 Features == 97 97 98 98 ... ... @@ -111,6 +111,7 @@ 111 111 * Tri-color LED, Alarm button 112 112 * Datalog 113 113 116 + 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 123 + 124 + 120 120 = 2.1 Use TrackerD = 121 121 122 122 ... ... @@ -144,10 +144,11 @@ 144 144 145 145 Each TrackerD is shipped with a sticker with the default device EUI as below: 146 146 147 - 148 148 [[image:1664501677253-891.png]] 149 149 150 150 155 + 156 + 151 151 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 152 152 153 153 ... ... @@ -181,15 +181,15 @@ 181 181 182 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.190 +* **GPS ONLY(Factory Settings): **only get GPS location info. 191 +* **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking. 192 +* **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking. 187 187 188 -User can switch modes by [[changing SMOD>> ||anchor="H3.2.7SetPositioningMode"]].194 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 189 189 190 190 191 191 192 -== 2.3 Uplink Payload == 198 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 193 193 194 194 195 195 === 2.3.1 Uplink FPORT~=5, Device Status === ... ... @@ -196,7 +196,7 @@ 196 196 197 197 198 198 199 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 205 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 200 200 201 201 202 202 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. ) ... ... @@ -216,35 +216,43 @@ 216 216 217 217 (optional) 218 218 ))) 219 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 220 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 221 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]] 225 +|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)((( 226 +[[Alarm &>>path:#Alarm]] 222 222 228 +[[BAT>>path:#Alarm]] 229 +)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]] 230 + 231 + 232 + 223 223 [[image:1664501958445-288.png]] 224 224 225 225 226 - ==== (% style="color:blue" %)Alarm & BAT:====236 +**Alarm & BAT:** 227 227 228 228 (% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 229 229 |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 230 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>> ||anchor="HBAT:"]]240 +|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]] 231 231 232 -==== (% style="color:blue" %)FLAG: ==== 233 233 243 + 244 +**FLAG:** 245 + 234 234 (% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 235 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 version248 +|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version 237 237 238 -(% style="color:blue" %)**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 239 239 251 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 240 240 241 -==== (% style="color:blue" %)Location info: ==== 242 242 254 +**Location info:** 255 + 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// 245 245 246 -(% style="color:red" %)**Important note:** 247 247 260 +**Important note:** 261 + 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 250 2. In firmware version v1.5, Roll & Pitch is disabled by default. ... ... @@ -262,20 +262,12 @@ 262 262 263 263 264 264 265 -==== (% style="color:blue" %)Alarm: ==== 279 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 280 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 266 266 282 +The battery info shows the current voltage, for **TrackerD** version which powered by li-on battery. User can use below mapping to indicate the battery in percentage: \ 267 267 268 -Example: 0x4B & 0x40 >> 6 = 0x01 269 269 270 - 271 -==== (% style="color:blue" %)BAT: ==== 272 - 273 - 274 -Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 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: \ 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,28 +282,22 @@ 282 282 * 3.40v ~~ 3.69v: 20% ~~ 40% 283 283 * < 3.39v: 0~~20% 284 284 285 -==== (% style="color:blue" %)LON: ==== 286 286 287 - 288 -Enable/Disable LED activity for uplink 289 289 293 +* **LON: **Enable/Disable LED activity for uplink 294 + 290 290 0x00: Disable LED indicator. 291 291 292 292 0x01: Enable LED indicator (Default Value) 293 293 294 294 295 -==== (% style="color:blue" %)Hum: ==== 300 +* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 301 +* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 296 296 297 -0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 298 298 299 299 300 -==== (% style="color:blue" %)Tem: ==== 301 301 302 -011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree// 303 303 304 - 305 - 306 - 307 307 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 308 308 309 309 ... ... @@ -321,42 +321,53 @@ 321 321 322 322 **(bytes)** 323 323 )))|(% style="width:54px" %)16|(% style="width:72px" %)4|(% style="width:71px" %)4|(% style="width:145px" %)2|(% style="width:72px" %)4|(% style="width:76px" %)2|(% style="width:54px" %)1 324 -|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:72px" %)((( 325 -iBeacon MAJOR 324 +|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)((( 325 +iBeacon 326 + 327 +MAJOR 326 326 )))|(% style="width:71px" %)((( 327 -iBeacon MINOR 329 +iBeacon 330 + 331 +MINOR 328 328 )))|(% style="width:145px" %)((( 329 -iBeacon Measured Power 333 +iBeacon Measured 334 + 335 +Power 330 330 )))|(% style="width:72px" %)((( 331 -iBeacon RSSI 337 +iBeacon 338 + 339 +RSSI 332 332 )))|(% style="width:76px" %)((( 333 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 334 -)))|(% style="width:54px" %)[[FLAG>>||anchor="HFLAG:"]] 341 +[[Alarm &>>path:#Alarm]] 335 335 343 +[[BAT>>path:#Alarm]] 344 +)))|(% style="width:54px" %)[[FLAG>>path:#Flag]] 345 + 336 336 [[image:1664502425687-834.png]] 337 337 338 338 339 -* (% style="color:#037691" %)**BAT:**(%%)Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV).340 -* (% style="color:#037691" %)**MODE: **(%%)Define the payload format.341 -* (% style="color:#037691" %)**UUID: **(%%)The uuid from the strongest iBeacon.342 -* (% style="color:#037691" %)**MAJOR:**(%%)The MAJOR from the strongest iBeacon.343 -* (% style="color:#037691" %)**MINOR:**(%%)The MAJOR from the strongest iBeacon.344 -* (% style="color:#037691" %)**Measured Power:**(%%)The Measured Power from the strongest iBeacon.345 -* (% style="color:#037691" %)**RSSI:**(%%)The RSSI from the strongest iBeacon.349 +* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 350 +* **MODE: **Define the payload format. 351 +* **UUID: **The uuid from the strongest iBeacon. 352 +* **MAJOR**: The MAJOR from the strongest iBeacon. 353 +* **MINOR**: The MAJOR from the strongest iBeacon. 354 +* **Measured** **Power**: The Measured Power from the strongest iBeacon. 355 +* **RSSI**: The RSSI from the strongest iBeacon. 346 346 347 347 348 348 359 + 360 + 349 349 === 2.3.5 Add Payload format in TTN V3 === 350 350 351 351 352 352 In TTN V3, use can add a custom payload so it shows friendly. 353 353 354 -In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**366 +In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 355 355 356 356 357 357 [[image:1664502649601-895.png]] 358 358 359 - 360 360 Add the decoder from this link: 361 361 362 362 ... ... @@ -430,6 +430,8 @@ 430 430 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)**RED **on 500ms|(% style="width:202px" %)N/A 431 431 432 432 444 + 445 + 433 433 == 2.9 Button Function == 434 434 435 435 ... ... @@ -451,6 +451,8 @@ 451 451 |(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the **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. 453 453 467 + 468 + 454 454 == 2.10 USB Port Function == 455 455 456 456 ... ... @@ -462,6 +462,8 @@ 462 462 * [[Upgrade Firmware>>path:#upgrade_image]] 463 463 464 464 480 + 481 + 465 465 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 466 466 467 467 ... ... @@ -787,6 +787,8 @@ 787 787 788 788 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 789 789 807 + 808 + 790 790 [[image:1664503715811-892.png]] 791 791 792 792 ... ... @@ -793,6 +793,7 @@ 793 793 794 794 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 795 795 815 + 796 796 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 797 797 798 798 ... ... @@ -851,6 +851,8 @@ 851 851 852 852 853 853 874 + 875 + 854 854 = 8. Order Info = 855 855 856 856 ... ... @@ -868,6 +868,8 @@ 868 868 869 869 870 870 893 + 894 + 871 871 = 9. Packing Info = 872 872 873 873 ... ... @@ -882,6 +882,8 @@ 882 882 * Weight: 50g 883 883 884 884 909 + 910 + 885 885 = 10. Support = 886 886 887 887 ... ... @@ -889,6 +889,8 @@ 889 889 * 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]] 890 890 891 891 918 + 919 + 892 892 = 11. Reference = 893 893 894 894