Subversion Repositories funbase_ip_library

// **************************************************************************
// File             : sdram_drv.h
// Authors          : Antti Kojo
// Date             : 12.06.2009
// Decription       : SDRAM contoller driver for eCos
// Version history  : 12.06.2009    ank    Original version
// **************************************************************************
 
#ifndef SDRAM_H
#define SDRAM_H
 
#include "types.h"
 
/* CPU uses these HIBI addresses when receiving mem_ctrl_offset or data from
   SDRAM. Offset is added to CPU's HIBI base address. */
#define HIBI_ADDRESS_OFFSET_FOR_SDRAM  (0x600)
#define SDRAM_CONF_CHANNEL_ADDR        (HIBI_ADDRESS_OFFSET_FOR_SDRAM + 1)
#define SDRAM_DATA_CHANNEL_ADDR        (HIBI_ADDRESS_OFFSET_FOR_SDRAM + 2)
 
/* parameters used with configuration function */
#define SDRAM_READ_OPERATION           (0)
#define SDRAM_WRITE_OPERATION          (1)
 
 
/* Call this init-function before using other functions. */
void sdram_init(const uint32 sdram_hibi_addr);
 
 
 
 
 
 
/* This function, sdram_config, configures SDRAM controller 
   for read and write operations. 
 
 * Parameters:
 
   sdram_byte_addr:      SDRAM byte address for read and write operations
 
   words:                Amount of words to read/write
 
   operation:            Use parameter SDRAM_WRITE_OPERATION when writing and 
                         SDRAM_READ_OPERATION when reading.
 
   read_chn_addr:        In case of read operation, data from SDRAM will be
                         written to this hibi address. In case of write
                         operation, this parameter is not used.
 
   row_count_and_stride: This parameter is used when reading/writing
                         rectangular memory areas.
 
 
 * Return:
 
   In case of write operation, this function returns HIBI address where 
   the data should be written.
 
*/
uint32 sdram_config( const uint32 sdram_byte_addr,
		     const uint32 words,
		     const uint8  operation,
		     const uint32 read_chn_addr,
		     const uint32 row_count_and_stride );
 
 
 
 
/* This function, sdram_write, writes data to SDRAM 
 
 * Parameters:
 
   src:           Pointer to source data 
   sdram_addr:    SDRAM target address
   words:         Amount of data words
 
*/
bool sdram_write( uint32* const src, 
		  const uint32 sdram_addr,
		  const uint32 words );
 
 
 
 
 
 
/* This function, sdram_read, reads data from SDRAM.
   This is non-blocking read. After function returns,
   reading from SDRAM is in progress. User of this
   function has to declare sdram_rx_end-function
   which is called after data has been received.
 
 * Parameters:
 
   sdram_addr:    SDRAM source address
   words:         Amount of data words
 
*/
void sdram_read( const uint32 sdram_addr,
		 const uint32 words );
 
 
 
#endif