Argyll Installation on Microsoft Windows

# Installing the software on Microsoft Windows

### Unpacking the .zip archive:

You will need to unzip the downloaded file in the location you have chosen to hold the executable files (perhaps somewhere like \bin). I would NOT put them in \Program Files, since spaces in directory or file names and command line environments are a very bad mix, and will cause you endless problems. The archive will create a top level directory Argyll_VX.X.X, where X.X.X is the version number, and the executables will be in Argyll_VX.X.X/bin.

### Making the utilities accessible:

You should also configure your %PATH% environment variable to give access to the executables from your command line environment.
For Vista/Windows 7, look in
Start Menu -> Control Panel -> System And Maintenance -> System -> Change Settings -> Advanced -> Environment Variables
For XP and 2000 look in
Start->Settings->ControlPanel->System->Advanced->EnvironmentVariables
For NT 4 look in
Start->Settings->ControlPanel->System->Environment
You want to add the directory you've chosen to your %PATH%, which is a System Variable. Normally you would add this to the end of the current setting, separated by a ';'.
So if the current value of PATH is "%SystemRoot%\system32;%SystemRoot%" and you unpacked Argyll version 1.0.3 in d:\bin\, then you would modify PATH to be "%SystemRoot%\system32;%SystemRoot%;d:\bin\Argyll_V1.0.0\bin". The change will take effect when you start a new command shell, which you start from Start Menu->Accessories->Command Prompt, or Start Menu->Programs->Accessories->Command Prompt. You can check that the environment variable has been set by running the command "echo %PATH%" in the command shell.
The .zip file also contains several useful reference files (such as acquisition device chart recognition templates, sample illumination spectrum etc.) in the ref sub-directory, all the current documentation in a doc sub-directory, and instrument USB drivers in the libusbw directory.

### Serial Instruments:

If you are using a serial connected instrument, then there is nothing special to do to enable this.

### USB Instruments:

