To run the HALCON evaluation version you need an evaluation license. To get such a license, please contact your local distributor. Please note: the evaluation license is valid for a certain period of time. Feb 26, 2018 - To try out our machine vision software HALCON for free, please follow the instructions below. You need to in order to view the respective.
Product Information
Try for free
Buy HALCON
Download
MVTec HALCON is the comprehensive standard software for machine vision with an integrated development environment (HDevelop) that is used worldwide. It enables cost savings and improved time to market. HALCON’s flexible architecture facilitates rapid development of any kind of machine vision application.
MVTec HALCON provides outstanding performance and a comprehensive support of multi-core platforms, special instruction sets like AVX2 and NEON, as well as GPU acceleration. It serves all industries, with a library used in hundreds of thousands of installations in all areas of imaging like blob analysis, morphology, matching, measuring, and identification. The software provides the latest state-of-the-art machine vision technologies, such as comprehensive 3D vision and deep learning algorithms.
The software secures your investment by supporting a wide range of operating systems and providing interfaces to hundreds of industrial cameras and frame grabbers, in particular by supporting standards like GenICam, GigE Vision, and USB3 Vision. By default, MVTec HALCON runs on Arm®-based embedded vision platforms. It can also be ported to various target platforms. Thus, the software is ideally suited for the use within embedded and customized systems.
Interface: | Advantech |
Revision: | 13.0.1 |
Date: | 2016-10-28 |
HALCON Version: | 13.0 |
General
This page provides the documentation of the HALCON Advantech interface for accessing the Advantech Digital I/O cards. Only interface specific parameters and features are described here. For general information of the operators for I/O interfaces please have a look at the HALCON Operator Reference.
Registered customers can download the latest revision of this interface from the MVTec WWW server.
Registered customers can download the latest revision of this interface from the MVTec WWW server.
System Requirements
- Intel compatible PC with Windows 7 (32-bit or 64-bit) or newer that is also supported by the vendor-specific SDK, also WoW64 (using 32-bit HALCON on 64-bit Windows).
- Installed Advantech DAQNavi SDK version 3.1.6 (or higher).
- Windows: HALCON I/O interface hioAdvantech.dll or hioAdvantechxl.dll, respectively. If you have properly installed the interface, all these DLLs should reside in bin%HALCONARCH% within the HALCON base directory %HALCONROOT% you have chosen during the installation of HALCON.
Features
- Opening and using of multiple Advantech I/O ports.
- Opening and using of multiple specific channels (specific port values).
Limitations
- No support of event counters
- No support of pattern matching
- No support of analog functions Error #21010: HALCON license error:Error #21010: HALCON license error:Error #21010: HALCON license error:Error #21010: HALCON license error:Error #21010: HALCON license error:
Operator read_io_channel
Read the value from the specific I/O channel or from a port.
Operator write_io_channel
Write a value to the specific I/O channel or to a port. If several handles are passed, an atomically write is only supported if the order of the handles is not arbitrary. Ports and channels will be written atomically if an ascending order with no gaps is given, e.g. if the following handle values will be passed (the name (do_x.x) represents the handle queried via open_io_channel) ['do_0.1', 'do_0.5', 'do_1.4', 'do_2.0']. In case of ['do_0.0','do_2.0'] or ['do_1.0','do_0.0'] the execution is not atomically and two write calls will be executed internally.
Operator query_io_interface
Query information about the specified I/O device interface.
Operator open_io_device
Operator set_io_device_param
Set the device parameters. Currently, no parameters are defined.
Operator get_io_device_param
There may exist additional parameter attributes, which can be accessed as 'ParamNames.AttributeName'. The following standard attributes may be available:
- '.access': This attribute provides the access permissions of the corresponding parameter as a string. Possible values are 'ro' (read-only), 'wo' (write-only), 'rw' (read/write), 'na' (unavailable, perhaps due to insufficient access rights), and 'ni' (unavailable, not defined for this device or channel).
- '.category': This attribute provides the category of the corresponding parameter as a string. 'I/O interface' for all pre-defined I/O interface parameters.
- '.default': This attribute provides the default value of the corresponding parameter.
- '.description': This attribute provides the description of the corresponding parameter as a string.
- '.displayname': This attribute provides the displayname of the corresponding parameter as a string.
- '.range': This attribute provides the minimum and maximum, (and the step width, if applicable) for the corresponding integer or float parameter as a tuple with 2 (or 3) elements.
- '.representation': This attribute provides how the value of the parameter should be displayed in a GUI: 'ip address', 'hex', ...
- '.tooltip': This attribute provides the tool-tip of the corresponding parameter as a string.
- '.type': This attribute provides the HALCON value type (integer, real, or string) of the corresponding parameter as a string.
- '.values': This attribute provides the valid value list for the corresponding parameter as a tuple.
- '.visibility': This attribute provides the visibility of the corresponding parameter as a string. Possible values are 'common', 'extended', and 'dangerous'.
- '.unit': This attribute provides the units of the corresponding parameter as a string. For example: 'ns', 'us' and 'ms', or 'mm', 'cm', 'dm' and 'm'.
Query the requested information from the specified I/O channels. The parameter 'ParameterNode' is not used by this interface.
Operator set_io_channel_param
Operator get_io_channel_param
There may exist additional parameter attributes, which can be accessed as 'ParamNames.AttributeName'. The following standard attributes may be available:
- '.access': This attribute provides the access permissions of the corresponding parameter as a string. Possible values are 'ro' (read-only), 'wo' (write-only), 'rw' (read/write), 'na' (unavailable, perhaps due to insufficient access rights), and 'ni' (unavailable, not defined for this device or channel).
- '.category': This attribute provides the category of the corresponding parameter as a string. 'I/O interface' for all pre-defined I/O interface parameters.
- '.default': This attribute provides the default value of the corresponding parameter.
- '.description': This attribute provides the description of the corresponding parameter as a string.
- '.displayname': This attribute provides the displayname of the corresponding parameter as a string.
- '.range': This attribute provides the minimum and maximum, (and the step width, if applicable) for the corresponding integer or float parameter as a tuple with 2 (or 3) elements.
- '.representation': This attribute provides how the value of the parameter should be displayed in a GUI: 'ip address', 'hex', ...
- '.tooltip': This attribute provides the tool-tip of the corresponding parameter as a string.
- '.type': This attribute provides the HALCON value type (integer, real, or string) of the corresponding parameter as a string.
- '.values': This attribute provides the valid value list for the corresponding parameter as a tuple.
- '.visibility': This attribute provides the visibility of the corresponding parameter as a string. Possible values are 'common', 'extended', and 'dangerous'.
- '.unit': This attribute provides the units of the corresponding parameter as a string. For example: 'ns', 'us' and 'ms', or 'mm', 'cm', 'dm' and 'm'.
HDevelop Examples
For this interface the following examples are available:- advantech_digital_read.hdev - Example to show how to read several parameters and values.
- advantech_digital_write.hdev - Example to show how to write several parameters and values.
Release Notes
- Revision 13.0.1 (Oct 28, 2016):
- HALCON 13 version of the interface.
- Revision 1.2 (May 13, 2016):
- In read_io_channel, when reading an input port, the value of the returned Status parameter was always 1 (failure). This problem has been fixed.
- Revision 1.1 (Apr 25, 2016):
- When querying the channels list with query_io_device, the current port direction configuration was not taking into account for bi-directional ports. This problem has been fixed.
- When querying the channel list of unsupported channel types an error message was returned. This problem has been fixed and now an empty tuple is returned.
- The query of the possible parameter names accepted by query_io_device returned an error. This problem has been fixed.
- query_io_device returned an empty tuple when querying the channel type without specifying a channel. This problem has been fixed and now an error is returned.
- query_io_device crashed when querying 'value.range' without specifying a channel name. This problem has been solved and now an error is returned.
- Revision 1.0 (Jan 10, 2014):
- First official release.