====== Command:SAM ======

--> MS2000 or RM2000 syntax ^

^Shortcut  |SAM| 
^Format  |SAM [axis]=### …|
^Units    |Integer code, 0-3 (see below)|
^Remembered |Using SS Z |
^Firmware Module | [[:singleaxis|SINGLEAXIS_FUNCTION]] |

<--

--> Tiger syntax ^

^Shortcut  |SAM| 
^Format  |SAM [axis]=### …|
^Units    |Integer code, 0-4 (see below)|
^Type    |Axis-Specific  |
^Remembered |Using [addr#]SS Z |
^Firmware Module | [[:singleaxis|SINGLEAXIS_FUNCTION]] |

<--

Sets the single-axis mode according to the integer code.

For the TTL-triggered modes (2 and 4), the controller needs to be in the [[commands:ttl|TTL X=30]] input mode.

^Code	^Meaning ^
|0	|Puts single-axis mode in idle state (i.e. stops it if running)                                                              |
|1	|Puts the single-axis mode in active state (i.e. starts generating the pattern)                                              |
|2	|Arms the trigger; the routine only cycles once, then waits again for another TTL trigger. <wrap lo>//Tiger 3.31+//</wrap>                                |
|3	|Makes the single-axis mode active and restarts the pattern of any other axis on the same card so they will be synchronized  |
|4	|Arms the trigger; the routine is free running after the TTL trigger. <wrap lo>//Tiger 3.41+//</wrap> |

**Note:** On Tiger v3.29 and lower, mode 2 has the same behavior as mode 4.

== Example ==

<asi> $ SAM A=0  
:A</asi>
Disables the routine for the A axis 
<asi> $ SAM A=1  
:A</asi>
Enables the routine for the A axis 
<asi> $ SAM B=2  
:A</asi>
Arms the routine for the B axis. The routine for B will start running on receipt of a TTL pulse.

<WRAP center round info 80%>
**Note:** In Tiger version 3.29 and prior the routine is free running after the TTL trigger. In version 3.31 and later, the routine only cycles once, then waits again for another TTL trigger. As of Tiger version 3.41, in mode 4 the routine is free running after the TTL trigger.
</WRAP>

<asi> $ SAM B=3  
:A</asi>
Enables the routine for the B axis. Also the routine for A axis is reset, so they will both run in sync






{{tag>commands tiger ms2000 singleaxis}}