GPIO_OpenAsOutput-Funktion

  • Artikel

Header: #include <applibs/gpio.h>

Öffnet eine GPIO (Universell Input/Output) als Ausgabe.

Eine Ausgabe-GPIO kann als Push-Pull,open drain oder Open Source konfiguriert werden. Rufen Sie GPIO_SetValue für eine geöffnete Ausgabe-GPIO auf, um den Ausgabewert festzulegen. Sie können auch GPIO_GetValue für eine geöffnete Ausgabe-GPIO aufrufen, um den aktuellen Wert zu lesen (z. B. wenn die Ausgabe-GPIO als GPIO_OutputMode_OpenDrain oder GPIO_OutputMode_OpenSource konfiguriert ist).

GPIO-Funktionen sind threadsicher zwischen Aufrufen verschiedener GPIOs. Es liegt jedoch in der Verantwortung des Aufrufers, die Threadsicherheit für den Zugriff auf dieselbe GPIO zu gewährleisten.

int GPIO_OpenAsOutput(GPIO_Id gpioId, GPIO_OutputMode_Type outputMode, GPIO_Value_Type initialValue);

Parameter

  • gpioId Ein GPIO_Id , der die GPIO identifiziert.

  • outputMode Der Ausgabemodus der GPIO. Eine Ausgabe kann als Push-Pull, open drain oder Open Source konfiguriert werden.

  • initialValue Die anfängliche GPIO_Value für die GPIO – GPIO_Value_High oder GPIO_Value_Low.

Fehler

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

  • EACCES: Der Zugriff auf gpioId ist nicht zulässig, da die GPIO nicht im Gpio-Feld des Anwendungsmanifests aufgeführt ist.

  • EBUSY: die gpioId ist bereits geöffnet.

  • ENODEV: die gpioId ist ungültig.

  • EINVAL: ist outputMode kein gültiger GPIO_OutputMode oder kein initialValue gültiger GPIO_Value.

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 bei Erfolg einen Dateideskriptor für die geöffnete GPIO oder -1 bei Einem Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Um auf einzelne GPIOs zuzugreifen, muss Ihre Anwendung diese im Gpio-Feld des Anwendungsmanifests identifizieren.