Tizen Native API  8.0

The GPIO API provides functions to control GPIO peripherals connected to the IoT device.

Required Header

#include <peripheral_io.h>

Overview

This GPIO API provides functions to control GPIO peripherals connected to the IoT device.

Realted Features

This API is related with the following feature:

It is recommended to use features in your application for reliability.

You can check if a IoT device supports the related features for this API
by using System Information, and control your application's actions accordingly.

To ensure your application is only running on the IoT device with specific features,
please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions

int peripheral_gpio_open (int gpio_pin, peripheral_gpio_h *gpio)
 Opens a GPIO pin.
int peripheral_gpio_close (peripheral_gpio_h gpio)
 Closes a GPIO pin.
int peripheral_gpio_set_direction (peripheral_gpio_h gpio, peripheral_gpio_direction_e direction)
 Sets the GPIO direction.
int peripheral_gpio_set_edge_mode (peripheral_gpio_h gpio, peripheral_gpio_edge_e edge)
 Sets the GPIO edge mode.
int peripheral_gpio_set_interrupted_cb (peripheral_gpio_h gpio, peripheral_gpio_interrupted_cb callback, void *user_data)
 Sets the GPIO interrupted callback to be invoked when the GPIO interrupt is triggered.
int peripheral_gpio_unset_interrupted_cb (peripheral_gpio_h gpio)
 Unsets the GPIO interrupted callback.
int peripheral_gpio_read (peripheral_gpio_h gpio, uint32_t *value)
 Gets the current value of the GPIO pin.
int peripheral_gpio_write (peripheral_gpio_h gpio, uint32_t value)
 Sets the value of the GPIO pin.

Typedefs

typedef struct _peripheral_gpio_s * peripheral_gpio_h
 The handle of a GPIO pin.
typedef void(* peripheral_gpio_interrupted_cb )(peripheral_gpio_h gpio, peripheral_error_e error, void *user_data)
 The GPIO interrupted callback called when the GPIO interrupt is triggered.

Typedef Documentation

typedef struct _peripheral_gpio_s* peripheral_gpio_h

The handle of a GPIO pin.

Since :
4.0
typedef void(* peripheral_gpio_interrupted_cb)(peripheral_gpio_h gpio, peripheral_error_e error, void *user_data)

The GPIO interrupted callback called when the GPIO interrupt is triggered.

Warning:
This is not for use by third-party applications.

The following errors can be received:
PERIPHERAL_ERROR_NONE Successful
PERIPHERAL_ERROR_NOT_SUPPORTED Not supported
PERIPHERAL_ERROR_PERMISSION_DENIED Permission denied
PERIPHERAL_ERROR_INVALID_PARAMETER Invalid parameter
PERIPHERAL_ERROR_IO_ERROR I/O operation failed
PERIPHERAL_ERROR_NO_DEVICE Device does not exist or is removed
PERIPHERAL_ERROR_TRY_AGAIN Try again
PERIPHERAL_ERROR_OUT_OF_MEMORY Memory allocation failed
PERIPHERAL_ERROR_RESOURCE_BUSY Device is in use
PERIPHERAL_ERROR_UNKNOWN Unknown internal error

Since :
4.0
Parameters:
[in]gpioThe GPIO handle
[in]errorThe GPIO error
[in]user_dataThe user data passed from the callback registration function
See also:
peripheral_gpio_set_interrupted_cb()

Enumeration Type Documentation

Enumeration of GPIO direction options.

Since :
4.0
Enumerator:
PERIPHERAL_GPIO_DIRECTION_IN 

Input Mode

PERIPHERAL_GPIO_DIRECTION_OUT_INITIALLY_HIGH 

Output mode with high value

PERIPHERAL_GPIO_DIRECTION_OUT_INITIALLY_LOW 

Output mode with low value

Enumeration of edge types for the GPIO interrupt.

Since :
4.0
Enumerator:
PERIPHERAL_GPIO_EDGE_NONE 

No interrupt on GPIO

