gpioTool

The gpioTool command-line tool allows you to configure the physical properties of the trigger signals received or sent by a frame grabber or trigger board.

• 可以将输入线路配置为接收单端或差分信号。
• 可以将输入线路配置为在上拉或下拉模式下工作。
• 可以指定是否应将输出信号反相。

The gpioTool is included in the Framegrabber SDK and in the pylon Software Suite.

要启动该工具，请执行以下操作：

1. 打开命令行。
2. If you're using the Framegrabber SDK, change to the bin directory of your Framegrabber SDK installation: cd /D %BASLER_FG_SDK_DIR%\bin.

3. 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

4. 使用如下所述的选项启动 gpioTool。

选项

可以使用如下选项：

gpioTool -b [board_index]
         -g
         -v
         -s [bank]:[settings]
         -h

-b [board_index]
Specify which board (frame grabber or trigger board) in your system you want to address. This parameter is mandatory for all options except -h.
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.

-h
Show help.

设置

For the [settings] part in -b [board_index] -s [bank]:[settings], the following settings are available:

设置	值	结果
[signal]	se	将输入线路配置为接收单端信号。
[signal]	ds	将输入线路配置为接收差分信号。
[pull-up-down]	pu	将输入线路配置为在上拉模式下工作。a
[pull-up-down]	pd	将输入线路配置为在下拉模式下工作。a
[inversion]	ni	禁用输出线路的反转。
[inversion]	in	启用输出线路的反转。

---

1. 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). ↩

2. 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 [settings] to 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).

重置配置

To reset a board and GPIO bank to the default settings, start the gpioTool with [settings] set to default:

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 dip-switch:

gpioTool -b [board_index] -s [bank]:dip-switch

示例： gpioTool -b 0 -s 0:dip-switch