Thermal2 Command
sys focus (learn|adjust|on|off)

Description Configure the focus control mode.

The user can use the monitor commands sys focus learn and sys focus adjust to learn the focus. While the monitor command focus learn will learn the focus in blocking mode ( the monitor command will wait for completion ), the monitor commands sys focus learn and sys focus state will learn the focus in non-blocking mode ( the monitor commands will return immediately ). This allows multiple functions to be performed simultaneously.

For example, the user can use the monitor command sys focus learn to initiate the "Learn" focus control mode to learn focus. If successful, the exposure head will continue to learn focus while the user can continue with other processing ( for example, turning on the write laser ). The user can use this monitor command to determine the status of the focus control mode. The status of the focus control mode will be either in progress, successful or unsuccessful.

If the user attempts to access the focus while the exposure head is learning the focus ( for example, turning focus on ), an error will indicate that a command is in progress. However, the user can use the monitor command sys plot abort to abort learning the focus.

The user can use the monitor command sys focus on to turn on the focus. If successful, the focus is prepared to track the media profile. Note that if focus has not been learned, this monitor command will not return immediately ( there will be a significant delay while learning focus ).

The user can use the monitor command sys focus off to turn off the focus. Whether successful or unsuccessful, the focus has been turned off.

Notes Thermal 1.0 / 1.7x equivalents:
  • The monitor command sys focus (learn|on|off) is comparable to focus (learn|on|off).
  • The monitor command sys focus adjust does not have an equivalent.

Related Documents COMMAND: sys focus state
PARAMETER: sys plotenable
ERRORCODE: [03539] The focus control mode is in progress
ERRORCODE: [03543] Timeout waiting for the focus learn
ERRORCODE: [03546] The focus control mode has been aborted

Firmware Notes The monitor command sys focus (learn|adjust|on|off) corresponds to the API function CEH_FocusMode( ) in the CEH API document.

Applies to: THERMAL2
Access: FIELD
Modified: Tue Oct 24 11:54:52 2006
Updated: Thu Jul 17 02:31:38 2008
Module: SYS