玄武设备栈：SOC：外部中断更多...

#include <xwcd/ds/standard.h>
#include <xwcd/ds/soc/gpio.h>
#include <xwcd/ds/soc/eirq.h>

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

函数
xwer_t	xwds_eirq_req (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask, xwid_t eiid, xwsq_t eiflag, xwds_eirq_f isr, xwds_eirq_arg_t arg)
	XWDS API：申请外部中断

xwer_t	xwds_eirq_rls (struct xwds_soc *soc, xwid_t port, xwsq_t pinmask, xwid_t eiid)
	XWDS API：释放外部中断

详细描述

玄武设备栈：SOC：外部中断

作者

隐星魂 (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.

在文件 eirq.c 中定义.

函数说明

◆ xwds_eirq_req()

xwer_t xwds_eirq_req	(	struct xwds_soc *	soc,
		xwid_t	port,
		xwsq_t	pinmask,
		xwid_t	eiid,
		xwsq_t	eiflag,
		xwds_eirq_f	isr,
		xwds_eirq_arg_t	arg
	)

XWDS API：申请外部中断

参数

[in]	soc	SOC对象指针
[in]	port	GPIO端口
[in]	pinmask	GPIO PIN
[in]	eiid	外部中断ID
[in]	eiflag	触发标志
[in]	isr	中断响应函数
[in]	arg	中断响应函数参数

返回: 错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	外部中断ID错误

注解

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

<No error

在文件 eirq.c 第 26 行定义.

{
        const struct xwds_soc_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((eiid < soc->eirq.num), "out-of-range", -ERANGE);
 
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
 
#if defined(XWCDCFG_ds_SOC_EIRQ_ROISRT) && (1 == XWCDCFG_ds_SOC_EIRQ_ROISRT)
        XWOS_UNUSED(isr);
        XWOS_UNUSED(arg);
        if (NULL == soc->eirq.isrs[eiid]) {
                rc = -EPERM;
                goto err_perm;
        }
#else
        if (soc->eirq.isrs[eiid]) {
                rc = -EBUSY;
                goto err_perm;
        }
        soc->eirq.isrs[eiid] = isr ? isr : (xwds_eirq_f)err_ptr(-EBUSY);
        soc->eirq.isrargs[eiid] = arg;
#endif
 
        drv = xwds_cast(const struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->eirq_req)) {
                rc = drv->eirq_req(soc, port, pinmask, eiid, eiflag);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_eirq_req;
        }
        return XWOK;
 
err_drv_eirq_req:
#if !defined(XWCDCFG_ds_SOC_EIRQ_ROISRT) || (1 != XWCDCFG_ds_SOC_EIRQ_ROISRT)
        soc->eirq.isrs[eiid] = NULL;
        soc->eirq.isrargs[eiid] = NULL;
#endif
err_perm:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

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

◆ xwds_eirq_rls()

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

XWDS API：释放外部中断