GPIO¶

GPIO 回读、静态驱动、定时脉冲与脉冲宽度触发配置位于 AqProtocolExerciser。从 aqpxlib.gpio 导入枚举与值类型，从 aqpxlib.event 导入触发事件——不要从 aqpxlib.message 导入。

教程

GPIO 读取、驱动与脉冲 · GPIO 脉冲宽度触发

公开导出¶

名称	种类	用途
`GpioState`	enum	`set_gpio_state`、脉冲边沿与回报引脚状态的电平（`PxIoState` 别名）
`GpioWidthTriggerMode`	enum	`set_gpio_trigger(..., mode=...)`（`PxGpioWidthTriggerMode` 别名）
`GpioPinState`	dataclass	`get_gpio_state` 的返回类型（`PxGpioPinState` 别名）
`GpioWidthTriggerConfig`	dataclass	`get_gpio_trigger` 的返回类型

GpioState ¶

Logical level for one GPIO line.

METHOD	DESCRIPTION
`to_protobuf`	Encode as a wire `PxIoState` enum value.
`from_protobuf`	Build from a wire `PxIoState` enum value.

to_protobuf ¶

to_protobuf() -> PxIoState

Encode as a wire PxIoState enum value.

from_protobuf ¶

from_protobuf(value: PxIoState | None) -> GpioState | None

Build from a wire PxIoState enum value.

单一 GPIO 线路的逻辑电平。

成员	含义
`LOW`	驱动或采样为低
`HIGH`	驱动或采样为高
`HIGH_Z`	高阻抗(未主动驱动)

GpioWidthTriggerMode ¶

Width-condition selector for set_gpio_trigger.

METHOD	DESCRIPTION
`to_protobuf`	Encode as a wire `PxGpioWidthTriggerMode` enum value.
`from_protobuf`	Build from a wire `PxGpioWidthTriggerMode` enum value.

to_protobuf ¶

to_protobuf() -> PxGpioWidthTriggerMode

Encode as a wire PxGpioWidthTriggerMode enum value.

from_protobuf ¶

from_protobuf(value: PxGpioWidthTriggerMode) -> GpioWidthTriggerMode

Build from a wire PxGpioWidthTriggerMode enum value.

set_gpio_trigger 的宽度条件选择器。

成员	含义
`TRIGGER_PULSE_WIDTH_IN_RANGE`	宽度落在 `[min_duration_ns, max_duration_ns]` 内时触发(配合 `low_pulse` / `high_pulse`)
`TRIGGER_PULSE_WIDTH_OUT_OF_RANGE`	宽度落在该窗口外时触发

GpioPinState ¶

GpioPinState(
    pin_idx: int,
    output_state: GpioState | None = None,
    input_state: GpioState | None = None,
)

One GPIO pin snapshot from get_gpio_state.

METHOD	DESCRIPTION
`to_protobuf`	Encode as a wire `PxGpioPinState` message.
`from_protobuf`	Build from a wire `PxGpioPinState` message.

to_protobuf ¶

to_protobuf() -> PxGpioPinState

Encode as a wire PxGpioPinState message.

from_protobuf ¶

from_protobuf(msg: PxGpioPinState) -> Self

Build from a wire PxGpioPinState message.

get_gpio_state(gpio_idx=…) 返回的单一引脚快照。

字段	含义
`pin_idx`	引脚索引
`output_state`	驱动电平(未驱动/未知时为 `None`)
`input_state`	采样输入(无法取得时为 `None`)

GpioWidthTriggerConfig ¶

GpioWidthTriggerConfig(
    pin_idx: int,
    min_duration_ns: int,
    max_duration_ns: int,
    mode: GpioWidthTriggerMode = TRIGGER_PULSE_WIDTH_IN_RANGE,
    low_pulse: bool = False,
    high_pulse: bool = False,
)

Pulse-width trigger settings for one GPIO pin.

METHOD	DESCRIPTION
`to_protobuf`	Encode as a wire `PxGpioWidthTriggerParams` message.
`from_protobuf`	Build from a wire `PxGpioWidthTriggerParams` message.

to_protobuf ¶

to_protobuf() -> PxGpioWidthTriggerParams

Encode as a wire PxGpioWidthTriggerParams message.

from_protobuf ¶

from_protobuf(msg: PxGpioWidthTriggerParams) -> Self

