====== Command:SAP ======

--> MS2000 or RM2000 syntax ^

^Shortcut  |SAP| 
^Format  |SAP [axis]=### …|
^Units    |Integer code, 0-255 (see below)|
^Remembered |Using SS Z |

<--

--> Tiger syntax ^

^Shortcut  |SAP| 
^Format  |SAP [axis]=### …|
^Units    |Integer code, 0-255 (see below)|
^Type    |Axis-Specific  |
^Remembered |Using [addr#]SS Z |

<--

This command sets the type of pattern to generate and configures the clocks. The parameter is a bit-mapped number that determines the characteristics of the motion, with the lowest bits determining the type of pattern.  The code is interpreted according to the following table:

^ Bit  ^ Clear                                                                                                                                                                              ^ Set                                      ^
| 7    | Internal Trigger                                                                                                                                                                   | External Trigger on Backplane TTL input  |
| 6    | Polarity of Trigger: positive edge                                                                                                                                                 | Polarity of Trigger: negative edge       |
| 5    | No TTL out                                                                                                                                                                         | TTL out                                  |
| 4    | Polarity of TTL out: active high                                                                                                                                                   | Polarity of TTL out: active low          |
| 3    | reserved                                                                                                                                                                           | Reserved                                 |
| 2-0  | 000 Ramp/sawtooth (code 0) \\ 001 Triangle (code 1) (period always even number of msec) \\ 010 Square wave (code 2) (period always even number of msec) \\ 011 Sine wave (code 3)                                            ||

The TTL inputs for external triggering will individually trigger each axis as follows:
^ Triggered Axis  ^ Backplane Trigger input address  ^ Backplane TTL out address  ^
| 0               | 42                               | 41                         |
| 1               | 44                               | 43                         |
| 2               | 46                               | 45                         |
| 3               | 48                               | 47                         |


== Example ==

<asi> $ SAP r=0   
:A</asi>
Sets up for ramp (sawtooth) pattern, running off internal clock with no TTL outs 
<asi> $ SAP r=129   
:A</asi>
Sets up for triangle pattern, running off positive edge external TTL clock with no TTL outs. 
<asi> $ SAP r=161   
:A</asi>
Sets up for triangle pattern, running off positive edge external TTL clock with TTL outs.  A 250usec pulse is put out at the start of the pattern. 

<WRAP center round info 60%>
Serial command[[commands:ttl|<Card Addr#>TTL Y=22]] will route the TTL pulses generated when BIT5 is set, to the  TTL OUT0 port. Available only in Tiger firmware v3.17 and above.  
</WRAP>


{{tag>commands tiger ms2000 singleaxis}}