Configuring the Physical Properties of Trigger Signals

You can configure the physical properties of trigger signals passing a GPIO bank. You can define if you want to:

Configuring a GPIO Bank

LightBridge 2 ACL offers two GPIO banks, the Front GPIO and the GPIO. Both banks you configure in the same way.

You work with the gpioTool (a command line tool) which comes as part of the Silicon Software runtime environment.

To configure the trigger signals of a GPIO bank physically:

  1. Open the command line window:
  2. In the command line tool, go to the bin directory of your runtime installation:
    cd /D %SISODIR5%\bin
  3. Now, enter your commands and values as described in the following.

You have the following commands and parameters available:

  gpioTool -b <board_index>  
    -g  
    -s <bank>:<settings>  
    -h  
    -v  

Commands

With command gpioTool -b <board_index> you specify which LightBridge device in your system you want to address. Specifying the addressed LightBridge device is mandatory.

Via command gpioTool -b <board_index> -g you get the current GPIO bank settings of the specified LightBridge device displayed directly in the command line window.

Via command gpioTool -b <board_index> -s <bank>:<settings> you configure a specific GPIO bank on the specifiedLightBridge device.

Via command gpioTool -h you get help instructions displayed directly in the command line window.

Via command gpioTool -b <board_index> -v you get verbose output displayed directly in the command line window.

Value ranges:

<board_index>: Specify here the index number of the LightBridge device you want to configure. The value range of <board_index> is the index numbers of all frame grabbers installed in your system.

<bank>: The bank defines which GPIO bank on the LightBridge device you want to address. You have the following values available:

Value

Addressed GPIO Bank

0

Front GPIO

1

GPIO (rear side)

all

"All" addresses the front GPIO and the GPIO (rear side).

 

<settings>: Here, you set the values for three parameters, separated by comma. <settings> is in the form <signal>,<pull-up-down>,<inversion>

 

<signal> you can set to "ds" or "se": GPIs receive differential ("ds") or single-ended ("se") signals.

<pull-up-down> you can set to "pu" or "pd" : GPIs receive incoming signals in pull-up (pu) or pull-down (pd) mode. This configuration depends on the electrical source of the incoming signal: Use pull-up (10 kΩ) to receive signals from NPN transistors (open collector, open drain). Use pull-down (10 kΩ) to receive signals from PNP transistors (open emitter, open source).

<inversion> you can set to "in" (inverted) or "ni" (not-inverted): GPOs will send inverted or not inverted signals.

Alternatively, you can use "default" for <settings> to set the default values for the bank.

Parameter

Value

Effect of specific value

<signal>

se

You set all addressed GPIs to receive single-ended signals.

<signal>

ds

You set all addressed GPIs to receive differential signals.
<pull-up-down> pu You set all addressed GPIs to pull-up mode to receive signals from NPN transistors (open collector, open drain).
<pull-up-down> pd You set all addressed GPIs to pull-down mode to receive signals from PNP transistors (open emitter, open source).
<inversion> ni You set all addressed GPOs to send not-inverted signals.

<inversion>

in

You set all addressed GPOs to send inverted signals.

 

Example:

C:\Users\nameofuser>cd /D %SISODIR5\bin

C:\SiliconSoftware\Runtime5.4.1\bin>gpioTool -b 0 -s 0:ds,pu,ni

Explanation:

  1. In the first line of the example, you go into the bin directory of your Silicon Software runtime installation.

In the second line:

  1. You call the GPIO configuration tool via gpioTool.
  2. You specify which LightBridge device in your system you want to configure. You first enter -b to say that the next input will be the board index of the LightBridge device. Then you enter the index number of the LightBridge device you want to configure {0, 1, 2 ...}. If you have only one LightBridge device in your system, the board index is 0. In our example, you want to configure GPIOs on LightBridge device 0. Specifying the board index is mandatory.
  3. With -s (like "setting") you announce that you are now starting the actual configuration.
  4. With the value that follows {0,1,all} you specify which GPIO bank on the selected LightBridge device you are going to configure. In the example, you selected the Front GPIO (0).
  5. With double dot : you separate the specification of the addressed GPIO bank and the actual configuration values.
  6. After the double dot you specify the values for the three parameters. In the example, the Front GPIO is configured to receive two differential IN signals (ds), to work in pull-up mode (pu), and to send the outgoing signals not inverted (ni).

Re-Setting Default Values

To re-set a bank to the default values:

  1. Open the command line window:
  1. In the command line tool, go to the bin directory of your runtime installation:
    cd /D %SISODIR5%\bin
  2. Now, enter the following string:
    installdir\bin>gpioTool -b <board_index> -s <bank>:default