Build from a wire PxGpioWidthTriggerParams message.

get_gpio_trigger(gpio_idx=…) 返回的宽度触发设置。

PxGpioTriggerEvent ¶

PxGpioTriggerEvent(
    *, pin_idx: int = 0, pulse_duration: int = 0, pulse_polarity: bool = False
)

A GPIO width trigger fired.

METHOD	DESCRIPTION
`from_protobuf`	Build from a wire `PxGlobalEvent` message.

from_protobuf ¶

from_protobuf(msg: PxGlobalEvent) -> Self

Build from a wire PxGlobalEvent message.

传给 gpio_trigger 处理函数的事件(来自 aqpxlib.event)。

字段	含义
`pin_idx`	符合条件的引脚
`pulse_duration`	宽度，单位为纳秒
`pulse_polarity`	检测到的极性

Exerciser 方法¶

AqProtocolExerciser ¶

AqProtocolExerciser(session: PxSession | None = None, **legacy: object)

AqProtocolExerciser class.

Most callers use :meth:connect instead, which builds the session from a transport config and connects it. Pass a session here to supply one yourself: an already-connected session.

PARAMETER	DESCRIPTION
`session` ¶	The :class:`~aqpxlib.sessions.PxSession` to drive. TYPE: `PxSession \| None` DEFAULT: `None`
`legacy` ¶	Present only so the removed `host` / `port` / `protocol_version` / `generation` constructor arguments give a clear error instead of a bare `TypeError`. TYPE: `object` DEFAULT: `{}`

RAISES	DESCRIPTION
`TypeError`	If `session` is omitted, or if any keyword argument is given.

METHOD	DESCRIPTION
`get_gpio_state`	Read electrical state for one GPIO pin.
`set_gpio_state`	Drive a static logic level on one GPIO pin.
`send_gpio_pulse`	Emit one pulse: idle → `active_state` for `active_time_ns` → `idle_state`.
`set_gpio_trigger`	Configure GPIO pulse-width triggering (fires `gpio_trigger` global events).
`get_gpio_trigger`	Get GPIO pulse-width triggering configuration.

get_gpio_state ¶

get_gpio_state(gpio_idx: int) -> GpioPinState

Read electrical state for one GPIO pin.

The instrument returns status for all pins; this method selects gpio_idx.

PARAMETER	DESCRIPTION
`gpio_idx` ¶	Index of the pin to read. TYPE: `int`

RETURNS	DESCRIPTION
`GpioPinState`	`pin_idx` plus optional `output_state` (driven level) TYPE: `GpioPinState`
`GpioPinState`	and `input_state` (sampled level).

RAISES	DESCRIPTION
`ValueError`	If `gpio_idx` is negative or not present in the reply.

set_gpio_state ¶

set_gpio_state(gpio_idx: int, state: GpioState) -> None

Drive a static logic level on one GPIO pin.

PARAMETER	DESCRIPTION
`gpio_idx` ¶	Pin index to drive. TYPE: `int`
`state` ¶	Target level (see `GpioState`: `LOW`, `HIGH`, `HIGH_Z`). TYPE: `GpioState`

Note

The server may reject the operation if the pin is owned by another protocol.

send_gpio_pulse ¶

send_gpio_pulse(
    gpio_idx: int, active_state: GpioState, idle_state: GpioState, active_time_ns: int
) -> None

Emit one pulse: idle → active_state for active_time_ns → idle_state.

Supported only on GPIO indices 8 and 9. Pulse width must be greater than 5 ns and less than 1 second.

PARAMETER	DESCRIPTION
`gpio_idx` ¶	Pin index; must be `8` or `9`. TYPE: `int`
`active_state` ¶	Level during the active portion of the pulse. TYPE: `GpioState`
`idle_state` ¶	Level after the pulse completes. TYPE: `GpioState`
`active_time_ns` ¶	Width of the active portion in nanoseconds. TYPE: `int`

RAISES	DESCRIPTION
`ValueError`	If `gpio_idx` is not `8` or `9`, or `active_time_ns` is outside `(5, 1_000_000_000)`.

set_gpio_trigger ¶

set_gpio_trigger(
    gpio_idx: int,
    min_duration_ns: int,
    max_duration_ns: int,
    low_pulse: bool = False,
    high_pulse: bool = False,
    mode: GpioWidthTriggerMode = TRIGGER_PULSE_WIDTH_IN_RANGE,
) -> None

