libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues Releases Wiki Activity
rt-thread-official/bsp/x1000/drivers/dma.h

156 lines
6.3 KiB
C
Raw Normal View History

[bsp]update x1000 bsp driver
2017-11-11 13:51:56 +08:00
/*
* 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_ */