UART_Open-Funktion

  • Artikel

Header: #include <applibs/uart.h>

Öffnet und konfiguriert einen UART und gibt einen Dateideskriptor zurück, der für nachfolgende Aufrufe verwendet werden soll.

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

Parameter

  • uartId Die ID des zu öffnenden UART.

  • uartConfig Ein Zeiger auf eine UART_Config Struktur, die die Konfiguration des UART definiert. Rufen Sie UART_InitConfig auf, um eine UART_Config mit Standardeinstellungen zu erhalten.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Der Zugriff auf UART_Id ist nicht zulässig, da nicht uartId im Uart-Feld des Anwendungsmanifests aufgeführt ist.

  • ENODEV: die uartId ist ungültig.

  • EINVAL: stellt uartConfig eine ungültige Konfiguration dar.

  • EBUSY: die uartId ist bereits geöffnet.

  • EFAULT: ist uartConfig NULL.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt den Dateideskriptor des UART zurück, wenn er erfolgreich geöffnet wurde, oder -1 bei Einem Fehler. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Für den Zugriff auf einzelne UARTs muss Ihre Anwendung diese im Uart-Feld des Anwendungsmanifests identifizieren.