GPIO子系统下的API函数

清疚 2022-12-22 14:27 118阅读 0赞

### GPIO子系统下的API函数 ###

*  1、GPIO子系统下的API函数
 *   *  1.1、gpio\_request 函数
     *  1.2、 gpio\_free 函数
     *  1.3、 gpio\_direction\_input 函数
     *  1.4、 gpio\_direction\_output 函数
     *  1.5、 gpio\_get\_value 函数
     *  1.6、 gpio\_set\_value 函数

# 1、GPIO子系统下的API函数 #

对于驱动开发人员，设置好设备树以后就可以使用 gpio 子系统提供的 API 函数来操作指定的 GPIO， gpio 子系统向驱动开发人员屏蔽了具体的读写寄存器过程。这就是驱动分层与分离的好处，大家各司其职，做好自己的本职工作即可。 gpio 子系统提供的常用的 API 函数有下面几个。

## 1.1、gpio\_request 函数 ##

gpio\_request 函数用于申请一个 GPIO 管脚，在使用一个 GPIO 之前一定要使用 gpio\_request进行申请，函数原型如下：

int gpio_request(unsigned gpio, const char *label)

**参数：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>意义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>gpio</td> 
   <td>要申请的 gpio 标号，使用 of_get_named_gpio 函数从设备树获取指定 GPIO 属性信息，此函数会返回这个 GPIO 的标号。</td> 
  </tr> 
  <tr> 
   <td>label</td> 
   <td>给 gpio 设置个名字。</td> 
  </tr> 
 </tbody> 
</table>

**返回值：**

0，申请成功；其他值，申请失败。

## 1.2、 gpio\_free 函数 ##

如果不使用某个 GPIO 了，那么就可以调用 gpio\_free 函数进行释放。函数原型如下：

void gpio_free(unsigned gpio)

**参数：**

**返回值：** 无。

## 1.3、 gpio\_direction\_input 函数 ##

此函数用于设置某个 GPIO 为输入，函数原型如下所示：

int gpio_direction_input(unsigned gpio)

**参数：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>意义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>gpio</td> 
   <td>要设置为输入的 GPIO 标号。</td> 
  </tr> 
 </tbody> 
</table>

**返回值:**  
0，设置成功；负值，设置失败。

## 1.4、 gpio\_direction\_output 函数 ##

此函数用于设置某个 GPIO 为输出，并且设置默认输出值，函数原型如下：

int gpio_direction_output(unsigned gpio, int value)

**参数：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>意义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>gpio</td> 
   <td>要设置为输出的 GPIO 标号。</td> 
  </tr> 
  <tr> 
   <td>value</td> 
   <td>GPIO 默认输出值。</td> 
  </tr> 
 </tbody> 
</table>

**返回值：**  
0，设置成功；负值，设置失败。

## 1.5、 gpio\_get\_value 函数 ##

此函数用于获取某个 GPIO 的值(0 或 1)，此函数是个宏，定义所示：

#define gpio_get_value __gpio_get_value
    int __gpio_get_value(unsigned gpio)

**参数：**

**返回值：**  
非负值，得到的 GPIO 值；负值，获取失败。

## 1.6、 gpio\_set\_value 函数 ##

此函数用于设置某个 GPIO 的值，此函数是个宏，定义如下

#define gpio_set_value __gpio_set_value
    void __gpio_set_value(unsigned gpio, int value)

**参数：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>意义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>gpio</td> 
   <td>要设置的 GPIO 标号。</td> 
  </tr> 
  <tr> 
   <td>value</td> 
   <td>要设置的值。</td> 
  </tr> 
 </tbody> 
</table>

**返回值：** 无

关于 gpio 子系统常用的 API 函数就讲这些，这些是我们用的最多的