全志R128 SDK HAL 模块开发指南——DMA Controller

DMA Controller

本文介绍RTOS 中DMA 驱动的接口及使用方法，为DMA 的使用者提供参考。

DMA 主要实现设备与设备、设备与 memory、memory 与 memory 之间的数据搬运与传输；BSP DMA 驱动主要实现设备驱动的底层细节，并为上层提供一套标准的 API 接口以供使用。

文档约定

数据说明
DRQSRC_XXX源 DRQ 号
DRQDST_XXX目的 DRQ 号

模块配置

Drivers Options —>
	soc related device drivers —>
    	DMA Devices —>
    		[*] enable dma driver
    		[*] 	enable dma hal API test command

源码结构

hal/source/dma/       ---- 驱动源码
├── hal_dma.c
├── Kconfig
├── Makefile
├── platform
│   └── dma-sun20iw3.h
├── platform-dma.h

include/hal/          ---- 驱动APIs声明头文件
└── hal_dma.h

驱动框架

在这里插入图片描述

模块接口说明

头文件：

#include <hal_dma.h>
#include <sunxi_hal_common.h>

申请 DMA 通道

函数原型：

hal_dma_chan_status_t hal_dma_chan_request(struct sunxi_dma_chan **dma_chan)

参数：

  • dma_chan: 存放 DMA 通道的指针变量

返回值：

  • HAL_DMA_CHAN_STATUS_BUSY: 申请失败
  • HAL_DMA_CHAN_STATUS_FREE: 申请成功

释放 DMA 通道

函数原型：

hal_dma_status_t hal_dma_chan_free(struct sunxi_dma_chan *chan)

参数：

  • chan: 要释放的 DMA 通道结构体指针变量

返回值：

  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

释放 DMA 通道描述符

函数原型：

hal_dma_status_t hal_dma_chan_desc_free(struct sunxi_dma_chan *chan)

参数：

  • chan: 要释放的 DMA 通道结构体指针变量

返回值：

  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

初始化环形 DMA 传输

函数原型：

hal_dma_status_t hal_dma_prep_cyclic(struct sunxi_dma_chan *chan, uint32_t buf_addr, uint32_t buf_len, uint32_t period_len, enum dma_transfer_direction dir)

参数：

  • chan:DMA 通道结构体指针变量
  • buf_addr: 数据缓冲区
  • buf_len: 数据缓冲区长度
  • period_len: 单次 DMA 搬运长度
  • dir:DMA 传输方向

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

初始化 memory to memory DMA 传输

函数原型：

hal_dma_status_t hal_dma_prep_memcpy(struct sunxi_dma_chan *chan, uint32_t dest, uint32_t src, uint32_t len)

参数：

  • chan:DMA 通道结构体指针变量
  • dest: 目的地址
  • src: 源地址
  • len: 传输长度

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

初始化通用 DMA 传输

函数原型：

hal_dma_status_t hal_dma_prep_device(struct sunxi_dma_chan *chan, uint32_t dest, uint32_t src, uint32_t len, enum dma_transfer_direction dir)

参数：

  • chan:DMA 通道结构体指针变量
  • dest: 目的地址
  • src: 源地址
  • len: 传输长度
  • dir:DMA 传输方向

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

注册 DMA 回调函数

函数原型：

hal_dma_status_t hal_dma_callback_install(struct sunxi_dma_chan *chan, dma_callback callback, void *callback_param)

参数：

  • chan:DMA 通道结构体指针变量
  • callback: 回调函数 handler
  • callback_param: 回调函数传参

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_OK: 成功

配置 DMA 描述符传输信息

函数原型：

hal_dma_status_t hal_dma_slave_config(struct sunxi_dma_chan *chan, struct dma_slave_config *config)

参数：

  • chan:DMA 通道结构体指针变量
  • config:DMA 描述符结构体指针变量

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_OK: 成功

获取 DMA 发送状态

函数原型：

enum dma_status hal_dma_tx_status(struct sunxi_dma_chan *chan, uint32_t *left_size)

参数：

  • chan:DMA 通道结构体指针变
  • left_size: 存放剩余长度的指针变量

返回值：

  • DMA_INVALID_PARAMETER: 参数非法
  • DMA_IN_PROGRESS: 正在进行
  • DMA_COMPLETE: 传输完成

启动 DMA 传输

函数原型：

hal_dma_status_t hal_dma_start(struct sunxi_dma_chan *chan)

参数：

  • chan:DMA 通道结构体指针变量

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

停止 DMA 传输

函数原型：

hal_dma_status_t hal_dma_stop(struct sunxi_dma_chan *chan)

参数：

  • chan:DMA 通道结构体指针变量

返回值：

  • HAL_DMA_STATUS_INVALID_PARAMETER: 参数非法
  • HAL_DMA_STATUS_ERROR: 失败
  • HAL_DMA_STATUS_OK: 成功

