Changes for page TrackerD -- LoRaWAN Tracker User Manual
Last modified by Xiaoling on 2025/04/27 16:48
From version 88.1
edited by Kilight Cao
on 2022/11/01 15:59
on 2022/11/01 15:59
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Kilight1 +XWiki.Xiaoling - Content
-
... ... @@ -97,6 +97,8 @@ 97 97 * LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm 98 98 * Tracking: max: 38mA 99 99 100 + 101 + 100 100 == 1.3 Features == 101 101 102 102 ... ... @@ -115,6 +115,8 @@ 115 115 * Tri-color LED, Alarm button 116 116 * Datalog 117 117 120 + 121 + 118 118 == 1.4 Applications == 119 119 120 120 ... ... @@ -121,9 +121,11 @@ 121 121 * Logistics and Supply Chain Management 122 122 * Human tracking 123 123 124 -= 2.1 Use TrackerD = 125 125 126 126 130 += 2. Use TrackerD = 131 + 132 + 127 127 == 2.1 How it works? == 128 128 129 129 ... ... @@ -279,7 +279,7 @@ 279 279 280 280 (% style="color:red" %)** 1: ** (%%) BLE Positioning with Strongest iBeacon 281 281 282 -(% style="color:red" %)** 2:** (%%) 288 +(% style="color:red" %)** 2:** (%%)WiFi Positioning with Strongest WiFi SSID(% style="color:blue" %)(V1.4.1 Version support this function later)(%%) 283 283 284 284 285 285 (% style="color:#037691" %)**Status Field (total 1 byte)**(%%): 0x02 ... ... @@ -288,6 +288,8 @@ 288 288 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)5 Bits|(% style="width:60px" %)1 Bit|(% style="width:20px" %)1 Bit|(% style="width:80px" %)1 Bit 289 289 |=(% style="width: 77px;" %)**Value**|(% style="width:70px" %)Reserve|(% style="width:92px" %)[[PNACKMD>>||anchor="H2.4.4A0UplinkFPORT3D42CHistoryGNSSPositioning"]]|(% style="width:48px" %)[[LON>>||anchor="H3.2.5Disable2FEnableLEDflash"]]|(% style="width:126px" %)[[Transport Mode>>||anchor="H2.9TransportMode"]] 290 290 297 + 298 + 291 291 === 2.4.2 Uplink FPORT~=2, Realtime GNSS Positioning + Temperature & Humidity === 292 292 293 293 ... ... @@ -315,6 +315,8 @@ 315 315 |=(% scope="row" style="width: 50px;" %)**Size(bit)**|(% style="width:50px" %)1 bit|(% style="width:80px" %)1bit|(% style="width:50px" %)14bits 316 316 |=(% style="width: 72px;" %)**Value**|(% style="width:67px" %)reserve|(% style="width:118px" %)Alarm Indicate|(% style="width:63px" %)[[BAT>>||anchor="HBAT:"]] 317 317 326 + 327 + 318 318 ==== (% style="color:blue" %)**FLAG:**(%%) ==== 319 319 320 320 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:120px" %) ... ... @@ -364,6 +364,8 @@ 364 364 * 3.40v ~~ 3.69v: 20% ~~ 40% 365 365 * < 3.39v: 0~~20% 366 366 377 + 378 + 367 367 ==== (% style="color:blue" %)**MOD:**(%%) ==== 368 368 369 369 **Example: ** (0x60>>6) & 0x3f =1 ... ... @@ -433,7 +433,7 @@ 433 433 (% style="color:red" %)**Note for this mode:** 434 434 435 435 * a) TrackerD will do an ACK check for data records sending to make sure every data arrive server. 436 -* 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.448 +* b) TrackerD will send data in CONFIRMED Mode when PNACKMD=1 and CFM=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. 437 437 * c) the total payload will be 15 bytes, while US915/AU915 DR0 accepts only 11 bytes of payload. In this case (DR0 of US915/AU915), the payload on server will show NULL 438 438 439 439 The payload is 15 bytes, as below. ... ... @@ -485,10 +485,10 @@ 485 485 486 486 487 487 488 -=== 2.4.6 Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID === 500 +=== 2.4.6 Uplink FPORT~=8, WiFi Positioning with Strongest WiFi SSID(Since firmware 1.4.1) === 489 489 490 490 491 -TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to ** BLE pure** or **GPS/BLE hybrid** so TrackerD will scan WiFi and find the strongest WiFi info and uplink.503 +TrackerD supports WiFi scans for indoor positioning. User can set [[**SMOD**>>||anchor="H3.2.7SetPositioningMode"]] to **WiFi** so TrackerD will scan WiFi and find the strongest WiFi info and uplink. 492 492 493 493 494 494 (% border="1.2" cellspacing="3" style="background-color:#ffffcc; color:green; width:371.222px" %) ... ... @@ -537,6 +537,7 @@ 537 537 538 538 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]] 539 539 552 + 540 540 [[image:1664502695771-538.png]] 541 541 542 542 ... ... @@ -549,7 +549,6 @@ 549 549 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]] 550 550 551 551 552 - 553 553 [[image:1664502715371-321.png]] 554 554 555 555 ... ... @@ -620,6 +620,8 @@ 620 620 |(% style="width:157px" %)**Get Downlink**|(% style="width:271px" %)(% style="color:green" %)**GREEN**(%%) led on 1 second|(% style="width:202px" %)Yes 621 621 |(% style="width:157px" %)**Movement Detect**|(% style="width:271px" %)(% style="color:red" %)**RED **(%%)led on 500ms|(% style="width:202px" %)N/A 622 622 635 + 636 + 623 623 == 2.11 Button Function == 624 624 625 625 ... ... @@ -641,6 +641,8 @@ 641 641 |(% 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 642 642 |(% 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. 643 643 658 + 659 + 644 644 == 2.12 USB Port Function == 645 645 646 646 ... ... @@ -651,6 +651,8 @@ 651 651 * [[Configure Device>>||anchor="H3.ConfigureTrackerDviaATcommandorLoRaWANdownlink"]] 652 652 * [[Upgrade Firmware>>||anchor="H5.UploadFirmware"]] 653 653 670 + 671 + 654 654 = 3. Configure TrackerD via AT command or LoRaWAN downlink = 655 655 656 656 ... ... @@ -735,7 +735,7 @@ 735 735 736 736 * (% style="color:blue" %)**Downlink Payload (prefix 0x03):** 737 737 738 -(% style="color:#037691" %)**0x03 00 01 2C** (%%) ~/~/ Same as AT+ 756 +(% style="color:#037691" %)**0x03 00 01 2C** (%%) ~/~/ Same as AT+MTDC=3000000 739 739 740 740 741 741 ... ... @@ -779,12 +779,12 @@ 779 779 780 780 (% style="color:#037691" %)**AT+INTWK=xx. (Disable (0), Enable (1), default:0)** 781 781 782 -Example: AT+ 800 +Example: AT+INTWK=1 **~-~-> ** Enable Transport Mode. 783 783 784 784 785 785 * (% style="color:blue" %)**Downlink Payload (prefix 0xAF):** 786 786 787 -(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/ Same as AT+ 805 +(% style="color:#037691" %)**0xAF 01 ** (%%) ~/~/ Same as AT+INTWK=1 788 788 789 789 790 790 ... ... @@ -801,30 +801,37 @@ 801 801 (% style="color:#037691" %)** aa:** 802 802 803 803 * (% style="color:red" %)**1: GPS ONLY(Factory Settings): **(%%)Only get and uplink GPS location info. 822 + 804 804 * (% style="color:red" %)**2: BLE or WiFi ONLY: **(%%)Only obtain iBeacon info via BLE and uplink or obtain WiFi ssid info via WiFi and uplink. Design for Indoor tracking. 805 -* (% style="color:red" %)**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. 806 806 825 +* (% style="color:red" %)**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. 826 + 807 807 (% style="color:#037691" %)**bb:** 808 808 809 809 * (% style="color:red" %)**0 : **(%%)GPS+ BAT+ State+Tem&Hum 830 + 810 810 * (% style="color:red" %)**1 :**(%%) GPS +BAT State 811 811 812 812 (% style="color:#037691" %)**cc: ** 813 813 814 -* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 835 +* (% style="color:red" %)**1 : **(%%) (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 836 + 815 815 * (% style="color:red" %)**2 : **(%%) (WiFi)SSID+Rssi+BAT+State ((% style="color:#037691" %)V1.4.1 Version support this function later(%%)) 816 816 817 817 (% style="color:blue" %)**Example:** 818 818 819 - AT+ SMOD =1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 820 - AT+ SMOD =1,1,0 ~-~-> GPS +BAT State 821 - AT+ SMOD =2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 822 - AT+ SMOD =2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 841 + AT+SMOD=1,0,0 ~-~-> GPS+ BAT+ State+Tem&Hum 823 823 843 + AT+SMOD=1,1,0 ~-~-> GPS +BAT State 824 824 845 + AT+SMOD=2,0,1 ~-~-> (iBeacon)UUID+ Major + Minor+Power+Rssi+BAT+State 846 + 847 + AT+SMOD=2,0,2 ~-~-> (WiFi)SSID+Rssi+BAT+State 848 + 849 + 825 825 * (% style="color:blue" %)**Downlink Payload (prefix 0xA5):** 826 826 827 -(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+ 852 +(% style="color:#037691" %)**0xA5 01 00 00** (%%) ~/~/ Same as AT+SMOD=1,0,0 828 828 829 829 830 830 ... ... @@ -883,14 +883,14 @@ 883 883 884 884 **~ Example:** 885 885 886 - AT+ 911 + AT+CFM=0 **~-~-> ** Disable confirmation 887 887 888 - AT+ 913 + AT+CFM=1 **~-~-> ** Enable confirmation 889 889 890 890 891 891 * (% style="color:blue" %)**Downlink Payload (prefix 0x05):** 892 892 893 -(% style="color:#037691" %)**0x05 01 **(%%) ~/~/ Same as AT+ SMOD=1918 +(% style="color:#037691" %)**0x05 01 **(%%) ~/~/ Same as AT+CFM=1 894 894 895 895 896 896 ... ... @@ -929,31 +929,59 @@ 929 929 930 930 (% style="color:#037691" %)**AT+BLEMASK=0** (%%) ~/~/ disable BLEMASK 931 931 957 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB2)(Since firmware 1.4.1)** 932 932 933 - (% style="color:blue"%)**DownlinkPayload: (Prefix:0xA5)**959 +Example: 0xB2010203040506 ~/~/ Set BLEMASK to 123456 934 934 935 -Example: 0xA5010203040506 ~/~/ Set BLEMASK to 123456 936 936 937 937 938 -=== 3.2.12 Set WiFIMASK to filter WiFi SSID === 963 +=== 3.2.12 Set WiFIMASK to filter WiFi SSID(Since firmware 1.4.1) === 939 939 940 940 941 -WiFiMASK is to filter the unwanted WiFi SSID during scan. For example, if WiFiMASK is 123456. TrackerD will only uplink SSID info which includes 123456. It will ignore all other WiFi which doesn’t contact 123456 in the SSID. 966 +WiFiMASK is to filter the unwanted WiFi SSID during scan. For example, if WiFiMASK is 123456. TrackerD will only uplink SSID info which includes 123456 as prefix. It will ignore all other WiFi which doesn’t contact 123456 in the SSID. 942 942 943 943 (% style="color:red" %)**Note: WiFiMASK range is 6 ~~ 10 bytes. If AT+ WiFiMASK < 6 bytes, WiFiMASK will be disabled.** 944 944 945 945 (% style="color:blue" %)**AT Command:** 946 946 947 - (% style="color:#037691" %)**AT+ 972 + (% style="color:#037691" %)**AT+WiFiMASK=123456** (%%) ~/~/ Set WiFiMASK = 123456 948 948 949 - (% style="color:#037691" %)**AT+ 974 + (% style="color:#037691" %)**AT+WiFiMASK=0** (%%) ~/~/ disable WiFiMASK 950 950 976 +(% style="color:blue" %)**Downlink Payload: (Prefix : 0xB3)(Since firmware 1.4.1)** 951 951 952 - (% style="color:blue"%)**DownlinkPayload:(Prefix:0xA5)**978 +Example: 0xB3010203040506 ~/~/ Set WiFiMASK to 123456 953 953 954 -Example: 0xA5010203040506 ~/~/ Set WiFiMASK to 123456 955 955 956 956 982 +=== 3.2.13 Disable/Enable Information printing(Since firmware 1.4.1) === 983 + 984 + 985 +Users can use this feature to enable/disable Information printing. 986 + 987 +(% style="color:blue" %)**AT Command:** 988 + 989 +(% style="color:#037691" %)**AT+SHOWID=XX **(%%) ~/~/(Disable (0), Enable (1), default:0) 990 +\\Example: AT+SHOWID=1 ~-~-> Enable Information printing. 991 + 992 + 993 + 994 +=== 3.2.14 Get or Set Eight Channels Mode, only for us915, AU915(Since firmware 1.4.1) === 995 + 996 + 997 +The Channels Mode in the LORAWAN LMIC library is from 0 ~~ 7. When CHE = 8, 72 channels will be accessible to the network. 998 + 999 +(% style="color:blue" %)**AT Command:** 1000 + 1001 +(% style="color:#037691" %)**AT+CHE=1**(%%) ~/~/ set one channels mode 1002 + 1003 + 1004 +(% style="color:blue" %)**Downlink Payload:0X24** 1005 + 1006 +Example: 0x24 01 ~/~/ Same as AT+CHE=1 1007 + 1008 + 1009 + 957 957 = 4. Setting for Different Scenarios = 958 958 959 959 ... ... @@ -1110,9 +1110,92 @@ 1110 1110 |(% style="width:118px" %)A8|(% style="width:67px" %)Yellow|(% style="width:123px" %)MTMS/GPIO14 1111 1111 |(% style="width:118px" %)B8|(% style="width:67px" %)Grey|(% style="width:123px" %)MTDO/GPIO15 1112 1112 1113 -= 8. Order Info = 1114 1114 1115 1115 1168 +== 7.3 Notes on using different serial port tools for TrackerD == 1169 + 1170 + 1171 +=== 7.3.1 Serial port utility === 1172 + 1173 + 1174 +Serial port utility requires you to automatically add data streams. 1175 + 1176 +Need to adjust the data stream to RTS/CTS on physical restart. 1177 + 1178 + 1179 +(% class="wikigeneratedid" %) 1180 +[[image:image-20221102140621-1.png]] 1181 + 1182 + 1183 +When using AT commands, the data flow needs to be adjusted to XON/XOFF 1184 + 1185 + 1186 +[[image:image-20221102140638-2.png]] 1187 + 1188 + 1189 + 1190 +=== 7.3.2 SecureCRT === 1191 + 1192 + 1193 +The default command window of SecureCRT is not displayed. Entering a command requires a complete input of the entire command. You can open the command window in the view. 1194 + 1195 + 1196 +[[image:image-20221102140704-3.png]] 1197 + 1198 + 1199 +[[image:image-20221102140712-4.png]] 1200 + 1201 + 1202 + 1203 +=== 7.3.3 PUTTY === 1204 + 1205 + 1206 +[[image:image-20221102140748-5.png]] 1207 + 1208 + 1209 +Since putty does not have a command window, you need to fill in the complete command externally, and then copy it to putty.The information copied outside can be pasted by right-clicking the mouse in putty. 1210 + 1211 + 1212 +[[image:image-20221102140801-6.png]] 1213 + 1214 + 1215 + 1216 += 8 Trouble Shooting = 1217 + 1218 + 1219 +== 8.1 TDC is changed to 4294947296 and cause no uplink. == 1220 + 1221 + 1222 +((( 1223 +Before firmware v1.4.0: When the Transport Mode is enabled (**AT+INTWK=1**), the **TDC** needs to be greater than **MTDC**, otherwise, TDC setting will because 4294947296 after wakre up from motion. This bug is fixed in firmware v1.4.1 1224 +))) 1225 + 1226 + 1227 + 1228 +== 8.2 Device not able get AT Command or show output after wake up from deep sleep mode == 1229 + 1230 + 1231 +((( 1232 +ESP32 is not able to accept the Interrupt from UART after wake up from deep sleep mode. User need to press the button (one click) and trackerD will be able to accept UART command, it there is no action in UART for 15 seconds. it will go to deep sleep mode. 1233 +))) 1234 + 1235 + 1236 + 1237 +== 8.3 The reason why it has been restarted after upgrading(V.1.4.1) == 1238 + 1239 + 1240 +((( 1241 +If it is V1.4.0 and the previous version, new partitions need to be loaded when upgrading. The new version of the software is stored in the partition package. The upgrade method is shown in the figure 1242 +))) 1243 + 1244 + 1245 +[[image:image-20221107145243-1.png||height="695" width="443"]] 1246 + 1247 + 1248 + 1249 += 9. Order Info = 1250 + 1251 + 1116 1116 Part Number: (% style="color:blue" %)**TrackerD-XXX** 1117 1117 1118 1118 (% style="color:blue" %)**XXX**(%%): The default frequency band ... ... @@ -1125,9 +1125,11 @@ 1125 1125 * (% style="color:red" %)**AU915**(%%): Default frequency band AU915 1126 1126 * (% style="color:red" %)**US915**(%%): Default frequency band US915 1127 1127 1128 -= 9. Packing Info = 1129 1129 1130 1130 1266 += 10. Packing Info = 1267 + 1268 + 1131 1131 (% style="color:#037691" %)**Package Includes**: 1132 1132 1133 1133 * TrackerD LoRaWAN GPS/BLE Tracker x 1 ... ... @@ -1135,18 +1135,24 @@ 1135 1135 1136 1136 (% style="color:#037691" %)**Dimensions and Weight**: 1137 1137 1138 -* Device Size: 85 x 48 x 15 cm1276 +* Device Size: 85 x 48 x 15 mm 1139 1139 * Weight: 50g 1140 1140 1141 -= 10. Support = 1142 1142 1143 1143 1281 += 11. Support = 1282 + 1283 + 1144 1144 * 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. 1145 1145 * 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]]. 1146 1146 1147 -= 11. Reference = 1148 1148 1149 1149 1289 += 12. Reference = 1290 + 1291 + 1150 1150 * [[**Firmware in Bin format**>>https://www.dropbox.com/sh/733s8xlwahhqg1d/AABxDz80lBVX_to8zNuUQWFja?dl=0]] 1151 1151 * **[[Source Code>>https://github.com/dragino/TrackerD]] ** 1152 1152 * [[**Hardware Source**>>https://www.dropbox.com/sh/orwoy6cecb89m4e/AAD37sRuUrvKsHgAJxuVTkB5a?dl=0]] 1295 + 1296 +
- image-20221102140621-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +46.1 KB - Content
- image-20221102140638-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +40.8 KB - Content
- image-20221102140704-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +15.5 KB - Content
- image-20221102140712-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +73.2 KB - Content
- image-20221102140748-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +56.0 KB - Content
- image-20221102140801-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +21.0 KB - Content
- image-20221107145243-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +107.3 KB - Content