controller.c 文件参考

玄武设备栈：UART控制器 更多...

#include <xwcd/ds/standard.h>
#include <string.h>
#include <xwos/osal/lock/spinlock.h>
#include <xwos/osal/lock/mtx.h>
#include <xwos/osal/sync/sem.h>
#include <xwcd/ds/uart/controller.h>

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

浏览源代码.

函数
static xwer_t	xwds_uartc_vop_probe (struct xwds_uartc *uartc)
	XWDS VOP：探测UART控制器
static xwer_t	xwds_uartc_vop_remove (struct xwds_uartc *uartc)
	XWDS VOP：移除UART控制器
static xwer_t	xwds_uartc_vop_start (struct xwds_uartc *uartc)
	XWDS VOP：启动UART控制器
static xwer_t	xwds_uartc_vop_stop (struct xwds_uartc *uartc)
	XWDS VOP：停止UART控制器
static xwer_t	xwds_uartc_vop_suspend (struct xwds_uartc *uartc)
	XWDS VOP：暂停UART控制器
static xwer_t	xwds_uartc_vop_resume (struct xwds_uartc *uartc)
	XWDS VOP：继续UART控制器
void	xwds_uartc_construct (struct xwds_uartc *uartc)
	XWDS API：UART控制器的构造函数
void	xwds_uartc_destruct (struct xwds_uartc *uartc)
	XWDS API：UART控制器对象的析构函数
xwer_t	xwds_uartc_grab (struct xwds_uartc *uartc)
	增加对象的引用计数
xwer_t	xwds_uartc_put (struct xwds_uartc *uartc)
	减少对象的引用计数
xwer_t	xwds_uartc_rx (struct xwds_uartc *uartc, xwu8_t *buf, xwsz_t *size, xwtm_t to)
	XWDS API：从接收队列中获取数据
xwer_t	xwds_uartc_try_rx (struct xwds_uartc *uartc, xwu8_t *buf, xwsz_t *size)
	XWDS API：尝试从接收队列中获取数据
xwer_t	xwds_uartc_tx (struct xwds_uartc *uartc, const xwu8_t *data, xwsz_t *size, xwtm_t to)
	XWDS API：同步发送
xwer_t	xwds_uartc_eq (struct xwds_uartc *uartc, const xwu8_t *data, xwsz_t *size, xwds_uartc_eqcb_f cb)
	XWDS API：异步发送
xwer_t	xwds_uartc_putc (struct xwds_uartc *uartc, const xwu8_t byte, xwtm_t to)
	XWDS API：直接发送一个字节（非DMA模式）
xwer_t	xwds_uartc_cfg (struct xwds_uartc *uartc, const struct xwds_uart_cfg *cfg)
	XWDS API：配置UART
void	xwds_uartc_drvcb_rxq_flush (struct xwds_uartc *uartc)
	XWDS Driver Callback：清空接收队列
xwsq_t	xwds_uartc_drvcb_rxq_fill (struct xwds_uartc *uartc, xwu8_t bytes[], xwsz_t size)
	XWDS Driver Callback：从UART硬件接收数据到缓冲区
void	xwds_uartc_drvcb_rxq_pub (struct xwds_uartc *uartc, xwsq_t pub)
	XWDS Driver Callback：发布数据到接收队列

变量
const struct xwds_virtual_operation	xwds_uartc_vop

详细描述

玄武设备栈：UART控制器

作者

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

注解

• 方案1：
  • 中断优先级：定时器中断的优先级 == DMA中断的优先级
  • 定时器中断函数与DMA中断函数运行在同一个CPU上
• 方案2：
  • 中断优先级：定时器中断的优先级 < DMA半完成与完成中断的优先级
  • 定时器中断中，获取DMA剩余计数前关闭DMA中断或总中断开关
  • 定时器中断函数与DMA中断函数运行在同一个CPU上

在文件 controller.c 中定义.

函数说明

xwds_uartc_vop_probe()

static xwer_t xwds_uartc_vop_probe ( struct xwds_uartc *  uartc )

static

XWDS VOP：探测UART控制器

参数

[in]

uartc

UART控制器对象指针