PERIPHERAL_GPIO_EDGE_RISING 

Interrupt on rising only

PERIPHERAL_GPIO_EDGE_FALLING 

Interrupt on falling only

PERIPHERAL_GPIO_EDGE_BOTH 

Interrupt on rising & falling


Function Documentation

Closes a GPIO pin.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]gpioThe GPIO handle
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
Precondition:
peripheral_gpio_open()
int peripheral_gpio_open ( int  gpio_pin,
peripheral_gpio_h gpio 
)

Opens a GPIO pin.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
gpio should be released with peripheral_gpio_close()
Parameters:
[in]gpio_pinThe GPIO pin number
[out]gpioThe GPIO handle is created on success
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_OUT_OF_MEMORYMemory allocation failed
PERIPHERAL_ERROR_RESOURCE_BUSYDevice is in use
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
Postcondition:
peripheral_gpio_close()
int peripheral_gpio_read ( peripheral_gpio_h  gpio,
uint32_t *  value 
)

Gets the current value of the GPIO pin.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]gpioThe GPIO handle
[out]valueThe value to get
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_gpio_write()

Sets the GPIO direction.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
To set the direction to PERIPHERAL_GPIO_DIRECTION_OUT_INITIALLY_HIGH or PERIPHERAL_GPIO_DIRECTION_OUT_INITIALLY_LOW, the edge mode must be set to PERIPHERAL_GPIO_EDGE_NONE.
Parameters:
[in]gpioThe GPIO handle
[in]directionThe direction of the GPIO pin
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_gpio_direction_e
peripheral_gpio_set_edge_mode()

Sets the GPIO edge mode.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
To set the edge mode to PERIPHERAL_GPIO_EDGE_RISING, PERIPHERAL_GPIO_EDGE_FALLING, PERIPHERAL_GPIO_EDGE_BOTH, the data direction must be set to the PERIPHERAL_GPIO_DIRECTION_IN.
Parameters:
[in]gpioThe GPIO handle
[in]edgeThe edge mode of the GPIO pin
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_gpio_edge_e
peripheral_gpio_set_direction()

Sets the GPIO interrupted callback to be invoked when the GPIO interrupt is triggered.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
The interrupted callback is unset when called peripheral_gpio_unset_interrupted_cb() or callback receives an error value other than PERIPHERAL_ERROR_NONE.
Parameters:
[in]gpioThe GPIO handle
[in]callbackThe GPIO interrupted callback function to set
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
Postcondition:
peripheral_gpio_unset_interrupted_cb()
See also:
peripheral_gpio_set_edge_mode()

Unsets the GPIO interrupted callback.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Parameters:
[in]gpioThe GPIO handle
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
Precondition:
peripheral_gpio_set_interrupted_cb()
int peripheral_gpio_write ( peripheral_gpio_h  gpio,
uint32_t  value 
)

Sets the value of the GPIO pin.

Warning:
This is not for use by third-party applications.
Since :
4.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/peripheralio
Remarks:
To write binary data, the direction must be set to PERIPHERAL_GPIO_DIRECTION_OUT_INITIALLY_HIGH or PERIPHERAL_GPIO_DIRECTION_OUT_INITIALLY_LOW.
Parameters:
[in]gpioThe GPIO handle
[in]valueThe value to set (must be 0 or 1)
Returns:
0 on success, otherwise a negative error value
Return values:
PERIPHERAL_ERROR_NONESuccessful
PERIPHERAL_ERROR_NOT_SUPPORTEDNot supported
PERIPHERAL_ERROR_PERMISSION_DENIEDPermission denied
PERIPHERAL_ERROR_INVALID_PARAMETERInvalid parameter
PERIPHERAL_ERROR_IO_ERRORI/O operation failed
PERIPHERAL_ERROR_NO_DEVICEDevice does not exist or is removed
PERIPHERAL_ERROR_UNKNOWNUnknown internal error
See also:
peripheral_gpio_read()
peripheral_gpio_set_direction()