AMP

This command returns the last measured amplitude for a specified retroreflector target.

Mnemonic:

cube AMPlitude.

Syntax:

AMP $<$n$>$

n: Cube name or number

Return values:

Success:

AMP 1, n, a

Failure:

AMP 0, err_msg

n: Cube index number

a: Last measured amplitude for the retroreflector. If valid, this will be a value between 0 and 10 Volts.

err_msg: Should the command fail, this value will be an error message string, explaining the cause of failure.

Remarks:

This is a cube based command, therefore INI must be called before this command can be successful. AMP will also fail if cube n is not found in the cube collection. The value returned by AMP will be meaningless unless a measurement was previously taken of this cube with CMEAS or SCN.

Example:

     send: AMP 5
  receive: AMP 1, 5, 0.385

     send: AMP ZRG
  receive: AMP 1, 0, 8.153

See also:

CIL, CMEAS, COO, INI, INITZY, PHI, SCN