GPIO

更新时间：2019-04-19 17:19:07

接口列表

接口详情

int32_t hal_gpio_init(gpio_dev_t *gpio)

int32_t hal_gpio_output_high(gpio_dev_t *gpio)

int32_t hal_gpio_output_low(gpio_dev_t *gpio)

int32_t hal_gpio_output_toggle(gpio_dev_t *gpio)

int32_t hal_gpio_input_get(gpio_dev_t gpio, uint32_t value)

int32_t hal_gpio_enable_irq(gpio_dev_t *gpio, gpio_irq_trigger_t trigger, gpio_irq_handler_t handler, void *arg)

int32_t hal_gpio_disable_irq(gpio_dev_t *gpio)

int32_t hal_gpio_clear_irq(gpio_dev_t *gpio)

int32_t hal_gpio_finalize(gpio_dev_t *gpio)

相关结数据结构

gpio_dev_t

typedef struct {
    uint8_t       port;    /* gpio逻辑端口号 */
    gpio_config_t config;  /* gpio配置信息 */
    void         *priv;    /* 私有数据 */
} gpio_dev_t;

gpio_config_t

typedef enum {
    ANALOG_MODE,               /* 管脚用作功能引脚，如用于pwm输出，uart的输入引脚 */
    IRQ_MODE,                  /* 中断模式，配置为中断源 */
    INPUT_PULL_UP,             /* 输入模式，内部包含一个上拉电阻 */
    INPUT_PULL_DOWN,           /* 输入模式，内部包含一个下拉电阻 */
    INPUT_HIGH_IMPEDANCE,      /* 输入模式，内部为高阻模式 */
    OUTPUT_PUSH_PULL,          /* 输出模式，普通模式 */
    OUTPUT_OPEN_DRAIN_NO_PULL, /* 输出模式，输出高电平时，内部为高阻状态 */
    OUTPUT_OPEN_DRAIN_PULL_UP, /* 输出模式，输出高电平时，被内部电阻拉高 */
} gpio_config_t;

gpio_irq_trigger_t

typedef enum {
    IRQ_TRIGGER_RISING_EDGE  = 0x1, /* 上升沿触发 */
    IRQ_TRIGGER_FALLING_EDGE = 0x2, /* 下降沿触发 */
    IRQ_TRIGGER_BOTH_EDGES   = IRQ_TRIGGER_RISING_EDGE | IRQ_TRIGGER_FALLING_EDGE,                                    /* 上升沿下降沿均触发 */
} gpio_irq_trigger_t;

gpio_irq_handler_t

typedef void (*gpio_irq_handler_t)(void *arg);

使用示例

GPIO作为输出

#include <aos/hal/gpio.h>

#define GPIO_LED_IO 18

/* define dev */
gpio_dev_t led;

int application_start(int argc, char *argv[])
{
    int ret = -1;

    /* gpio port config */
    led.port = GPIO_LED_IO;

    /* set as output mode */
    led.config = OUTPUT_PUSH_PULL;

    /* configure GPIO with the given settings */
    ret = hal_gpio_init(&led);
    if (ret != 0) {
        printf("gpio init error !\n");
    }

    /* output high */
    hal_gpio_output_high(&led);

    /* output low */
    hal_gpio_output_low(&led);

    /* toggle the LED every 1s */
    while(1) {

        /* toggle output */
        hal_gpio_output_toggle(&led);

        /* sleep 1000ms */
        aos_msleep(1000);
    };
}

注：port为逻辑端口号，其与物理端口号的对应关系见具体的对接实现

GPIO作为中断输入

#include <aos/hal/gpio.h>

#define GPIO_BUTTON_IO 5

/* define dev */
gpio_dev_t button1;

/* pressed flag */
int button1_pressed = 0;

void button1_handler(void *arg)
{
    button1_pressed = 1;
}

int application_start(int argc, char *argv[])
{
    int ret = -1;

    /* input pin config */
    button1.port = GPIO_BUTTON_IO;

    /* set as interrupt mode */
    button1.config = IRQ_MODE;

    /* configure GPIO with the given settings */
    ret = hal_gpio_init(&button1);
    if (ret != 0) {
        printf("gpio init error !\n");
    }

    /* gpio interrupt config */
    ret = hal_gpio_enable_irq(&button1, IRQ_TRIGGER_BOTH_EDGES, 
                              button1_handler, NULL);
    if (ret != 0) {
        printf("gpio irq enable error !\n");
    }

    /* if button is pressed, print "button 1 is pressed !" */
    while(1) {
        if (button1_pressed == 1) {
            button1_pressed = 0;
            printf("button 1 is pressed !\n");
        }

        /* sleep 100ms */
        aos_msleep(100);
    };
}

当button被按下后，串口会打印"button 1 is pressed !"

移植说明

  新建hal_gpio_xxmcu.c和hal_gpio_xxmcu.h的文件，并将这两个文件放到platform/mcu/xxmcu/hal目录下。在hal_gpio_xxmcu.c中实现所需要的hal函数，hal_gpio_xxmcu.h中放置相关宏定义。<br />      参考platform/mcu/stm32l4xx/src/STM32L496G-Discovery/hal/hal_gpio_stm32l4.c