====== Command:SETHOME (HM) ======

--> MS2000 or RM2000 syntax ^

^Shortcut  |HM| 
^Format  |HM [axis]=[position in mm]… |
^Units    |Millimeter|
^Remembered |Automatically |
^ Required MS2000 Firmware Version |8.0+|

<--

--> Tiger syntax ^

^Shortcut  |HM| 
^Format  |HM [axis]=[position in mm]… |
^Units    |Millimeter|
^Type    |Axis-Specific  |
^Remembered |Automatically |

<--

This command sets/displays a fixed hardware HOME location for an axis in units of millimeters.  The ''HOME'' position is considered a fixed hardware location and is adjusted properly when the controller’s coordinate system is altered with the ''HERE'' or ''ZERO'' function.  The HOME position is automatically remembered and recalled through a power cycle and does not need to be saved using the [[commands:saveset|SAVESET command]].  The home position defaults to a large positive number far exceeding the mechanical limits of the system, or else with the upper limit for DAC devices including piezos, micro-mirror, and tunable lenses.

''HM [axis]+'' will set the home position to be the current position. Restore the default home position by executing ''HM [axis]-''. 

== Reply ==

If there are no errors, a reply of  <wrap reply> :A </wrap>  is returned.
== Example ==

<asi> $ HM X?
:A X=1000.000</asi>

In the above example the default location for the ''HOME'' position for the X-axis is returned.


{{tag>commands tiger ms2000}}