EZ

Loads new azimuth and elevation offset values for the coordinate transformation module, or optionally requests the old values, if the parameters are omitted.

Mnemonic:

Encoder Zero

Syntax:

EZ [az0, el0]

az0: azimuth encoder count offset. Legal range is from $-(2^{30})$ to $(2^{30}) - 1$, but will be a number between 0 and the number of counts per revolution for the azimuth encoder.

el0: elevation encoder count offset. Legal range is from $-(2^{30})$ to $(2^{30}) - 1$, but will be a number between 0 and the number of counts per revolution for the elevation encoder.

Return values:

Success:

EZ 1, az0, el0

Failure:

EZ 0, err_msg

az0: azimuth encoder count offset.

el0: elevation encoder count offset.

err_msg: Should the command fail, this value will be an error message string, explaining the cause of failure. The only possible failure mode is if a value outside of the range specified above is entered.

Remarks:

This function, along with it's companion functions, load coordinate transformation constants that allow the laser to correctly point to any 3 dimensional coordinate in an arbitrary coordinate system. EZ sets the azimuth and elevation encoder offsets that allows for the physical mounting of the azimuth and elevation encoders. These values are determined by a calibration procedure [8].

Example:

     send: EZ 23766, 75846
  receive: EZ 1, 23766, 75846

     send: EZ
  receive: EZ 1, 23766, 75846

See also:

ALPHA, BETA, BP, EZ, INITZY