<No error

在文件 controller.c 第 115 行定义.

{
        xwer_t rc;
 
        xwos_splk_init(&uartc->rxq.lock);
        rc = xwos_sem_init(&uartc->rxq.sem, 0, 1);
        if (rc < 0) {
                goto err_sem_init;
        }
        rc = xwos_mtx_init(&uartc->txmtx, XWOS_SKD_PRIORITY_RT_MIN);
        if (rc < 0) {
                goto err_txmtx_init;
        }
        rc = xwds_device_vop_probe(&uartc->dev);
        if (rc < 0) {
                goto err_dev_probe;
        }
        return XWOK;
 
err_dev_probe:
        xwos_mtx_fini(&uartc->txmtx);
err_txmtx_init:
        xwos_sem_fini(&uartc->rxq.sem);
err_sem_init:
        return rc;
}

函数调用图:

xwds_uartc_vop_remove()

static xwer_t xwds_uartc_vop_remove ( struct xwds_uartc *  uartc )

static

XWDS VOP：移除UART控制器

参数

[in]

uartc

UART控制器对象指针

<No error

在文件 controller.c 第 147 行定义.

{
        xwer_t rc;
 
        rc = xwds_device_vop_remove(&uartc->dev);
        if (rc < 0) {
                goto err_dev_vop_remove;
        }
 
        xwos_mtx_fini(&uartc->txmtx);
        xwos_sem_fini(&uartc->rxq.sem);
        return XWOK;
 
err_dev_vop_remove:
        return rc;
}

函数调用图:

xwds_uartc_vop_resume()

static xwer_t xwds_uartc_vop_resume ( struct xwds_uartc *  uartc )

static

XWDS VOP：继续UART控制器

参数

[in]

uartc

UART控制器对象指针

在文件 controller.c 第 215 行定义.

{
        xwer_t rc;
 
        memset(uartc->rxq.mem, 0, sizeof(uartc->rxq.mem));
        uartc->rxq.pos = 0;
        uartc->rxq.tail = 0;
        rc = xwds_device_vop_resume(&uartc->dev);
        return rc;
}

函数调用图:

xwds_uartc_vop_start()

static xwer_t xwds_uartc_vop_start ( struct xwds_uartc *  uartc )

static

XWDS VOP：启动UART控制器

参数

[in]

uartc

UART控制器对象指针

在文件 controller.c 第 169 行定义.

{
        xwer_t rc;
 
        memset(uartc->rxq.mem, 0, sizeof(uartc->rxq.mem));
        uartc->rxq.pos = 0;
        uartc->rxq.tail = 0;
        uartc->rxq.idx = 0;
 
        rc = xwds_device_vop_start(&uartc->dev);
        return rc;
}

函数调用图:

xwds_uartc_vop_stop()

static xwer_t xwds_uartc_vop_stop ( struct xwds_uartc *  uartc )

static

XWDS VOP：停止UART控制器

参数

[in]

uartc

UART控制器对象指针

在文件 controller.c 第 187 行定义.

{
        xwer_t rc;
 
        rc = xwds_device_vop_stop(&uartc->dev);
        return rc;
}

函数调用图:

xwds_uartc_vop_suspend()

static xwer_t xwds_uartc_vop_suspend ( struct xwds_uartc *  uartc )

static

XWDS VOP：暂停UART控制器

参数

[in]

uartc

UART控制器对象指针

在文件 controller.c 第 202 行定义.

{
        xwer_t rc;
 
        rc = xwds_device_vop_suspend(&uartc->dev);
        return rc;
}

函数调用图:

变量说明

xwds_uartc_vop

const struct xwds_virtual_operation xwds_uartc_vop

初始值:

= {
        .probe = (void *)xwds_uartc_vop_probe,
        .remove = (void *)xwds_uartc_vop_remove,
        .start = (void *)xwds_uartc_vop_start,
        .stop = (void *)xwds_uartc_vop_stop,
 
        .suspend = (void *)xwds_uartc_vop_suspend,
        .resume = (void *)xwds_uartc_vop_resume,
 
}

在文件 controller.c 第 56 行定义.