top bar

Difference between revisions of "ASITiger"

m (ASI Tiger)
m (Known limitations)
 
(6 intermediate revisions by 2 users not shown)
Line 6: Line 6:
 
<tr><td>'''License:'''</td><td>BSD</td></tr>  
 
<tr><td>'''License:'''</td><td>BSD</td></tr>  
 
<tr><td>'''Platforms:'''</td><td>All platforms (uses serial port)</td></tr>
 
<tr><td>'''Platforms:'''</td><td>All platforms (uses serial port)</td></tr>
<tr><td>'''Devices:'''</td><td>XYStage, ZStage (motorized linear stage), Piezo, FWheel (FW-1000 filterwheel), FSlider (filter slider), Micromirror (scanner)</td></tr>
+
<tr><td>'''Devices:'''</td><td>XYStage, ZStage (motorized linear stage), Piezo, FWheel (FW-1000 filterwheel), FSlider (filter slider), Turret, Scanner (MEMS micro-mirror), Port Switch, PLogic (digital I/O), LED, PMT, tunable lens (Optotune)</td></tr>
 
<tr><td>'''Example Config File:'''</td><td>None</td></tr>
 
<tr><td>'''Example Config File:'''</td><td>None</td></tr>
 
</table>   
 
</table>   
  
If you run into problems please contact the author at the address above.
+
For "Tiger" or TG-1000 controller from ASI [http://www.asiimaging.com/index.php/products/controllers/tiger-controller/ (manufacturer page]).  Controller has various cards that can be added as needed for any particular configuration, so the device adapter is a hub with peripheral devices.
  
 
NB: there is a separate device adapter, [[ASIStage]], for stand-alone MS-2000 controllers or older rack-mount controllers.
 
NB: there is a separate device adapter, [[ASIStage]], for stand-alone MS-2000 controllers or older rack-mount controllers.
 +
 +
Serial port settings are 115200 baud, no parity, 1 stop bit, no handshaking (for both RS-232 and USB).
 +
 +
If you run into problems please contact the author at the address above.  This device adapter is actively supported by the manufacturer.
 +
  
 
For TG-1000 systems the build-in USB connection is actually a USB to serial converter. You can find drivers for Windows, Mac OS X, and Linux at the [http://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx Silicon labs website].  This is the same as used for recent ASI 'WK' or 'Whizkid' controllers.
 
For TG-1000 systems the build-in USB connection is actually a USB to serial converter. You can find drivers for Windows, Mac OS X, and Linux at the [http://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx Silicon labs website].  This is the same as used for recent ASI 'WK' or 'Whizkid' controllers.
Line 20: Line 25:
 
* SerialCommand: By default the command is sent only sent when a change is made; to resend same command you can add a space; change the property "OnlySendSerialCommandOnChange" property to "No" to change this behavior.  This is due to the behavior of Micro-manager often refreshing the property values which can cause the command to be sent multiple times.
 
* SerialCommand: By default the command is sent only sent when a change is made; to resend same command you can add a space; change the property "OnlySendSerialCommandOnChange" property to "No" to change this behavior.  This is due to the behavior of Micro-manager often refreshing the property values which can cause the command to be sent multiple times.
  
 +
==Z Stages (piezo or motorized)==
 +
The Z stage can be set up to receive trigger signals from many cameras (see documentation on Micro-Manager's [[Hardware-based_synchronization]] feature). A BNC cable is connected from the camera's TTL output to the controller's trigger input on the corresponding card's front panel of the Tiger controller.  By synchronizing Z slices with camera exposures, you can acquire very fast Z stacks. Most ASI firmware includes the required ring buffer module with 50 positions; if you want to acquire Z stacks with more slices or do not have ring buffer support, please [http://www.asiimaging.com/contact-us/ contact ASI directly] for a firmware update. To use this feature, set the property "UseSequence" to value "Yes" under device "ZStage" in the Property Browser.
 +
 +
There is a further feature designed for collecting sequential Z-stacks with minimal delay by eliminating serial communication between Z-stacks and relying completely on TTL. This is the "UseFastSequence" property. To use, first set the property value set to "No" (but "UseSequence" must be set to "Yes") and run a Z-stack, or if you are scripting you need to invoke SendStageSequence().  This forces Micro-Manager to compute the ring buffer positions and send them to the controller. Then set the property value to "Armed" and perform desired acquisitions. Afterwards be sure to set the value back to "No" because the controller will not interact with Micro-Manager normally when set to "Armed" (sequence operations are short-circuited as is the widely-used API function Busy()).
  
 
==Known limitations==
 
==Known limitations==
 
* CRISP supported was added 25-Sep-2013.  Use requires both a Micro-manager build and card firmware after that date.
 
* CRISP supported was added 25-Sep-2013.  Use requires both a Micro-manager build and card firmware after that date.
 
* LED illuminator support was added 20-May-2014.  Use requires both a Micro-manager build and card firmware after that date.
 
* LED illuminator support was added 20-May-2014.  Use requires both a Micro-manager build and card firmware after that date.
* TTL-triggered piezo sequences are not yet supported, but will be added upon request (contact the author).
+
* TTL-triggered piezo (and Z stage) sequences are supported as of 2020-May-20 nightly build of Micro-Manager.
  
 
==Support==
 
==Support==

Latest revision as of 17:24, 21 May 2020

ASI Tiger

Summary:For TG-1000 "Tiger" controller hub, providing access to various supported cards
Author:Jon Daniels (jon at asiimaging.com)
License:BSD
Platforms:All platforms (uses serial port)
Devices:XYStage, ZStage (motorized linear stage), Piezo, FWheel (FW-1000 filterwheel), FSlider (filter slider), Turret, Scanner (MEMS micro-mirror), Port Switch, PLogic (digital I/O), LED, PMT, tunable lens (Optotune)
Example Config File:None

For "Tiger" or TG-1000 controller from ASI (manufacturer page). Controller has various cards that can be added as needed for any particular configuration, so the device adapter is a hub with peripheral devices.

NB: there is a separate device adapter, ASIStage, for stand-alone MS-2000 controllers or older rack-mount controllers.

Serial port settings are 115200 baud, no parity, 1 stop bit, no handshaking (for both RS-232 and USB).

If you run into problems please contact the author at the address above. This device adapter is actively supported by the manufacturer.


For TG-1000 systems the build-in USB connection is actually a USB to serial converter. You can find drivers for Windows, Mac OS X, and Linux at the Silicon labs website. This is the same as used for recent ASI 'WK' or 'Whizkid' controllers.

TigerCommHub

Property Notes

  • SerialCommand: By default the command is sent only sent when a change is made; to resend same command you can add a space; change the property "OnlySendSerialCommandOnChange" property to "No" to change this behavior. This is due to the behavior of Micro-manager often refreshing the property values which can cause the command to be sent multiple times.

Z Stages (piezo or motorized)

The Z stage can be set up to receive trigger signals from many cameras (see documentation on Micro-Manager's Hardware-based_synchronization feature). A BNC cable is connected from the camera's TTL output to the controller's trigger input on the corresponding card's front panel of the Tiger controller. By synchronizing Z slices with camera exposures, you can acquire very fast Z stacks. Most ASI firmware includes the required ring buffer module with 50 positions; if you want to acquire Z stacks with more slices or do not have ring buffer support, please contact ASI directly for a firmware update. To use this feature, set the property "UseSequence" to value "Yes" under device "ZStage" in the Property Browser.

There is a further feature designed for collecting sequential Z-stacks with minimal delay by eliminating serial communication between Z-stacks and relying completely on TTL. This is the "UseFastSequence" property. To use, first set the property value set to "No" (but "UseSequence" must be set to "Yes") and run a Z-stack, or if you are scripting you need to invoke SendStageSequence(). This forces Micro-Manager to compute the ring buffer positions and send them to the controller. Then set the property value to "Armed" and perform desired acquisitions. Afterwards be sure to set the value back to "No" because the controller will not interact with Micro-Manager normally when set to "Armed" (sequence operations are short-circuited as is the widely-used API function Busy()).

Known limitations

  • CRISP supported was added 25-Sep-2013. Use requires both a Micro-manager build and card firmware after that date.
  • LED illuminator support was added 20-May-2014. Use requires both a Micro-manager build and card firmware after that date.
  • TTL-triggered piezo (and Z stage) sequences are supported as of 2020-May-20 nightly build of Micro-Manager.

Support

Contact the author at jon_remove@asiimaging.com (remove the last part of the email address).

© Micro-Manager : Vale Lab, UCSF 2006-2011 | All Rights Reserved | Contact