User Tools

Site Tools



MS2000 or RM2000 syntax
Shortcut ZS
Format ZS [X=dZ] [Y=n] [Z=mode] [F= stack_timeout]
Remembered Using SS Z
Tiger syntax
Shortcut ZS
Format [addr#]ZS [X=dZ] [Y=n] [Z=mode] [F= stack_timeout]
Type Card-Addressed
Remembered Using [addr#]SS Z

Sets parameters for use with TTL triggered Z movement. User must set TTL X=4 for this trigger mode to be active. When a positive TTL edge is detected, the Z-axis is moved by an amount dZ (expressed in 10th microns units). Note that internally the amount dZ is actually stored as a multiple of the encoder unit, e.g. ~22 nanometers for a 4 TPI stage with rotary encoders, or 10 nanometers exactly for most linear encoded stages. This move distance is repeated for n TTL triggered moves. If mode=1, the stage will step in the opposite direction for n moves, then turn around again, repeating a triangular waveform cycle. If mode=0 the stage will return to the original position after n moves and repeat a saw-tooth waveform cycle.

The stage will move to the starting position upon receiving the first TTL pulse after waiting more than stack_timeout milliseconds (default 500ms) from the previous pulse. The maximum timeout allowed is 32767 milliseconds.

The axis moved by the TTL is the designated “focus index” (also the axis used for CRISP among other things). Use UNLOCK F to read or set the axis letter corresponding to “focus index”. Note the setting has to be changed, settings saved, and the controller reset or power cycled for the new setting to take effect. If the controller has a piezo but no motorized focus drive then the piezo axis should be set as the “focus index”. If both are present the “focus index” normally defaults to the piezo.

Backlash : ZS routine also performs the backlash compensation move for each step. For step size smaller than 10 microns, this might result in issues like irregular step sizes. Consider disabling Command:BACKLASH for smaller step sizes.

Stack Timeout : If the TTL frequency is less than 2Hz , then the controller might consider it a stack time out condition. Consider increasing the Stack timeout to accommodate the slower TTL frequency, to avoid any issue.


If there are no errors, a positive reply of :A will be returned. Example

Tiger Example
Focus Drive axis is on Card#2
2ZS X=10 Y=20 Z=1
MS2000 Example
ZS X=10 Y=20 Z=1

Setup to do twenty 1 micron slices with triangular pattern.

Address: 29391 W Enid Rd. Eugene, OR 97402, USA | Phone: +1 (541) 461-8181
commands/zs.txt · Last modified: 2022/11/07 20:15 by jon