gpio.c 文件参考

玄武设备栈：IO扩展芯片：GPIO 更多...

#include <xwcd/ds/standard.h>
#include <string.h>
#include <xwos/lib/xwaop.h>
#include <xwcd/ds/iochip/gpio.h>

gpio.c 的引用(Include)关系图:

浏览源代码.

函数
xwer_t	xwds_iochip_gpio_req (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwtm_t to)
	XWDS API：申请IO扩展芯片的GPIO
xwer_t	xwds_iochip_gpio_rls (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwtm_t to)
	XWDS API：释放IO扩展芯片的GPIO
xwer_t	xwds_iochip_gpio_cfg (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, void *cfg, xwtm_t to)
	XWDS API：配置IO扩展芯片的GPIO
xwer_t	xwds_iochip_gpio_set (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwtm_t to)
	XWDS API：将IO扩展芯片的GPIO设置为高电平
xwer_t	xwds_iochip_gpio_reset (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwtm_t to)
	XWDS API：将IO扩展芯片的GPIO设置为低电平
xwer_t	xwds_iochip_gpio_toggle (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwtm_t to)
	XWDS API：翻转IO扩展芯片的GPIO电平
xwer_t	xwds_iochip_gpio_output (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwsq_t out, xwtm_t to)
	XWDS API：并行输出多个IO扩展芯片的GPIO
xwer_t	xwds_iochip_gpio_input (struct xwds_iochip *iochip, xwid_t port, xwsq_t pinmask, xwsq_t *inbuf, xwtm_t to)
	XWDS API：并行读取多个IO扩展芯片的GPIO

详细描述

玄武设备栈：IO扩展芯片：GPIO

作者

• 隐星魂 (Roy Sun) xwos@.nosp@m.xwos.nosp@m..tech

版权所有

• Copyright © 2015 xwos.tech, All Rights Reserved.

  ‍Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0
  

  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

在文件 gpio.c 中定义.

函数说明

xwds_iochip_gpio_cfg()

xwer_t xwds_iochip_gpio_cfg	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		void *	cfg,
		xwtm_t	to
	)

XWDS API：配置IO扩展芯片的GPIO

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	cfg	GPIO配置，取值依据不同IOCHIP
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-ENOSYS	不支持的API

注解

• 上下文：线程

<No error

在文件 gpio.c 第 100 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
        XWDS_VALIDATE(cfg, "nullptr", -EFAULT);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
               goto err_iochip_grab;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_cfg)) {
                rc = drv->gpio_cfg(iochip, port, pinmask, cfg, to);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_gpio_cfg;
        }
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_gpio_cfg:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图:

xwds_iochip_gpio_input()

xwer_t xwds_iochip_gpio_input	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwsq_t *	inbuf,
		xwtm_t	to
	)

XWDS API：并行读取多个IO扩展芯片的GPIO

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[out]	inbuf	输入缓冲区
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EPERM	GPIO PIN未被申请
-ENOSYS	不支持的API

注解

• 上下文：线程

<No error

在文件 gpio.c 第 299 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
                goto err_iochip_grab;
        }
        pinsts = xwaop_load(xwsq_t, &iochip->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_input)) {
                rc = drv->gpio_input(iochip, port, pinmask, inbuf, to);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_in;
        }
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_in:
err_pinsts:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图:

xwds_iochip_gpio_output()

xwer_t xwds_iochip_gpio_output	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwsq_t	out,
		xwtm_t	to
	)

XWDS API：并行输出多个IO扩展芯片的GPIO

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	out	输出值，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算， 只有被pinmask掩码覆盖的部分有效，未覆盖的pin输出不会发生改变。
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EPERM	GPIO PIN未被申请
-ENOSYS	不支持的API

注解

• 上下文：线程

<No error

在文件 gpio.c 第 258 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
                goto err_iochip_grab;
        }
        pinsts = xwaop_load(xwsq_t, &iochip->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_output)) {
                rc = drv->gpio_output(iochip, port, pinmask, out, to);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_out;
        }
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_out:
err_pinsts:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图:

xwds_iochip_gpio_req()

xwer_t xwds_iochip_gpio_req	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwtm_t	to
	)

