query_io_interface — Query information about the specified I/O device interface.
query_io_interface( : : IOInterfaceName, Query : Result)
The operator query_io_interface returns information about
the I/O device interface IOInterfaceName. The desired
information is specified via Query. If applicable,
Result contains a list of supported values.
Generally, when passing the value 'interface_name' for
Query, all available I/O interfaces are returned. The value
of the parameter IOInterfaceName is ignored in this case.
Please check the directory 'doc/html/reference/io' for documentation about your specific I/O device interface, where all supported interface specific parameters are listed.
On Windows Systems, error dialog boxes from the operating system can occur when dependency modules of the interface are not found, e.g., the according SDK was not installed. The occurrence of the error boxes can be controlled by setting Windows' Error Mode. Please refer to the description of SetErrorMode within the Windows MSDN documentation.
IOInterfaceName (input_control) string → (string)
HALCON I/O interface name.
Default value: []
Suggested values: 'ADLINK-DAQPilot', 'ADLINK-EOS', 'Advantech', 'Contec', 'Hilscher-cifX', 'Interface', 'NIDAQmx', 'OPC_Classic', 'OPC_UA'
Query (input_control) string(-array) → (string)
Parameter name of the query.
Default value: 'io_device_names'
Suggested values: 'interface_name', 'io_device_names', 'param_name', 'revision'
Result (output_control) string-array → (string / integer / real)
List of result values (according to Query).
* Select a suitable i/o device interface of name IOInterfaceName query_io_interface (IOInterfaceName, 'io_device_names', DeviceNames) open_io_device (IOInterfaceName, DeviceNames[0], [], [], IODeviceHandle) query_io_device (IODeviceHandle, [], 'io_channel_names.digital_input', ChannelInputNames) open_io_channel (IODeviceHandle, ChannelInputNames[0], [], [], IOChannelHandle) read_io_channel (IOChannelHandle, Value, Status)
If the parameters are valid, the operator
query_io_interface returns the value 2 (H_MSG_TRUE). If necessary an
exception is raised. In this case, an extended error information may be
set and can be queried with the operator get_extended_error_info.
Foundation