SylixOS--gpiofd接口的实现

SylixOS中会把GPIO抽象为设备文件，应用层通过访问设备文件即可操作GPIO。除了按照文件的方式访问GPIO外，系统还封装了GpioFd接口，简化了应用层对GPIO的操作。这一篇来说明GpioFd接口是如何实现的，实现代码如下：

/*********************************************************************************************************
** 函数名称: gpiofd
** 功能描述: 打开 gpiofd 文件
** 输　入  : gpio           gpio 号
**           flags          打开标志 GFD_CLOEXEC / GFD_NONBLOCK
**           gpio_flags     gpio 属性标志
** 输　出  : gpiofd 文件描述符
*********************************************************************************************************/
LW_API  
int  gpiofd (unsigned int gpio, int flags, int gpio_flags)
{
    INT  iFd;
    INT  iError;
    CHAR cGpioName[MAX_FILENAME_LENGTH];

    flags &= (GFD_CLOEXEC | GFD_NONBLOCK);
    
    snprintf(cGpioName, MAX_FILENAME_LENGTH, "%s/%d", LW_GPIOFD_DEV_PATH, gpio);
    
    iFd = open(cGpioName, O_RDWR | flags);
    if (iFd >= 0) {
        iError = ioctl(iFd, GPIO_CMD_SET_FLAGS, gpio_flags);
        if (iError < 0) {
            close(iFd);
            return  (iError);
        }
    }
    
    return  (iFd);
}
/*********************************************************************************************************
** 函数名称: gpiofd_read
** 功能描述: 读取 gpiofd 文件
** 输　入  : fd        文件描述符
**           value     读取缓冲
** 输　出  : 0 : 成功  -1 : 失败
*********************************************************************************************************/
LW_API  
int  gpiofd_read (int fd, uint8_t *value)
{
    return  (read(fd, value, sizeof(uint8_t)) != sizeof(uint8_t) ? PX_ERROR : ERROR_NONE);
}
/*********************************************************************************************************
** 函数名称: gpiofd_write
** 功能描述: 写 gpiofd 文件
** 输　入  : fd        文件描述符
**           value     写入数据
** 输　出  : 0 : 成功  -1 : 失败
*********************************************************************************************************/
LW_API  
int  gpiofd_write (int fd, uint8_t  value)
{
    return  (write(fd, &value, sizeof(uint8_t)) != sizeof(uint8_t) ? PX_ERROR : ERROR_NONE);
}

• gpiofd接口是基于设备文件访问标准接口（open,close,read,write,ioctl）实现的。
• 对输入的文件打开方式进行了调整，保留了GFD_CLOEXEC和GFD_NONBLOCK，增加了O_RDWR。

GFD_CLOEXEC            close_on_exec
GFD_NONBLOCK         非阻塞访问，读写数据时不会阻塞
O_RDWR                       读写访问

• 将GPIO编号转为相应的GPIO设备文件名，包含文件路径。
• 打开成功则通过ioctl函数设置gpio_flags，标准open函数是没有gpio_flags参数的，所以要通过ioctl函数设置。
• 读写则是直接调用的read,write函数，同时设置读写缓存固定为1字节。
• 参考该实现代码，应用层也可以直接使用设备文件访问标准接口来操作GPIO。