Funzione GPIO_OpenAsOutputGPIO_OpenAsOutput Function

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

Consente di aprire l'interfaccia GPIO (General Purpose Input/Output, input/output per utilizzo generico) come output.Opens a GPIO (General Purpose Input/Output) as an output.

Un GPIO di output può essere configurato come push pull, open drain oppure open source.An output GPIO may be configured as push-pull, open drain, or open source. Effettuare la chiamata GPIO_SetValue su un GPIO di output aperto, per impostare il valore di output.Call GPIO_SetValue on an open output GPIO to set the output value. È inoltre possibile effettuare la chiamata GPIO_GetValue su un GPIO di output aperto, per leggere il valore corrente (ad esempio, quando il GPIO di output è configurato come GPIO_OutputMode_OpenDrain o GPIO_OutputMode_OpenSource).You can also call GPIO_GetValue on an open output GPIO to read the current value (for example, when the output GPIO is configured as GPIO_OutputMode_OpenDrain or GPIO_OutputMode_OpenSource).

Le funzioni GPIO sono thread-safe tra le chiamate a diversi GPIO; tuttavia, è responsabilità del chiamante garantire la thread safety per gli accessi allo stesso GPIO.GPIO functions are thread-safe between calls to different GPIOs; however, it is the caller’s responsibility to ensure thread safety for accesses to the same GPIO.

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

ParametriParameters

  • gpioId Un GPIO_Id che identifica l'interfaccia GPIO.gpioId A GPIO_Id that identifies the GPIO.

  • outputMode La modalità di output dell'interfaccia GPIO.outputMode The output mode of the GPIO. Un output può essere configurato come push pull, open drain oppure open source.An output may be configured as push-pull, open drain, or open source.

  • initialValue L'iniziale GPIO_Value per l'interfaccia GPIO - GPIO_Value_High o GPIO_Value_Low.initialValue The initial GPIO_Value for the GPIO - GPIO_Value_High or GPIO_Value_Low.

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 gpioId non è consentito perché GPIO non figura nel campo Gpio del manifesto dell'applicazione.EACCES: access to gpioId is not permitted as the GPIO is not listed in the Gpio field of the application manifest.

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

  • EINVAL: gpioId non è valido.ENODEV: the gpioId is invalid.

  • EINVAL: outputMode non è un valore GPIO_OutputMode valido oppure initialValue non è un valore GPIO_Value valido.EINVAL: the outputMode is not a valid GPIO_OutputMode or the initialValue is not a valid GPIO_Value.

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 un descrittore di file per il GPIO aperto in caso di esito positivo o-1 per l'errore, nel qual caso errno verrà impostato sul valore di errore.Returns a file descriptor for the opened GPIO on success, or -1 for failure, in which case errno will be set to the error value.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

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