GPIO (General Purpose Input Output)通用输入输出接口

要保证引脚功能可以正常使用,在配置IO之前必须将对应IO口的电源打开,使用

bool PM_PowerEnable(Power_Type_t powerType, bool isOn)
```c
函数来打开对应的IO口电源,不同IO口对应的电源如下:
```c
typedef enum{
    POWER_TYPE_VPAD = 0,            // GPIO0  ~ GPIO7  and GPIO25 ~ GPIO36    2.8V   //always on
    POWER_TYPE_MMC,                 // GPIO8  ~ GPIO13                        1.9V
    POWER_TYPE_LCD,                 // GPIO14 ~ GPIO18                        1.9V
    POWER_TYPE_CAM,                 // GPIO19 ~ GPIO24                        1.9V
    POWER_TYPE_MAX
}Power_Type_t;

比如:

  • 需要使用GPIO5,则需要调用PM_PowerEnable(POWER_TYPE_VPAD,true);
  • 需要调用I2C2,因为I2C2是复用IO19和20,所以调用PM_PowerEnable(POWER_TYPE_CAM,true);

模组引脚除了通用IO功能外,部分引脚还有复用功能,具体见开发板中的引脚图

例示代码请参考CSDK demo/gpio


1. 枚举类型

1.1. GPIO_PIN

引脚

typedef enum{
    GPIO_PIN0 = 0, //IO 可中断
    GPIO_PIN1,     //IO 可中断
    GPIO_PIN2,     //IO 可中断
    GPIO_PIN3,     //IO 可中断
    GPIO_PIN4,     //IO 可中断
    GPIO_PIN5,     //IO 可中断
    GPIO_PIN6,     //IO 可中断
    GPIO_PIN7,     //IO 可中断
    GPIO_PIN8,
    GPIO_PIN9,
    GPIO_PIN10,
    GPIO_PIN11,
    GPIO_PIN12,
    GPIO_PIN13,
    GPIO_PIN14,
    GPIO_PIN15,
    GPIO_PIN16,
    GPIO_PIN17,
    GPIO_PIN18,
    GPIO_PIN19,
    GPIO_PIN20,
    GPIO_PIN21,
    GPIO_PIN22,
    GPIO_PIN23,
    GPIO_PIN24,
    GPIO_PIN25,
    GPIO_PIN26,
    GPIO_PIN27,
    GPIO_PIN28,
    GPIO_PIN29,
    GPIO_PIN30,
    GPIO_PIN31,
    GPIO_PIN32,
    GPIO_PIN33,
    GPIO_PIN34,
    GPIO_PIN_MAX
}GPIO_PIN;

1.2. GPIO_MODE

IO模式

typedef enum{
    GPIO_MODE_OUTPUT = 0,   // 输出模式
    GPIO_MODE_INPUT,        // 输入模式
    GPIO_MODE_INPUT_INT,    // 中断模式
    GPIO_MODE_MAX
}GPIO_MODE;

1.3. GPIO_LEVEL

高低电平

typedef enum{
    GPIO_LEVEL_LOW  = 0,  //低电平
    GPIO_LEVEL_HIGH = 1   //高电平
}GPIO_LEVEL;

1.4. GPIO_INT_TYPE

中断类型

typedef enum {
    GPIO_INT_TYPE_HIGH_LEVEL = 0,      //高电平中断
    GPIO_INT_TYPE_LOW_LEVEL,           //低电平中断
    GPIO_INT_TYPE_RISING_EDGE,         //上升沿中断
    GPIO_INT_TYPE_FALLING_EDGE,        //下降沿中断
    GPIO_INT_TYPE_RISING_FALLING_EDGE, //上升沿和下降沿中断
    GPIO_INT_TYPE_MAX
}GPIO_INT_TYPE;

2. 结构体类型

2.1. GPIO_INT_callback_param_t

中断回调函数参数类型

typedef struct{
    GPIO_PIN pin;
}GPIO_INT_callback_param_t;

2.2. PCallbackINT

中断回调函数类型

typedef void (*PCallbackINT)(GPIO_INT_callback_param_t* param);

2.3. GPIO_INT_config_t

中断配置选项

typedef struct{
    uint16_t        debounce; //去抖时间(ms)
    GPIO_INT_TYPE   type    ;
    PCallbackINT    callback;
}GPIO_INT_config_t;

2.4. GPIO_config_t

GPIO配置选项

typedef struct{
    GPIO_PIN          pin         ;  //引脚
    GPIO_MODE         mode        ;  //模式
    GPIO_LEVEL        defaultLevel;  //默认电平
    GPIO_INT_config_t intConfig   ;  //中断配置(中断模式需要配置)
}GPIO_config_t;

3. 功能函数接口

3.1. GPIO_Init

bool GPIO_Init(GPIO_config_t config);
功能

初始化IO

参数
  • config:初始化配置
返回值
  • bool:配置成功/失败

3.2. GPIO_GetConfig

void GPIO_GetConfig(GPIO_PIN pin,GPIO_config_t* config);
功能

获取GPIO配置

参数
  • config:GPIO配置变量地址
返回值

3.3. GPIO_SetLevel

bool GPIO_SetLevel(GPIO_config_t gpioConf, GPIO_LEVEL  level);
功能

设置GPIO电平

参数
  • gpioConf:GPIO初始化配置变量
  • level:电平高低
返回值
  • bool:是否设置成功

3.4. GPIO_Set

bool GPIO_Set(GPIO_PIN pin, GPIO_LEVEL  level);
功能

设置GPIO电平,与GPIO_SetLevel功能一样,只是参数不一样

参数
  • pin:GPIO口
  • level:电平高低
返回值
  • bool:是否设置成功

3.5. GPIO_GetLevel

bool GPIO_GetLevel(GPIO_config_t gpioConf, GPIO_LEVEL* level);
功能

获取GPIO电平

参数
  • gpioConf:GPIO初始化配置变量
  • level:电平高低结果返回值,变量指针
返回值
  • bool:是否获取成功

3.6. GPIO_Get

bool GPIO_Get(GPIO_PIN pin, GPIO_LEVEL* level);
功能

获取GPIO电平,功能与GPIO_GetLevel一样,只是参数不同

参数
  • pin:GPIO口
  • level:电平高低结果返回值,变量指针
返回值
  • bool:是否获取成功

3.7. GPIO_Close

bool GPIO_Close(GPIO_PIN pin);
功能

关闭GPIO口,复位GPIO到默认状态

参数
  • pin:GPIO口
返回值
  • bool:是否成功

results matching ""

    No results matching ""