Datasheet

ManualsBrandsUnbranded ManualsC-ControlData gateway USB , RS232 Compatible with: C-Control

AN335

USB DRIVER INSTALLATION UTILITY

1. Description

The driver installer and uninstaller combination is a customizable installation utility for Silicon Laboratories USB

drivers. These utilities are completely independent of the actual driver and no referencing is done by the INF file to

the installer or uninstaller. This is desirable because certification of the driver is not affected by changes in the

installation utility, and the installation utility is not required by the driver if a customer does not want to use it. The

utilities currently work under Windows 2000, XP, Server 2003, and Vista.

This also means that as newer versions of the installer are released, they can be dropped into an existing

installation package without un-certifying or breaking the installation while still taking advantage of the latest bug

fixes or enhancements.

This application note provides a description of utility usage and options. For customization of a driver installation,

use the software and read the document associated with AN220.

2. Installation

The following sections explain how installation works.

2.1. Install Package

The driver installer is built as a single executable that references a file called setup.ini. This INI file contains all of

the settings used for driver installation and uninstallation. This DriverInstaller.exe and setup.ini combo should exist

in a directory alongside the .sys driver files, .inf installation files, and, if the driver is certified, any .cat catalog files.

For example, the USBXpress Driver Package structure looks like this:

\USBXpressInstaller.exe (renamed DriverInstaller.exe)

\setup.ini (customized setup values)

\x64\SiUSBXp.sys (USBXpress driver 64 bit)

\x64\SiLib.sys (support library for USBXpress 64 bit)

\x86\SiUSBXp.sys (USBXpress driver 32 bit)

\x86\SiLib.sys (support library for USBXpress 32 bit)

\SiUSBXp.inf (INF file for the USBXpress driver)

\SiUSBXp.cat (catalog file for the USB driver)

When the USBXpressInstaller.exe is run, it starts by reading in all the values from the setup.ini file. From this, it can

determine if setup should be performed quietly or if the windows and message boxes should be shown. If quiet

mode is selected, then the installation routine begins immediately and no status messages are shown to the user.

If quiet mode is not selected, the main window is populated with the strings specified in the INI file such as

company name, product name, the driver version, etc., and displayed to the user.

2.1.1. Installation Directory Selection

There is an option in the setup.ini file that determines if drivers should be copied to the PC. If driver files are

supposed to be copied to the hard drive, then a default installation directory specified in setup.ini is displayed in the

DriverInstaller window. This directory can be changed by clicking the “Change Install Location Button”. The

installation directory is where the driver package is copied and also where the installation originates. This is so the

original install media (such as a CD or floppy) is not needed every time a device is installed.

The DriverInstaller can also take a default directory from the command line, which will override the default directory

for installation and forces the driver files to be copied regardless of the copy files specification in setup.ini. The

following is an example of how to pass in an installation directory:

USBXpressInstaller.exe “C:\Program Files\Silicon Labs\USBXpress”

Summary of content (10 pages)

PAGE 1
AN335 USB D RIVER I N S TAL LA T IO N U TILITY 1. Description The driver installer and uninstaller combination is a customizable installation utility for Silicon Laboratories USB drivers. These utilities are completely independent of the actual driver and no referencing is done by the INF file to the installer or uninstaller.
PAGE 2
AN335 If the setup.ini specifies that driver files should not copied to the PC then no installation directory is shown in the window, and nothing will happen if a directory is supplied at command line. Because nothing is copied, the install media (such as a CD, floppy, or the source install directory on the PC) is where the installation originates and will be needed when devices are plugged in.
PAGE 3
AN335 The following registry entries are examples of the current USBXpress and VCP installations: USBXpress: HKEY_LOCAL_MACHINE\SOFTWARE\Silicon Laboratories, Inc.\Silicon Laboratories Driver Installations\USBXpress\SIUSBXP&10C4&EA61 VCP: HKEY_LOCAL_MACHINE\SOFTWARE\Silicon Laboratories, Inc.\Silicon Laboratories Driver Installations\VCP CP210x Cardinal\SLABCOMM&10C4&EA60 There may be times when an installation completes and the system needs to be rebooted.
PAGE 4
AN335 3. Uninstallation The following sections explain how uninstallation works. 3.1. Calling the Uninstaller As stated in the above installation routine, an uninstaller is copied to a Silabs directory inside the Windows system directory (such as C:\Windows\system32\Silabs\). This uninstaller is named DriverUninstaller.exe and is embedded within the DriverInstaller.exe. Because this is a universal installation utility, the same DriverUninstaller.exe is used by any Silicon Labs driver installations.
PAGE 5
AN335 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.
PAGE 6
AN335 [Install Quiet Mode] and [Uninstall Quiet Mode]—REQUIRED—This has to be one of the following: On Off If quiet mode is on, no windows, dialogs or message boxes are shown to the user, which is good for third party installers that integrate the driver installation or do not want to display information or choices on its installation. This is not case sensitive (on and ON will both work).
PAGE 7
AN335 4.1.1. Example setup.ini Below is an example setup.ini listing, specifically for the USBXpress Driver Package: [Driver Type] USBXpress [Driver Version] 3.
PAGE 8
AN335 DOCUMENT CHANGE LIST Revision 0.1 to Revision 0.2 Relative Install added to sections “4.1. setup.ini Format” and “4.1.1. Example setup.ini”. 8 Rev. 0.
PAGE 9
AN335 NOTES: Rev. 0.
PAGE 10
AN335 CONTACT INFORMATION Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 Email: MCUinfo@silabs.com Internet: www.silabs.com The information in this document is believed to be accurate in all respects at the time of publication but is subject to change without notice. Silicon Laboratories assumes no responsibility for errors and omissions, and disclaims responsibility for any consequences resulting from the use of information included herein.