- You can configure the input lines to receive single-ended or differential signals.
- You can configure the input lines to operate in pull-up or pull-down mode.
- You can specify whether output signals should be inverted.
The gpioTool is included in the Framegrabber SDK and in the pylon Camera Software Suite.
To start the tool:
- Open a command line.
- If you're using the Framegrabber SDK, change to the
bindirectory of your Framegrabber SDK installation: cd /D %BASLER_FG_SDK_DIR%\bin.
If you're using pylon, change to the bin directory of your pylon installation:
- Windows: %programfiles%\Basler\pylon[version]\Runtime\x64\pylonCXP\bin
- Linux: /opt/pylon/lib/pylonCXP/bin
Start the gpioTool using the options described below.
The following options are available:
Specify which board (frame grabber or trigger board) in your system you want to address. This parameter is mandatory for all options except
The value range of
[board_index] is the index numbers of all boards installed in your system. If you only have one board in your system, set
[board_index] to 0.
-b [board_index] -g
Show the current GPIO bank settings of the board specified.
-b [board_index] -v
Show the current GPIO bank settings with verbose output.
-b [board_index] -s [bank]:[settings]
Configure the GPIO bank on the board specified.
[bank] specifies the index number of the GPIO bank.
[settings] configures the settings. See below.
[settings] part in
-b [board_index] -s [bank]:[settings], the following settings are available:
| ||se||Configures the input lines to receive single-ended signals.|
| ||ds||Configures the input lines to receive differential signals.|
| ||pu||Configures the input lines to operate in pull-up mode.a|
| ||pd||Configures the input lines to operate in pull-down mode.b|
| ||ni||Disables inversion for the output lines.|
| ||in||Enables inversion for the output lines.|
For most applications, use this mode. The board activates a 10 kΩ pull-up resistor to receive signals from NPN transistors (open collector, open drain).
The board activates a 10 kΩ pull-down resistor to receive signals from PNP transistors (open emitter, open source).
You must enter the settings in the following format:
[signal],[pull-up-down],[inversion]. Example: ds,pu,ni
Alternatively, you can set
default. This resets the configuration of a GPIO bank.
gpioTool -b 0 -s 0:ds,pu,ni
This command configures the board as follows:
-b 0: Configure the GPIOs on board 0.
-s: Start the actual configuration.
0:: Configure GPIO bank 0 (front GPIO).
ds,pu,ni: Configure the front GPIO to receive differential signals (ds), to work in pull-up mode (pu), and to send the outgoing signals not inverted (ni).
Resetting the Configuration#
To reset a board and GPIO bank to the default settings, start the gpioTool with
[settings] set to
gpioTool -b [board_index] -s [bank]:default
gpioTool -b 0 -s 0:default
Resetting to DIP Switch Settings#
You can reset a board to the current DIP switch settings. This overrides the software configuration.
To reset a board to DIP switch settings, start the gpioTool with
[settings] set to
gpioTool -b [board_index] -s [bank]:dip-switch
gpioTool -b 0 -s 0:dip-switch