estructura GPIO_CONNECT_IO_PINS_PARAMETERS (gpioclx.h)

Artículo
08/07/2023

La estructura de GPIO_CONNECT_IO_PINS_PARAMETERS describe una conexión lógica a un conjunto de patillas de E/S de uso general (GPIO) y especifica si se deben configurar estas patillas como entradas o salidas de datos.

Sintaxis

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;

Miembros

BankId

Identificador del banco que contiene los patillas GPIO. Si M es el número de bancos en el controlador GPIO, BankId es un entero en el intervalo de 0 a M-1. La extensión del marco gpIO (GpioClx) obtuvo previamente el número de bancos en el controlador de la función de devolución de llamada de eventos CLIENT_QueryControllerBasicInformation . Para obtener más información, vea Comentarios en CLIENT_CONTROLLER_BASIC_INFORMATION.

PinNumberTable

Puntero a una matriz de valores de PIN_NUMBER. Cada elemento de matriz especifica el número de una patilla GPIO a la que conectarse. Si N es el número de patillas de este banco, las patillas se numeran de 0 a N-1. El miembro PinCount especifica el número de elementos de esta matriz.

PinCount

Número de elementos de la matriz PinNumberTable .

ConnectMode

Si los patillas GPIO de la nueva conexión deben configurarse como entradas o como salidas. El valor de este parámetro es ConnectModeInput para una conexión de solo lectura, ConnectModeOutput para una conexión de solo escritura y (ConnectModeInput | ConnectModeOutput) para una conexión de lectura y escritura. Para obtener más información, consulte GPIO_CONNECT_IO_PINS_MODE.

PullConfiguration

Si el pin GPIO se extrae o se extrae hacia abajo. Este miembro se establece normalmente en una de las siguientes constantes definidas por el sistema:

GPIO_PIN_PULL_CONFIGURATION_PULLDEFAULT
GPIO_PIN_PULL_CONFIGURATION_PULLUP
GPIO_PIN_PULL_CONFIGURATION_PULLDOWN
GPIO_PIN_PULL_CONFIGURATION_PULLNONE

Si ninguna de estas constantes describe adecuadamente la configuración del pin, este miembro se puede establecer en una constante definida por el proveedor en el intervalo 128-255. Para obtener más información sobre estas constantes, consulte GPIO_PIN_PULL_CONFIGURATION_XXX.

DebounceTimeout

Tiempo de desbounce en unidades de 10 microsegundos. Por ejemplo, se especifica una hora de desbounce de 5,84 milisegundos como 584. Si un interruptor mecánico genera una señal de entrada, el contacto metálico en el interruptor tiende a rebotar durante un breve tiempo después de activar o desactivar el interruptor. El tiempo de espera es el tiempo mínimo que el nivel de la señal de entrada debe permanecer estable antes de que la señal se pueda interpretar como un nivel alto o bajo válido.

DriveStrength

Resistencia de la unidad del pin GPIO en unidades de 10 microamperes. Por ejemplo, se especifica un nivel de unidad de 1,21 miliamperes como 121.

VendorData

Puntero a un búfer asignado por el autor de la llamada que contiene datos específicos del proveedor obtenidos del firmware ACPI para la plataforma de hardware. Estos datos se copian del campo VendorData del descriptor de recursos GPIO que describe la conexión de E/S de datos entre el dispositivo periférico y un conjunto de patillas GPIO en el controlador GPIO. Este miembro es opcional y se establece en NULL si el firmware no proporciona datos específicos del proveedor para esta conexión.

VendorDataLength

Tamaño, en bytes, del búfer de datos al que apunta el miembro VendorData . Si VendorData es NULL, VendorDataLength se establece en cero.

ConnectFlags

Conjunto de marcas que controlan la configuración de los patillas GPIO. No hay marcas definidas actualmente para este miembro.

Comentarios

El parámetro ClientParameters de la rutina de devolución de llamada de evento CLIENT_ConnectIoPins es un puntero a una estructura de GPIO_CONNECT_IO_PINS_PARAMETERS .