Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 2 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,13 +7,6 @@ 1 -(% style="text-align:center" %) 2 -[[image:1664505654417-133.png]] 3 - 4 - 5 - 6 - 7 7 (% class="wikigeneratedid" %) 8 8 **Table of Contents:** 9 9 10 -{{toc/}} 11 11 12 12 13 13 ... ... @@ -14,10 +14,9 @@ 14 14 15 15 = 1. Introduction = 16 16 10 +== 1.1 OverView == 17 17 18 -== 1.1 What is TrackerD == 19 19 20 - 21 21 ((( 22 22 TrackerD is an (% style="color:blue" %)**Open Source LoRaWAN Tracker**(%%) based on (% style="color:blue" %)**ESP32 MCU**(%%) and (% style="color:blue" %)**Semtech LoRa Wireless Chip**. 23 23 ))) ... ... @@ -42,7 +42,6 @@ 42 42 (% style="color:red" %)**Note: LoRaWAN server can be a general LoRaWAN server other than TTN.** 43 43 44 44 45 - 46 46 == 1.2 Specifications == 47 47 48 48 ... ... @@ -57,11 +57,13 @@ 57 57 * EEPROM: 520 KB 58 58 * Clock Speed: 32Mhz 59 59 51 + 60 60 (% style="color:blue" %)**Common DC Characteristics:** 61 61 62 62 * Supply Voltage: 5V via USB port or Internal li-on battery 63 63 * Operating Temperature: -40 ~~ 60°C 64 64 57 + 65 65 (% style="color:blue" %)**LoRa Spec:** 66 66 67 67 * Frequency Range, ... ... @@ -83,10 +83,12 @@ 83 83 * Packet engine up to 256 bytes with CRC. 84 84 * LoRaWAN 1.0.3 Specification 85 85 79 + 86 86 (% style="color:blue" %)**Battery:** 87 87 88 88 * 1000mA Li-on Battery power (for model TrackerD) 89 89 84 + 90 90 (% style="color:blue" %)**Power Consumption** 91 91 92 92 * Sleeping Mode: 200uA ... ... @@ -94,6 +94,8 @@ 94 94 * Tracking: max: 38mA 95 95 96 96 92 + 93 + 97 97 == 1.3 Features == 98 98 99 99 ... ... @@ -112,6 +112,8 @@ 112 112 * Tri-color LED, Alarm button 113 113 * Datalog 114 114 112 + 113 + 115 115 == 1.4 Applications == 116 116 117 117 ... ... @@ -119,9 +119,10 @@ 119 119 * Human tracking 120 120 121 121 122 -= 2.1 Use TrackerD = 123 123 124 124 123 += 2.1 Use TrackerD = 124 + 125 125 == 2.1 How it works? == 126 126 127 127 ... ... @@ -128,256 +128,240 @@ 128 128 TrackerD is configured as LoRaWAN OTAA Class A GPS tracker by default. It has OTAA keys to join LoRaWAN network. To connect a LoRaWAN network, user need to input the OTAA keys in the LoRaWAN IoT server and push reset button of TrackerD (next to USB port). TrackerD will wake up and auto join the network via OTAA. 129 129 130 130 131 - 132 132 == 2.2 Quick guide to connect to LoRaWAN server == 133 133 133 +Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example. 134 134 135 -Here is an example for how to join the [[TTNv3 LoRaWAN Network>>url:https://eu1.cloud.thethings.network]]. Below is the network structure, we use LPS8N as LoRaWAN gateway in this example. 136 136 136 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] 137 137 138 -[[image:1664501652064-326.png]] 139 139 140 - 141 - 142 142 The LPS8N is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. What the rest need to is register this device in TTN V3: 143 143 141 +**(% style="color:blue" %)Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD. 144 144 145 -(% style="color:blue" %)**Step 1**:(%%) Create a device in TTN V3 with the OTAA keys from TrackerD. 146 - 147 147 Each TrackerD is shipped with a sticker with the default device EUI as below: 148 148 145 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]] 149 149 150 -[[image:1664501677253-891.png]] 151 151 152 152 149 + 153 153 Input these keys to their LoRaWAN Server portal. Below is TTN V3 screen shot: 154 154 155 155 156 - **__Add APP EUI in the application:__**153 +Add APP EUI in the application 157 157 155 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]] 158 158 159 -[[image: 1664501711466-918.png]]157 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] 160 160 161 161 160 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]] 162 162 163 -[[image:1664501721248-725.png]] 164 164 165 165 166 - [[image:1664501734705-405.png]]164 +Add APP KEY and DEV EUI 167 167 166 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]] 168 168 169 169 170 -**__Add APP KEY and DEV EUI:__** 171 171 172 172 173 - [[image:1664501784668-703.png]]171 +**(% style="color:blue" %)Step 2**:(%%) Power on TrackerD by using the on board switch. 174 174 175 175 174 +**(% 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. 176 176 177 177 178 -(% style="color:blue" %) **Step 2**:(%%)PoweronTrackerD by usingtheon boardswitch.177 +**(% style="color:blue" %)Positioning Mode(SMOD):** 179 179 180 - 181 -(% 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. 182 - 183 - 184 -(% style="color:blue" %)**Positioning Mode(SMOD):** 185 - 186 186 * **GPS ONLY(Factory Settings): **only get GPS location info. 187 187 * **BLE ONLY: **Only obtain iBeacon info via BLE. Design for Indoor tracking. 188 188 * **GPS/BLE Hybrid: **Combination for Indoor and Outdoor tracking. 189 189 190 -User can switch modes by [[changing SMOD>> ||anchor="H3.2.7SetPositioningMode"]].183 +User can switch modes by [[changing SMOD>>path:#Positioning_Mode]]. 191 191 192 192 186 +== 2.3 Uplink Payload ~-~-~-~-~-~-~-~-~-~-~-~-~-~- == 193 193 194 -== 2.3 Uplink Payload == 195 195 189 +=== 2.3.1 Uplink FPORT=5, Device Status === 196 196 197 -=== 2.3.1 Uplink FPORT~=5, Device Status === 198 198 199 199 193 +=== 2.3.2 Uplink FPORT= , Realtime GNSS Positioning === 200 200 201 - ===2.3.2UplinkFPORT~=,RealtimeGNSSPositioning===195 +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. ) 202 202 203 203 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. ) 205 - 206 - 207 -(% border="2" style="background-color:#ffffcc; color:green; width:537px" %) 208 -|(% style="width:69px" %)((( 198 +|((( 209 209 **Size** 210 210 211 211 **(bytes)** 212 -)))| (% style="width:76px" %)4|(% style="width:87px" %)4|(% style="width:76px" %)2|(% style="width:52px" %)1|(% style="width:88px" %)(((202 +)))|4|4|2|1|((( 213 213 2 214 214 215 215 (optional ) 216 -)))|( % style="width:83px" %)(((206 +)))|((( 217 217 2 218 218 219 219 (optional) 220 220 ))) 221 -| (% style="width:69px" %)**Value**|(% style="width:76px" %)[[Latitude>>path:#Location]]|(% style="width:87px" %)[[Longitude>>path:#Location]]|(% style="width:76px" %)(((211 +|**Value**|[[Latitude>>path:#Location]]|[[Longitude>>path:#Location]]|((( 222 222 [[Alarm &>>path:#Alarm]] 223 223 224 224 [[BAT>>path:#Alarm]] 225 -)))| (% style="width:52px" %)[[FLAG>>path:#Flag]]|(% style="width:88px" %)Hum|(% style="width:83px" %)[[Tem>>path:#Pitch]]215 +)))|[[FLAG>>path:#Flag]]|Hum|[[Tem>>path:#Pitch]] 226 226 227 227 228 -[[image: 1664501958445-288.png]]218 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]] 229 229 230 230 231 231 **Alarm & BAT:** 232 232 233 -(% border="2" style="background-color:#ffffcc; color:green; width:329px" %) 234 -|(% style="width:72px" %)**Size(bit)**|(% style="width:67px" %)1 bit|(% style="width:118px" %)1bit|(% style="width:63px" %)14 bits 235 -|(% style="width:72px" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>path:#BAT]] 223 +|**Size(bit)**|1 bit|1bit|14 bits 224 +|**Value**|reserve|Alarm Indicate|[[BAT>>path:#BAT]] 236 236 237 - 238 238 **FLAG:** 239 239 240 -(% border="2" style="background-color:#ffffcc; color:green; width:332px" %) 241 -|(% style="width:79px" %)**Size(bit)**|(% style="width:55px" %)2 bits|(% style="width:47px" %)1bit|(% style="width:140px" %)5 bits 242 -|(% style="width:79px" %)**Value**|(% style="width:55px" %)[[MOD>>path:#MD]]|(% style="width:47px" %)[[LON>>path:#LON]]|(% style="width:140px" %)Firmware version 228 +|**Size(bit)**|2 bits|1bit|5 bits 229 +|**Value**|[[MOD>>path:#MD]]|[[LON>>path:#LON]]|Firmware version 243 243 244 -**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 245 245 246 246 247 -** Locationinfo:**233 +**Example: Payload: 0x02863D68 FAC29BAF 4B45 60 0202 011A ** 248 248 249 -* Latitude: 02863D68 ⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// //value = 02863D68 /1000000 = 42.351976// 250 -* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// //value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 251 251 252 -** Important note:**236 +**Location info:** 253 253 254 - 1.When power is low (<2.84v), GPS won't beableto get location info and GPS feature will bedisabledandthe locationfieldwill be filled with0x0FFFFFFF,0x0FFFFFFF.238 +* Latitude: 02863D68⇒ //if (0x//02863D68//& 0x80000000 = 0 )~:// 255 255 256 - 2. In firmwareversionv1.5,Roll& Pitch is disabled by default.240 +//value = 02863D68 /1000000 = 42.351976// 257 257 258 - 3.Whenenable 9-axis motion sensor, the total payloadwill be15bytes,whileUS915/AU915DR0acceptonly11bytes payload. In this case, the payload on server will be ignore and shows as below:242 +* Longitude: FAC29BAF ⇒ //if (0x//FAC29BAF// & 0x80000000 = 1 )~:// 259 259 244 +//value = (0x//FAC29BAF// – 0x 100000000)/1000000 =//-87.9094//57// 260 260 261 -[[image:1664502116362-706.png]] 262 262 247 +Important note: 263 263 249 +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. 250 +1. In firmware version v1.5, Roll & Pitch is disabled by default. 251 +1. 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: 264 264 265 - 4. While GPS can'tget location info after timeout(FTIME Parameter), the latitudeandlongitude willbe filled withall0x00:253 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]] 266 266 267 -[[image:1664502166010-515.png]] 268 268 256 +1. While GPS can’t get location info after timeout(FTIME Parameter), the latitude and longitude will be filled with all 0x00: 269 269 258 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]] 270 270 271 -* **Alarm**: 272 -* **BAT**: 260 +* **Alarm**: Example: 0x4B & 0x40 >> 6 = 0x01 261 +* **BAT**: Example: 0x0CDD & 0x3FFF ⇒ 3293 (mV). 273 273 274 274 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: \ 275 275 276 276 277 -* > 4.0v : 278 -* 3.85v ~~3.99v: 279 -* 3.70v ~~ 3.84v: 280 -* 3.40v ~~ 3.69v: 281 -* < 3.39v: 266 +* > 4.0v : 80% ~~ 100% 267 +* 3.85v ~~3.99v: 60% ~~ 80% 268 +* 3.70v ~~ 3.84v: 40% ~~ 60% 269 +* 3.40v ~~ 3.69v: 20% ~~ 40% 270 +* < 3.39v: 0~~20% 282 282 283 283 284 284 * **LON: **Enable/Disable LED activity for uplink 285 285 286 -0x00: 275 +0x00: Disable LED indicator. 287 287 288 -0x01: 277 +0x01: Enable LED indicator (Default Value) 289 289 290 290 291 -* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): 292 -* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): 280 +* **Hum**: 0202 = //if (0x0202 & 0x8000 = 0 ): value =// 0x0202 / 100 = +514 ⇒ 51.4 degree 281 +* **//Tem//**//: 011A =if (0x011A & 0x8000 = 1 ): value =( 0x011A - 0x10000)/10(dec) ⇒ -//28.2 degree 293 293 294 294 295 295 285 +=== 2.3.3 Uplink FPORT= , History GNSS Positioning === 296 296 297 -=== 2.3.3 Uplink FPORT~= , History GNSS Positioning === 298 298 299 299 289 +=== 2.3.4 BLE positioning Payload(Fport=2) === 300 300 301 -=== 2.3.4 BLE positioning Payload(Fport2) === 302 - 303 - 304 304 Different MODE has different payload: 305 305 306 306 **MODE=2** 307 307 308 -(% border="2" style="background-color:#ffffcc; color:green; width:620px" %) 309 -|(% style="width:70px" %)((( 295 +|((( 310 310 **Size** 311 311 312 312 **(bytes)** 313 -)))| (% 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" %)1314 -| (% style="width:70px" %)**Value**|(% style="width:54px" %)[[UUID>>path:#Location]]|(% style="width:72px" %)(((299 +)))|16|4|4|2|4|2|1 300 +|**Value**|[[UUID>>path:#Location]]|((( 315 315 iBeacon 316 316 317 317 MAJOR 318 -)))|( % style="width:71px" %)(((304 +)))|((( 319 319 iBeacon 320 320 321 321 MINOR 322 -)))|( % style="width:145px" %)(((308 +)))|((( 323 323 iBeacon Measured 324 324 325 325 Power 326 -)))|( % style="width:72px" %)(((312 +)))|((( 327 327 iBeacon 328 328 329 329 RSSI 330 -)))|( % style="width:76px" %)(((316 +)))|((( 331 331 [[Alarm &>>path:#Alarm]] 332 332 333 333 [[BAT>>path:#Alarm]] 334 -)))| (% style="width:54px" %)[[FLAG>>path:#Flag]]320 +)))|[[FLAG>>path:#Flag]] 335 335 336 -[[image:1664502425687-834.png]] 337 337 323 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]] 338 338 339 -* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 340 -* **MODE: **Define the payload format. 341 -* **UUID: **The uuid from the strongest iBeacon. 342 -* **MAJOR**: The MAJOR from the strongest iBeacon. 343 -* **MINOR**: The MAJOR from the strongest iBeacon. 344 -* **Measured** **Power**: The Measured Power from the strongest iBeacon. 345 -* **RSSI**: The RSSI from the strongest iBeacon. 346 346 326 +* **BAT**: Ex1: 0x4B45 & 0x3FFF ⇒ 3901 (mV). 327 +* **MODE: **Define the payload format. 328 +* **UUID: **The uuid from the strongest iBeacon. 329 +* **MAJOR**: The MAJOR from the strongest iBeacon. 330 +* **MINOR**: The MAJOR from the strongest iBeacon. 331 +* **Measured** **Power**: The Measured Power from the strongest iBeacon. 332 +* **RSSI**: The RSSI from the strongest iBeacon. 347 347 348 348 349 349 350 350 === 2.3.5 Add Payload format in TTN V3 === 351 351 352 - 353 353 In TTN V3, use can add a custom payload so it shows friendly. 354 354 355 355 In the page Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder 356 356 342 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]] 357 357 358 -[[image:1664502649601-895.png]] 359 - 360 360 Add the decoder from this link: 361 361 362 362 363 363 Save the change the uplink message will be parsed. As below: 364 364 365 -[[image: 1664502676891-606.png]]349 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]] 366 366 367 367 368 368 353 + 354 + 369 369 == 2.4 Integrate with Datacake == 370 370 371 371 372 372 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. 373 373 374 -Instruction is here: 360 +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]] 375 375 362 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]] 376 376 377 -[[image:1664502695771-538.png]] 378 378 379 - 380 - 381 381 == 2.5 Integrate with Tago == 382 382 383 383 ... ... @@ -385,8 +385,8 @@ 385 385 386 386 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]] 387 387 372 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]] 388 388 389 -[[image:1664502715371-321.png]] 390 390 391 391 392 392 ... ... @@ -407,7 +407,6 @@ 407 407 When exit alarm mode, **RED LED** will light up for 5 seconds, indicating that the alarm mode is exited. And the alert flag will be set to false. 408 408 409 409 410 - 411 411 == 2.7 Sports Mode ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-- == 412 412 413 413 ... ... @@ -415,28 +415,28 @@ 415 415 == 2.8 LED Status == 416 416 417 417 418 -(% border="2" style="background-color:#ffffcc; color:green; width:636px" %) 419 -|(% style="width:157px" %)**Event**|(% style="width:271px" %)**Action**|(% style="width:202px" %)**AT+LON to control on/off** 420 -|(% style="width:157px" %)**Power On**|(% style="width:271px" %)**BLUE, RED , Green** flash once|(% style="width:202px" %)N/A 421 -|(% style="width:157px" %)**Join request**|(% style="width:271px" %)**Green** led fast blink once (200ms)|(% style="width:202px" %)Yes 422 -|(% style="width:157px" %)**Join Success**|(% style="width:271px" %)**Green** led on 5 second|(% style="width:202px" %)N/A 423 -|(% style="width:157px" %)**Fixing Location**|(% style="width:271px" %)**BLUE **blinks 200ms per second|(% style="width:202px" %)Yes 424 -|(% style="width:157px" %)**Fixed and uplink**|(% style="width:271px" %)**GREEN **blinks twice (200ms per blink)|(% style="width:202px" %)Yes 425 -|(% style="width:157px" %)**Fail Fix and uplink**|(% style="width:271px" %)**RED **blinks twice (200ms per blink)|(% style="width:202px" %)Yes 426 -|(% style="width:157px" %)**Enter Alarm mode**|(% style="width:271px" %)**RED **on for 3 seconds|(% style="width:202px" %)Yes 427 -|(% style="width:157px" %)**Uplink under Alarm**|(% style="width:271px" %)**RED **on for 1 second|(% style="width:202px" %)Yes 428 -|(% style="width:157px" %)**Exit Alarm**|(% style="width:271px" %)**BLUE **led on 5 second|(% style="width:202px" %)Yes 429 -|(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)**GREEN** led on 1 second|(% style="width:202px" %)Yes 430 -|(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)**RED **on 500ms|(% style="width:202px" %)N/A 401 +|**Event**|**Action**|**AT+LON to control on/off** 402 +|**Power On**|**BLUE, RED , Green** flash once|N/A 403 +|**Join request**|**Green** led fast blink once (200ms)|Yes 404 +|**Join Success**|**Green** led on 5 second|N/A 405 +|**Fixing Location**|**BLUE **blinks 200ms per second|Yes 406 +|**Fixed and uplink**|**GREEN **blinks twice (200ms per blink)|Yes 407 +|**Fail Fix and uplink**|**RED **blinks twice (200ms per blink)|Yes 408 +|**Enter Alarm mode**|**RED **on for 3 seconds|Yes 409 +|**Uplink under Alarm**|**RED **on for 1 second|Yes 410 +|**Exit Alarm**|**BLUE **led on 5 second|Yes 411 +|**Get Downlink**|**GREEN** led on 1 second|Yes 412 +|**Movement Detect**|**RED **on 500ms|N/A 431 431 432 432 433 433 434 -== 2.9 Button Function == 435 435 436 436 418 +== 2.9 Button Function == 419 + 437 437 **RESET button:** 438 438 439 -[[image: 1664502835802-546.png]]422 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]] 440 440 441 441 Push this button will reboot the device. Device will exit alarm mode and re-join to LoRaWAN server. 442 442 ... ... @@ -443,19 +443,18 @@ 443 443 444 444 **RED button:** 445 445 446 -[[image: 1664502854406-763.png]]429 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]] 447 447 431 +|**Function**|**Action**|**Description** 432 +|Send Alarm|Keep Pressing **RED** button for more than 5 seconds|Enter Alarm Mode. See [[Alarm Mode>>path:#Alarm_Mode]] 433 +|Exit Alarm Mode|Fast press the **RED** button 10 times|Exit Alarm Mode 434 +|Enter Deep Sleep Mode|Press and hold the button for 10 seconds, then quickly press the device 3 times to enter deep sleep|This is the mode ship out from factory. CPU will be complete in sleep mode and no LoRa activity, only use before deploy. 448 448 449 -(% border="2" style="background-color:#ffffcc; color:green; width:627px" %) 450 -|(% style="width:135px" %)**Function**|(% style="width:220px" %)**Action**|(% style="width:265px" %)**Description** 451 -|(% style="width:135px" %)Send Alarm|(% style="width:220px" %)Keep Pressing **RED** button for more than 5 seconds|(% style="width:265px" %)Enter Alarm Mode. See [[Alarm Mode>>path:#Alarm_Mode]] 452 -|(% style="width:135px" %)Exit Alarm Mode|(% style="width:220px" %)Fast press the **RED** button 10 times|(% style="width:265px" %)Exit Alarm Mode 453 -|(% 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. 454 454 455 455 438 + 456 456 == 2.10 USB Port Function == 457 457 458 - 459 459 The USB interface of TrackerD has below functions: 460 460 461 461 * Power on the device ... ... @@ -465,6 +465,8 @@ 465 465 466 466 467 467 450 + 451 + 468 468 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 469 469 470 470 ... ... @@ -473,37 +473,30 @@ 473 473 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]] 474 474 475 475 476 - 477 477 == 3.1 Access AT Command == 478 478 462 +TrackerD supports the AT command set in stock firmware. User can connect to TrackerD with TYPE-C cable to use AT commands as shown below. ... 479 479 480 - TrackerD supports the AT command set in stockfirmware.Usercan connectto TrackerD with TYPE-C cableto use AT commands as shown below.464 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]] 481 481 482 482 483 -[[image:1664502999401-486.png]] 484 - 485 - 486 486 In PC, User needs to set serial tool baud rate to **115200** to access serial console for TrackerD. TrackerD will output system info once power on and user will be able to send AT commands: 487 487 488 488 489 -[[image: 1664503022490-662.png]]470 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]] 490 490 491 491 492 492 493 -[[image: 1664503035713-500.png]]474 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]] 494 494 476 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]] 495 495 496 496 497 -[[image:1664503047675-651.png]] 498 - 499 - 500 - 501 501 == 3.2 Command Set == 502 502 503 503 504 504 === 3.2.1 Set Transmit Interval === 505 505 506 - 507 507 Set device uplink interval. 508 508 509 509 * AT Command: ... ... @@ -510,18 +510,16 @@ 510 510 511 511 AT+TDC=xxx 512 512 513 -Example: 490 +Example: AT+TDC=300000. Means set interval to 5 minutes(300 seconds) 514 514 515 515 516 516 * Downlink Payload (prefix 0x01): 517 517 518 -0x01 00 01 2C ~/~/ 495 +0x01 00 01 2C ~/~/ Same as AT+TDC=300000 519 519 520 520 521 - 522 522 === 3.2.2 Set Alarm Packet transmission interval === 523 523 524 - 525 525 Set alarm packet transmit interval 526 526 527 527 * AT Command: ... ... @@ -528,18 +528,16 @@ 528 528 529 529 AT+ATDC=xx. 530 530 531 -Example: **~-~-> **Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000506 +Example: AT+ATDC=60000 à Set Alarm Packet Interval to 60 seconds. TrackerD will send every 60 seconds in Alarm mode, Default Value: 60000 532 532 533 533 534 534 * Downlink Payload (prefix 0xB1): 535 535 536 -0xB1 00 00 3C 511 +0xB1 00 00 3C ~/~/Same as AT+ATDC=60000 537 537 538 538 514 +=== 3.3.3 Set Sports Mode Packet transmission interval === 539 539 540 -=== 3.2.3 Set Sports Mode Packet transmission interval === 541 - 542 - 543 543 Set sports packet transmit interval 544 544 545 545 * AT Command: ... ... @@ -546,18 +546,17 @@ 546 546 547 547 AT+MTDC=xx. 548 548 549 - Example: **~-~-> **Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000522 + Example: AT+MTDC=300000 à Set Sports Mode Packet Interval to 300 seconds. TrackerD will send every 300 seconds in Sports mode, Default Value: 300000 550 550 551 551 552 552 * Downlink Payload (prefix 0x03): 553 553 554 -0x03 00 01 2C 527 +0x03 00 01 2C ~/~/Same as AT+ MTDC=3000000 555 555 556 556 557 557 558 -=== 3. 2.4 Exit Alarm ===531 +=== 3.3.4 Exit Alarm === 559 559 560 - 561 561 Server send downlink command to exit Alarm mode 562 562 563 563 * AT Command: ... ... @@ -567,13 +567,11 @@ 567 567 568 568 * Downlink Payload (prefix 0x02): 569 569 570 -0x02 01 542 +0x02 01 ~/~/ Exit Alarm Mode 571 571 572 572 545 +=== 3.3.5 Disable/Enable LED flash === 573 573 574 -=== 3.2.5 Disable/Enable LED flash === 575 - 576 - 577 577 Disable/Enable LED for position, downlink and uplink 578 578 579 579 * AT Command: ... ... @@ -580,17 +580,17 @@ 580 580 581 581 AT+LON=xx. (Disable (0), Enable (1), default:1) 582 582 583 - Example: AT+LON=0 **~-~-> **Disable LED for position, downlink and uplink.553 + Example: AT+LON=0 à Disable LED for position, downlink and uplink. 584 584 585 585 586 586 * Downlink Payload (prefix 0xAE): 587 587 588 -0xAE 00 558 +0xAE 00 ~/~/Same as AT+LON=0 589 589 590 590 591 591 592 -=== 3.2.6 Disable/Enable movement detect (Debug Only) === 593 593 563 +=== 3.3.6 Disable/Enable movement detect (Debug Only) === 594 594 595 595 User can use this feature to check and set thread hole of movement detect 596 596 ... ... @@ -598,53 +598,50 @@ 598 598 599 599 AT+INTWK=xx. (Disable (0), Enable (1), default:0) 600 600 601 - Example: **~-~-> **Enable detect movement.571 + Example: AT+ INTWK =1 à Enable detect movement. 602 602 603 603 604 604 * Downlink Payload (prefix 0xAF): 605 605 606 -0xAF 01 576 +0xAF 01 ~/~/Same as AT+ INTWK =1 607 607 608 608 609 609 610 -=== 3. 2.7 Set Positioning Mode ===580 +=== 3.3.7 Set Positioning Mode === 611 611 612 - 613 613 SMOD define the how TrackerD scan and uplink date. 614 614 615 -GPS室外定位模式: 584 +GPS室外定位模式:设备默认模式,设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是3分钟定位,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。GPS还有一种logdata模式,在断网的情况下将数据存储下来,等到有网的时候,一次将数据以每10秒上报。 616 616 617 -BLE室内定位模式: 586 + BLE室内定位模式:设备入网后会发送device当前模式下的信息,随后立即定位发送数据包(默认是5秒,超过将发送无效数据),如果出现意外情况下,快速按键3下,将会发出报警消息(默认每3分钟发送一次)。 618 618 619 -GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。 588 + GPS和BLE混动模式:设备入网后会发送device当前模式下的信息,随后立即判断是否在室内,如果是就进行BLE定位,不是就GPS定位。如果出现意外情况下,快速按键3下,将会发出报警消息(默认每分钟发送一次)。 620 620 621 -运动模式: 590 +运动模式:设备入网后会发送device当前模式下的信息,随后发送GPS定位数据,设备判断是否在运动,没有运动传感器没有检测到动作,立即进入静止状态(默认20分钟),如果产生运动,将每5分钟发送一次数据,再第五分钟后检测设备有误运动,无将切换到静止状态,有立即发送数据。 622 622 623 623 624 624 594 + 625 625 * AT Command: 626 626 627 627 AT+SMOD=xx. 628 628 599 + Example: 629 629 630 - **Example:**601 + AT+ SMOD =1,0 à GPS+ BAT+ State+Tem&Hum 631 631 632 - AT+ SMOD =1, 0**~-~-> **GPS+BAT+State+Tem&Hum603 + AT+ SMOD =1,1 à GPS +BAT State 633 633 634 - AT+ SMOD = 1,1**~-~->**GPS+BAT605 + AT+ SMOD =2,3 à (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 635 635 636 - AT+ SMOD =2,3 **~-~->** (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State。 637 637 638 - 639 639 * Downlink Payload (prefix 0xA5): 640 640 641 -0xA5 01 00 610 +0xA5 01 00 ~/~/ Same as AT+ SMOD =1,0 642 642 643 643 613 +=== 3.3.8 Set MAX GPS position time === 644 644 645 -=== 3.2.8 Set MAX GPS position time === 646 - 647 - 648 648 Set max positioning time, default is 150 seconds. TrackerD will try to get location info within this period. If fail to get position data within this time, TrackerD will use 000000 for latitude and longitude. 649 649 650 650 ... ... @@ -653,40 +653,39 @@ 653 653 654 654 * AT Command: 655 655 656 -AT+FTIME=xx **~-~-> **Set to use xx as max fix time.623 +AT+FTIME=xx à Set to use xx as max fix time. 657 657 658 -Example: 625 +Example: AT+FTIME=150 659 659 660 660 661 661 * Downlink Payload (prefix 0xAA): 662 662 663 -0xAA 00 96 630 +0xAA 00 96 ~/~/Set AT+FTIME=150 664 664 665 665 666 666 634 + 667 667 === 3.3.9 Set PDOP value for GPS fix accuracy === 668 668 637 +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. 669 669 670 -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. 671 671 672 - 673 673 A GPS packet with lower PDOP has higher accuracy. PDOP default value is 2.0 674 674 675 675 676 676 * AT Command: 677 677 678 -AT+PDOP=2.5 **~-~-> **Set PDOP to 2.5645 +AT+PDOP=2.5 à Set PDOP to 2.5 679 679 680 680 681 681 * Downlink Payload (prefix 0xAD): 682 682 683 -0xAD 00 0A 650 +0xAD 00 0A ~/~/Set AT+PDOP=1 (0x0A / 10 =1) 684 684 685 -0xAD 00 19 652 +0xAD 00 19 ~/~/Set AT+PDOP=2.5 (0x19 / 10 =2.5) 686 686 687 -0xAD 00 46 654 +0xAD 00 46 ~/~/Set AT+PDOP=7 (0x46 / 10 =7) 688 688 689 - 690 690 Disable/Enable the confirmation mode 691 691 692 692 * AT Command: ... ... @@ -693,20 +693,22 @@ 693 693 694 694 AT+CFM=xx. 695 695 662 + Example: 696 696 697 - **~Example:**664 + AT+ CFM=0 à Disable confirmation 698 698 699 - AT+ CFM= 0**~-~->** Disable confirmation666 + AT+ CFM=1 à Enable confirmation 700 700 701 - AT+ CFM=1 **~-~-> ** Enable confirmation 702 702 703 - 704 704 * Downlink Payload (prefix 0x05): 705 705 706 -0x05 01 671 +0x05 01 ~/~/ Same as AT+ SMOD =1 707 707 708 708 709 709 675 + 676 + 677 + 710 710 = 4. Setting for Different Scenarios = 711 711 712 712 ... ... @@ -716,41 +716,35 @@ 716 716 717 717 == 5.1 Firmware Change Log == 718 718 719 - 720 720 **[[See this link>>url:https://github.com/dragino/TrackerD]]** 721 721 722 722 723 - 724 724 == 5.2 How to upgrade firmware == 725 725 692 +User can use the TrackerD ’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below: 726 726 727 -User can use the TrackerD's USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below: 728 728 695 +**(% style="color:blue" %)Step1: **(%%)Connect TrackerD and PC via USB cable shipped with TrackerD. 729 729 730 -(% style="color:blue" %) **Step1:ConnectTrackerDand PCvia USB cableshippedwithTrackerD.697 +**(% style="color:blue" %)Step2:** (%%) Install CH9102 driver in the PC. 731 731 732 - 733 -(% style="color:blue" %)**Step2:** (%%) Install CH9102 driver in the PC. 734 - 735 735 After installation of the driver and plug in TrackerD, user should be able to see com port in PC's device manager. 736 736 737 737 738 -(% style="color:blue" %) **Step3:**(%%) Download and Install Flash Tool:702 +**(% style="color:blue" %)Step3:**(%%) Download and Install Flash Tool: 739 739 740 740 [[https:~~/~~/www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools>>url:https://www.espressif.com.cn/en/support/download/other-tools?keys=Flash%2BDownload%2BTools]] 741 741 706 +**(% style="color:blue" %)Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 742 742 743 -(% style="color:blue" %)**Step4:** (%%) Run Flash Download Tool and configure chip type to ESP32 744 744 709 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png||alt="image-20220712083115-1.png"]] 745 745 746 -[[image: 1664503563660-578.png]]711 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png||alt="image-20220712083115-2.png"]] 747 747 748 748 749 - [[image:1664503574618-659.png]]714 +**(% style="color:blue" %)Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 750 750 751 - 752 -(% style="color:blue" %)**Step5:** (%%) Select the firmware file (.bin format), com port and proper SPI configure. Clink Start. Bin file location: 753 - 754 754 [[https:~~/~~/www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0>>url:https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 755 755 756 756 ... ... @@ -760,17 +760,16 @@ 760 760 761 761 ESP_LORA-eeprom-class.bin @ 0x10000 762 762 725 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png||alt="image-20220712083115-3.png"]] 763 763 764 - [[image:1664503593459-435.png]]727 +After upgrade finish, it will show finish as below: 765 765 729 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png||alt="image-20220712083115-4.png"]] 766 766 767 767 768 -After upgrade finish, it will show finish as below: 769 769 770 -[[image:1664503611848-385.png]] 771 771 772 772 773 - 774 774 = 6. Developer Guide = 775 775 776 776 ... ... @@ -780,27 +780,28 @@ 780 780 === 6.1.1 Set up ARDUINO compile environment === 781 781 782 782 783 -* Download the latest Arduino software (IDE) from the Arduino official website : [[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]]744 +* Download the latest Arduino software (IDE) from the Arduino official website 784 784 785 - Install IDE on PC, open and click **File ~-~-> Preference**, add the following URL:[[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]]746 +[[https:~~/~~/www.arduino.cc/en/Main/Software>>url:https://www.arduino.cc/en/Main/Software]] 786 786 748 +Install IDE on PC, open and click File ~-~-> Preference, add the following URL [[https:~~/~~/dl.espressif.com/dl/package_esp32_index.json>>url:https://links.jianshu.com/go?to=https%3A%2F%2Fdl.espressif.com%2Fdl%2Fpackage_esp32_index.json]] 787 787 788 -[[image: 1664503635019-941.png]]750 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]] 789 789 790 - 791 791 * Go to tools ~-~-> Boards ~-~-> Boards Manager, find the esp32 information and install it. 792 792 754 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]] 793 793 794 -[[image:1664503715811-892.png]] 795 795 757 +* Download the latest TrackerD from the dragino github 796 796 759 +[[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 797 797 798 -* Download the latest TrackerD from the dragino github: [[https:~~/~~/github.com/dragino/TrackerD>>url:https://github.com/dragino/TrackerD]] 799 799 800 -Put the Library in the TrackerD directory into the libraries file in the Arduino directory :762 +Put the Library in the TrackerD directory into the libraries file in the Arduino directory 801 801 764 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]] 802 802 803 -[[image:1664503752288-974.png]] 804 804 805 805 806 806 ... ... @@ -809,19 +809,19 @@ 809 809 810 810 * Open the example in the TrackerD file, please select the correct port in the IDE, as shown below: 811 811 812 -[[image: 1664503794261-827.png]]774 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]] 813 813 776 +* Click to upload 814 814 778 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]] 815 815 816 -* C lick toupload780 +* Check the result, if the upload is successful, as shown below, open the serial port to view the data 817 817 818 -[[image:1664503808294-336.png]] 819 819 783 +[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]] 820 820 821 821 822 -* Check the result, if the upload is successful, as shown below, open the serial port to view the data 823 823 824 -[[image:1664503824081-592.png]] [[image:1664503831430-500.png]] 825 825 826 826 827 827 ... ... @@ -828,6 +828,7 @@ 828 828 = 7. FAQ = 829 829 830 830 793 + 831 831 == 7.1 How to change the LoRa Frequency Bands/Region? == 832 832 833 833 ... ... @@ -853,9 +853,6 @@ 853 853 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 854 854 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 855 855 856 - 857 - 858 - 859 859 = 8. Order Info = 860 860 861 861 ... ... @@ -864,6 +864,7 @@ 864 864 (% style="color:blue" %)**XXX**(%%): The default frequency band 865 865 866 866 * (% style="color:red" %)**EU433**(%%): Default frequency band EU433 827 +* (% style="color:red" %)**CN470**(%%): Default frequency band CN470 867 867 * (% style="color:red" %)**EU868**(%%): Default frequency band EU868 868 868 * (% style="color:red" %)**IN865**(%%): Default frequency band IN865 869 869 * (% style="color:red" %)**KR920**(%%): Default frequency band KR920 ... ... @@ -872,31 +872,32 @@ 872 872 * (% style="color:red" %)**US915**(%%): Default frequency band US915 873 873 874 874 875 - 876 - 877 877 = 9. Packing Info = 878 878 879 879 880 880 **Package Includes**: 881 881 882 -* TrackerD LoRaWAN GPS/BLE Tracker x 1 883 -* USB recharge & program cable x 1 841 +* TrackerD x 1 842 +* Rechargeable cable x 1 843 +* Program Cable x 1 884 884 885 885 **Dimensions and Weight**: 886 886 887 -* Device Size: 85 x 48 x 15 cm888 -* Weight: 5 0g847 +* Device Size: 85 x 48 x 15 mm/pcs 848 +* Weight: 55g/pcs 889 889 890 890 891 891 892 892 = 10. Support = 893 893 894 - 895 895 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 896 -* 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]]855 +* 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 897 897 857 +[[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]] 898 898 899 899 860 + 861 + 900 900 = 11. Reference = 901 901 902 902
- 1664503831430-500.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -147.8 KB - Content
- 1664505654417-133.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.5 KB - Content