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.