本文主要是介绍RK3568驱动指南｜第十二篇 GPIO子系统-第133章 GPIO操作函数实验，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
瑞芯微RK3568芯片是一款定位中高端的通用型SOC，采用22nm制程工艺，搭载一颗四核Cortex-A55处理器和Mali G52 2EE 图形处理器。RK3568 支持4K 解码和 1080P 编码，支持SATA/PCIE/USB3.0 外围接口。RK3568内置独立NPU，可用于轻量级人工智能应用。RK3568 支持安卓 11 和 linux 系统，主要面向物联网网关、NVR 存储、工控平板、工业检测、工控盒、卡拉 OK、云终端、车载中控等行业。
【公众号】迅为电子
【粉丝群】824412014（加群获取驱动文档+例程）
【视频观看】嵌入式学习之Linux驱动（第十二篇 GPIO子系统_全新升级）_基于RK3568
【购买链接】迅为RK3568开发板瑞芯微Linux安卓鸿蒙ARM核心板人工智能AI主板
第133章 GPIO操作函数实验
从本章节将对新gpio子系统中操作GPIO的相关api接口函数进行讲解。
133.1 函数介绍
1获取 GPIO 的方向函数：
（1）函数原型：
int gpiod_get_direction(struct gpio_desc *desc);
（2）头文件：
#include <linux/gpio/consumer.h>
（3）参数：
desc：指向GPIO描述符的指针。
（4）函数功能：
gpiod_get_direction函数用于获取GPIO的方向，即判断GPIO是输入还是输出。
（5）返回值：
返回值为整型，表示GPIO的方向。如果成功获取到GPIO方向，返回值为GPIO_LINE_DIRECTION_IN（0）表示输入，或GPIO_LINE_DIRECTION_OUT（1）表示输出。如果获取失败，返回值为负数，表示错误码。
该函数的作用是获取给定GPIO描述符所代表的GPIO的方向。通过该函数，可以确定GPIO 是配置为输入还是输出。返回值可以用于进一步判断和处理GPIO的方向相关逻辑。
2配置 GPIO 的方向函数：
（1）函数原型：
int gpiod_direction_input(struct gpio_desc *desc);
int gpiod_direction_output(struct gpio_desc *desc, int value);
（2）头文件：
#include <linux/gpio/consumer.h>
（3）参数：
desc：指向GPIO描述符的指针。
value（仅适用于 gpiod_direction_output）：初始输出值，可以是0或1。
（4）函数功能：
gpiod_direction_input 函数用于配置GPIO的方向为输入。
gpiod_direction_output 函数用于配置GPIO的方向为输出，并可指定初始输出值。
（5）返回值：
返回值为整型，表示配置GPIO方向的结果。
如果成功配置GPIO方向，返回值为0。
如果配置失败，返回值为负数，表示错误码。
这两个函数用于配置GPIO的方向。gpiod_direction_input 将给定的GPIO描述符所代表的GPIO配置为输入模式。而 gpiod_direction_output 将GPIO配置为输出模式，并可以指定初始输出值。
3读取GPIO的电平状态函数：
（1）函数原型：
int gpiod_get_value(const struct gpio_desc *desc);
（2）头文件：
#include <linux/gpio/consumer.h>
（3）参数：
desc：指向GPIO描述符的指针。
（4）函数功能：
gpiod_get_value 函数用于读取 GPIO 的电平状态。
（5）返回值：
返回值为整型，表示GPIO的电平状态。
如果成功读取到 GPIO 的电平状态，返回值为 0 或 1，分别表示低电平和高电平。
如果读取失败，返回值为负数，表示错误码。
该函数用于读取给定GPIO描述符所代表的GPIO的电平状态。通过调用该函数，可以获取GPIO当前的电平状态，以便进一步处理和判断GPIO的状态。
4设置 GPIO 的电平状态函数：
（1）函数原型：
void gpiod_set_value(struct gpio_desc *desc, int value);
（2）头文件：
#include <linux/gpio/consumer.h>
（3）参数：
desc：指向GPIO描述符的指针。
value：要设置的 GPIO 的电平状态，可以是0或1。
（4）函数功能：
gpiod_set_value 函数用于设置GPIO的电平状态。
（5）返回值：无（void）
该函数用于设置给定GPIO描述符所代表的GPIO的电平状态。通过调用该函数，您可以将GPIO 设置为特定的电平状态，以便控制外部设备或执行其他相关操作。
value 参数表示要设置的 GPIO 的电平状态，可以是 0 或 1。当 value 为 0 时，表示设置 GPIO 为低电平；当 value 为 1 时，表示设置 GPIO 为高电平。
该函数没有返回值，因为它只是执行设置操作而不需要返回任何结果。
在使用该函数之前，需要确保 GPIO 已经被正确地配置为输出模式。
5将 GPIO 描述符转换为中断编号函数：
（1）函数原型：
int gpiod_to_irq(const struct gpio_desc *desc);
（2）头文件：
#include <linux/gpio/consumer.h>
（3）参数：
desc：指向 GPIO 描述符的指针。
（4）函数功能：
gpiod_to_irq 函数用于将 GPIO 描述符转换为中断号。
（5）返回值：
返回值为整型，表示中断号。
如果成功将GPIO描述符转换为中断号，返回值为大于等于0的中断号。
如果转换失败，返回值为负数，表示错误码。
该函数用于将给定GPIO描述符所代表的GPIO转换为对应的中断号。
133.2 驱动程序的编写
本实验对应的网盘路径为：iTOP-RK3568开发板【底板V1.7版本】\03_【iTOP-RK3568开发板】指南教程\02_Linux驱动配套资料\04_Linux驱动例程\87_gpioctrl06。
编写完成的gpio_api.c代码如下所示，添加的代码已加粗表示。
#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/mod_devicetable.h>
#include <linux/gpio/consumer.h>
struct gpio_desc *mygpio1; // GPIO 描述符指针
int dir, value, irq; // 方向、值和中断号变量//平台设备初始化函数
int mydriver_probe(struct platform_device *dev) {printk("This is mydriver_probe\n");// 获取GPIO描述符mygpio1 = gpiod_get_optional(&dev->dev, "my", 0);if (mygpio1 == NULL) {printk("gpiod_get_optional error\n");return -1;}gpiod_direction_output(mygpio1, 0); // 将 GPIO 设置为输出模式并设置初始值为低电平gpiod_set_value(mygpio1, 1); // 设置 GPIO 为高电平dir = gpiod_get_direction(mygpio1); // 获取 GPIO 的方向if (dir == GPIOF_DIR_IN) {printk("dir is GPIOF_DIR_IN\n"); // 输出方向为输入} else if (dir == GPIOF_DIR_OUT) {printk("dir is GPIOF_DIR_OUT\n"); // 输出方向为输出}value = gpiod_get_value(mygpio1); // 获取 GPIO 的值printk("value is %d\n", value); // 输出 GPIO 的值irq = gpiod_to_irq(mygpio1); // 将 GPIO 转换为中断号printk("irq is %d\n", irq); // 输出中断号return 0;
}// 平台设备的移除函数
static int my_platform_remove(struct platform_device *pdev)
{printk(KERN_INFO "my_platform_remove: Removing platform device\n");// 清理设备特定的操作// ...return 0;
}const struct of_device_id of_match_table_id[] = {{.compatible="mygpio"},
};// 定义平台驱动结构体
static struct platform_driver my_platform_driver = {.probe = my_platform_probe,.remove = my_platform_remove,.driver = {.name = "my_platform_device",.owner = THIS_MODULE,.of_match_table = of_match_table_id,},
};// 模块初始化函数
static int __init my_platform_driver_init(void)
{int ret;// 注册平台驱动ret = platform_driver_register(&my_platform_driver);if (ret) {printk(KERN_ERR "Failed to register platform driver\n");return ret;}printk(KERN_INFO "my_platform_driver: Platform driver initialized\n");return 0;
}// 模块退出函数
static void __exit my_platform_driver_exit(void)
{// 注销平台驱动gpiod_put(mygpio2);platform_driver_unregister(&my_platform_driver);printk(KERN_INFO "my_platform_driver: Platform driver exited\n");
}module_init(my_platform_driver_init);
module_exit(my_platform_driver_exit);MODULE_LICENSE("GPL");
MODULE_AUTHOR("topeet");133.3 运行测试
133.3.1 编译驱动程序
对于Makefile的内容注释已在上图添加，保存退出之后，来到存放gpio_api.c和Makefile文件目录下，如下图（图133-1）所示：
图 133-1
然后使用命令“make”进行驱动的编译，编译完成如下图（图133-2）所示：
图 133-2
编译完生成gpio_api.ko目标文件，如下图（图133-3）所示：
至此驱动模块就编译成功了。
133.3.2 运行测试
首先需要确保当前开发板使用的内核镜像是我们在132.2小节中修改设备树后编译生成的镜像，然后启动开发板，使用以下命令进行驱动的加载，如下图（图133-4）所示：
insmod gpio_api.ko
图 133-4
在驱动程序中首先会将GPIO的方向设置为输出，并且设置为了高电平，所以上面的第一个打印IO口方向为输出，而由于已经设置为了高电平，所以第二个打印1表示引脚为高电平，第三个打印的值为113，表示gpio转换的中断号，然后使用以下命令进行驱动的卸载，如下图所示：
rmmod gpio_api.ko
图 133-5
至此，GPIO操作函数实验就完成了。
这篇关于RK3568驱动指南｜第十二篇 GPIO子系统-第133章 GPIO操作函数实验的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
