clock.c 文件参考

玄武设备栈：SOC：时钟 更多...

#include <xwcd/ds/standard.h>
#include <string.h>
#include <xwcd/ds/soc/clock.h>

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

浏览源代码.

函数
xwer_t	xwds_clk_req (struct xwds_soc *soc, xwid_t id)
	XWDS API：申请时钟
xwer_t	xwds_clk_rls (struct xwds_soc *soc, xwid_t id)
	XWDS API：释放时钟
xwer_t	xwds_clk_getfqcy (struct xwds_soc *soc, xwid_t id, xwu32_t *buf, xwsz_t *num)
	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.

在文件 clock.c 中定义.

函数说明

xwds_clk_getfqcy()

xwer_t xwds_clk_getfqcy	(	struct xwds_soc *	soc,
		xwid_t	id,
		xwu32_t *	buf,
		xwsz_t *	num
	)

XWDS API：获取时钟频率

参数

[in]	soc	SOC对象指针
[in]	id	时钟ID
[out]	buf	返回时钟频率的缓冲区的指针
[in,out]	num	指向缓冲区的指针，此缓冲区： (I) 作为输入时，表示缓冲区数组的数量 (O) 作为输出时，返回实际的频率数据的数量

返回

错误码

返回值

XWOK	没有错误
-EFAULT	无效指针
-ERANGE	时钟ID错误
-ENOSYS	不支持的API

注解

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

<No error

在文件 clock.c 第 83 行定义.

{
        const struct xwds_soc_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((id < soc->clk.num), "out-of-range", -ERANGE);
        XWDS_VALIDATE(buf, "nullptr", -EFAULT);
        XWDS_VALIDATE(num, "nullptr", -EFAULT);
 
        rc = xwds_soc_grab(soc);
        if (rc < 0) {
                goto err_soc_grab;
        }
 
        drv = xwds_cast(struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->clk_getfqcy)) {
                rc = drv->clk_getfqcy(soc, id, buf, num);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_getfqcy;
        }
 
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_getfqcy:
        xwds_soc_put(soc);
err_soc_grab:
        return rc;
}

函数调用图:

xwds_clk_rls()

xwer_t xwds_clk_rls	(	struct xwds_soc *	soc,
		xwid_t	id
	)

XWDS API：释放时钟

参数

[in]	soc	SOC对象指针
[in]	id	时钟ID

返回

错误码

返回值

XWOK	没有错误
-ERANGE	时钟ID错误
-ENOSYS	不支持的API

注解

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

<No error

在文件 clock.c 第 57 行定义.

{
        const struct xwds_soc_driver * drv;
        xwer_t rc;
 
        XWDS_VALIDATE(soc, "nullptr", -EFAULT);
        XWDS_VALIDATE((id < soc->clk.num), "out-of-range", -ERANGE);
 
        drv = xwds_cast(struct xwds_soc_driver *, soc->dev.drv);
        if ((drv) && (drv->clk_rls)) {
                rc = drv->clk_rls(soc, id);
        } else {
                rc = -ENOSYS;
        }
        if (rc < 0) {
                goto err_drv_clk_rls;
        }
 
        xwds_soc_put(soc);
        return XWOK;
 
err_drv_clk_rls:
        return rc;
}

函数调用图: