Condividi tramite

Funzione UART_Open

  • Articolo

Intestazione: #include <applicazioni/uart.h>

Apre e configura un oggetto UART e restituisce un descrittore di file da usare per le chiamate successive.

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

Parametri

  • uartId ID dell'oggetto UART da aprire.

  • uartConfig Puntatore a una struttura UART_Config che definisce la configurazione dell'oggetto UART. Chiama UART_InitConfig per ottenere un UART_Config con le impostazioni predefinite.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: l'accesso a UART_Id non è consentito perché uartId non è elencato nel campo Uart del manifesto dell'applicazione.

  • ENODEV: il uartId valore non è valido.

  • EINVAL: uartConfig rappresenta una configurazione non valida.

  • EBUSY: il uartId è già aperto.

  • EFAULT: è uartConfig NULL.

Potrebbero anche essere specificati altri errno errori. Tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce il descrittore di file UART se è stato aperto correttamente, o -1 per errore, nel qual caso errno è impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

Per accedere ai singoli UARTs, l'applicazione deve identificarli nel campo Uart del manifesto dell'applicazione.