Datasheet

AN335
Rev. 0.2 5
4. Customization of the Driver Installer
To customize a driver installation use the DriverCustomization.exe utility provided in the AN220 software package
and documented in the AN220 document. It is not recommended to change anything by hand since this application
performs everything for you automatically.
There is an explanation below of the INI format. Any hand editing done here must match up with the INF (such as
VID and PID) but is not recommended.
4.1. setup.ini Format
The setup.ini file contains a set of entries denoted by [<option>]. All of the bracketed entries are case sensitive and
must be exact or the DriverInstaller.exe will ignore it. The value of the entry is directly below the bracketed entry
line. Each entry and selection must be separated by a blank line. (See section “4.1.1. Example setup.ini”) Some of
these bracketed entries are required, and some are not. Also, some are case sensitive (such as strings, what you
type is what you will see) and some are not (such as “on, off, yes, no” options). Each entry is described in detail
below:
[Driver Type]—REQUIRED—This is the type of driver that you are trying to install. Currently there is support for
two driver types which are both case sensitive:
 USBXpress
 VCP CP210x Cardinal
USBXpress and VCP CP210x Cardinal specify a USBXpress driver installation and CP210x driver installation,
respectively.
[Driver Version]—REQUIRED—This is the version of the driver you are trying to install. This is a string and will
appear exactly as entered.
[Product Name]—REQUIRED—This is the product name for the device you are installing. This string will also
appear in the Add/Remove Programs as “<product string> (Driver Removal)”. This is a string and will appear
exactly as entered.
[Company Name]—REQUIRED—This is the name of the company that is distributing the driver set. This is a
string and will appear exactly as entered.
[VID]—REQUIRED—This is the 4 character hexadecimal VID of the device that matches this driver (example:
10C4). This is not case sensitive.
[PID]—REQUIRED—This is the 4 character hexadecimal PID of the device that matches this driver (example:
EA61). This is not case sensitive.
[Relative Install]—OPTIONAL (required if not using a drive relative path in the [Install Directory] and [Copy Driver
Files] = Yes)—This allows the driver to be installed relative to either the Windows Drive or the Program Files
Directory. This is done by specifying one of the following, which is case sensitive:
 Relative To Program Files
 Relative To Windows Drive
If you specify one of the above, then you can simply specify the Install Directory as
"Directory\SubDirectory\SubSubDirectory", and it will be placed directly under the relative path chosen.
[Install Directory]—OPTIONAL (required if [Copy Driver Files] = Yes)—This is the default driver installation
directory that appears on the Installer window. This is a string and will appear exactly as entered. This directory
does not need to exist, as the installer will create it for you.
[Install Subdirectories]—OPTIONAL (required if [Copy Driver Files = Yes)—If any drivers to be copied contain a
.\*subdir*\driver.sys all *subdir* names should be listed here.