初始化 DMA 控制器驱动

函数原型：

void hal_dma_init(void)

参数：

  • 无

返回值：

  • 无

申请一致性内存

函数原型：

void *dma_alloc_coherent(size_t size)

参数：

  • size: 申请内存的大小

返回值：

  • ptr: 内存缓冲区指针

释放一致性内存

函数原型：

void dma_free_coherent(void *addr)

参数：

  • addr: 内存缓冲区指针

返回值：

  • 无

调试节点

  • menuconfig 选择测试文件CONFIG_HAL_TEST_DMA

  • s系统启动后执行hal_dma即可，若结果为 “PASS”, 则表明当前 DMA 基本功能是否正常

模块使用范例

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include <hal_log.h>
#include <hal_cmd.h>
#include <hal_mem.h>
#include <hal_cache.h>
#include <hal_dma.h>

#include <sunxi_hal_common.h>

#define DMA_TEST_LEN	1024
static void dma_test_cb(void *param)
{
	hal_log_info("DMA finished, callback to do something...\n");
}

int cmd_test_dma(int argc, char **argv)
{
	int ret, i;
	struct sunxi_dma_chan *hdma = NULL;
	char *buf1 = NULL,*buf2 = NULL;
	struct dma_slave_config config = {0};
	uint32_t size = 0;

	hal_log_info("run in dma test");

	buf2 = dma_alloc_coherent(DMA_TEST_LEN);
	buf1 = dma_alloc_coherent(DMA_TEST_LEN);

	if (buf1 == NULL) {
		hal_log_err("malloc buf1 error!");
		goto end;
	}

	if (buf2 == NULL) {
		hal_log_err("malloc buf2 error!");
		goto end;
	}

	memset(buf1, 0, DMA_TEST_LEN);
	memset(buf2, 0, DMA_TEST_LEN);

	for (i = 0;i < DMA_TEST_LEN; i++)
		buf1[i] = i & 0xff;

	hal_dcache_clean_invalidate((unsigned long)buf1, DMA_TEST_LEN);
	hal_dcache_clean_invalidate((unsigned long)buf2, DMA_TEST_LEN);

	/* request dma chan */
	ret = hal_dma_chan_request(&hdma);
	if (ret == HAL_DMA_CHAN_STATUS_BUSY) {
		hal_log_err("dma channel busy!");
		goto end;
	}

	/* register dma callback */
	ret = hal_dma_callback_install(hdma, dma_test_cb, hdma);
	if (ret != HAL_DMA_STATUS_OK) {
		hal_log_err("register dma callback failed!");
		goto end;
	}

	config.direction = DMA_MEM_TO_MEM;
	config.dst_addr_width = DMA_SLAVE_BUSWIDTH_8_BYTES;
	config.src_addr_width = DMA_SLAVE_BUSWIDTH_8_BYTES;
	config.dst_maxburst = DMA_SLAVE_BURST_16;
	config.src_maxburst = DMA_SLAVE_BURST_16;
	config.slave_id = sunxi_slave_id(DRQDST_SDRAM, DRQSRC_SDRAM);

	ret = hal_dma_slave_config(hdma, &config);

	if (ret != HAL_DMA_STATUS_OK) {
		hal_log_err("dma config error, ret:%d", ret);
		goto end;
	}

	ret = hal_dma_prep_memcpy(hdma, (unsigned long)buf2, (unsigned long)buf1, DMA_TEST_LEN);
	if (ret != HAL_DMA_STATUS_OK) {
		hal_log_err("dma prep error, ret:%d", ret);
		goto end;
	}

	ret = hal_dma_start(hdma);
	if (ret != HAL_DMA_STATUS_OK) {
		hal_log_err("dma start error, ret:%d", ret);
		goto end;
	}

	while (hal_dma_tx_status(hdma, &size)!= 0);

	ret = hal_dma_stop(hdma);
	if (ret != HAL_DMA_STATUS_OK) {
		hal_log_err("dma stop error, ret:%d", ret);
		goto end;
	}

	ret = hal_dma_chan_free(hdma);
	if (ret != HAL_DMA_STATUS_OK) {
		hal_log_err("dma free error, ret:%d", ret);
		goto end;
	}

	hal_dcache_invalidate((unsigned long)buf2, DMA_TEST_LEN);

	hal_log_info("src buf:\n");
	for (i = 0;i < DMA_TEST_LEN; i++) {
		if (i % 16 == 0)
			printf("\n");
		printf("%02x ", buf1[i]);
	}
	printf("\n\n\n");
	hal_log_info("dst buf:\n");
	for (i = 0;i < DMA_TEST_LEN; i++) {
		if (i % 16 == 0)
			printf("\n");
		printf("%02x ", buf2[i]);
	}
	printf("\n\n\n");

	if (memcmp(buf1, buf2, DMA_TEST_LEN) != 0)
		printf("dma test fail\n");
	else
		printf("dma test pass\n");

end:
	dma_free_coherent(buf1);
	dma_free_coherent(buf2);

	return 0;
}

