156 lines
6.3 KiB
C
156 lines
6.3 KiB
C
|
/*
|
|||
|
|
* File : dma.h
|
|||
|
|
* This file is part of RT-Thread RTOS
|
|||
|
|
* COPYRIGHT (C) 2008 - 2012, RT-Thread Development Team
|
|||
|
|
*
|
|||
|
|
* This program is free software; you can redistribute it and/or modify
|
|||
|
|
* it under the terms of the GNU General Public License as published by
|
|||
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|||
|
|
* (at your option) any later version.
|
|||
|
|
*
|
|||
|
|
* This program is distributed in the hope that it will be useful,
|
|||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|||
|
|
* GNU General Public License for more details.
|
|||
|
|
*
|
|||
|
|
* You should have received a copy of the GNU General Public License along
|
|||
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|||
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|||
|
|
*
|
|||
|
|
* Change Logs:
|
|||
|
|
* Date Author Notes
|
|||
|
|
* 2015-11-19 Urey the first version
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
#ifndef _DMA_H_
|
|||
|
|
#define _DMA_H_
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** ͷ<EFBFBD>ļ<EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
#include <stdlib.h>
|
|||
|
|
#include <rtdef.h>
|
|||
|
|
#include <rtthread.h>
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
extern "C"{
|
|||
|
|
#endif
|
|||
|
|
#define RT_DMA_CHANNEL(n) (n)
|
|||
|
|
#ifndef RT_DMA_MAX_NODES
|
|||
|
|
# define RT_DMA_MAX_NODES 8
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** DMA ״̬<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
#define RT_DMA_STATUS_IDLE 0 /* DMA <20><><EFBFBD>ڿ<EFBFBD><DABF><EFBFBD>ģʽ */
|
|||
|
|
#define RT_DMA_STATUS_BUSY 1 /* DMA <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڹ<EFBFBD><DAB9><EFBFBD> */
|
|||
|
|
#define RT_DMA_STATUS_ERROR 2 /* DMA <20><><EFBFBD>ڴ<EFBFBD><DAB4><EFBFBD>״̬ */
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** DMA <EFBFBD><EFBFBD>ַ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
#define RT_DMA_ADDR_INC 0 /* <20><>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ */
|
|||
|
|
#define RT_DMA_ADDR_FIX 1 /* <20><>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD> */
|
|||
|
|
#define RT_DMA_ADDR_DEC 2 /* <20><>ַ<EFBFBD><D6B7><EFBFBD>ٷ<EFBFBD>ʽ */
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** DMA <EFBFBD><EFBFBD><EFBFBD>䷽<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
#define RT_DMA_MEM_TO_MEM 0
|
|||
|
|
#define RT_DMA_MEM_TO_DEV 1
|
|||
|
|
#define RT_DMA_DEV_TO_MEM 2
|
|||
|
|
#define RT_DMA_DEV_TO_DEV 3
|
|||
|
|
#define RT_DMA_TRANS_NONE 4
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** DMA <EFBFBD><EFBFBD><EFBFBD>߿<EFBFBD><EFBFBD><EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
#define RT_DMA_BUSWIDTH_UNDEFINED 0
|
|||
|
|
#define RT_DMA_BUSWIDTH_1_BYTE 1
|
|||
|
|
#define RT_DMA_BUSWIDTH_2_BYTES 2
|
|||
|
|
#define RT_DMA_BUSWIDTH_4_BYTES 4
|
|||
|
|
#define RT_DMA_BUSWIDTH_8_BYTES 8
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** DMA <EFBFBD><EFBFBD><EFBFBD><EFBFBD> ʱ<EFBFBD><EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
#define RT_DMA_EVENT_COMPLETE 0x01
|
|||
|
|
#define RT_DMA_EVENT_ERROR 0x02
|
|||
|
|
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** <EFBFBD><EFBFBD><EFBFBD>ݽṹ
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
struct rt_dma_channel;
|
|||
|
|
struct dma_message;
|
|||
|
|
struct dma_config;
|
|||
|
|
struct dma_ops
|
|||
|
|
{
|
|||
|
|
void (*reset)(struct rt_dma_channel *dmac);
|
|||
|
|
rt_size_t (*trans)(struct rt_dma_channel *dmac,struct dma_message *message);
|
|||
|
|
int (*status)(struct rt_dma_channel *dmac);
|
|||
|
|
int (*configure)(struct rt_dma_channel *dmac,struct dma_config *config);
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
struct dma_message
|
|||
|
|
{
|
|||
|
|
rt_uint8_t *src_addr; /* Դ<>˻<EFBFBD><CBBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ */
|
|||
|
|
rt_uint8_t *dst_addr; /* Ŀ<>Ķ˻<C4B6><CBBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ */
|
|||
|
|
rt_uint8_t src_option; /* Դ<>˵<EFBFBD>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
|
|||
|
|
rt_uint8_t dst_option; /* Ŀ<>ĵ<EFBFBD>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
|
|||
|
|
rt_size_t t_size; /* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ֽ<EFBFBD><D6BD><EFBFBD> */
|
|||
|
|
|
|||
|
|
rt_uint32_t t_mode; /* <20><><EFBFBD><EFBFBD>ģʽ, <20>Զ<EFBFBD><D4B6><EFBFBD> */
|
|||
|
|
|
|||
|
|
void (*complete_cb)(void *data,void *pbuf);
|
|||
|
|
void *complete_arg;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
|
|||
|
|
struct dma_config
|
|||
|
|
{
|
|||
|
|
rt_uint32_t direction;
|
|||
|
|
rt_uint32_t src_addr_width;
|
|||
|
|
rt_uint32_t dst_addr_width;
|
|||
|
|
rt_uint32_t src_maxburst;
|
|||
|
|
rt_uint32_t dst_maxburst;
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
struct rt_dma_channel
|
|||
|
|
{
|
|||
|
|
int ch;
|
|||
|
|
rt_list_t list; /* channel list */
|
|||
|
|
|
|||
|
|
struct dma_config config;
|
|||
|
|
struct dma_ops *ops;
|
|||
|
|
|
|||
|
|
struct dma_message msg_list[RT_DMA_MAX_NODES];
|
|||
|
|
rt_uint16_t get_index;
|
|||
|
|
rt_uint16_t put_index;
|
|||
|
|
|
|||
|
|
void (*start)(struct rt_dma_channel *dmac,struct dma_message *msg); /* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD> */
|
|||
|
|
void (*complete)(struct rt_dma_channel *dmac,struct dma_message *msg); /* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> <20>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD> */
|
|||
|
|
|
|||
|
|
void *user_data; /* <20>Զ<EFBFBD><D4B6><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
|
|||
|
|
/*********************************************************************************************************
|
|||
|
|
** <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
|||
|
|
*********************************************************************************************************/
|
|||
|
|
rt_err_t rt_dma_drv_install(struct rt_dma_channel *dmac, struct dma_ops *ops,struct dma_config *config,void* user_data);
|
|||
|
|
struct rt_dma_channel *rt_dma_get_channel(int id);
|
|||
|
|
struct dma_message *rt_dma_get_current_message (struct rt_dma_channel *dmac);
|
|||
|
|
rt_err_t rt_dma_reset (struct rt_dma_channel *dmac);
|
|||
|
|
rt_err_t rt_dma_trans_message (struct rt_dma_channel *dmac,struct dma_message* message);
|
|||
|
|
rt_err_t rt_dma_configture (struct rt_dma_channel *dmac,struct dma_config *config);
|
|||
|
|
rt_err_t rt_dma_contex_service (struct rt_dma_channel *dmac,rt_uint32_t event);
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
}
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#endif /* _DMA_H_ */
|