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,6 +94,7 @@ 94 94 * Tracking: max: 38mA 95 95 96 96 97 + 97 97 == 1.3 Features == 98 98 99 99 ... ... @@ -112,6 +112,7 @@ 112 112 * Tri-color LED, Alarm button 113 113 * Datalog 114 114 116 + 115 115 == 1.4 Applications == 116 116 117 117 ... ... @@ -119,6 +119,7 @@ 119 119 * Human tracking 120 120 121 121 124 + 122 122 = 2.1 Use TrackerD = 123 123 124 124 ... ... @@ -146,10 +146,11 @@ 146 146 147 147 Each TrackerD is shipped with a sticker with the default device EUI as below: 148 148 149 - 150 150 [[image:1664501677253-891.png]] 151 151 152 152 155 + 156 + 153 153 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 154 154 155 155 ... ... @@ -183,15 +183,15 @@ 183 183 184 184 (% style="color:blue" %)**Positioning Mode(SMOD):** 185 185 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.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. 189 189 190 -User can switch modes by [[changing SMOD>> ||anchor="H3.2.7SetPositioningMode"]].194 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 191 191 192 192 193 193 194 -== 2.3 Uplink Payload == 198 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 195 195 196 196 197 197 === 2.3.1 Uplink FPORT~=5, Device Status === ... ... @@ -198,7 +198,7 @@ 198 198 199 199 200 200 201 -=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 205 +=== 2.3.2 Uplink FPORT~= , Realtime GNSS Positioning === 202 202 203 203 204 204 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. ) ... ... @@ -218,38 +218,43 @@ 218 218 219 219 (optional) 220 220 ))) 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:"]]225 +|(% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)((( 226 +[[Alarm &>>path:#Alarm]] 223 223 224 -)))|(% style="width:52px" %)[[FLAG>>||anchor="HFLAG:"]]|(% style="width:88px" %)[[Hum>>||anchor="HHum:"]]|(% style="width:83px" %)[[Tem>>||anchor="HTem:"]] 228 +[[BAT>>path:#Alarm]] 229 +)))|(% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]] 225 225 226 226 232 + 227 227 [[image:1664501958445-288.png]] 228 228 229 229 230 - ====Alarm & BAT:====236 +**Alarm & BAT:** 231 231 232 232 (% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 233 233 |(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 234 -|(% 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]] 235 235 236 236 237 -==== FLAG: ==== 238 238 244 +**FLAG:** 245 + 239 239 (% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 240 240 |(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 241 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>> ||anchor="H2.3.4BLEpositioningPayload28Fport229"]]|(% style="width:47px" %)[[LON>>||anchor="HLocationinfo:"]]|(% 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 242 242 243 -**(% style="color:blue" %)Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 244 244 251 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 245 245 246 -==== Location info: ==== 247 247 254 +**Location info:** 255 + 248 248 * Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 249 249 * Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 250 250 251 -**(% style="color:red" %)Important note:** 252 252 260 +**Important note:** 261 + 253 253 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. 254 254 255 255 2. In firmware version v1.5, Roll & Pitch is disabled by default. ... ... @@ -267,18 +267,12 @@ 267 267 268 268 269 269 270 -==== Alarm: ==== 279 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 280 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 271 271 272 - Example:0x4B&0x40>>6=0x01282 +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: \ 273 273 274 274 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 - 282 282 * > 4.0v : 80% ~~ 100% 283 283 * 3.85v ~~3.99v: 60% ~~ 80% 284 284 * 3.70v ~~ 3.84v: 40% ~~ 60% ... ... @@ -286,26 +286,21 @@ 286 286 * < 3.39v: 0~~20% 287 287 288 288 289 -==== LON: ==== 290 -Enable/Disable LED activity for uplink 291 291 293 +* **LON: **Enable/Disable LED activity for uplink 294 + 292 292 0x00: Disable LED indicator. 293 293 294 294 0x01: Enable LED indicator (Default Value) 295 295 296 296 297 -==== 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 298 298 299 -0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 300 300 301 301 302 -==== Tem: ==== 303 303 304 -011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 305 305 306 - 307 - 308 - 309 309 === 2.3.3 Uplink FPORT~= , History GNSS Positioning === 310 310 311 311 ... ... @@ -323,38 +323,49 @@ 323 323 324 324 **(bytes)** 325 325 )))|(% 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 326 -|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>||anchor="HLocationinfo:"]]|(% style="width:72px" %)((( 327 -iBeacon MAJOR 324 +|(% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)((( 325 +iBeacon 326 + 327 +MAJOR 328 328 )))|(% style="width:71px" %)((( 329 -iBeacon MINOR 329 +iBeacon 330 + 331 +MINOR 330 330 )))|(% style="width:145px" %)((( 331 -iBeacon Measured Power 333 +iBeacon Measured 334 + 335 +Power 332 332 )))|(% style="width:72px" %)((( 333 -iBeacon RSSI 337 +iBeacon 338 + 339 +RSSI 334 334 )))|(% style="width:76px" %)((( 335 -[[Alarm & BAT>>||anchor="HAlarm26BAT:"]] 336 -)))|(% style="width:54px" %)[[FLAG>>||anchor="HFLAG:"]] 341 +[[Alarm &>>path:#Alarm]] 337 337 343 +[[BAT>>path:#Alarm]] 344 +)))|(% style="width:54px" %)[[FLAG>>path:#Flag]] 345 + 338 338 [[image:1664502425687-834.png]] 339 339 340 340 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.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. 348 348 349 349 350 350 351 351 360 + 352 352 === 2.3.5 Add Payload format in TTN V3 === 353 353 354 354 355 355 In TTN V3, use can add a custom payload so it shows friendly. 356 356 357 -In the page Applications (%style="color:#037691" %)~-~-> Payload Formats ~-~-> Custom ~-~-> decoder366 +In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 358 358 359 359 360 360 [[image:1664502649601-895.png]] ... ... @@ -433,6 +433,7 @@ 433 433 434 434 435 435 445 + 436 436 == 2.9 Button Function == 437 437 438 438 ... ... @@ -455,6 +455,7 @@ 455 455 |(% 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. 456 456 457 457 468 + 458 458 == 2.10 USB Port Function == 459 459 460 460 ... ... @@ -467,6 +467,7 @@ 467 467 468 468 469 469 481 + 470 470 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 471 471 472 472 ... ... @@ -793,6 +793,7 @@ 793 793 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 794 794 795 795 808 + 796 796 [[image:1664503715811-892.png]] 797 797 798 798 ... ... @@ -799,6 +799,7 @@ 799 799 800 800 * Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 801 801 815 + 802 802 Put the Library in the TrackerD directory into the libraries file in the Arduino directory: 803 803 804 804 ... ... @@ -858,6 +858,7 @@ 858 858 859 859 860 860 875 + 861 861 = 8. Order Info = 862 862 863 863 ... ... @@ -876,6 +876,7 @@ 876 876 877 877 878 878 894 + 879 879 = 9. Packing Info = 880 880 881 881 ... ... @@ -891,6 +891,7 @@ 891 891 892 892 893 893 910 + 894 894 = 10. Support = 895 895 896 896 ... ... @@ -899,6 +899,7 @@ 899 899 900 900 901 901 919 + 902 902 = 11. Reference = 903 903 904 904