riot-ci/RIOT
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Merge pull request #5711 from gebart/pr/gpio-doxygen

Browse Source 
periph/gpio: Clean up Doxygen text
This commit is contained in:
kYc0o 2016-07-31 13:07:29 +02:00 committed by GitHub
commit 355e6b19b5
1 changed files with 23 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
drivers/include/periph/gpio.h
View File

@ -64,27 +64,28 @@
extern "C" {
#endif
/**
* @brief Default GPIO macro maps port-pin tuples to the pin value
*/
#ifndef GPIO_PIN
#define GPIO_PIN(x,y) ((x & 0) | y)
#endif
/**
* @brief Define global value for GPIO not defined
*/
#ifndef GPIO_UNDEF
#define GPIO_UNDEF (UINT_MAX)
#endif
/**
* @brief Define the default GPIO type identifier
*/
#ifndef HAVE_GPIO_T
/**
* @brief GPIO type identifier
*/
typedef unsigned int gpio_t;
#endif
#ifndef GPIO_PIN
/**
* @brief Convert (port, pin) tuple to @c gpio_t value
*/
/* Default GPIO macro maps port-pin tuples to the pin value */
#define GPIO_PIN(x,y) ((gpio_t)((x & 0) | y))
#endif
#ifndef GPIO_UNDEF
/**
* @brief GPIO pin not defined
*/
#define GPIO_UNDEF ((gpio_t)(UINT_MAX))
#endif
/**
* @brief Available pin modes
*
@ -140,8 +141,7 @@ typedef struct {
* @brief Initialize the given pin as general purpose input or output
*
* @param[in] pin pin to initialize
* @param[in] dir direction for the pin, input or output
* @param[in] pullup define what pull resistors should be used
* @param[in] mode mode of the pin, see @c gpio_mode_t
*
* @return 0 on success
* @return -1 on error
@ -157,7 +157,7 @@ int gpio_init(gpio_t pin, gpio_mode_t mode);
* The interrupt is activated automatically after the initialization.
*
* @param[in] pin pin to initialize
* @param[in] pullup define what pull resistors should be enabled
* @param[in] mode mode of the pin, see @c gpio_mode_t
* @param[in] flank define the active flank(s)
* @param[in] cb callback that is called from interrupt context
* @param[in] arg optional argument passed to the callback
@ -169,14 +169,14 @@ int gpio_init_int(gpio_t pin, gpio_mode_t mode, gpio_flank_t flank,
gpio_cb_t cb, void *arg);
/**
* @brief Enable pin's interrupt if configured as interrupt source
* @brief Enable pin interrupt if configured as interrupt source
*
* @param[in] pin the pin to enable the interrupt for
*/
void gpio_irq_enable(gpio_t pin);
/**
* @brief Disable the pin's interrupt if configured as interrupt source
* @brief Disable the pin interrupt if configured as interrupt source
*
* @param[in] pin the pin to disable the interrupt for
*/
@ -186,10 +186,9 @@ void gpio_irq_disable(gpio_t pin);
* @brief Get the current value of the given pin
*
* @param[in] pin the pin to read
* @return the current value, 0 for LOW, != 0 for HIGH
*
* @return 0 when pin is LOW
* @return greater 0 for HIGH
* @return >0 for HIGH
*/
int gpio_read(gpio_t pin);