diff options
author | Dave Chapman <dave@dchapman.com> | 2007-11-10 20:26:54 +0000 |
---|---|---|
committer | Dave Chapman <dave@dchapman.com> | 2007-11-10 20:26:54 +0000 |
commit | a5e4cc9e68640ed9ee82c02e7b9796c8511cfccf (patch) | |
tree | 8fa11c86514cafdfe8259f265f14c0d578abb936 | |
parent | 0d8111cb399cf9db7a25d4a5ddc867a22de1a5bc (diff) | |
download | rockbox-a5e4cc9e68640ed9ee82c02e7b9796c8511cfccf.tar.gz rockbox-a5e4cc9e68640ed9ee82c02e7b9796c8511cfccf.zip |
Document how to use tcctool in Windows, and include the appropriate .inf file for use with the libusb-win32 device driver
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@15559 a1c6a512-1295-4272-9138-f99709370657
-rw-r--r-- | utils/tcctool/README | 27 | ||||
-rw-r--r-- | utils/tcctool/tcctool-driver-win32/tcc.cat | 3 | ||||
-rw-r--r-- | utils/tcctool/tcctool-driver-win32/tcc.inf | 139 | ||||
-rw-r--r-- | utils/tcctool/tcctool-driver-win32/tcc_x64.cat | 3 | ||||
-rwxr-xr-x | utils/tcctool/tcctool-windows.txt | 31 |
5 files changed, 203 insertions, 0 deletions
diff --git a/utils/tcctool/README b/utils/tcctool/README index c2fa8a0fb9..2031f6fdb9 100644 --- a/utils/tcctool/README +++ b/utils/tcctool/README | |||
@@ -27,3 +27,30 @@ A first test when using tcctool on a new device can be to upload the | |||
27 | original firmware. If you do this, make sure you upload the same | 27 | original firmware. If you do this, make sure you upload the same |
28 | version that is installed on your player - otherwise you may find | 28 | version that is installed on your player - otherwise you may find |
29 | yourself with corrupted config files and music database. | 29 | yourself with corrupted config files and music database. |
30 | |||
31 | |||
32 | Building for Windows | ||
33 | -------------------- | ||
34 | |||
35 | 1) Download libusb-win32-device-bin-0.1.12.1.tar.gz from: | ||
36 | |||
37 | http://sourceforge.net/project/showfiles.php?group_id=78138 | ||
38 | |||
39 | 2) Extract libusb-win32-device-bin-0.1.12.1.tar.gz in the tcctool | ||
40 | source directory. | ||
41 | |||
42 | 3) Type "make tcctool.exe" to compile. | ||
43 | |||
44 | 4) Copy the following four files from libusb-win32-device-bin-0.1.12.1/bin | ||
45 | to tcctool-driver-win32/ | ||
46 | |||
47 | libusb0.dll | ||
48 | libusb0.sys | ||
49 | libusb0_x64.dll | ||
50 | libusb0_x64.sys | ||
51 | |||
52 | 5) Create the tcctool-win32.zip file from the directory above tcctool as follows: | ||
53 | |||
54 | zip tcctool-win32.zip tcctool/tcctool.exe tcctool/tcctool-windows.txt tcctool/tcctool-driver/win32/* | ||
55 | |||
56 | 6) See tcctool/tcctool-windows.txt for Windows usage instructions. | ||
diff --git a/utils/tcctool/tcctool-driver-win32/tcc.cat b/utils/tcctool/tcctool-driver-win32/tcc.cat new file mode 100644 index 0000000000..2ef39c526e --- /dev/null +++ b/utils/tcctool/tcctool-driver-win32/tcc.cat | |||
@@ -0,0 +1,3 @@ | |||
1 | This file will contain the digital signature of the files to be installed | ||
2 | on the system. | ||
3 | This file will be provided by Microsoft upon certification of your drivers. | ||
diff --git a/utils/tcctool/tcctool-driver-win32/tcc.inf b/utils/tcctool/tcctool-driver-win32/tcc.inf new file mode 100644 index 0000000000..63bc8a64d4 --- /dev/null +++ b/utils/tcctool/tcctool-driver-win32/tcc.inf | |||
@@ -0,0 +1,139 @@ | |||
1 | [Version] | ||
2 | Signature = "$Chicago$" | ||
3 | provider = %manufacturer% | ||
4 | DriverVer = 03/20/2007,0.1.12.1 | ||
5 | CatalogFile = tcc.cat | ||
6 | CatalogFile.NT = tcc.cat | ||
7 | CatalogFile.NTAMD64 = tcc_x64.cat | ||
8 | |||
9 | Class = LibUsbDevices | ||
10 | ClassGUID = {EB781AAF-9C70-4523-A5DF-642A87ECA567} | ||
11 | |||
12 | [ClassInstall] | ||
13 | AddReg=libusb_class_install_add_reg | ||
14 | |||
15 | [ClassInstall32] | ||
16 | AddReg=libusb_class_install_add_reg | ||
17 | |||
18 | [libusb_class_install_add_reg] | ||
19 | HKR,,,,"LibUSB-Win32 Devices" | ||
20 | HKR,,Icon,,"-20" | ||
21 | |||
22 | [Manufacturer] | ||
23 | %manufacturer%=Devices,NT,NTAMD64 | ||
24 | |||
25 | ;-------------------------------------------------------------------------- | ||
26 | ; Files | ||
27 | ;-------------------------------------------------------------------------- | ||
28 | |||
29 | [SourceDisksNames] | ||
30 | 1 = "Libusb-Win32 Driver Installation Disk",, | ||
31 | |||
32 | [SourceDisksFiles] | ||
33 | libusb0.sys = 1,, | ||
34 | libusb0.dll = 1,, | ||
35 | libusb0_x64.sys = 1,, | ||
36 | libusb0_x64.dll = 1,, | ||
37 | |||
38 | [DestinationDirs] | ||
39 | libusb_files_sys = 10,system32\drivers | ||
40 | libusb_files_sys_x64 = 10,system32\drivers | ||
41 | libusb_files_dll = 10,system32 | ||
42 | libusb_files_dll_wow64 = 10,syswow64 | ||
43 | libusb_files_dll_x64 = 10,system32 | ||
44 | |||
45 | [libusb_files_sys] | ||
46 | libusb0.sys | ||
47 | |||
48 | [libusb_files_sys_x64] | ||
49 | libusb0.sys,libusb0_x64.sys | ||
50 | |||
51 | [libusb_files_dll] | ||
52 | libusb0.dll | ||
53 | |||
54 | [libusb_files_dll_wow64] | ||
55 | libusb0.dll | ||
56 | |||
57 | [libusb_files_dll_x64] | ||
58 | libusb0.dll,libusb0_x64.dll | ||
59 | |||
60 | ;-------------------------------------------------------------------------- | ||
61 | ; Device driver | ||
62 | ;-------------------------------------------------------------------------- | ||
63 | |||
64 | [LIBUSB_DEV] | ||
65 | CopyFiles = libusb_files_sys, libusb_files_dll | ||
66 | AddReg = libusb_add_reg | ||
67 | |||
68 | [LIBUSB_DEV.NT] | ||
69 | CopyFiles = libusb_files_sys, libusb_files_dll | ||
70 | |||
71 | [LIBUSB_DEV.NTAMD64] | ||
72 | CopyFiles = libusb_files_sys_x64, libusb_files_dll_wow64, libusb_files_dll_x64 | ||
73 | |||
74 | [LIBUSB_DEV.HW] | ||
75 | DelReg = libusb_del_reg_hw | ||
76 | AddReg = libusb_add_reg_hw | ||
77 | |||
78 | [LIBUSB_DEV.NT.HW] | ||
79 | DelReg = libusb_del_reg_hw | ||
80 | AddReg = libusb_add_reg_hw | ||
81 | |||
82 | [LIBUSB_DEV.NTAMD64.HW] | ||
83 | DelReg = libusb_del_reg_hw | ||
84 | AddReg = libusb_add_reg_hw | ||
85 | |||
86 | [LIBUSB_DEV.NT.Services] | ||
87 | AddService = libusb0, 0x00000002, libusb_add_service | ||
88 | |||
89 | [LIBUSB_DEV.NTAMD64.Services] | ||
90 | AddService = libusb0, 0x00000002, libusb_add_service | ||
91 | |||
92 | [libusb_add_reg] | ||
93 | HKR,,DevLoader,,*ntkern | ||
94 | HKR,,NTMPDriver,,libusb0.sys | ||
95 | |||
96 | ; Older versions of this .inf file installed filter drivers. They are not | ||
97 | ; needed any more and must be removed | ||
98 | [libusb_del_reg_hw] | ||
99 | HKR,,LowerFilters | ||
100 | HKR,,UpperFilters | ||
101 | |||
102 | ; Device properties | ||
103 | [libusb_add_reg_hw] | ||
104 | HKR,,SurpriseRemovalOK, 0x00010001, 1 | ||
105 | |||
106 | ;-------------------------------------------------------------------------- | ||
107 | ; Services | ||
108 | ;-------------------------------------------------------------------------- | ||
109 | |||
110 | [libusb_add_service] | ||
111 | DisplayName = "LibUsb-Win32 - Kernel Driver 03/20/2007, 0.1.12.1" | ||
112 | ServiceType = 1 | ||
113 | StartType = 3 | ||
114 | ErrorControl = 0 | ||
115 | ServiceBinary = %12%\libusb0.sys | ||
116 | |||
117 | ;-------------------------------------------------------------------------- | ||
118 | ; Devices | ||
119 | ;-------------------------------------------------------------------------- | ||
120 | |||
121 | [Devices] | ||
122 | "TCC77x usb-boot mode"=LIBUSB_DEV, USB\VID_140E&PID_B021 | ||
123 | "TCC7801 usb-boot mode"=LIBUSB_DEV, USB\VID_140E&PID_B011 | ||
124 | |||
125 | [Devices.NT] | ||
126 | "TCC77x usb-boot mode"=LIBUSB_DEV, USB\VID_140E&PID_B021 | ||
127 | "TCC7801 usb-boot mode"=LIBUSB_DEV, USB\VID_140E&PID_B011 | ||
128 | |||
129 | [Devices.NTAMD64] | ||
130 | "TCC77x usb-boot mode"=LIBUSB_DEV, USB\VID_140E&PID_B021 | ||
131 | "TCC7801 usb-boot mode"=LIBUSB_DEV, USB\VID_140E&PID_B011 | ||
132 | |||
133 | |||
134 | ;-------------------------------------------------------------------------- | ||
135 | ; Strings | ||
136 | ;-------------------------------------------------------------------------- | ||
137 | |||
138 | [Strings] | ||
139 | manufacturer = "Telechips" | ||
diff --git a/utils/tcctool/tcctool-driver-win32/tcc_x64.cat b/utils/tcctool/tcctool-driver-win32/tcc_x64.cat new file mode 100644 index 0000000000..2ef39c526e --- /dev/null +++ b/utils/tcctool/tcctool-driver-win32/tcc_x64.cat | |||
@@ -0,0 +1,3 @@ | |||
1 | This file will contain the digital signature of the files to be installed | ||
2 | on the system. | ||
3 | This file will be provided by Microsoft upon certification of your drivers. | ||
diff --git a/utils/tcctool/tcctool-windows.txt b/utils/tcctool/tcctool-windows.txt new file mode 100755 index 0000000000..d116bfeefe --- /dev/null +++ b/utils/tcctool/tcctool-windows.txt | |||
@@ -0,0 +1,31 @@ | |||
1 | tcctool for Windows | ||
2 | ------------------- | ||
3 | |||
4 | Installation | ||
5 | ------------ | ||
6 | |||
7 | When you first attach your device in USB boot mode to your computer, | ||
8 | Windows should display the Found New Hardware Wizard. | ||
9 | |||
10 | If this doesn't appear, and if you have previously used a firmware | ||
11 | recovery tool with your device, you will need to uninstall the USB | ||
12 | driver used by that application. | ||
13 | |||
14 | Go into Control Panel -> System -> Hardware -> Device Manager, then | ||
15 | click on Universal Serial Bus Controllers, look for something like | ||
16 | "Telechips TCC77x VTC USB Driver", right-click on it and select | ||
17 | Uninstall. | ||
18 | |||
19 | After doing this, disconnect and reconnect your device and the Found | ||
20 | New Hardware Wizard should appear. | ||
21 | |||
22 | Select "No, not this time" to the question about connecting to Windows | ||
23 | Update, and select "Install from a list or specific location | ||
24 | (Advanced)" on the next screen. | ||
25 | |||
26 | On the next screen, select "Search for the best driver in these | ||
27 | locations", unselect "Search removable media", select "Include this | ||
28 | location in the search:" and browse to the tcctool-driver-win32 | ||
29 | folder. | ||
30 | |||
31 | You should now be able to run tcctool.exe | ||