MSP432P401R TI Drivers 库函数学习笔记（四）GPIO

平台：Code Composer Studio 10.4.0

MSP432P401R SimpleLink™ 微控制器 LaunchPad™ 开发套件

(MSP-EXP432P401R)

API

GPIO API官方手册

头文件

#include

函数 (机翻)

void GPIO_clearInt (uint_least8_t index)

清除GPIO管脚中断标志

void GPIO_disableInt (uint_least8_t index)

禁用GPIO脚中断

void GPIO_enableInt (uint_least8_t index)

使能GPIO脚中断

void GPIO_getConfig (uint_least8_t index, GPIO_PinConfig *pinConfig)

获取gpio引脚的当前配置

void GPIO_init ()

初始化GPIO模块

uint_fast8_t GPIO_read (uint_least8_t index)

读取GPIO管脚的值

void GPIO_setCallback (uint_least8_t index, GPIO_CallbackFxn callback)

绑定回调函数到GPIO脚中断

int_fast16_t GPIO_setConfig (uint_least8_t index, GPIO_PinConfig pinConfig)

配置gpio管脚

void GPIO_toggle (uint_least8_t index)

切换GPIO的当前状态

void GPIO_write (uint_least8_t index, unsigned int value)

将该值写入GPIO管脚

宏

GPIO驱动程序api返回的通用状态代码

#define GPIO_STATUS_RESERVED   (-32)

//通用GPIO状态码保留偏移量

#define GPIO_STATUS_SUCCESS   (0)

//GPI_setConfig()返回成功的状态代码

#define GPIO_STATUS_ERROR   (-1)

//GPI_setConfig()返回的通用错误状态代码

GPIO_PinConfig输出引脚配置宏

#define GPIO_CFG_OUTPUT

引脚是输出引脚

#define GPIO_CFG_OUT_STD

引脚是是主动输出高/低

#define GPIO_CFG_OUT_OD_NOPULL

输出引脚是开漏模式

#define GPIO_CFG_OUT_OD_PU

输出引脚是开漏上拉

#define GPIO_CFG_OUT_OD_PD

输出引脚是开漏下拉

#define GPIO_CFG_OUT_STR_LOW

将输出引脚输出强度设置为低

#define GPIO_CFG_OUT_STR_MED

将输出引脚输出强度设置为中

#define GPIO_CFG_OUT_STR_HIGH

将输出引脚输出强度设置为高

#define GPIO_CFG_OUT_HIGH

设置引脚输出为1

#define GPIO_CFG_OUT_LOW

设置引脚输出为0

GPIO_PinConfig输入引脚配置宏

#define GPIO_CFG_INPUT

引脚是输入引脚 

#define GPIO_CFG_IN_NOPULL

输入引脚不内部上拉下拉

#define GPIO_CFG_IN_PU

输入引脚内部上拉

#define GPIO_CFG_IN_PD

输入引脚不内部下拉

GPIO_PinConfig中断配置宏

#define GPIO_CFG_IN_INT_NONE

没有中断

#define GPIO_CFG_IN_INT_FALLING

在下降沿触发中断

#define GPIO_CFG_IN_INT_RISING

在上升沿触发中断

#define GPIO_CFG_IN_INT_BOTH_EDGES

在上升沿和下降沿触发中断

#define GPIO_CFG_IN_INT_LOW

低电平触发中断

#define GPIO_CFG_IN_INT_HIGH

高电平触发中断

特殊的GPIO_PinConfig配置宏

#define GPIO_CFG_IN_INT_ONLY

//GPIO_PinConfig参数中以或运算通知GPIO_setConfig()只配置GPIO输入引脚的中断属性

#define GPIO_DO_NOT_CONFIG

//使用这个GPIO_PinConfig宏来通知GPIO_init()不要配置相应的pin

类型别名

typedef uint32_t GPIO_PinConfig

GPIO管脚配置参数

typedef void(* GPIO_CallbackFxn) (uint_least8_t index)

GPIO回调函数名

示例

// Import GPIO Driver definitions

#include

// Define names for GPIO pin indexes

#define BUTTON 0

#define LED    1

// One-time init of GPIO driver

GPIO_init();

// Read GPIO pin

unsigned int state = GPIO_read(BUTTON);

// Write to GPIO pin

GPIO_write(LED, state);

配置引脚示例

// Driver header file

#include

// TI Driver configuration

#include "ti_drivers_config.h"

#define LED    CONFIG_GPIO_LED0

#define BUTTON CONFIG_GPIO_BUTTON0

void main()