Configure GPIO pulse-width triggering (fires gpio_trigger global events).

Supported only on GPIO indices 8 and 9. Both duration bounds must be greater than 5 ns and less than 1 second.

PARAMETER	DESCRIPTION
`gpio_idx` ¶	Pin index; must be `8` or `9`. TYPE: `int`
`min_duration_ns` ¶	Minimum pulse width for the condition (nanoseconds). TYPE: `int`
`max_duration_ns` ¶	Maximum pulse width for the condition (nanoseconds). TYPE: `int`
`low_pulse` ¶	Include low-going pulses when `True`. TYPE: `bool` DEFAULT: `False`
`high_pulse` ¶	Include high-going pulses when `True`. TYPE: `bool` DEFAULT: `False`
`mode` ¶	`TRIGGER_PULSE_WIDTH_IN_RANGE` or `TRIGGER_PULSE_WIDTH_OUT_OF_RANGE`. TYPE: `GpioWidthTriggerMode` DEFAULT: `TRIGGER_PULSE_WIDTH_IN_RANGE`

RAISES	DESCRIPTION
`ValueError`	If `gpio_idx` is invalid or durations are out of range.

get_gpio_trigger ¶

get_gpio_trigger(gpio_idx: int) -> GpioWidthTriggerConfig | None

Get GPIO pulse-width triggering configuration.

Supported only on GPIO indices 8 and 9.

PARAMETER	DESCRIPTION
`gpio_idx` ¶	Pin index; must be `8` or `9`. TYPE: `int`

RETURNS	DESCRIPTION
`GpioWidthTriggerConfig`	The configuration of the pin. Returns `None` if the pin is not configured. TYPE: `GpioWidthTriggerConfig \| None`

GPIO¶

公开导出¶

GpioState ¶

to_protobuf ¶

from_protobuf ¶

GpioWidthTriggerMode ¶

to_protobuf ¶

from_protobuf ¶

GpioPinState ¶

to_protobuf ¶

from_protobuf ¶

GpioWidthTriggerConfig ¶

to_protobuf ¶

from_protobuf ¶

PxGpioTriggerEvent ¶

from_protobuf ¶

Exerciser 方法¶

AqProtocolExerciser ¶

`session` ¶

`legacy` ¶

get_gpio_state ¶

`gpio_idx` ¶

set_gpio_state ¶

`gpio_idx` ¶

`state` ¶

send_gpio_pulse ¶

`gpio_idx` ¶

`active_state` ¶

`idle_state` ¶

`active_time_ns` ¶

set_gpio_trigger ¶

`gpio_idx` ¶

`min_duration_ns` ¶

`max_duration_ns` ¶

`low_pulse` ¶

`high_pulse` ¶

`mode` ¶

get_gpio_trigger ¶

`gpio_idx` ¶

GPIO¶

公开导出¶

GpioState ¶

to_protobuf ¶

from_protobuf ¶

GpioWidthTriggerMode ¶

to_protobuf ¶

from_protobuf ¶

GpioPinState ¶

to_protobuf ¶

from_protobuf ¶

GpioWidthTriggerConfig ¶

to_protobuf ¶

from_protobuf ¶

PxGpioTriggerEvent ¶

from_protobuf ¶

Exerciser 方法¶

AqProtocolExerciser ¶

session ¶

legacy ¶

get_gpio_state ¶

gpio_idx ¶

set_gpio_state ¶

gpio_idx ¶

state ¶

send_gpio_pulse ¶

gpio_idx ¶

active_state ¶

idle_state ¶

active_time_ns ¶

set_gpio_trigger ¶

gpio_idx ¶

min_duration_ns ¶

max_duration_ns ¶

low_pulse ¶

high_pulse ¶

mode ¶

get_gpio_trigger ¶

gpio_idx ¶

`session` ¶

`legacy` ¶

`gpio_idx` ¶

`gpio_idx` ¶

`state` ¶

`gpio_idx` ¶

`active_state` ¶

`idle_state` ¶

`active_time_ns` ¶

`gpio_idx` ¶

`min_duration_ns` ¶

`max_duration_ns` ¶

`low_pulse` ¶

`high_pulse` ¶

`mode` ¶

`gpio_idx` ¶