Controller

The diSPIM uses ASI's modular controller, the TG-1000 or “Tiger” controller. It has separate cards for controlling the XY stage, linear stages, micro-mirrors (scanners), triggering cameras/lasers, driving piezo objective movers if present, driving filterwheels if present, etc.

In general firmware updates add new functionality and fix bugs while retaining backwards compatibility, though on rare occasion backward compatibility is compromised. If you are not using Micro-Manager, you should double-check with the vendor of the acquisition software before updating firmware. If you are using Micro-Manager, you should generally download the latest nightly build whenever you update firmware. Conversely, if you are having problems with a recent build of Micro-Manager make sure that the controller firmware is the latest.

Updating the firmware will erase all (or very nearly all) the firmware settings, including the positions of motorized axes, software-defined limits, axis speeds, etc. Move motorized stages to their zero position if feasible, or at least to a known position so the zero position can be easily recovered. Turrets and filter sliders, if any, should be moved to their first position. If you have made adjustments to firmware settings outside of the diSPIM plugin it is advisable to note them down so that you can set them again afterwards. This is not necessary for settings controlled by the diSPIM plugin.

To update the firmware you need the ASI Tiger Console software and the latest diSPIM firmware package from ASI (last updated 2018-01-19, firmware version 3.19), or from the diSPIM firmware archive. Use 7zip to decompress. This firmware should work for diSPIM systems sold 2014 or later. A link to download firmware for the oSPIM is found on the oSPIM page.

General instructions for using the ASI Tiger Console software for updating the firmware are here.

Standard firmwares for card addresses on diSPIM controllers are as follows. Omit any cards that your controller doesn't have. If your controller is otherwise non-standard (e.g. the addresses don't match the labels on the front of the controller) feel free to contact ASI for help.

In general you should update all the firmware on your controller together. One exception is filter wheel firmware which generally does not need updating.

If you have any trouble please contact ASI.

In late 2016 ASI transitioned to using scan-optimized XY stages with SPIM systems by default. These stages have 16 TPI leadscrews instead of the usual 4 TPI leadscrew, along with removing anti-backlash gearing in the X axis for smoother scanning.

Until mid-2018 you would flash the firmware and then set the leadscrew pitch using a serial command if you have a 16 TPI. As of June 2018 there are two firmware versions available and flash the one that matches your stage. Use SCAN_XY_LED_SO__Adr1.hex for scan-optimized 16 TPI stages (note the “SO”) or SCAN_XY_LED__Adr1.hex for 4 TPI stages.

If you are upgrading from pre-3.00 firmware then the piezo range(s) may need to be set to match the hardware using the PR command. Starting with firmware version 3.00 the piezo range is stored in a way not affected by firmware updates.

To set the piezo range you need to send serial commands to the controller using a serial program. In Micro-Manager you can use the properties “SerialCommand” and “SerialResponse” of the TigerCommHub device, or you can use another program as described in ASI's serial communication documentation. Send the PR command with the appropriate range code followed by the SS Z command for each affected card so that the setting to save the settings to non-volatile memory. For example, the most common configuration is 150um range piezos (range code 3) on axes P and Q which are on cards 4 and 5. For this, send the following commands:

PR P=3 Q=3

4 SS Z

5 SS Z

Afterwards power cycle the controller and verify the setting took effect. You can see the current range in Micro-Manager with the read-only property “PiezoTravelRange(um)”, or send PR <axis letter>? and look at the reply code. Common range codes are 3 for 150um, 4 for 200um, and 5 for 300um piezo range.

The Programmable Logic Card (PLC) is a field-programmable card for digital logic, sort of a mini-FPGA inside the Tiger controller. Its original use is to enable multi-laser control for diSPIM, but it is designed to be very flexible. You can find full documentation of the PLC on the ASI website.

When used for diSPIM under Micro-Manager, the PLC uses a clock signal from the micro-mirror card so that the camera and laser triggers are tightly synchronized with the sheet generation. For Tiger controllers sold with the PLC this is already done, but when the PLC is added to an existing controller a jumper must be added to the micro-mirror card as shown in this photo.

