Partilhar via


Função UART_Open

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

Abre e configura um UART e devolve um descritor de ficheiros para utilizar para chamadas subsequentes.

int UART_Open(UART_Id uartId, const UART_Config * uartConfig);

Parâmetros

  • uartId O ID do UART a abrir.

  • uartConfig Um ponteiro para uma estrutura UART_Config que define a configuração do UART. Chame UART_InitConfig para obter uma UART_Config com as predefinições.

Erros

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

  • EACCES: o acesso ao UART_Id não é permitido, uma vez que o uartId não está listado no campo Uart do manifesto da aplicação.

  • ENODEV: o uartId é inválido.

  • EINVAL: representa uartConfig uma configuração inválida.

  • EBUSY: o uartId já está aberto.

  • EFAULT: o uartConfig é NULO.

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 o descritor de ficheiros do UART se tiver sido aberto com êxito ou -1 para a falha, caso errno em que está definido como o valor de erro.

Requisitos do manifesto de aplicação

Para aceder a UARTs individuais, a sua aplicação tem de identificá-las no campo Uart do manifesto da aplicação.