T-Series/Commands/Set Home Offset/T-Series Motorized Devices

From ZaberWiki
Jump to navigation Jump to search

Warning: This is an "include" page. As such, its contents may be included in multiple other pages. To see a list of all pages that include this page, click on "What links here" in the bottom left navbar. If you make changes to this page, be sure that your changes are appropriate to all pages on which this content will be included. You are also encouraged to review our Zaber Wiki Editing Guidelines. This header will not be included in other pages.

Instruction Name Set Home Offset
Applies to T-Series motorized devices
Firmware Version 5.xx
Command Number 47
Command Type Setting
Command Data Offset
Reply Data Offset
Safe to retry? Yes
Returns Current Position? No
Persistence Non-Volatile
Summary Sets the the new "Home" position which can then be used when the Home command is issued.

When the home command is issued, the device will retract until the home sensor is triggered, then move forward until the home sensor is no longer triggered, then move forward by the Home Offset value (in microsteps) and resets the internal position (to 0 for most devices).

Note that the home offset command also changes the range settings of the device. For example, if the initial Home Offset is 0 and the Maximum Position is 500,000, and the user changes the Home Offset to 70,000, then the Maximum Position is automatically adjusted to be 430,000. However, changing the Maximum Position does not affect the home offset.

When a new Home Offset is specified, Maximum Position is adjusted to provide the same maximum location. However, the device will not be able to travel below its new home position unless it is homing.

This setting is stored in non-volatile memory and will persist after power-down or reset.