WhyCan Forum(哇酷开发者社区)

libgpiod C++ binding 概述

libgpiod C++ binding，以下简称libgpiod，主要提供了三个对象来实现对IO的操作，分别是

• gpiod::chip代表一个GPIO芯片，对应/dev下的一个gpiochipN文件

• gpiod::line代表一个GPIO引脚

• gpiod::line_bulk代表多个GPIO引脚，开头说的同时操作多个IO就是依此实现的

操作一个IO的步骤是：
1，使用gpiod::chip构造函数实例化一个chip对象，参数是character device的文件名，比如gpiochip0：

gpiod::chip chip("gpiochip0");

2，使用gpiod::chip::get_line或者get_lines来获得一个line或者line_bulk对象
对于gpiod::chip::get_line，参数是那个引脚对应的偏移量，比如主线内核里一个port一般是32个脚，PH00就是224：

gpiod::line PH00 = chip.get_line(224);

对于gpiod::chip::get_lines，参数是包含那一组引脚对应的偏移量的一个std::vector<unsigned int>，利用C++11列表初始化可以很方便地写在一行：

gpiod::line_bulk PH00_01 = get_lines(std::vector<unsigned int>{224, 225});

需要注意的是到这一步line和line_bulk还不能用，如果直接调用其上的方法会抛出一个std::system_error异常：
what():  error setting GPIO line values: Operation not permitted
必须首先通过gpiod::line::request或者gpiod::line_bulk::request来配置这个引脚的方向和偏置（上下拉或开漏/开源），参数是一个gpiod::line_request结构体。这个结构体有三个成员，分别是consumer名字的string，io的用途（输入或输出或中断），以及一个标志位的bitset，用于配置极性，输入上下拉或者输出开漏或开源，利用C++11列表初始化也可以很方便地写在一行：

PH00.request({"", gpiod::line_request::DIRECTION_OUTPUT, 0})

其中io的用途是一个匿名枚举，可以是以下的值：

		DIRECTION_AS_IS = 1,
		/**< Request for values, don't change the direction. */
		DIRECTION_INPUT,
		/**< Request for reading line values. */
		DIRECTION_OUTPUT,
		/**< Request for driving the GPIO lines. */
		EVENT_FALLING_EDGE,
		/**< Listen for falling edge events. */
		EVENT_RISING_EDGE,
		/**< Listen for rising edge events. */
		EVENT_BOTH_EDGES,
		/**< Listen for all types of events. */

每个值的含义配合名字和注释应该很容易理解，不赘述了，多提一句，需要使用这个匿名枚举的类型名的时候怎么办？可以利用C++11的decltype给他指派一个名字：

using reqType = decltype(glReq::EVENT_BOTH_EDGES);

标志位可以是以下几个预定义的值，配合名字和注释也很容易理解，不赘述：

FLAG_ACTIVE_LOW;
/**< Set the active state to 'low' (high is the default). */
FLAG_OPEN_SOURCE;
/**< The line is an open-source port. */
FLAG_OPEN_DRAIN;
/**< The line is an open-drain port. */
FLAG_BIAS_DISABLED;
/**< The line has neither pull-up nor pull-down resistor enabled. */
FLAG_BIAS_PULL_DOWN;
/**< The line has a configurable pull-down resistor enabled. */
FLAG_BIAS_PULL_UP;
/**< The line has a configurable pull-up resistor enabled. */

操作line的函数主要就是get_value()读取和set_value(int val)设置，line_bulk对应的的get_values()和set_values(const ::std::vector<int>& values)就是把返回值和参数换成vector，更多的成员函数可以在libgpiod头文件的源码里查阅，不多说。
已经request过的line/lines要作他用时必须先调用release()，否则会抛出std::system_error异常：
what():  error requesting GPIO lines: Device or resource busy
最后需要注意的是，编译的时候需带上选项 -lgpiodcxx 以链接对应的库。当然，编译平台上还必须安装了libgpiod的包。

最近编辑记录 SdtElectronics (2021-06-20 16:24:35)