Instead of moving the sheet position and imaging piezo to create a stack of images, the sample can be translated through a fixed sheet. Generally speaking this is best for large and/or flat samples. The main advantages are that the light sheet can be thinner for flat samples because the beam waist stays at the same height relative to the coverslip and that there is a nearly unlimited stack “Z” (instead of limitation of piezo range). The main disadvantages are that the output data need to be sheared or shifted before conventional analysis and the minimum time between successive time points is somewhat longer (because the motorized stage can't return to its starting position as fast as the piezo objective mover). In the Micro-Manager implementation, the stage moves continuously in the X axis at an appropriate rate to give the user-specified slice spacing and the beam sweep creating the sheet creates a “stop motion” effect. The stage speed is very uniform and the initial trigger is synchronized with the stage's encoder to give extremely repeatable positioning.

Stage scanning acquisition requires:

1. An ASI-made XY stage, whether on a RAMM or other inverted microscope (requires tight synchronization of the stage with the light sheet/laser/camera). In mid 2016 ASI transitioned to “scan-optimized” stages with SPIM systems; these stages have 16 TPI leadscrews for a slower overall motion (and hence better accuracy with slow moves) and omit the anti-backlash gearing on the X axis for smoothest possible scanning.
2. “SCAN” firmware module on XY card in the Tiger controller
   • Use SCAN_XY_LED firmware variant on the XY card; this has been in the firmware releases for download (on this page above) since late 2015.
   • As of June 2018 there are two firmware versions available and flash the one that matches your stage. Use SCAN_XY_LED_SO__Adr1.hex for scan-optimized 16 TPI stages (note the “SO”) or SCAN_XY_LED__Adr1.hex for 4 TPI stages.
   • All firmware should be updated to v3.10 or later
3. XY card Rev F2 or later with proper jumper (standard after Jun 2015)
   • Make sure the following jumper is present: this photo
4. Micromirror card with proper jumper (standard after Jun 2015)
   • For micro-mirror card Rev E3 or later, add this jumper: this photo
   • For micro-mirror card Rev C, it is similar to Rev E3 except the order of that bank of 8 jumper positions is reversed. So for Rev C leave the top position in the bank vacant and fill all the other positions, which means adding a jumper in the 3rd position from the top.
5. Software support (present in Micro-Manager plugin since mid-2015)

• The spacing between slices is specified in the plugin, so the stage moves sqrt(2) times that distance per slice. There may be very small rounding errors (which would come out in normal post-processing) but the metadata should contain the actual slice spacing instead of the user-specified one. Rounding errors were reduced as of the 2018-03-15 nightly build.
• The stage cannot go arbitrarily slow and still be perfectly smooth. For 4 TPI leadscrew max speed is ~8.5mm/s and speed setting quantum is 0.000688 mm/s. A rough rule of thumb is that the slowest speed that is relatively smooth is ~1000x slower than the max speed or about 12x the quantum. For 16 TPI leadscrew (“scan-optimized” stages) divide those numbers by 4. So at this 12x quantum threshold, the “minimum smooth” speed is 2 um/sec for 16 TPI and 8 um/sec for 4 TPI.
• The initial X position is used as the center X position of the dataset and the stage should return there afterwards.
• For large samples there is a YZ grid creator (as of March 2018) so multiple strips can be collected covering a sample. The same GUI allows you to create a “grid” in X where instead of specifying slice spacing you specify start, stop, and number of slices.
• There are three modes implemented, “stage scan”, “stage scan interleaved”, and “stage scan unidirectional”; see the manual's description of the different SPIM acquisition modes.
• As noted above the data needs to be deskewed before it can be used/viewed in a conventional way. On-the-fly deskewing for visualizing test acquisitions and also for post-processing real acquisitions is in the plugin as of December 2016; the algorithm is fundamentally the same as the ImageJ macro and may not be quite as accurate as a full affine transformation.