GPIO_CONNECT_IO_PINS_PARAMETERS-Struktur (gpioclx.h)

Artikel
02/29/2024

Die GPIO_CONNECT_IO_PINS_PARAMETERS-Struktur beschreibt eine logische Verbindung mit einer Reihe von GPIO-Pins (General Purpose E/O) und gibt an, ob diese Pins als Dateneingaben oder -ausgaben konfiguriert werden sollen.

Syntax

typedef struct _GPIO_CONNECT_IO_PINS_PARAMETERS {
  BANK_ID                    BankId;
  PPIN_NUMBER                PinNumberTable;
  USHORT                     PinCount;
  GPIO_CONNECT_IO_PINS_MODE  ConnectMode;
  UCHAR                      PullConfiguration;
  USHORT                     DebounceTimeout;
  USHORT                     DriveStrength;
  PVOID                      VendorData;
  ULONG                      VendorDataLength;
  GPIO_CONNECT_IO_PINS_FLAGS ConnectFlags;
} GPIO_CONNECT_IO_PINS_PARAMETERS, *PGPIO_CONNECT_IO_PINS_PARAMETERS;

Member

BankId

Der Bezeichner für die Bank, die die GPIO-Pins enthält. Wenn M die Anzahl der Banken im GPIO-Controller ist, ist Die BankId eine ganze Zahl im Bereich von 0 bis M–1. Die GPIO-Frameworkerweiterung (GpioClx) hat zuvor die Anzahl der Banken im Controller aus der CLIENT_QueryControllerBasicInformation Ereignisrückruffunktion abgerufen. Weitere Informationen finden Sie unter Hinweise in CLIENT_CONTROLLER_BASIC_INFORMATION.

PinNumberTable

Ein Zeiger auf ein Array von PIN_NUMBER Werten. Jedes Arrayelement gibt die Anzahl eines GPIO-Pins an, mit dem eine Verbindung hergestellt werden soll. Wenn N die Anzahl der Pins in dieser Bank ist, sind die Pins 0 bis N–1 nummeriert. Die Anzahl der Elemente in diesem Array wird vom PinCount-Element angegeben.

PinCount

Die Anzahl der Elemente im PinNumberTable-Array .

ConnectMode

Gibt an, ob die GPIO-Pins in der neuen Verbindung als Eingaben oder als Ausgaben konfiguriert werden sollen. Der Wert dieses Parameters ist ConnectModeInput für eine schreibgeschützte Verbindung, ConnectModeOutput für eine schreibgeschützte Verbindung und (ConnectModeInput | ConnectModeModeOutput) für eine Lese-/Schreibverbindung. Weitere Informationen finden Sie unter GPIO_CONNECT_IO_PINS_MODE.

PullConfiguration

Gibt an, ob der GPIO-Pin nach oben oder nach unten gezogen wird. Dieser Member ist in der Regel auf eine der folgenden systemdefinierte Konstanten festgelegt:

GPIO_PIN_PULL_CONFIGURATION_PULLDEFAULT
GPIO_PIN_PULL_CONFIGURATION_PULLUP
GPIO_PIN_PULL_CONFIGURATION_PULLDOWN
GPIO_PIN_PULL_CONFIGURATION_PULLNONE

Wenn keine dieser Konstanten die Pinkonfiguration angemessen beschreibt, kann dieser Member auf eine vom Hersteller definierte Konstante im Bereich 128-255 festgelegt werden. Weitere Informationen zu diesen Konstanten finden Sie unter GPIO_PIN_PULL_CONFIGURATION_XXX.

DebounceTimeout

Die Debouncezeit in Einheiten von 10 Mikrosekunden. Beispielsweise wird eine Debouncezeit von 5,84 Millisekunden als 584 angegeben. Wenn durch einen mechanischen Schalter ein Eingangssignal generiert wird, neigt der Metallkontakt im Schalter dazu, nach dem Ein- oder Ausschalten des Schalters für eine kurze Zeit zu springen. Die Debouncezeit ist die mindeste Zeit, in der der Pegel des Eingangssignals stabil bleiben muss, bevor das Signal als gültiger hoher oder niedriger Pegel interpretiert werden kann.

DriveStrength

Die Antriebsstärke des GPIO-Pins in Einheiten von 10 Mikroamperen. Beispielsweise wird eine Antriebsstärke von 1,21 Milliampere als 121 angegeben.

VendorData

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der herstellerspezifische Daten enthält, die von der ACPI-Firmware für die Hardwareplattform abgerufen wurden. Diese Daten werden aus dem Feld VendorData des GPIO-Ressourcendeskriptors kopiert, der die Daten-E/A-Verbindung zwischen dem Peripheriegerät und einer Reihe von GPIO-Pins auf dem GPIO-Controller beschreibt. Dieser Member ist optional und auf NULL festgelegt, wenn die Firmware keine herstellerspezifischen Daten für diese Verbindung liefert.

VendorDataLength

Die Größe des Datenpuffers in Bytes, auf die das VendorData-Element verweist. Wenn VendorData NULL ist, wird VendorDataLength auf 0 festgelegt.

ConnectFlags

Eine Gruppe von Flags, die die Konfiguration der GPIO-Pins steuern. Für dieses Element sind derzeit keine Flags definiert.

Hinweise

Der ClientParameters-Parameter auf die CLIENT_ConnectIoPins Ereignisrückrufroutine ist ein Zeiger auf eine GPIO_CONNECT_IO_PINS_PARAMETERS Struktur.