If you are using a USB connected instrument, then suitable USB drivers may need to be installed.
NOTE that you generally can't install USB drivers on Vista 64/Windows 7 64 bit due to Microsoft's driver code signing requirements.
You can install the USB drivers on Vista 64 if you use some sort of driver code signing workaround, such as pressing F8 when the system boots, and selecting the boot option to "Disable Driver Signature Enforcement". Note that you have to do this every time you boot and want to use the USB instruments. [You may still get a warning about an unsigned driver not being loaded after plugging the instrument in, booting or installing the driver, but take these messages with a grain of salt, and check in device manager and also whether the instruments are actually accessible using Argyll's tools.]
A safer and more convenient workaround is to self sign the drivers and put your system in test mode. The procedure for doing this is a little complicated though, and beyond the scope of this documentation. You might want to refer to this. If you take this path then make sure you sign the libusb0.sys and libusb0_x86.sys files in the argyll/libusbw directory BEFORE you install the device, otherwise you will have to remove & delete the driver, and also manually delete the libusb0 and libusb0_x86 .sys and .dll files from Windows\system32, Windows\System32\drivers and Windows\SysWOW64 and start again.
(Another possibility might be to use this <http://www.ngohq.com/home.php?page=dseo>, but use at your own risk, I haven't tried it myself.)
[In the long run it may be possible to switch Argyll to using the winusb drivers, which should avoid the signing issue.]
Fresh Install of USB drivers:
If you currently don't have any applications that talk to your instrument using USB, then it is relatively simple to use the drivers provided with Argyll. On plugging the instrument in, MSWindows should pop up a "New Hardware" dialog, and ask you for drivers for the particular USB instrument.
In Vista/Win 7 a "Found new hardware" window will pop up.
Select the top "Locate and install driver software (recommended)" button.
A "User Account Control" window will probably then pop up, and you should "Continue".
A "Found New Hardware" window should pop up. Select the last "Don't Search online" button.
In the next screen select the "I don't have the disc. Show me other options." button.
In the next screen, select the "Browse my computer for driver software (advanced)" button.
On the next screen use the brows dialog to locate the directory argyll\libusbw below where you installed Argyll. Click "next".
The screen should change to "Installing driver software...", and a "Windows Security" window should pop up.
In the "Windows Security" window choose the "Install this driver software anyway" button.
You should get the final screen "The software for this device has been successfully installed". Click "Close".
In XP a "Welcome to the Found New Hardware Wizard" window will pop up.
For "Can Windows connect to Windows Update to search for software ?" Select "No, not this time" and "Next"
Select "Install from a list or specific location (Advanced) " then "Next"
Select "Search for the best driver in these locations", "Include this location in the search" and "Brows"
Brows to locate the directory argyll\libusbw below where you installed Argyll. Click "next".
The screen should change to "Installing driver software...",
You should get the final screen "Completing the Found New Hardware Wizard". Click "Finish".
In 2000 a "Welcome to the Found New Hardware Wizard" window will pop up.
Click "Next"
Select "Search for a suitable driver for my device (recommended)" then "Next"
Tick the "Specify a location" box and then "Next"
A "Found New Hardware Wizard" dialog should pop up with "Insert the manufacturer's installation disk
into the driver selected, and then clock OK'. Select "Browse...".
Brows to locate the directory argyll\libusbw below where you installed Argyll, and select the .inf file that
corresponds to the device (ie. DTP94.inf, i1Disp.inf etc.). Click "Open".
Click "OK".
The screen should change to "Windows found a driver for this device. To install the driver Windows found, click Next",
and the path to the file you selected should be shown bellow this. Click "Next".
You should get the final screen "Completing the Found New Hardware Wizard". Click "Finish".
Note that the "Huey" colorimeter appears as an HID (USB Human Interface Device Class) device, and hence will be assigned to the default MSWindows HID driver, rather than popping a "New Hardware" dialog. You don't normally need to install an Argyll libusbw driver for the Huey.
Adding Argyll drivers to existing drivers:
If you currently have applications other than Argyll accessing your USB connected instrument, then you won't automatically be prompted to install the drivers needed to access it. Instead you have to manually install the drivers, and then switch back and forth between the Argyll and other drivers if you want to switch between applications.
In Vista/Win 7:
Plug the instrument that you want to install the the computer.
Right click on the "Computer" item in the Start menu and select "Manage".
Click on "Device Manager"
Locate the device in the device manager. It may be underneath one of the top level "USB" items.
Right click on the device and choose "Update Driver Software..."
In the next screen, select the "Browse my computer for driver software" button.
On the next screen choose "Let me Pick from a list of device drivers on my computer"
On the next screen choose "Have Disk..."
On the next screen "Install From Disk" use the brows dialog to locate the directory argyll\libusbw below where you installed Argyll. Click "next".
The screen should change to "Installing driver software...", and a "Windows Security" window should pop up.
In the "Windows Security" window choose the "Install this driver software anyway" button.
You should get the final screen "The software for this device has been successfully installed". Click "Close".
The Argyll driver will now be used to access the device.
To switch between drivers in Vista/Win 7:
Plug the instrument that you want to install the the computer.
Right click on the "Computer" item in the Start menu and select Manage.
Click on "Device Manager"
Locate the device in the device manager. It may be underneath one of the top level "USB" items.
Right click on the device and choose "Update Driver Software..."
In the next screen, select the "Let me pick from a list of device drivers on my computer" button.
On the next screen make sure that the "Show compatible hardware" checkbox is ticked, and choose which
driver you want to use, and press "Next". All Argyll drivers have (Argyll) at the end of them.
You should get the final screen "The software for this device has been successfully installed". Click "Close".
In XP:
Plug the instrument that you want to install the the computer.
Right click on the "My Computer" item on the desktop and select "Manage".
Click on "Device Manager"
Locate the device in the device manager. It may be underneath one of the top level "USB" items.
Right click on the device and choose "Update Driver Software..."
For "Can Windows connect to Windows Update to search for software ?" Select "No, not this time" and "Next"
Select "Install from a list or specific location (Advanced) " then "Next"
In the next screen, select the "Don't search. I will choose the driver to install" button, then click "Next".
On the next screen "Select the device driver you want to install for this hardware", the existing driver for the device should be listed. Click "Have Disk".
On the next screen use the brows dialog to locate the directory argyll\libusbw below where you installed Argyll, and select
the appropriate .inf file for the device. Click "Open".
Back on the "Install From Disk" dialog, click "OK".
Back in the "Select the device driver you want to install for this hardware", click "Next".
A "Please wait while the wizard installs the software" dialog will be shown.
You should get the final screen "Completing the Hardware Update Wizard". Click "Finish".
The Argyll driver will now be used to access the device.
To switch between drivers in XP:
Plug the instrument that you want to install the the computer.
Right click on the "My Computer" item on the desk top and select "Manage".
Click on "Device Manager"
Locate the device in the device manager. It may be underneath one of the top level "USB" items.
Right click on the device and choose "Update Driver Software..."
For "Can Windows connect to Windows Update to search for software ?" Select "No, not this time" and "Next"
Select "Install from a list or specific location (Advanced) " then "Next"
In the next screen, select the "Don't search. I will choose the driver to install" button, then click "Next".
On the next screen "Select the device driver you want to install for this hardware", the Argyll driver and any alternative
driver for the device should be listed. Choose the driver you want to switch to, and then Click "Next".
A "Please wait while the wizard installs the software" dialog will be shown.
You should get the final screen "Completing the Hardware Update Wizard". Click "Finish".
The Argyll driver will now be used to access the device.
In 2000:
Plug the instrument that you want to install the the computer.
Right click on the "My Computer" item on the desktop and select "Manage".
Click on "Device Manager"
Locate the device in the device manager. It may be underneath one of the top level "USB" items.
Right click on the device and choose "Properties..."
Select the "Driver" Tab.
Select "Update Driver..."
A "Welcome to the Upgrade Device Driver Wizard" window will pop up.
Click "Next"
Select "Search for a suitable driver for my device (recommended)" then "Next"
Tick the "Specify a location" box and untick all other boxes. Click "Next"
A "Upgrade Device Driver Wizard" dialog should pop up with "Insert the manufacturer's installation disk
into the driver selected, and then clock OK'. Select "Browse...".
Brows to locate the directory argyll\libusbw below where you installed Argyll, and select the .inf file that
corresponds to the device (ie. DTP94.inf, i1Disp.inf etc.). Click "Open".
Click "OK".
Wait while the wizard also searches other locations.
The wizard should then display screen titled "Driver Files Search Results".
Tick the "Install one of the other drivers" box and then "Next"
A list of available drivers should then be displayed. Select the Argyll driver for the device then "Next".
You should get the final screen "Completing the Upgrade Device Driver Wizard". Click "Finish".
To switch between drivers in 2000:
Plug the instrument that you want to install the the computer.
Right click on the "My Computer" item on the desktop and select Manage.
Click on "Device Manager"
Locate the device in the device manager. It may be underneath one of the top level "USB" items.
Right click on the device and choose "Properties".
Select the "Drivers" tab.
Select "Update Driver".
On the "Welcome to the Update Device Driver Wizard" click "Next".
On the "Install Hardware Device Drivers" dialog, select the "Display a list of known drivers for this device so that I can choose a specific driver", then click "Next".
The next dialog called "Select a Device Driver" should list the Argyll driver and any alternative
driver for the device. Choose the driver you want to switch to, and then Click "Next".
On the next dialog called "Start Device Driver Installation" click "Next".
You should get the final screen "Completing the Upgrade Device Driver Wizard". Click "Finish".
[ The alternative to switching to the Argyll drivers is to go to the libusb-win32 web site, and download and then install the "filter drivers", - see <http://libusb-win32.sourceforge.net./#downloads>. This may then let you access the device using Argyll, without disabling access by existing applications. (I haven't tried this, so I'm not sure how well it works). You don't make use of the Argyll .inf file using this approach.
NOTE that a potential problem with this approach is that the filter drivers haven't been modified to have a longer USB control transaction timeout, and this may cause failures for certain instruments when measuring dark colors.]
Updating Argyll drivers:
NOTE that if you are updating to a new version of Argyll, that it may be necessary to uninstall all the Argyll USB devices, and re-install them, to update the relevant libusb-win32 system driver and dll. (This is true for updating to Argyll Version 1.0.0). You may get an error when trying to run updated programs that access instrumments that "The procedure entry point usb_argyll_patched could not be located in the dynamic link library libusb0.dll", an indication that the USB drivers need updating. To do this you need to
In Vista/Win 7
Plug an instrument that has been installed into the computer.
Right click on the "Computer" item in the Start menu and select "Manage".
Click on "Device Manager"
Locate the device under "LibUSB-Win32 Device"
Right click on the device and choose "Uninstall"
In the "Confirm Device Removal" window select the "Delete the driver software for this device" checkbox and then choose "OK"
In the "Action" menu of the window choose "Acquisition for hardware changes"
A "Found New Hardware Wizard" window should pop up.
Follow the same directions as above for installing the updated drivers..
In XP and 2000:
Plug an instrument that has been installed into the computer.
Right click on the "My Computer" icon on the desktop or start menu and select Manage.
Click on "Device Manager"
Locate the device under "LibUSB-Win32 Device"
Right click on the device and choose "Uninstall"
On the "Confirm Device Removal" window choose "OK"
In the "Action" menu of the window choose "Acquisition for hardware changes"
A "Found New Hardware Wizard" window should pop up.
Follow the same directions as above (XP, 2000) for installing the updated drivers.