/* dma.h -- Definition of types and structures for DMA
|
/* dma.h -- Definition of types and structures for DMA
|
Copyright (C) 2001 by Erez Volk, erez@opencores.org
|
Copyright (C) 2001 by Erez Volk, erez@opencores.org
|
|
|
This file is part of OpenRISC 1000 Architectural Simulator.
|
This file is part of OpenRISC 1000 Architectural Simulator.
|
|
|
This program is free software; you can redistribute it and/or modify
|
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
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 2 of the License, or
|
the Free Software Foundation; either version 2 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program; if not, write to the Free Software
|
along with this program; if not, write to the Free Software
|
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
*/
|
*/
|
|
|
|
#include "dma_defs.h"
|
|
|
/* Exported function prototypes */
|
/* Exported function prototypes */
|
void dma_reset( void );
|
void dma_reset( void );
|
void dma_clock( void );
|
void dma_clock( void );
|
void dma_status( void );
|
void dma_status( void );
|
|
|
void set_dma_req_i( unsigned dma_controller, unsigned channel );
|
void set_dma_req_i( unsigned dma_controller, unsigned channel );
|
void clear_dma_req_i( unsigned dma_controller, unsigned channel );
|
void clear_dma_req_i( unsigned dma_controller, unsigned channel );
|
void set_dma_nd_i( unsigned dma_controller, unsigned channel );
|
void set_dma_nd_i( unsigned dma_controller, unsigned channel );
|
void clear_dma_nd_i( unsigned dma_controller, unsigned channel );
|
void clear_dma_nd_i( unsigned dma_controller, unsigned channel );
|
unsigned check_dma_ack_o( unsigned dma_controller, unsigned channel );
|
unsigned check_dma_ack_o( unsigned dma_controller, unsigned channel );
|
|
|
/* Number of channel per DMA controller */
|
|
#define DMA_NUM_CHANNELS 31
|
|
|
|
|
|
/* Address space required by one DMA controller */
|
|
#define DMA_ADDR_SPACE 0x400
|
|
|
|
/* Relative Register Addresses */
|
|
#define DMA_CSR 0x00
|
|
#define DMA_INT_MSK_A 0x04
|
|
#define DMA_INT_MSK_B 0x08
|
|
#define DMA_INT_SRC_A 0x0C
|
|
#define DMA_INT_SRC_B 0x10
|
|
|
|
/* Channel registers definitions */
|
|
#define DMA_CH_BASE 0x20 /* Offset of first channel registers */
|
|
#define DMA_CH_SIZE 0x20 /* Per-channel address space */
|
|
|
|
/* Per-channel Register Addresses, relative to channel start */
|
|
#define DMA_CH_CSR 0x00
|
|
#define DMA_CH_SZ 0x04
|
|
#define DMA_CH_A0 0x08
|
|
#define DMA_CH_AM0 0x0C
|
|
#define DMA_CH_A1 0x10
|
|
#define DMA_CH_AM1 0x14
|
|
#define DMA_CH_DESC 0x18
|
|
#define DMA_CH_SWPTR 0x1C
|
|
|
|
/* Field Definitions for the Main CSR */
|
|
#define DMA_CSR_PAUSE_OFFSET 0
|
|
|
|
/* Field Definitions for the Channel CSR(s) */
|
|
#define DMA_CH_CSR_CH_EN_OFFSET 0
|
|
#define DMA_CH_CSR_DST_SEL_OFFSET 1
|
|
#define DMA_CH_CSR_SRC_SEL_OFFSET 2
|
|
#define DMA_CH_CSR_INC_DST_OFFSET 3
|
|
#define DMA_CH_CSR_INC_SRC_OFFSET 4
|
|
#define DMA_CH_CSR_MODE_OFFSET 5
|
|
#define DMA_CH_CSR_ARS_OFFSET 6
|
|
#define DMA_CH_CSR_USE_ED_OFFSET 7
|
|
#define DMA_CH_CSR_SZ_WB_OFFSET 8
|
|
#define DMA_CH_CSR_STOP_OFFSET 9
|
|
#define DMA_CH_CSR_BUSY_OFFSET 10
|
|
#define DMA_CH_CSR_DONE_OFFSET 11
|
|
#define DMA_CH_CSR_ERR_OFFSET 12
|
|
#define DMA_CH_CSR_PRIORITY_OFFSET 13
|
|
#define DMA_CH_CSR_PRIORITY_WIDTH 3
|
|
#define DMA_CH_CSR_REST_EN_OFFSET 16
|
|
#define DMA_CH_CSR_INE_ERR_OFFSET 17
|
|
#define DMA_CH_CSR_INE_DONE_OFFSET 18
|
|
#define DMA_CH_CSR_INE_CHK_DONE_OFFSET 19
|
|
#define DMA_CH_CSR_INT_ERR_OFFSET 20
|
|
#define DMA_CH_CSR_INT_DONE_OFFSET 21
|
|
#define DMA_CH_CSR_INT_CHUNK_DONE_OFFSET 22
|
|
#define DMA_CH_CSR_RESERVED_OFFSET 23
|
|
#define DMA_CH_CSR_RESERVED_WIDTH 9
|
|
|
|
/* Masks -- Writable and readonly parts of the register */
|
|
#define DMA_CH_CSR_WRITE_MASK 0x000FE3FF
|
|
|
|
/* Field definitions for Channel Size Registers */
|
|
#define DMA_CH_SZ_TOT_SZ_OFFSET 0
|
|
#define DMA_CH_SZ_TOT_SZ_WIDTH 12
|
|
#define DMA_CH_SZ_CHK_SZ_OFFSET 16
|
|
#define DMA_CH_SZ_CHK_SZ_WIDTH 9
|
|
|
|
/* Field definitions for Channel Address Registers CHn_Am */
|
|
#define DMA_CH_A0_ADDR_OFFSET 2
|
|
#define DMA_CH_A0_ADDR_WIDTH 30
|
|
#define DMA_CH_A1_ADDR_OFFSET 2
|
|
#define DMA_CH_A1_ADDR_WIDTH 30
|
|
|
|
/* Field definitions for Channel Address Mask Registers CHn_AMm */
|
|
#define DMA_CH_AM0_MASK_OFFSET 4
|
|
#define DMA_CH_AM0_MASK_WIDTH 28
|
|
#define DMA_CH_AM1_MASK_OFFSET 4
|
|
#define DMA_CH_AM1_MASK_WIDTH 28
|
|
|
|
/* Field definitions for Channel Linked List descriptor Pointer CHn_DESC */
|
|
#define DMA_CH_DESC_ADDR_OFFSET 2
|
|
#define DMA_CH_DESC_ADDR_WIDTH 30
|
|
|
|
/* Field definitions for Channel Software Pointer */
|
|
#define DMA_CH_SWPTR_PTR_OFFSET 2
|
|
#define DMA_CH_SWPTR_PTR_WIDTH 29
|
|
#define DMA_CH_SWPTR_EN_OFFSET 31
|
|
|
|
|
|
/* Structure of linked list descriptors (offsets of elements) */
|
|
#define DMA_DESC_CSR 0x00
|
|
#define DMA_DESC_ADR0 0x04
|
|
#define DMA_DESC_ADR1 0x08
|
|
#define DMA_DESC_NEXT 0x0C
|
|
|
|
/* Field definitions for linked list descriptor DESC_CSR */
|
|
#define DMA_DESC_CSR_EOL_OFFSET 20
|
|
#define DMA_DESC_CSR_INC_SRC_OFFSET 19
|
|
#define DMA_DESC_CSR_INC_DST_OFFSET 18
|
|
#define DMA_DESC_CSR_SRC_SEL_OFFSET 17
|
|
#define DMA_DESC_CSR_DST_SEL_OFFSET 16
|
|
#define DMA_DESC_CSR_TOT_SZ_OFFSET 0
|
|
#define DMA_DESC_CSR_TOT_SZ_WIDTH 12
|
|
|
|
|
|
/* Implementation of DMA Channel Registers and State */
|
/* Implementation of DMA Channel Registers and State */
|
struct dma_channel
|
struct dma_channel
|
{
|
{
|
/* The controller we belong to */
|
/* The controller we belong to */
|
struct dma_controller *controller;
|
struct dma_controller *controller;
|
|
|
/* Our channel number and bit mask */
|
/* Our channel number and bit mask */
|
unsigned channel_number;
|
unsigned channel_number;
|
unsigned long channel_mask;
|
unsigned long channel_mask;
|
|
|
/* Used for dump, to save dumping all 32 channels */
|
/* Used for dump, to save dumping all 32 channels */
|
unsigned referenced;
|
unsigned referenced;
|
|
|
/* Inner state of transfer etc. */
|
/* Inner state of transfer etc. */
|
unsigned load_next_descriptor_when_done;
|
unsigned load_next_descriptor_when_done;
|
unsigned long current_descriptor;
|
unsigned long current_descriptor;
|
unsigned long source, destination, source_mask, destination_mask;
|
unsigned long source, destination, source_mask, destination_mask;
|
unsigned long chunk_size, total_size, words_transferred;
|
unsigned long chunk_size, total_size, words_transferred;
|
|
|
/* The interface registers */
|
/* The interface registers */
|
struct
|
struct
|
{
|
{
|
unsigned long csr;
|
unsigned long csr;
|
unsigned long sz;
|
unsigned long sz;
|
unsigned long a0;
|
unsigned long a0;
|
unsigned long am0;
|
unsigned long am0;
|
unsigned long a1;
|
unsigned long a1;
|
unsigned long am1;
|
unsigned long am1;
|
unsigned long desc;
|
unsigned long desc;
|
unsigned long swptr;
|
unsigned long swptr;
|
} regs;
|
} regs;
|
|
|
/* Some control signals */
|
/* Some control signals */
|
unsigned dma_req_i;
|
unsigned dma_req_i;
|
unsigned dma_ack_o;
|
unsigned dma_ack_o;
|
unsigned dma_nd_i;
|
unsigned dma_nd_i;
|
};
|
};
|
|
|
|
|
/* Implementation of DMA Controller Registers and State */
|
/* Implementation of DMA Controller Registers and State */
|
struct dma_controller
|
struct dma_controller
|
{
|
{
|
/* Base address in memory */
|
/* Base address in memory */
|
oraddr_t baseaddr;
|
oraddr_t baseaddr;
|
|
|
/* Which interrupt number we generate */
|
/* Which interrupt number we generate */
|
unsigned irq;
|
unsigned irq;
|
|
|
/* Controller Registers */
|
/* Controller Registers */
|
struct
|
struct
|
{
|
{
|
unsigned long csr;
|
unsigned long csr;
|
unsigned long int_msk_a;
|
unsigned long int_msk_a;
|
unsigned long int_msk_b;
|
unsigned long int_msk_b;
|
unsigned long int_src_a;
|
unsigned long int_src_a;
|
unsigned long int_src_b;
|
unsigned long int_src_b;
|
} regs;
|
} regs;
|
|
|
/* Channels */
|
/* Channels */
|
struct dma_channel ch[DMA_NUM_CHANNELS];
|
struct dma_channel ch[DMA_NUM_CHANNELS];
|
};
|
};
|
|
|