Difference between revisions of "AndorLaserCombiner"
m |
(Better separation of install steps) |
||
Line 28: | Line 28: | ||
− | == Installing | + | == Installing the Device Adapter == |
+ | === Setup the ALC_SDK === | ||
* The Andor Laser Combiner SDK is packaged in a zip file. Decompress to a folder on your C: drive. Copy the location of the `Libraries' folder (e.g. C:\Andor\0.9\ALC_REV_SDK\Libraries). | * The Andor Laser Combiner SDK is packaged in a zip file. Decompress to a folder on your C: drive. Copy the location of the `Libraries' folder (e.g. C:\Andor\0.9\ALC_REV_SDK\Libraries). | ||
[[Image:01- Decompress Andor SDK for Laser combiner.png|frame|center||Decompress the Andor Laser Combiner SDK from the zip file]] | [[Image:01- Decompress Andor SDK for Laser combiner.png|frame|center||Decompress the Andor Laser Combiner SDK from the zip file]] | ||
Line 34: | Line 35: | ||
* Right-click the My Computer icon on the desktop or start menu, click properties and on the advanced tab choose Environment variables. On the system variables list, find "Path" or "PATH" and click edit. DO NOT DELETE ANYTHING. Just add ;C:\YOURFOLDER on the end of the line on the edit window. Of course, remember to change the folder to where you unzipped the SDK. Also, remember to include the semi-colon (;) or you might break something on your windows installation. Now, reboot your computer. | * Right-click the My Computer icon on the desktop or start menu, click properties and on the advanced tab choose Environment variables. On the system variables list, find "Path" or "PATH" and click edit. DO NOT DELETE ANYTHING. Just add ;C:\YOURFOLDER on the end of the line on the edit window. Of course, remember to change the folder to where you unzipped the SDK. Also, remember to include the semi-colon (;) or you might break something on your windows installation. Now, reboot your computer. | ||
[[Image:02- Put Andor SDK libraries folder in Path.png|frame|center||Add the Andor Laser Combiner SDK `Libraries' folder to the Windows PATH so that MicroManager can find the DLLs]] | [[Image:02- Put Andor SDK libraries folder in Path.png|frame|center||Add the Andor Laser Combiner SDK `Libraries' folder to the Windows PATH so that MicroManager can find the DLLs]] | ||
+ | |||
+ | |||
+ | |||
+ | === Configuring Micro-Manager === | ||
* Get the latest nightly build to run the Andor laser combiner in uManager. | * Get the latest nightly build to run the Andor laser combiner in uManager. | ||
Line 99: | Line 104: | ||
− | [[User:P.nanda|P.nanda]] 14: | + | [[User:P.nanda|P.nanda]] 14:39, 29 July 2011 (PDT) |
Revision as of 13:39, 29 July 2011
Summary: | Interfaces with Andor laser combiner |
Author: | Karl Hoover, UCSF - µManager device adapter Pariksheet Nanda, Andor Support - this documentation and µManager device adapter code maintainer |
License: | BSD |
Platforms: | Windows XP 32bit, Windows 7 32bit and 64bit (No Mac or Linux driver available) |
Devices: | Andor laser combiners: ALC-401, ALC-501, ALC-601 |
Contents
Getting Started
- The Andor Laser Combiner SDK, and consequently µManager which depends on it, can control the following models:
- LC-401
- LC-501
- LC-601
- These models are not currently supported:
- LC-103
- Use the AA AOTF driver instead. There is a an RS-232 connection on the front of the Andor PCU to interface to the AOTF controller. However, switching lasers wavelengths and power using this method is much slower than using the analog interface.
- If you want proper analog control supported for fastest operation, i.e. using Andor's choice of DAC card, please request Andor
- External laser control via PCUV-101
- Use the NEOS driver instead.
- LC-103
- You need to download a copy of the Andor Laser Combiner SDK (ALC_SDK). It is not publicly available. Request Andor support to gain access to it, stating in the support request form you need the drivers for µManager.
- ALC_SDK 2.0 is the current version as of July 29, 2011
- This guide assumes you have a computer preconfigured with drivers, such as the computer Andor sells. If, instead, you have a non-Andor computer please read the appendix to install the drivers and map the COM ports.
Installing the Device Adapter
Setup the ALC_SDK
- The Andor Laser Combiner SDK is packaged in a zip file. Decompress to a folder on your C: drive. Copy the location of the `Libraries' folder (e.g. C:\Andor\0.9\ALC_REV_SDK\Libraries).
- Right-click the My Computer icon on the desktop or start menu, click properties and on the advanced tab choose Environment variables. On the system variables list, find "Path" or "PATH" and click edit. DO NOT DELETE ANYTHING. Just add ;C:\YOURFOLDER on the end of the line on the edit window. Of course, remember to change the folder to where you unzipped the SDK. Also, remember to include the semi-colon (;) or you might break something on your windows installation. Now, reboot your computer.
Configuring Micro-Manager
- Get the latest nightly build to run the Andor laser combiner in uManager.
- When configuring your hardware setup, remember to add the AndorLaserCombiner and AndorLaserCombiner Piezostage (if you have a piezostage). Also, the configuration wizard will ask if you have a multiport unit present. If you have a FRAPPA unit or TIRF setup, you do and should set it to "1" (true). Other than those cases you probably don't have it, set it to "0" (false).
Resources
Laser Combiner questions
For contacting Andor product support regarding any questions, use this Andor Product Support link
Development support
This driver is not actively maintained by the Andor software team. For feature requests or bug reports, please liaison with µManager developers on the mailing list and Pariksheet Nanda.
Appendix
Setting Micro-Manager but not iQ
If you want to run Andor's iQ software as well on this computer, skip to the the next section
Specific driver versions are required. Do not rely on the manufacturer websites for these drivers. The ALC_SDK version 2 now bundles all the drivers you need to install to get the ALC running. Install the drivers bundled with the ALC SDK zip file for your flavor of Windows:
.\ALC_REV_SDK\Drivers\
Setting Micro-Manager alongside Andor iQ
Andor completes the steps described in this section in their factory. If you are setting up an Andor laser combiner on a new computer, only then do you need to follow this section.
When you start Windows, ignore the Found New Hardware Wizard. Also when installing, ignore the driver requests to restart your computer.
- (Optional for testing) Dongle Driver
- Andor iQ
- Necessary because iQ installs the driver to recognize the DeVaSys microcontroller in the combiner
- (Optional for testing) iQ would also serve to test that communication and control of the combiner is possible
- Instacal for the Measurement Computing DAC card driver
- Recognizes the Andor Precision Control Unit (PCU) box which controls the laser combiner Acousto-Optic Tunable Filter (AOTF)
- Prolific PL-2303 USB to RS232 driver. For Windows 7 do not use Prolific's public driver. It will lock up Windows. Use the version bundled with the ALC SDK instead.
- Restart your PC
- Let Windows Found New Hardware wizard finish for all hardware
- Start menu > Measurement Computing > InstalCal, to register the PCU DAC card
- Running InstaCal creates a new configuration file which is used by iQ
- Simply running the program once and closing it creates the file
- Do not delete the DEMO board.
- Two boards should exist, the DEMO board #0 and your installed board #1
- Start Menu > Andor Bioimaging > ConfigurationManager
- Create a new configuration with a Kinetic Dummy Camera and the Andor laser combiner
Mapping COM ports
- Remap the USB-to-Serial COM ports in your Device Manager to 201-204
- iQ reserves these specific port numbers for the combiner
- (Right-click) on My Computer > Manage to invoke the Device Manager
- See screenshots below to change COM ports. By unplugging the USB cable from the front of the Andor combiner we know that Windows has enumerated the COM ports for the lasers from COM 7 to COM 10 (since these port numbers disappear from the Device manager when we unplug the combiner and reappear when we plug it back in)
Testing
- (Optional for testing) Now start iQ with your new laser combiner configuration and test. The ALC_SDK also includes a test program which turns lasers on sequentially and then off:
.\ALC_REV_SDK\Libraries\ALC_REVTest.exe .\ALC_REV_SDK\Libraries\ALC_REVTest64.exe
P.nanda 14:39, 29 July 2011 (PDT)