FINSH_FUNCTION_EXPORT_CMD(cmd_test_dma, hal_dma, dma hal APIs tests)

常见问题

  1. 使用时出现数据搬运后数据为 0 的情况

    确保传输内存使用 dma_alloc_coherent 申请

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mfbz.cn/a/485670.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

如何使用C语言实现文件操作

如何使用C语言实现文件操作

目录 文件打开和关闭 函数原型 案例展示 1.引入头文件 2. 定义字符数组与打开文件 3. 检查文件打开情况 4. 读取与写入文件 5. 关闭文件与清理资源 总结 文件打开和关闭 在编写程序的时候&#xff0c;在打开⽂件的同时&#xff0c;都会返回⼀个FILE*的指针变量指向该…
阅读更多...
移动硬盘盒结合PD技术为电脑供电：一种便携高效的供电新方案

移动硬盘盒结合PD技术为电脑供电：一种便携高效的供电新方案

在数字化时代&#xff0c;电脑已经成为我们生活和工作中不可或缺的工具。而在电脑的使用过程中&#xff0c;供电问题一直是我们需要关注的重要方面。近年来&#xff0c;随着技术的不断进步&#xff0c;移动硬盘盒子与PD&#xff08;Power Delivery&#xff09;技术的结合&#…
阅读更多...
GA遗传算法和ALNS算法的区别(我的APS项目七)

GA遗传算法和ALNS算法的区别(我的APS项目七)

博主用最简单的方式告诉你遗传算法是什么&#xff0c;估计这是网上最简单的遗传算法入门教程了。首先我们先带入一个问题&#xff0c;我们要去9大城市旅游&#xff0c;想知道每个城市走一遍&#xff0c;总路程最短的出行顺序是什么&#xff1f; OK&#xff0c;题目我们已经明确…
阅读更多...
用eclipse创建Web项目，通过Servlet实现Web访问的功能。

用eclipse创建Web项目，通过Servlet实现Web访问的功能。

要使用Eclipse和Tomcat 10创建一个简单的Web项目&#xff0c;并通过Servlet实现Web访问功能&#xff0c;你需要遵循以下详细步骤&#xff1a; 1. 安装和配置Eclipse和Tomcat 10 确保你已经安装了Eclipse IDE for Java EE Developers和Tomcat 10。如果还没有安装&#xff0c;请…
阅读更多...
SpringAOP+自定义注解实现限制接口访问频率，利用滑动窗口思想Redis的ZSet（附带整个Demo）

SpringAOP+自定义注解实现限制接口访问频率，利用滑动窗口思想Redis的ZSet（附带整个Demo）

目录 1.创建切面 2.创建自定义注解 3.自定义异常类 4.全局异常捕获 5.Controller层 demo的地址&#xff0c;自行获取《《—————————————————————————— Spring Boot整合Aop面向切面编程实现权限校验&#xff0c;SpringAop自定义注解自定义异常全局…
阅读更多...
uniapp 打包后缺少maps模块和share模块的解决方案

uniapp 打包后缺少maps模块和share模块的解决方案

缺失maps模块 我的应用 | 高德控制台 缺失share模块 QQ互联管理中心 微信开放平台
阅读更多...
HTTPS总结

HTTPS总结

密码学基础 在正式讲解HTTPS协议之前&#xff0c;我们首先要知道一些密码学的知识。 明文&#xff1a; 明文指的是未被加密过的原始数据。 密文&#xff1a;明文被某种加密算法加密之后&#xff0c;会变成密文&#xff0c;从而确保原始数据的安全。密文也可以被解密&#xf…
阅读更多...
【嵌入式学习】Qtday03.24

【嵌入式学习】Qtday03.24

一、思维导图 二、练习 QMovie *mv new QMovie(":/Logo/giphy (2).gif");ui->label_5->setMovie(mv);ui->label_5->setScaledContents(true);mv->start();this->setWindowIcon(QIcon(":/Logo/bdf48b5198c8417da0e4fef6b72c5657.png"));/…
阅读更多...
dubbo项目利用反射来调用，减少配置

dubbo项目利用反射来调用，减少配置

dubbo项目中&#xff0c;需要定义一个dubboService注解完成类的调用 DubboService(group "net-hospital", version "1.0.0", interfaceClass ReflectionService.class)如果每个需要调用的类都要定义的话显得很复杂&#xff0c;很麻烦 优化方式&#xf…
阅读更多...
NO9 蓝桥杯单片机串口通信之进阶版

NO9 蓝桥杯单片机串口通信之进阶版

