Configuring GPIO Banks on a Frame Grabber
To configure a GPIO unit via command line:
- Open the command line window:
- In the command line tool, go to the bin directory of your runtime installation:
cd /D %SISODIR5%\bin
- 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
you specify which frame grabber board in your system you want to address. Specifying the addressed board ins mandatory.
Via command gpioTool -b <board_index> -g
you get the current GPIO bank settings of the specified frame grabber board displayed directly in the command line window.
Via command gpioTool -b <board_index> -s <bank>:<settings>
you configure a specific GPIO bank on the specified frame grabber board.
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>: Index of the frame grabber board you want to configure. The value range depends on the number of frame grabbers you have installed in your system. When you are configuring a trigger extension board, you need to specify the frame grabber the trigger extension board is connected to.
<bank>: The bank defines which GPIO bank on the frame grabber board/trigger extension board you want to address. You have the following values available:
Value |
Addressed GPIO Bank |
---|---|
0 |
Front GPIO |
1 |
GPIO on LightBridge / Port A on external trigger extension board |
2 |
Port B on external trigger extension board |
all |
Addresses all GPIO banks of the selected frame grabber. When working with LightBridge, all addresses the Front GPIO and the GPIO. With marathon, all addresses the front GPIO and both ports of the trigger extension board. |
<settings>: You set here the values for three parameters, separated by comma. <settings> is in the form <signal>,<pull-up-down>,<inversion>
<signal> is either "ds" or "se" (GPIs receive differential or single-ended signals)
<pull-up-down> is either "pu" or "pd" (pupull-up or pull-down)
<inversion> is either "in" or "ni" (inverted or not-inverted)
Alternatively, "default" can be used for <settings> to set the default values for the bank, or "clear|dip-switch" can be used to control the settings on the GPIO extension board via the dip-switch (bank settings via software will be erased).
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 to pull-up mode. |
<pull-up-down> |
pd |
You set to pull-down mode. |
<inversion> |
ni |
GPOs are not inverted. |
<inversion> |
in |
GPOs are inverted. |
Example:
C:\Users\nameofuser>cd /D %SISODIR5\bin
C:\SiliconSoftware\Runtime5.4.1\bin>gpioTool -b 0 -s 0:ds,pu,ni
Explanation:
- In the first line of the example, you go into the bin directory of your Silicon Software runtime installation.
In the second line:
- You call the GPIO configuration tool via gpioTool.
- You specify which frame grabber board in your system you want to configure. When you are configuring a trigger extension board, specify the frame grabber the trigger exension board is connected to. You first enter -b to say that the next input will be the board index of the frame grabber board. Then you enter the index number of the frame grabber you want to configure {0, 1, 2 ...}. If you have only one frame grabber board in your system, the board index is 0. In our example, you want to configure GPIOs on frame grabber 0. Specifying the frame grabber index is mandatory.
- With -s you announce that you are now starting the actual configuration.
- With the value that follows {0,1,2,all} you specify which GPIO bank on the selected frame grabber/trigger extension board you are going to configure. In the example, you selected the Front GPIO (0).
- With double dot: you separate the specification of the addressed GPIO bank and the actual configuration values.
- 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).