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.
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.
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.
- 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.
device = ‘dev2006’ ziCreateAPISession(‘dev2006’, 5); input_channel = 0 ziSiginAutorange(device, input_channel)
See also ZICREATEAPISESSION, EXAMPLE_SCOPE