{

    // One-time init of GPIO driver

    GPIO_init();

    // Configure a button input pin

    GPIO_setConfig(BUTTON, GPIO_CFG_IN_PU | GPIO_CFG_IN_INT_FALLING);

    // Configure an LED output pin

    GPIO_setConfig(LED, GPIO_CFG_OUT_STD | GPIO_CFG_OUT_LOW);

}

配置外部中断示例

// Driver header file

#include

// TI Drivers Configuration

#include "ti_drivers_config.h"

// Board file

#include

// GPIO button call back function

void gpioButton0Fxn(uint_least8_t index);

main()

{

    // One-time Board initialization

    Board_init();

    // One-time init of GPIO driver

    GPIO_init();

    // Turn on user LED

    GPIO_write(CONFIG_GPIO_LED0, CONFIG_GPIO_LED_ON);

    // install Button callback

    GPIO_setCallback(CONFIG_GPIO_BUTTON0, gpioButton0Fxn);

    // Enable interrupts

    GPIO_enableInt(CONFIG_GPIO_BUTTON0);

}

//

//  ======== gpioButton0Fxn ========

//  Callback function for the GPIO interrupt on CONFIG_GPIO_BUTTON0

//

//  Note: index is the GPIO id for the button which is not used here

//

void gpioButton0Fxn(uint_least8_t index)

{

    // Toggle the LED

    GPIO_toggle(CONFIG_GPIO_LED0);

}

上机实战

配置引脚

继续在syscfg文件中配置引脚

build后会在

中生成对应的映射

并在GPIO_init()中自动地初始化，因此若是不需要动态修改引脚配置，调用GPIO_init()就行。

main.c

实现两个回调函数，并在mainThread中启用中断

/*

 *  ======== main_tirtos.c ========

 */

#include

/* POSIX Header files */

#include

/* RTOS header files */

#include BIOS.h>

/* Driver configuration */

#include

#include

#include "./inc/myTask.h"

/* Driver configuration */

#include "ti_drivers_config.h"

void S1_Callback_Function(void)

{

usleep(100000);

if(!GPIO_read(S1))

{

GPIO_toggle(LED1);

while(!GPIO_read(S1));

}

}

void S2_Callback_Function(void)

{

usleep(100000);

if(!GPIO_read(S2))

{

GPIO_toggle(LED2);

while(!GPIO_read(S2));

}

}

/*

 *  ======== main ========

 */

int main(void)

{

    /* Call driver init functions */

    Board_init();

    GPIO_init();

    My_Task_Init(mainThread, 1, 1024);

    BIOS_start();

    return (0);

}

/*

 *  ======== mainThread ========

 */

void *mainThread(void *arg0)

{

    GPIO_enableInt(S1);

    GPIO_enableInt(S2);

    while(1)

    {

    }

    return (NULL);

}

本次实验不需要建立其他任务

myTask.c

/*

 * myTask.c

 *

 *  Created on: 2021年8月2日

 *      Author: Royic

 */

#include

/* POSIX Header files */

#include

/* RTOS header files */

#include

/* Driver configuration */

#include "ti_drivers_config.h"

#include "./inc/myTask.h"

/* Driver Header files */

#include

// #include

// #include SPI.h>

// #include UART.h>

// #include

void My_Task_Init(void *(*startroutine)(void *), int priority, size_t stacksize)

{

    pthread_t           thread;

    pthread_attr_t      attrs;

    struct sched_param  priParam;

    int                 retc;

    /* Initialize the attributes structure with default values */

    pthread_attr_init(&attrs);

    /* Set priority, detach state, and stack size attributes */

    priParam.sched_priority = priority;

    retc = pthread_attr_setschedparam(&attrs, &priParam);

    retc |= pthread_attr_setdetachstate(&attrs, PTHREAD_CREATE_DETACHED);

    retc |= pthread_attr_setstacksize(&attrs, stacksize);

    if (retc != 0)

    {

        /* failed to set attributes */

        while (1)

        {

        }

    }

    retc = pthread_create(&thread, &attrs, startroutine, NULL);

    if (retc != 0)

    {

        /* pthread_create() failed */

        while (1)

        {

        }

    }

}

myTask.h

/*

 * myTask.h

 *

 *  Created on: 2021年8月2日

 *      Author: Royic

 */

#ifndef INC_MYTASK_H_

#define INC_MYTASK_H_

/* For usleep() */

#include

#include

#include

void *mainThread(void *arg0);

void My_Task_Init(void *(*startroutine)(void *), int priority, size_t stacksize);

#endif /* INC_MYTASK_H_ */

实验结果

按下S1 LED1反转，按下S2 LED2反转