Partilhar via


Função GPIO_OpenAsOutput

Cabeçalho: #include <applibs/gpio.h>

Abre um GPIO (Fins Gerais Entrada/Saída) como uma saída.

Um GPIO de saída pode ser configurado como push-pull, drenagem aberta ou open source. Chame GPIO_SetValue num GPIO de saída aberto para definir o valor de saída. Também pode chamar GPIO_GetValue num GPIO de saída aberto para ler o valor atual (por exemplo, quando o GPIO de saída está configurado como GPIO_OutputMode_OpenDrain ou GPIO_OutputMode_OpenSource).

As funções GPIO são seguras para threads entre chamadas para diferentes GPIOs; no entanto, é da responsabilidade do autor da chamada garantir a segurança dos threads para acessos ao mesmo GPIO.

int GPIO_OpenAsOutput(GPIO_Id gpioId, GPIO_OutputMode_Type outputMode, GPIO_Value_Type initialValue);

Parâmetros

  • gpioId Uma GPIO_Id que identifica o GPIO.

  • outputMode O modo de saída do GPIO. Uma saída pode ser configurada como push-pull, drenagem aberta ou open source.

  • initialValue A GPIO_Value inicial do GPIO - GPIO_Value_High ou GPIO_Value_Low.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: o acesso a gpioId não é permitido, uma vez que o GPIO não está listado no campo Gpio do manifesto da aplicação.

  • EBUSY: o gpioId já está aberto.

  • ENODEV: o gpioId é inválido.

  • EINVAL: o outputMode não é um GPIO_OutputMode válido ou o initialValue não é um GPIO_Value válido.

Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

Devolve um descritor de ficheiros para o GPIO aberto com êxito ou -1 para falha, caso errno em que será definido como o valor de erro.

Requisitos do manifesto de aplicação

Para aceder a GPIOs individuais, a sua aplicação tem de identificá-los no campo Gpio do manifesto da aplicação.