1 回顾 串口通信的代码编写结构还是与中断一样&#xff0c;不同的是&#xff1a; 初始中断函数条件涉及到串口通信相关的寄存器和定时器1相关的寄存器&#xff08;定时器1用于产生波特率&#xff09;&#xff0c;但初始条件中的中断寄存器只考虑串口通信而不考虑定时器1。 v…
阅读更多...
Python学习（一）

Python学习（一）

Python环境下载安装 安装略 验证安装结果与编写第一个Python程序
阅读更多...
MySQL学习笔记------SQL(1)

MySQL学习笔记------SQL(1)

关系型数据库&#xff08;RDBMS&#xff09; 建立在关系模型基础上&#xff0c;由多张相互连接的二维表组成的数据库 特点&#xff1a;使用表储存数据&#xff0c;格式统一&#xff0c;便于维护 使用SQL语言操作&#xff0c;标准统一&#xff0c;使用方便 SQL通用语法 SQL…
阅读更多...
【Java】this 与 super 关键字

【Java】this 与 super 关键字

目录 this 关键字基本使用 this关键字在继承中的使用 super关键字使用 super 和 this 的比较 this 关键字基本使用 this 关键字可以用来访问本类的属性、方法、构造器 this 用于区分当前类的属性和局部变量&#xff0c;this代表当前对象访问成员方法的语法&#xff1a;thi…
阅读更多...
Kruskal最小生成树【详细解释+动图图解】【sort中的cmp函数】 【例题：洛谷P3366 【模板】最小生成树】

Kruskal最小生成树【详细解释+动图图解】【sort中的cmp函数】 【例题：洛谷P3366 【模板】最小生成树】

文章目录 Kruskal算法简介Kruskal算法前置知识sort 中的cmp函数 算法思考样例详细示范与解释kruskal模版code↓ 例题&#xff1a;洛谷P3366 【模板】最小生成树code↓完结撒花QWQ Kruskal算法简介 K r u s k a l Kruskal Kruskal 是基于贪心算法的 M S T MST MST 算法&#xff…
阅读更多...
Vue 实现带拖动功能的时间轴

Vue 实现带拖动功能的时间轴

1.效果图 2. 当使用timeline-slider-vue组件时&#xff0c;你可以设置以下属性&#xff1a; date&#xff1a;用于设置时间轴滑块的初始日期&#xff0c;格式通常为 YYYY-MM-DD。 mask&#xff1a;一个布尔值&#xff0c;用于控制是否显示背景遮罩。 markDate&#xff1a;一…
阅读更多...
Verilog刷题笔记45

Verilog刷题笔记45

题目&#xff1a;Given the finite state machine circuit as shown, assume that the D flip-flops are initially reset to zero before the machine begins. Build this circuit. 解题&#xff1a; module top_module (input clk,input x,output z ); wire [2:0]size;dtou…
阅读更多...
台灯学生用多少瓦的灯泡比较好?学生适用的五款护眼台灯推荐！

台灯学生用多少瓦的灯泡比较好?学生适用的五款护眼台灯推荐！

对于广大学生而言&#xff0c;选择一款合适的台灯灯泡瓦数至关重要。合适的瓦数不仅能够确保充足而均匀的照明&#xff0c;避免眼睛疲劳&#xff0c;还能在一定程度上节省能源。那么&#xff0c;台灯学生用多少瓦的灯泡比较好呢&#xff1f;今天就给大家科普一下&#xff0c;顺…
阅读更多...
matlab实现遗传算法与蚁群算法

matlab实现遗传算法与蚁群算法

一、要求 1.利用matlab实现遗传算法和蚁群算法&#xff0c;解决相关问题 2.体会两种算法的具体作用 二、原理 &#xff08;1&#xff09;遗传算法&#xff1a; 不断循环&#xff0c;直到寻找出一个解 1. 检查每个染色体&#xff0c;看它解决问题的性能怎样&#xff0c;并…
阅读更多...
C# for/foreach 循环

C# for/foreach 循环

一个 for 循环是一个允许您编写一个执行特定次数的循环的重复控制结构。 语法 C# 中 for 循环的语法&#xff1a; for ( init; condition; increment ) {statement(s); } 下面是 for 循环的控制流&#xff1a; init 会首先被执行&#xff0c;且只会执行一次。这一步允许您声…
阅读更多...
【协议-HTTPS】

【协议-HTTPS】

https https是在http协议的基础上&#xff0c;添加了SSL/TLS握手以及数据加密传输&#xff0c;也属于应用层协议。 httpshttp加密认证完整性保护 https交互图&#xff1a; HTTPS的整体过程分为证书验证和数据传输阶段&#xff1a; ① 证书验证阶段 浏览器发起 HTTPS 请求 服务…
阅读更多...
最新文章

Copyright @ 2022~2023