XWDS API：申请IO扩展芯片的GPIO

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EBUSY	GPIO PIN已被使用

注解

• 上下文：线程

<No error

在文件 gpio.c 第 27 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
                goto err_iochip_grab;
        }
        rc = xwaop_t0ma_then_s1m(xwsq_t, &iochip->gpio.pins[port], pinmask, NULL, NULL);
        if (rc < 0) {
                rc = -EBUSY;
                goto err_set_pin;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_req)) {
                rc = drv->gpio_req(iochip, port, pinmask, to);
                if (rc < 0) {
                        goto err_drv_gpio_req;
                }
        }
        return XWOK;
 
err_drv_gpio_req:
        xwaop_c0m(xwsq_t, &iochip->gpio.pins[port], pinmask, NULL, NULL);
err_set_pin:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图:

xwds_iochip_gpio_reset()

xwer_t xwds_iochip_gpio_reset	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwtm_t	to
	)

XWDS API：将IO扩展芯片的GPIO设置为低电平

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EPERM	GPIO PIN未被申请
-ENOSYS	不支持的API

注解

• 上下文：线程

<No error

在文件 gpio.c 第 176 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
                goto err_iochip_grab;
        }
        pinsts = xwaop_load(xwsq_t, &iochip->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_reset)) {
                rc = drv->gpio_reset(iochip, port, pinmask, to);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_reset;
        }
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_reset:
err_pinsts:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图:

xwds_iochip_gpio_rls()

xwer_t xwds_iochip_gpio_rls	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwtm_t	to
	)

XWDS API：释放IO扩展芯片的GPIO

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EPERM	GPIO PIN未被申请

注解

• 上下文：线程

<No error

在文件 gpio.c 第 65 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        pinsts = xwaop_load(xwsq_t, &iochip->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_rls)) {
                rc = drv->gpio_rls(iochip, port, pinmask, to);
                if (rc < 0) {
                        goto err_drv_gpio_rls;
                }
        }
        xwaop_c0m(xwsq_t, &iochip->gpio.pins[port], pinmask, NULL, NULL);
 
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_gpio_rls:
err_pinsts:
        return rc;
}

函数调用图:

xwds_iochip_gpio_set()

xwer_t xwds_iochip_gpio_set	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwtm_t	to
	)

XWDS API：将IO扩展芯片的GPIO设置为高电平

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EPERM	GPIO PIN未被申请
-ENOSYS	不支持的API

注解

• 上下文：线程

<No error

在文件 gpio.c 第 135 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
                goto err_iochip_grab;
        }
        pinsts = xwaop_load(xwsq_t, &iochip->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_set)) {
                rc = drv->gpio_set(iochip, port, pinmask, to);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_set;
        }
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_set:
err_pinsts:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图:

xwds_iochip_gpio_toggle()

xwer_t xwds_iochip_gpio_toggle	(	struct xwds_iochip *	iochip,
		xwid_t	port,
		xwsq_t	pinmask,
		xwtm_t	to
	)

XWDS API：翻转IO扩展芯片的GPIO电平

参数

[in]	iochip	IOCHIP对象指针
[in]	port	GPIO端口
[in]	pinmask	引脚的掩码，取值 xwds_iochip_gpio_pin_em 中的任意项的或运算
[in]	to	期望唤醒的时间点

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	GPIO PORT错误
-EPERM	GPIO PIN未被申请
-ENOSYS	不支持的API

注解

• 上下文：线程

<No error

在文件 gpio.c 第 217 行定义.

{
        const struct xwds_iochip_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(iochip, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < iochip->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_IOCHIP_GPIO_PIN_MASK(iochip->gpio.pin_num);
        rc = xwds_iochip_grab(iochip);
        if (rc < 0) {
                goto err_iochip_grab;
        }
        pinsts = xwaop_load(xwsq_t, &iochip->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_iochip_driver *, iochip->bc.dev.drv);
        if ((drv) && (drv->gpio_toggle)) {
                rc = drv->gpio_toggle(iochip, port, pinmask, to);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_toggle;
        }
        xwds_iochip_put(iochip);
        return XWOK;
 
err_drv_toggle:
err_pinsts:
        xwds_iochip_put(iochip);
err_iochip_grab:
        return rc;
}

函数调用图: