Operator GPI

Operator Library: Hardware Platform

The GPI operator provides an interface to the digital inputs. Via the Pin_ID / PinID parameter (the name of the parameter depends on the hardware platform), you select the digital input (which is wired to a physical pin on a GPIO unit) you want to use for receiving a signal. The same digital inputs can be used by multiple operators.

For all platforms except the imaFlex platforms: If you use a device with several GPIO units, use the ConnectorType parameter to select the GPIO unit you want to address (Front GPIO or GPIO). On the imaFlex 2 Dual 100, imaFlex CXP-12 Quad and imaFlex CXP-12 Penta platforms, the parameter ConnectorType is not available.

[Note] Front GPI Port Groups and Signal Modes on the imaFlex 2 Dual 100 Platform

The front GPI ports on the imaFlex 2 Dual 100 platform are divided into two independent groups:

  • Each group can use a different power supply voltage.

  • GPO and GPI groups do not share the same supply voltage.

  • Each group has its own dedicated power supply pins.

The AppletProperties operator controls whether a front GPI port group operates in single-ended or differential mode.

If the FrontGpiPullControl03 / FrontGpiPullControl47 parameter on the AppletProperties operator is set to Differential:

  • Only even-numbered GPI ports in that group are valid in VisualApplets.

  • Odd-numbered ports should be ignored (treated as “don’t care”).

Example: If the FrontGpiType03 parameter is set to Differential in the AppletProperties operator, and the design requires a differential signal on ports 0 and 1:

  • Set the PinID parameter in the GPI operator to FrontGpi0 to access the differential signal.

  • Do not use FrontGpi1, as it will produce an undefined signal.

  • Mode comparison:

    • Single-ended mode: Both ports (0 and 1) can be used independently.

    • Differential mode: Ports 0 and 1 are combined to receive the differential signal. The resulting signal is output to VisualApplets on the even-numbered port.

For the mapping of digital inputs and pin connectors, see the GPIO Connectors topic of your frame grabber User Manual. For the imaFlex 2 Dual 100 plaform, see GPIO Connectors (CoF Frame Grabbers).

Available for Hardware Platforms
imaFlex 2 Dual 100
imaFlex CXP-12 Penta
imaFlex CXP-12 Quad
mE5 marathon VCLx
mE5 marathon VCL
mE5 marathon VCX-QP
mE5 marathon VF2
LightBridge VCL
mE5 ironman VQ8-CXP6D/-CXP6B
mE5 ironman VD8-PoCL
pixelPlant 100
pixelPlant 200

Resources

The FPGA device resources of this operator are equal to value of the PinID / Pin_ID parameter. You can see the FPGA device resources, if you open the FPGA Device Resources dialog from the Analysis menu. The device resources are read-only:

FPGA Device Resources

Figure 430. FPGA Device Resources


For the imaFlex 2 Dual 100 platform, the resource is of type GPI with index 0 to 7 for Front GPIO connector and 8 to 15 – for the Extension GPIO connector.

I/O Properties

Property Value
Operator Type M
Output Link O, general purpose input signal to be used inside VisualApplets.

Supported Link Format

Link Parameter Output Link O
Bit Width 1
Arithmetic unsigned
Parallelism 1
Kernel Columns 1
Kernel Rows 1
Img Protocol VALT_SIGNAL
Color Format VAF_GRAY
Color Flavor FL_NONE
Max. Img Width any
Max. Img Height any

Parameters

PinID (all imaFlex platforms)
Type static write parameter
Default FrontGpi0
Range

imaFlex CXP-12 Quad and imaFlex CXP-12 Penta: {FrontGpi0, FrontGpi1, FrontGpi2, FrontGpi3, ExtensionGpi0, ExtensionGpi1, ExtensionGpi2, ExtensionGpi3, ExtensionGpi4, ExtensionGpi5, ExtensionGpi6, ExtensionGpi7};

imaFlex 2 Dual 100: {FrontGpi0, FrontGpi1, FrontGpi2, FrontGpi3, FrontGpi4, FrontGpi5, FrontGpi6, FrontGpi7, ExtensionGpi0, ExtensionGpi1, ExtensionGpi2, ExtensionGpi3, ExtensionGpi4, ExtensionGpi5, ExtensionGpi6, ExtensionGpi7}

Via the PinID parameter, you define the digital input (which is wired to a physical pin on a GPIO socket) you want to use for receiving a signal. The same digital inputs can be used by multiple operators.

FrontGpiN represents the GPI for the Front GPIO connector.

ExtensionGpiN represents the GPI for Extension GPIO side connector.

For the mapping of digital inputs and pin connectors, see the GPIO Connectors topic of your frame grabber User Manual. For the imaFlex 2 Dual 100 plaform, see GPIO Connectors (CoF Frame Grabbers).

[Note] Pin Mapping for imaFlex 2 Dual 100
Front GPIO Connector of the imaFlex 2 Dual 100

Figure 431. Front GPIO Connector of the imaFlex 2 Dual 100


GPI Operator PinID Front GPIO Connector Pin GPI Group Differential / Single-ended
FrontGpi0 12 03 Differential and single-ended
FrontGpi1 13 03 Single-ended
FrontGpi2 3 03 Differential and single-ended
FrontGpi3 4 03 Single-ended
FrontGpi4 10 47 Differential and single-ended
FrontGpi5 11 47 Single-ended
FrontGpi6 1 47 Differential and single-ended
FrontGpi7 2 47 Single-ended
Extension GPIO Connector of the imaFlex 2 Dual 100

Figure 432. Extension GPIO Connector of the imaFlex 2 Dual 100


GPI Operator PinID Extension GPIO Connector Pin
ExtensionGpi0 9
ExtensionGpi1 11
ExtensionGpi2 13
ExtensionGpi3 15
ExtensionGpi4 25
ExtensionGpi5 27
ExtensionGpi6 29
ExtensionGpi7 31
[Note] Availability

imaFlex 2 Dual 100, imaFlex CXP-12 Quad, and imaFlex CXP-12 Penta

Pin_ID (mE5 platforms, pixelPlant and LightBridge VCL)
Type static write parameter
Default 0
Range [0;7] or [0;3]

Via parameter Pin_ID, you define the digital input (which is wired to a physical pin on a GPIO socket) you want to use for receiving a signal. The same digital inputs can be used by multiple operators.

[0;3] The value range is 0-3 for the Front GPIO on marathon, the Front GPIO on LightBridge, and the GPIO on LightBridge.

[0;7] For the GPIO on marathon and in all other cases, the value range is 0-7.

[Note] Availability

mE5 marathon VCLx, mE5 marathon VCL, mE5 marathon VCX-QP, mE5 marathon VF2, LightBridge VCL, mE5 ironman VQ8-CXP6D/-CXP6B, mE5 ironman VD8-PoCL, pixelPlant 100, pixelPlant 200

ConnectorType (mE5 marathon and LightBridge VCL platforms)
Type static write parameter
Default GPIO
Range {FrontGPIO, GPIO}

Via parameter ConnectorType, you define which GPIO socket (GPIO or Front GPIO) you want to address with the value you enter for parameter Pin_ID.

[Note] Availability

This parameter is only available for platforms that have a Front GPIO:

  • mE5 marathon VCLx

  • mE5 marathon VCL

  • mE5 marathon VCX-QP

  • mE5 marathon VF2

  • LightBridge VCL

Examples of Use

The use of operator GPI is shown in the following examples: