Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » GigE Vision » GigEVision_ExecuteCommand

GigEVision_ExecuteCommand


Module: Genicam

Conditionally executes command in GigEVision device.

Name Type Description
inAddress GevAddress GigE Vision Device identifying address (IP, MAC or Serial Number)
inCommandName GevParameterName Name of GenICam command node to access
inActivationMode GenActivationMode Specifies how filter checks inActivation input
inActivation Bool Activates execution of command
inVerifyAccess Bool True to verify GenICam command parameter access state before every command execution

Description

This filter is intended for cooperation with GigE Vision® compliant devices. Its purpose is to execute a command in a device using GenICam interface.

This filter does not require other GigE Vision® filters in the program (especially GigEVision_GrabImage is not obligatory), but can be used in any combination with them, including shared access to a single device with other filters. The device also does not have to be a transmitter.

Device address (inAddress port) is a textual definition of either IP, MAC or serial number. Use Device Manager (click "..." button in filter properties) to select appropriate address of connected device. For information on address type meaning and selecting device address see Device manager section in user manual.

This filter will interpret the value of inAddress port only during the first iteration of its parent Task, when the connection to the device is established. During the next iterations the filter will use previously established connection and subsequent changes in the device address will be ignored.

A command name (inCommandName port) must be an ID of a GenICam command exported by the device. Each device model can have different command names and their meanings. Refer to the device documentation and use GenICam settings browser (click "..." button in filter properties) to select the appropriate name of a command (see: Device settings editor section in user manual).

The name of the command must point to a GenICam node providing "ICommand" interface or error will be raised upon filter execution.

Do not execute commands "AcquisitionStart" and "AcquisitionStop" directly in the device with this filter, use GigEVision_StartAcquisition and GigEVision_StopAcquisition filters instead.

Command execution is controlled by inActivation input. The command in the device is executed at the filter execution point, but only when the value at inActivation input meets its condition. inActivationMode input can be used to specify how the inActivation input is checked. Refer to GenActivationMode enum description for more details.

For general information about working with GigE Vision devices, please refer to the following article.

Complexity Level

This filter is available on Advanced Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Adaptive Vision Studio Professional version.

See Also

  • Application Notes - set of documents about connecting devices or establishing communication with Adaptive Vision Studio.