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
-
... ... @@ -94,7 +94,6 @@ 94 94 * Tracking: max: 38mA 95 95 96 96 97 - 98 98 == 1.3 Features == 99 99 100 100 ... ... @@ -113,7 +113,6 @@ 113 113 * Tri-color LED, Alarm button 114 114 * Datalog 115 115 116 - 117 117 == 1.4 Applications == 118 118 119 119 ... ... @@ -121,7 +121,6 @@ 121 121 * Human tracking 122 122 123 123 124 - 125 125 = 2.1 Use TrackerD = 126 126 127 127 ... ... @@ -149,11 +149,10 @@ 149 149 150 150 Each TrackerD is shipped with a sticker with the default device EUI as below: 151 151 149 + 152 152 [[image:1664501677253-891.png]] 153 153 154 154 155 - 156 - 157 157 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 158 158 159 159 ... ... @@ -187,15 +187,15 @@ 187 187 188 188 (% style="color:blue" %)**Positioning Mode(SMOD):** 189 189 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. 186 +* **(% style="color:#037691" %)GPS ONLY(Factory Settings): **(%%)only get GPS location info. 187 +* **(% style="color:#037691" %)BLE ONLY: **(%%)Only obtain iBeacon info via BLE. Design for Indoor tracking. 188 +* **(% style="color:#037691" %)GPS/BLE Hybrid: **(%%)Combination for Indoor and Outdoor tracking. 193 193 194 -User can switch modes by [[changing SMOD>> path:#Positioning_Mode]].190 +User can switch modes by [[changing SMOD>>||anchor="H3.2.7SetPositioningMode"]]. 195 195 196 196 197 197 198 -== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~-==194 +== 2.3 Uplink Payload == 199 199 200 200 201 201 === 2.3.1 Uplink FPORT~=5, Device Status === ... ... @@ -202,7 +202,7 @@ 202 202 203 203 204 204 205 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning 201 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 206 206 207 207 208 208 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. ) ... ... @@ -222,43 +222,38 @@ 222 222 223 223 (optional) 224 224 ))) 225 -|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>> path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)(((226 -[[Alarm &>> path:#Alarm]]221 +|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>||anchor="HLocationinfo:"]]|(% style="width:87px" %)[[Longitude>>||anchor="HLocationinfo:"]]|(% style="width:76px" %)((( 222 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 227 227 228 -[[BAT>>path:#Alarm]] 229 -)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]] 224 +)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]] 230 230 231 231 232 - 233 233 [[image:1664501958445-288.png]] 234 234 235 235 236 - **Alarm & BAT:**230 +==== Alarm & BAT: ==== 237 237 238 238 (% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 239 239 |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 240 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>> path:#BAT]]234 +|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 241 241 242 242 237 +==== FLAG: ==== 243 243 244 -**FLAG:** 245 - 246 246 (% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 247 247 |(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 248 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>pat h:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version241 +|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLocationinfo:"]]|(% style="width:140px" %)Firmware version 249 249 243 +**(% style="color:blue" %)Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 250 250 251 -**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 252 252 246 +==== Location info: ==== 253 253 254 -**Location info:** 255 - 256 256 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 257 257 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 258 258 251 +**(% style="color:red" %)Important note:** 259 259 260 -**Important note:** 261 - 262 262 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. 263 263 264 264 2. In firmware version v1.5, Roll & Pitch is disabled by default. ... ... @@ -276,12 +276,18 @@ 276 276 277 277 278 278 279 -* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 280 -* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 270 +==== Alarm: ==== 281 281 282 - The battery info shows the current voltage, for **TrackerD** version whichpowered byli-on battery.Usercanusebelowmappingtoindicate the battery in percentage: \272 +Example: 0x4B & 0x40 >> 6 = 0x01 283 283 284 284 275 +==== BAT: ==== 276 + 277 +Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 278 + 279 +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: \ 280 + 281 + 285 285 * > 4.0v : 80% ~~ 100% 286 286 * 3.85v ~~3.99v: 60% ~~ 80% 287 287 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -289,21 +289,26 @@ 289 289 * < 3.39v: 0~~20% 290 290 291 291 289 +==== LON: ==== 290 +Enable/Disable LED activity for uplink 292 292 293 -* **LON: **Enable/Disable LED activity for uplink 294 - 295 295 0x00: Disable LED indicator. 296 296 297 297 0x01: Enable LED indicator (Default Value) 298 298 299 299 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 297 +==== Hum: ==== 302 302 299 +0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 303 303 304 304 302 +==== Tem: ==== 305 305 304 +011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 306 306 306 + 307 + 308 + 307 307 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 308 308 309 309 ... ... @@ -321,49 +321,38 @@ 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>>path:#Location]]|(% style="width:72px" %)((( 325 -iBeacon 326 - 327 -MAJOR 326 +|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:72px" %)((( 327 +iBeacon MAJOR 328 328 )))|(% style="width:71px" %)((( 329 -iBeacon 330 - 331 -MINOR 329 +iBeacon MINOR 332 332 )))|(% style="width:145px" %)((( 333 -iBeacon Measured 334 - 335 -Power 331 +iBeacon Measured Power 336 336 )))|(% style="width:72px" %)((( 337 -iBeacon 338 - 339 -RSSI 333 +iBeacon RSSI 340 340 )))|(% style="width:76px" %)((( 341 -[[Alarm &>>path:#Alarm]] 335 +[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 336 +)))|(% style="width:54px" %)[[FLAG>>||anchor="HFLAG:"]] 342 342 343 -[[BAT>>path:#Alarm]] 344 -)))|(% style="width:54px" %)[[FLAG>>path:#Flag]] 345 - 346 346 [[image:1664502425687-834.png]] 347 347 348 348 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.341 +* **(% style="color:#037691" %)BAT: ** (%%) Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 342 +* **(% style="color:#037691" %)MODE: **(%%)Define the payload format. 343 +* **(% style="color:#037691" %)UUID: **(%%)The uuid from the strongest iBeacon. 344 +* **(% style="color:#037691" %)MAJOR:** (%%) The MAJOR from the strongest iBeacon. 345 +* **(% style="color:#037691" %)MINOR:** (%%)The MAJOR from the strongest iBeacon. 346 +* **(% style="color:#037691" %)Measured Power: ** (%%) The Measured Power from the strongest iBeacon. 347 +* **(% style="color:#037691" %)RSSI: ** (%%) The RSSI from the strongest iBeacon. 356 356 357 357 358 358 359 359 360 - 361 361 === 2.3.5 Add Payload format in TTN V3 === 362 362 363 363 364 364 In TTN V3, use can add a custom payload so it shows friendly. 365 365 366 -In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 357 +In the page Applications(% style="color:#037691" %) ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 367 367 368 368 369 369 [[image:1664502649601-895.png]] ... ... @@ -442,7 +442,6 @@ 442 442 443 443 444 444 445 - 446 446 == 2.9 Button Function == 447 447 448 448 ... ... @@ -465,7 +465,6 @@ 465 465 |(% 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. 466 466 467 467 468 - 469 469 == 2.10 USB Port Function == 470 470 471 471 ... ... @@ -478,7 +478,6 @@ 478 478 479 479 480 480 481 - 482 482 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 483 483 484 484 ... ... @@ -805,7 +805,6 @@ 805 805 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 806 806 807 807 808 - 809 809 [[image:1664503715811-892.png]] 810 810 811 811 ... ... @@ -812,7 +812,6 @@ 812 812 813 813 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 814 814 815 - 816 816 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 817 817 818 818 ... ... @@ -872,7 +872,6 @@ 872 872 873 873 874 874 875 - 876 876 = 8. Order Info = 877 877 878 878 ... ... @@ -891,7 +891,6 @@ 891 891 892 892 893 893 894 - 895 895 = 9. Packing Info = 896 896 897 897 ... ... @@ -907,7 +907,6 @@ 907 907 908 908 909 909 910 - 911 911 = 10. Support = 912 912 913 913 ... ... @@ -916,7 +916,6 @@ 916 916 917 917 918 918 919 - 920 920 = 11. Reference = 921 921 922 922