Funzione UART_OpenUART_Open Function

Intestazione: #include <applibs/uart.h>Header: #include <applibs/uart.h>

Apre e configura un UART e restituisce un descrittore di file da utilizzare per le chiamate successive.Opens and configures a UART, and returns a file descriptor to use for subsequent calls.

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

ParametriParameters

  • uartId ID dell’UART da aprire.uartId The ID of the UART to open.

  • uartConfig Un puntatore a uno struct UART_Config che definisce la configurazione di UART.uartConfig A pointer to a UART_Config struct that defines the configuration of the UART. Chiamare UART_InitConfig per ottenere un UART_Config con le impostazioni predefinite.Call UART_InitConfig to get a UART_Config with default settings.

ErrorsErrors

Restituisce-1 se viene rilevato un errore e imposta sul errno valore di errore.Returns -1 if an error is encountered and sets errno to the error value.

  • EACCES: l'accesso a UART_Id non è consentito perché uartId non figura nel campo Uart del manifesto dell'applicazione.EACCES: access to UART_Id is not permitted as the uartId is not listed in the Uart field of the application manifest.

  • ENODEV: uartId non è valido.ENODEV: the uartId is invalid.

  • EINVAL: uartConfig rappresenta una configurazione non valida.EINVAL: the uartConfig represents an invalid configuration.

  • EBUSY: uartId è già aperto.EBUSY: the uartId is already open.

  • EFAULT: il valore di uartConfig è NULL.EFAULT: the uartConfig is NULL.

errnoÈ possibile specificare anche qualsiasi altro tipo di errore. tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified; such errors aren't deterministic and the same behavior might not be retained through system updates.

Valore restituitoReturn value

Restituisce il descrittore del file UART se è stato aperto correttamente oppure-1 per l'errore, nel qual caso errno viene impostato sul valore di errore.Returns the file descriptor of the UART if it was opened successfully, or -1 for failure, in which case errno is set to the error value.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

Per accedere ai singoli UART, l'applicazione deve identificarli nel campo Uart del manifesto dell'applicazione.To access individual UARTs, your application must identify them in the Uart field of the application manifest.