ziSiginAutorange

Utils.ziSiginAutorange(device, in_channel)

ZISIGINAUTORANGE Perform an autorange on the specified device’s input channel

RANGE = ZISIGINAUTORANGE(DEVICE, IN_CHANNEL)

Perform an automatic adjustment of DEVICE’s signal input channel IN_C and return the final RANGE set. This utility function starts the functionality implemented in the device’s firmware and waits until it has completed. The range is set by the firmware based on the measured input signal’s amplitude measured over approximately 100 ms.

Requirements:

1. A device type that supports autorange functionality on the firmware level, e.g., UHFLI, MFLI, MFIA. For HF2 Instruments see the example hf2_example_autorange().

2. The ziDAQ API Session (connection to the device’s Data Server) has already been initialised.

Input arguments:

DEVICE (str): The device ID on which to perform the signal input autorange, e.g., ‘dev2006’

IN_CHANNEL (int): The index of the signal input channel to autorange.

Raises:

Error: If the functionality is not supported by the device or an

invalid in_channel was specified.

Error: If autorange functionality does not complete within the timeout.

Example:

device = ‘dev2006’ ziCreateAPISession(‘dev2006’, 5); input_channel = 0 ziSiginAutorange(device, input_channel)

See also ZICREATEAPISESSION, EXAMPLE_SCOPE