gpio.c 文件参考

玄武设备栈：SOC：GPIO 更多...

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

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

浏览源代码.

函数
xwer_t	xwds_gpio_req (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask)
	XWDS API：申请SOC的GPIO
xwer_t	xwds_gpio_rls (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask)
	XWDS API：释放SOC的GPIO
xwer_t	xwds_gpio_cfg (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask, void *cfg)
	XWDS API：配置SOC的GPIO
xwer_t	xwds_gpio_set (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask)
	XWDS API：将SOC的GPIO设置为高电平
xwer_t	xwds_gpio_reset (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask)
	XWDS API：将SOC的GPIO设置为低电平
xwer_t	xwds_gpio_toggle (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask)
	XWDS API：翻转SOC的GPIO电平
xwer_t	xwds_gpio_output (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask, xwsq_t out)
	XWDS API：并行输出多个SOC的GPIO
xwer_t	xwds_gpio_input (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask, xwsq_t *inbuf)
	XWDS API：并行读取多个SOC的GPIO

详细描述

玄武设备栈：SOC：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_gpio_cfg()

xwer_t xwds_gpio_cfg	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask,
		void *	cfg
	)

XWDS API：配置SOC的GPIO

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算
[in]	cfg	GPIO配置，取值依据不同SOC

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
        XWDS_VALIDATE(cfg, "nullptr", -EFAULT);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
               goto err_soc_grab;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_cfg)) {
                rc = drv->gpio_cfg(soc, port, pinmask, cfg);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_gpio_cfg;
        }
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_gpio_cfg:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

xwds_gpio_input()

xwer_t xwds_gpio_input	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask,
		xwsq_t *	inbuf
	)

XWDS API：并行读取多个SOC的GPIO

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算
[out]	inbuf	输入缓冲区

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
        pinsts = xwaop_load(xwsq_t, &soc->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_input)) {
                rc = drv->gpio_input(soc, port, pinmask, inbuf);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_in;
        }
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_in:
err_pinsts:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

xwds_gpio_output()

xwer_t xwds_gpio_output	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask,
		xwsq_t	out
	)

XWDS API：并行输出多个SOC的GPIO

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算
[in]	out	输出值，引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算， 只有被pinmask掩码覆盖的部分有效，未覆盖的pin输出不会发生改变。

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
        pinsts = xwaop_load(xwsq_t, &soc->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_output)) {
                rc = drv->gpio_output(soc, port, pinmask, out);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_out;
        }
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_out:
err_pinsts:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

xwds_gpio_req()

xwer_t xwds_gpio_req	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask
	)

XWDS API：申请SOC的GPIO

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
        rc = xwaop_t0ma_then_s1m(xwsq_t, &soc->gpio.pins[port], pinmask, NULL, NULL);
        if (rc < 0) {
                rc = -EBUSY;
                goto err_set_pin;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_req)) {
                rc = drv->gpio_req(soc, port, pinmask);
                if (rc < 0) {
                        goto err_drv_gpio_req;
                }
        }
        return XWOK;
 
err_drv_gpio_req:
        xwaop_c0m(xwsq_t, &soc->gpio.pins[port], pinmask, NULL, NULL);
err_set_pin:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwds_gpio_reset()

xwer_t xwds_gpio_reset	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask
	)

XWDS API：将SOC的GPIO设置为低电平

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
        pinsts = xwaop_load(xwsq_t, &soc->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_reset)) {
                rc = drv->gpio_reset(soc, port, pinmask);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_reset;
        }
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_reset:
err_pinsts:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwds_gpio_rls()

xwer_t xwds_gpio_rls	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask
	)

XWDS API：释放SOC的GPIO

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

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

函数调用图:

这是这个函数的调用关系图:

xwds_gpio_set()

xwer_t xwds_gpio_set	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask
	)

XWDS API：将SOC的GPIO设置为高电平

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
        pinsts = xwaop_load(xwsq_t, &soc->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_set)) {
                rc = drv->gpio_set(soc, port, pinmask);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_set;
        }
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_set:
err_pinsts:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

这是这个函数的调用关系图:

xwds_gpio_toggle()

xwer_t xwds_gpio_toggle	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask
	)

XWDS API：翻转SOC的GPIO电平

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口，取值 xwds_gpio_port_em 中的一项
[in]	pinmask	引脚的掩码，取值 xwds_gpio_pin_em 中的任意项的或运算

返回

错误码

返回值

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

注解

• 上下文：中断、中断底半部、线程

<No error

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

{
        const struct xwds_soc_driver * drv;
        xwsq_t pinsts;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((port < soc->gpio.port_num), "out-of-range", -ERANGE);
 
        pinmask &= XWDS_GPIO_PIN_MASK(soc->gpio.pin_num);
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
        pinsts = xwaop_load(xwsq_t, &soc->gpio.pins[port], xwaop_mo_relaxed);
        if (pinmask & (~pinsts)) {
                rc = -EPERM;
                goto err_pinsts;
        }
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->gpio_toggle)) {
                rc = drv->gpio_toggle(soc, port, pinmask);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_toggle;
        }
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_toggle:
err_pinsts:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图: