IO扩展芯片的协作图:

结构体
struct	xwds_iochip_driver
	BSP中需要提供的IO扩展芯片设备驱动函数表更多...

struct	xwds_iochip
	IO扩展芯片更多...

类型定义
typedef void *	xwds_iochip_eirq_arg_t
	外部中断函数参数

typedef void(*	xwds_iochip_eirq_f) (struct xwds_iochip *, xwid_t, xwds_iochip_eirq_arg_t)
	外部中断函数

函数
void	xwds_iochip_construct (struct xwds_iochip *iochip)
	XWDS API：IOCHIP对象的构造函数

void	xwds_iochip_destruct (struct xwds_iochip *iochip)
	XWDS API：IOCHIP对象的析构函数

xwer_t	xwds_iochip_grab (struct xwds_iochip *iochip)
	XWDS API：增加对象的引用计数

xwer_t	xwds_iochip_put (struct xwds_iochip *iochip)
	XWDS API：减少对象的引用计数

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

#define	XWDS_IOCHIP_GPIO_PORT(p) (p)

#define	XWDS_IOCHIP_GPIO_PIN(n) (1U << ((xwu32_t)(n)))

#define	XWDS_IOCHIP_GPIO_PIN_MASK(n) (XWDS_IOCHIP_GPIO_PIN(n) - 1U)

enum	xwds_iochip_gpio_pin_em { XWDS_IOCHIP_GPIO_PIN_0 = (1U << ((xwu32_t)( 0 ))) , XWDS_IOCHIP_GPIO_PIN_1 = (1U << ((xwu32_t)( 1 ))) , XWDS_IOCHIP_GPIO_PIN_2 = (1U << ((xwu32_t)( 2 ))) , XWDS_IOCHIP_GPIO_PIN_3 = (1U << ((xwu32_t)( 3 ))) , XWDS_IOCHIP_GPIO_PIN_4 = (1U << ((xwu32_t)( 4 ))) , XWDS_IOCHIP_GPIO_PIN_5 = (1U << ((xwu32_t)( 5 ))) , XWDS_IOCHIP_GPIO_PIN_6 = (1U << ((xwu32_t)( 6 ))) , XWDS_IOCHIP_GPIO_PIN_7 = (1U << ((xwu32_t)( 7 ))) , XWDS_IOCHIP_GPIO_PIN_8 = (1U << ((xwu32_t)( 8 ))) , XWDS_IOCHIP_GPIO_PIN_9 = (1U << ((xwu32_t)( 9 ))) , XWDS_IOCHIP_GPIO_PIN_10 = (1U << ((xwu32_t)( 10 ))) , XWDS_IOCHIP_GPIO_PIN_11 = (1U << ((xwu32_t)( 11 ))) , XWDS_IOCHIP_GPIO_PIN_12 = (1U << ((xwu32_t)( 12 ))) , XWDS_IOCHIP_GPIO_PIN_13 = (1U << ((xwu32_t)( 13 ))) , XWDS_IOCHIP_GPIO_PIN_14 = (1U << ((xwu32_t)( 14 ))) , XWDS_IOCHIP_GPIO_PIN_15 = (1U << ((xwu32_t)( 15 ))) , XWDS_IOCHIP_GPIO_PIN_16 = (1U << ((xwu32_t)( 16 ))) , XWDS_IOCHIP_GPIO_PIN_17 = (1U << ((xwu32_t)( 17 ))) , XWDS_IOCHIP_GPIO_PIN_18 = (1U << ((xwu32_t)( 18 ))) , XWDS_IOCHIP_GPIO_PIN_19 = (1U << ((xwu32_t)( 19 ))) , XWDS_IOCHIP_GPIO_PIN_20 = (1U << ((xwu32_t)( 20 ))) , XWDS_IOCHIP_GPIO_PIN_21 = (1U << ((xwu32_t)( 21 ))) , XWDS_IOCHIP_GPIO_PIN_22 = (1U << ((xwu32_t)( 22 ))) , XWDS_IOCHIP_GPIO_PIN_23 = (1U << ((xwu32_t)( 23 ))) , XWDS_IOCHIP_GPIO_PIN_24 = (1U << ((xwu32_t)( 24 ))) , XWDS_IOCHIP_GPIO_PIN_25 = (1U << ((xwu32_t)( 25 ))) , XWDS_IOCHIP_GPIO_PIN_26 = (1U << ((xwu32_t)( 26 ))) , XWDS_IOCHIP_GPIO_PIN_27 = (1U << ((xwu32_t)( 27 ))) , XWDS_IOCHIP_GPIO_PIN_28 = (1U << ((xwu32_t)( 28 ))) , XWDS_IOCHIP_GPIO_PIN_29 = (1U << ((xwu32_t)( 29 ))) , XWDS_IOCHIP_GPIO_PIN_30 = (1U << ((xwu32_t)( 30 ))) , XWDS_IOCHIP_GPIO_PIN_31 = (1U << ((xwu32_t)( 31 ))) }
	XWDS IOCHIP GPIO PIN 枚举更多...

详细描述

宏定义说明

◆ XWDS_IOCHIP_GPIO_PIN

#define XWDS_IOCHIP_GPIO_PIN ( n ) (1U << ((xwu32_t)(n)))

在文件 gpio.h 第 34 行定义.

◆ XWDS_IOCHIP_GPIO_PIN_MASK

#define XWDS_IOCHIP_GPIO_PIN_MASK ( n ) (XWDS_IOCHIP_GPIO_PIN(n) - 1U)

在文件 gpio.h 第 35 行定义.

◆ XWDS_IOCHIP_GPIO_PORT

#define XWDS_IOCHIP_GPIO_PORT ( p ) (p)

在文件 gpio.h 第 32 行定义.

类型定义说明

◆ xwds_iochip_eirq_arg_t

typedef void* xwds_iochip_eirq_arg_t

外部中断函数参数

在文件 chip.h 第 40 行定义.

◆ xwds_iochip_eirq_f

typedef void(* xwds_iochip_eirq_f) (struct xwds_iochip *, xwid_t, xwds_iochip_eirq_arg_t)

外部中断函数

在文件 chip.h 第 45 行定义.

枚举类型说明

◆ xwds_iochip_gpio_pin_em

enum xwds_iochip_gpio_pin_em

XWDS IOCHIP GPIO PIN 枚举

枚举值
XWDS_IOCHIP_GPIO_PIN_0	Pin 0
XWDS_IOCHIP_GPIO_PIN_1	Pin 1
XWDS_IOCHIP_GPIO_PIN_2	Pin 2
XWDS_IOCHIP_GPIO_PIN_3	Pin 3
XWDS_IOCHIP_GPIO_PIN_4	Pin 4
XWDS_IOCHIP_GPIO_PIN_5	Pin 5
XWDS_IOCHIP_GPIO_PIN_6	Pin 6
XWDS_IOCHIP_GPIO_PIN_7	Pin 7
XWDS_IOCHIP_GPIO_PIN_8	Pin 8
XWDS_IOCHIP_GPIO_PIN_9	Pin 9
XWDS_IOCHIP_GPIO_PIN_10	Pin 10
XWDS_IOCHIP_GPIO_PIN_11	Pin 11
XWDS_IOCHIP_GPIO_PIN_12	Pin 12
XWDS_IOCHIP_GPIO_PIN_13	Pin 13
XWDS_IOCHIP_GPIO_PIN_14	Pin 14
XWDS_IOCHIP_GPIO_PIN_15	Pin 15
XWDS_IOCHIP_GPIO_PIN_16	Pin 16
XWDS_IOCHIP_GPIO_PIN_17	Pin 17
XWDS_IOCHIP_GPIO_PIN_18	Pin 18
XWDS_IOCHIP_GPIO_PIN_19	Pin 19
XWDS_IOCHIP_GPIO_PIN_20	Pin 20
XWDS_IOCHIP_GPIO_PIN_21	Pin 21
XWDS_IOCHIP_GPIO_PIN_22	Pin 22
XWDS_IOCHIP_GPIO_PIN_23	Pin 23
XWDS_IOCHIP_GPIO_PIN_24	Pin 24
XWDS_IOCHIP_GPIO_PIN_25	Pin 25
XWDS_IOCHIP_GPIO_PIN_26	Pin 26
XWDS_IOCHIP_GPIO_PIN_27	Pin 27
XWDS_IOCHIP_GPIO_PIN_28	Pin 28
XWDS_IOCHIP_GPIO_PIN_29	Pin 29
XWDS_IOCHIP_GPIO_PIN_30	Pin 30
XWDS_IOCHIP_GPIO_PIN_31	Pin 31

在文件 gpio.h 第 40 行定义.

                             {
        XWDS_IOCHIP_GPIO_PIN_0 = XWDS_IOCHIP_GPIO_PIN(0), 
        XWDS_IOCHIP_GPIO_PIN_1 = XWDS_IOCHIP_GPIO_PIN(1), 
        XWDS_IOCHIP_GPIO_PIN_2 = XWDS_IOCHIP_GPIO_PIN(2), 
        XWDS_IOCHIP_GPIO_PIN_3 = XWDS_IOCHIP_GPIO_PIN(3), 
        XWDS_IOCHIP_GPIO_PIN_4 = XWDS_IOCHIP_GPIO_PIN(4), 
        XWDS_IOCHIP_GPIO_PIN_5 = XWDS_IOCHIP_GPIO_PIN(5), 
        XWDS_IOCHIP_GPIO_PIN_6 = XWDS_IOCHIP_GPIO_PIN(6), 
        XWDS_IOCHIP_GPIO_PIN_7 = XWDS_IOCHIP_GPIO_PIN(7), 
        XWDS_IOCHIP_GPIO_PIN_8 = XWDS_IOCHIP_GPIO_PIN(8), 
        XWDS_IOCHIP_GPIO_PIN_9 = XWDS_IOCHIP_GPIO_PIN(9), 
        XWDS_IOCHIP_GPIO_PIN_10 = XWDS_IOCHIP_GPIO_PIN(10), 
        XWDS_IOCHIP_GPIO_PIN_11 = XWDS_IOCHIP_GPIO_PIN(11), 
        XWDS_IOCHIP_GPIO_PIN_12 = XWDS_IOCHIP_GPIO_PIN(12), 
        XWDS_IOCHIP_GPIO_PIN_13 = XWDS_IOCHIP_GPIO_PIN(13), 
        XWDS_IOCHIP_GPIO_PIN_14 = XWDS_IOCHIP_GPIO_PIN(14), 
        XWDS_IOCHIP_GPIO_PIN_15 = XWDS_IOCHIP_GPIO_PIN(15), 
        XWDS_IOCHIP_GPIO_PIN_16 = XWDS_IOCHIP_GPIO_PIN(16), 
        XWDS_IOCHIP_GPIO_PIN_17 = XWDS_IOCHIP_GPIO_PIN(17), 
        XWDS_IOCHIP_GPIO_PIN_18 = XWDS_IOCHIP_GPIO_PIN(18), 
        XWDS_IOCHIP_GPIO_PIN_19 = XWDS_IOCHIP_GPIO_PIN(19), 
        XWDS_IOCHIP_GPIO_PIN_20 = XWDS_IOCHIP_GPIO_PIN(20), 
        XWDS_IOCHIP_GPIO_PIN_21 = XWDS_IOCHIP_GPIO_PIN(21), 
        XWDS_IOCHIP_GPIO_PIN_22 = XWDS_IOCHIP_GPIO_PIN(22), 
        XWDS_IOCHIP_GPIO_PIN_23 = XWDS_IOCHIP_GPIO_PIN(23), 
        XWDS_IOCHIP_GPIO_PIN_24 = XWDS_IOCHIP_GPIO_PIN(24), 
        XWDS_IOCHIP_GPIO_PIN_25 = XWDS_IOCHIP_GPIO_PIN(25), 
        XWDS_IOCHIP_GPIO_PIN_26 = XWDS_IOCHIP_GPIO_PIN(26), 
        XWDS_IOCHIP_GPIO_PIN_27 = XWDS_IOCHIP_GPIO_PIN(27), 
        XWDS_IOCHIP_GPIO_PIN_28 = XWDS_IOCHIP_GPIO_PIN(28), 
        XWDS_IOCHIP_GPIO_PIN_29 = XWDS_IOCHIP_GPIO_PIN(29), 
        XWDS_IOCHIP_GPIO_PIN_30 = XWDS_IOCHIP_GPIO_PIN(30), 
        XWDS_IOCHIP_GPIO_PIN_31 = XWDS_IOCHIP_GPIO_PIN(31), 
};

函数说明

◆ xwds_iochip_construct()

void xwds_iochip_construct ( struct xwds_iochip * iochip )

XWDS API：IOCHIP对象的构造函数

参数

[in] iochip IOCHIP对象指针

在文件 chip.c 第 58 行定义.

{
        xwds_device_construct(&iochip->bc.dev);
        iochip->bc.dev.vop = &xwds_iochip_vop;
}

函数调用图:

◆ xwds_iochip_destruct()

void xwds_iochip_destruct ( struct xwds_iochip * iochip )

XWDS API：IOCHIP对象的析构函数

参数

[in] iochip IOCHIP对象指针

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

{
        xwds_device_destruct(&iochip->bc.dev);
}

函数调用图:

◆ 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;
}

函数调用图:

◆ xwds_iochip_grab()

xwer_t xwds_iochip_grab ( struct xwds_iochip * iochip )

XWDS API：增加对象的引用计数

参数

[in] iochip IOCHIP对象指针

在文件 chip.c 第 71 行定义.

{
        return xwds_device_grab(&iochip->bc.dev);
}

函数调用图:

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

◆ xwds_iochip_put()

xwer_t xwds_iochip_put ( struct xwds_iochip * iochip )

XWDS API：减少对象的引用计数

参数

[in] iochip IOCHIP对象指针

在文件 chip.c 第 77 行定义.

{
        return xwds_device_put(&iochip->bc.dev);
}

函数调用图:

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

结构体

类型定义

函数

详细描述

宏定义说明

◆ XWDS_IOCHIP_GPIO_PIN

◆ XWDS_IOCHIP_GPIO_PIN_MASK

◆ XWDS_IOCHIP_GPIO_PORT

类型定义说明

◆ xwds_iochip_eirq_arg_t

◆ xwds_iochip_eirq_f

枚举类型说明

◆ xwds_iochip_gpio_pin_em

函数说明

◆ xwds_iochip_construct()

◆ xwds_iochip_destruct()

◆ xwds_iochip_gpio_cfg()

◆ xwds_iochip_gpio_input()

◆ xwds_iochip_gpio_output()

◆ xwds_iochip_gpio_req()

◆ xwds_iochip_gpio_reset()

◆ xwds_iochip_gpio_rls()

◆ xwds_iochip_gpio_set()

◆ xwds_iochip_gpio_toggle()

◆ xwds_iochip_grab()

◆ xwds_iochip_put()