gpio_request_optional和devm_gpiod_get_optional的函数定义
时间: 2023-09-22 18:05:40 浏览: 123
gpio_request_optional函数的定义如下:
```c
int gpio_request_optional(unsigned gpio, const char *label)
```
gpio_request_optional函数用于请求一个可选的GPIO,即如果指定的GPIO可用,则请求该GPIO,否则不进行任何操作。它的参数包括gpio,表示要请求的GPIO编号,和label,表示GPIO的标签。函数返回值为0表示成功,负数表示失败。
devm_gpiod_get_optional函数的定义如下:
```c
struct gpio_desc *devm_gpiod_get_optional(struct device *dev,
const char *con_id,
enum gpiod_flags flags)
```
devm_gpiod_get_optional函数用于获取一个可选的GPIO描述符,即如果指定的GPIO可用,则返回该GPIO的描述符,否则返回NULL。它的参数包括dev,表示设备结构体指针,con_id,表示GPIO的连接ID,flags,表示GPIO的标志。函数返回值为获取到的GPIO描述符或NULL。
相关问题
devm_gpiod_get_optional和devm_gpiod_get_optional区别
请注意,您提供的两个函数名称是相同的,我假设您想问的是以下两个函数的区别:
1. `devm_gpiod_get_optional()`:此函数是Linux内核提供的一个帮助程序,用于获取GPIO设备的可选引脚句柄(handle)。如果GPIO设备存在,则返回引脚句柄,否则返回NULL。此函数使用devres机制进行内存管理,因此如果使用devm_gpiod_get_optional()获取引脚句柄,则无需在使用完成后手动释放该句柄。
2. `devm_gpiod_get_optional()`:这是一个错误的函数名称,我猜测您想说的是`devm_gpio_get_optional()`。与`devm_gpiod_get_optional()`类似,此函数也是用于获取GPIO设备的可选GPIO句柄。但是,这个函数是用于旧版GPIO子系统,而不是新版GPIO子系统(gpiolib)。如果您的平台使用的是旧版GPIO子系统,则可以使用此函数来获取GPIO句柄,否则请使用`devm_gpiod_get_optional()`函数。
因此,这两个函数的区别在于它们所针对的GPIO子系统不同。`devm_gpiod_get_optional()`适用于新版GPIO子系统,而`devm_gpio_get_optional()`适用于旧版GPIO子系统。
devm_gpiod_get_optional 函数
devm_gpiod_get_optional函数是用来获取GPIO设备的句柄的函数,它是在设备驱动中使用的。
函数原型:struct gpio_desc *devm_gpiod_get_optional(struct device *dev,const char *con_id,unsigned int flags);
参数说明:
- dev:设备对象指针。
- con_id:GPIO 控制器标识符。
- flags:GPIO 标志位,如 GPIO_ACTIVE_HIGH、GPIO_ACTIVE_LOW、GPIO_OPEN_DRAIN 等。
函数返回值:
- 成功:返回 GPIO 设备描述符指针。
- 失败:返回 NULL。
该函数的作用与devm_gpiod_get函数类似,不同之处在于,如果没有找到GPIO控制器,则返回NULL,而不是引起错误。
此函数将申请一个GPIO描述符,用于对GPIO资源进行操作。申请的描述符是设备驱动的私有数据,当调用devm_gpiod_put函数时,这个描述符就会被释放。
在使用devm_gpiod_get_optional函数时,需要注意以下几点:
- 该函数只在设备驱动中使用,用户空间无法调用。
- 在使用GPIO之前,需要在设备树中定义GPIO控制器和GPIO引脚。
- con_id参数是一个字符串,用于标识GPIO控制器,需要在设备树中定义。
- flags参数用于指定GPIO的工作模式,如输入、输出、上拉、下拉等。
- 调用此函数后,必须检查返回值是否为NULL,以避免出现空指针引用错误。