r_xbus_api.h

/*
****************************************************************************
PROJECT : VLIB macro driver
FILE    : $Id: r_xbus_api.h 7640 2016-02-12 13:14:23Z florian.zimmermann $
============================================================================ 
DESCRIPTION
Generic part of the macro driver
============================================================================
                            C O P Y R I G H T
============================================================================
                       Copyright (c) 2013 - 2014
                                  by 
                       Renesas Electronics (Europe) GmbH. 
                           Arcadiastrasse 10
                          D-40472 Duesseldorf
                               Germany
                          All rights reserved.
============================================================================
Purpose: only for testing, not for mass production

DISCLAIMER

LICENSEE has read, understood and accepted the terms and conditions defined in
the license agreement, especially the usage rights. In any case, it is
LICENSEE's responsibility to make sure that any user of the software complies
with the terms and conditions of the signed license agreement.

SAMPLE CODE is not part of the licensed software, as such it must not be used in
mass-production applications. It can only be used for evaluation and
demonstration purposes at customer's premises listed in the signed license
agreement.
****************************************************************************
*/

#ifndef R_XBUS_API_H_
#define R_XBUS_API_H_

#ifdef __cplusplus
extern "C" {
#endif


/*******************************************************************************
  Title: XBUS Driver API 
  
  An application using XBUS should only need to include r_xbus_api.h
*/

/*******************************************************************************
  Section: Global Constants 
*/


/*******************************************************************************
  Constant:  R_XBUS_VERSION_HI and R_XBUS_VERSION_LO

  Driver version information  
*/

#define R_XBUS_VERSION_HI 0
#define R_XBUS_VERSION_LO 1

/*******************************************************************************
  Section: Global Types
*/

/*******************************************************************************
  Enum: r_xbus_Error_t

  XBUS macro driver error code.
  
  If an error occures these enums give information about the
  reason.

  Values:
  R_XBUS_ERR_OK           - No error
  R_XBUS_ERR_NG           - Unspecified error
*/

typedef enum
{
    R_XBUS_ERR_OK         = 0x00,
    R_XBUS_ERR_NG         ,
    R_XBUS_ERR_RANGE      ,
    R_XBUS_ERR_LOCKED     ,
    R_XBUS_ERR_NOTLOCKED  
} r_xbus_Error_t;

/*******************************************************************************
  Enum: r_xbus_AreaMode_t

  Access mode for an addres range (area) 

  Values:
    R_XBUS_AM_DIRECT    - direct    access
    R_XBUS_AM_CACHE     - cached    access
    R_XBUS_AM_BUFF      - buffered  access
    R_XBUS_AM_RESERVED  - do not use

*/
typedef enum {
    R_XBUS_AM_DIRECT = 0u,
    R_XBUS_AM_CACHE  = 1u,
    R_XBUS_AM_BUFF   = 2u,
    R_XBUS_AM_RESERVED 
} r_xbus_AreaMode_t; 

/*******************************************************************************
  Type: r_xbus_AreaCfg_t

  Configuraton settings for a given memory area. 
  Attention:   The settings only have effect if the area is enabled.  
               Otherwise only the direct access mode is set.           
 
  Values:
      Mode      - access mode       , see <r_xbus_AreaMode_t> 
      Enable    - enable            , boolean
      BaseAddr  - start ddress of the memory area          
      AddrMask  - addres mask for the area                 


*/
typedef struct {
    r_xbus_AreaMode_t   Mode; 
    uint8_t             Enable;     
    uint32_t            BaseAddr; 
    uint32_t            AddrMask; 
} r_xbus_AreaCfg_t; 


/*******************************************************************************
  Type: r_xbus_Cfg_t

  Configuraton of the AXI-Bus.
  A note about Wait Insertion: 
  It is strongly recommended to use this feature for debug purpose only and to
  disable the wait limit by setting this register to zero!

  Values:

    BuffFill;           - buffer fill method   , see: <r_xbus_BuffFill_t>    
    BuffPref;           - prefetch type        , see: <r_xbus_BuffPref_t>    
    CacheFill;          - cache fill method    , see: <r_xbus_BuffFill_t>    
    WaitInsertion;      - the upper limit of bus clock that the XBUS may request a wait. 
    AreaCfg[4];         - memory area configuration, see  <r_xbus_AreaCfg_t>
                          Note: Area 0/1 is cached or direct, area 2/3 is bufferd or direct, 
                          DO NOT MIX      
    xbusMasterAccess;   - xbus master access permission, see <r_xbus_MasterAccess_t>

*/
typedef struct {
    uint8_t               WaitInsertion; 
    uint8_t               SecRewrite; 
    r_xbus_AreaCfg_t      AreaCfg[4]; 
} r_xbus_Cfg_t; 



/*******************************************************************************
  Section: Global API Functions
*/

/*******************************************************************************
  Function: R_XBUS_GetVersionStr

  Get the driver version number in human readable form (string). 

  Parameters:
  void
  
  Returns:
  ReceiveString     - Pointer to receive string destination
  
*/

const int8_t * R_XBUS_GetVersionStr(void);

/*******************************************************************************
  Function: R_XBUS_GetMajorVersion

  Get the driver major version number. 

  Parameters:
  void
  
  Returns:
     - Major version number
  
*/

const uint16_t R_XBUS_GetMajorVersion(void); 

/*******************************************************************************
  Function: R_XBUS_GetMinorVersion

  Get the driver minor version number. 

  Parameters:
  void
  
  Returns:
     - Minor version number
  
*/

const uint16_t R_XBUS_GetMinorVersion(void); 

/*******************************************************************************
  Section: Global API Functions
*/

/*******************************************************************************
  Function: R_XBUS_Config

  Configure memory bus. 

  Parameters:
  Unit   - Instance number
  Cfg    - pointer to bus configuration, see <r_xbus_Cfg_t>
           Note: Area 0/1 is cached or direct, area 2/3 is bufferd or direct, 
                          DO NOT MIX   
   
  Returns:
  see: <r_xbus_Error_t>
*/
r_xbus_Error_t R_XBUS_Config(uint32_t Unit, r_xbus_Cfg_t * Cfg); 


/*******************************************************************************
  Function: R_XBUS_AreaConfig

  Configure one cache area  

  Parameters:
  Unit   - Instance number
  Area   - Index of the cache area 
  Cfg    - pointer to area configuration, see  <r_xbus_AreaCfg_t>
   
  Returns:
  see: <r_xbus_Error_t>
*/

r_xbus_Error_t R_XBUS_AreaConfig(uint32_t Unit, uint8_t Area, r_xbus_AreaCfg_t * Cfg); 

/*******************************************************************************
  Function: R_XBUS_SetMode

  Flush data on bus  
  
  Parameters:
  Unit       - Instance number
  Area       - selected memory area
  Mode       - access mode, see <r_xbus_AreaMode_t> 
   
  Returns:
  see: <r_xbus_Error_t>
*/
r_xbus_Error_t R_XBUS_SetMode(uint32_t Unit, uint8_t Area, r_xbus_AreaMode_t Mode); 

/*******************************************************************************
  Function: R_XBUS_Flush

  Flush the cache and/or buffer data on the x-bus. 
  The flush operation to be performed is depending on the parameters provided     
  
  Parameters:
  Unit       - Instance number
  FlushAddr  - What to flush  0: flush All
                              1: flush all Cache
                              2: flush all Buffer
                             >2: Flush address 
  FlushSize  - Size of the data to be flushed (starting from the given address >2) 
                
  Returns:
  void 
*/
void R_XBUS_Flush(uint32_t Unit, uint32_t FlushAddr, uint32_t FlushSize);

/*******************************************************************************
  Function: R_XBUS_Invalidate

  invalidate the whole cache. Note: pending data is not written.  
  Parameters:
  Unit       - Instance number
                 
  Returns:
  void 
*/

 r_xbus_Error_t R_XBUS_Invalidate(uint32_t Unit); 

/*******************************************************************************
  Function: R_XBUS_Init

  Driver init function.

  Parameters:
  Unit          - Macro instance number
 
  Returns:
  see: <r_xbus_Error_t>
*/

 r_xbus_Error_t R_XBUS_Init(uint32_t Unit);


/*******************************************************************************
  Function: R_XBUS_DeInit

  Driver deinit function.

  Parameters:
  Unit       - Macro Instance number

  Returns:
  see: <r_xbus_Error_t>
*/

 r_xbus_Error_t R_XBUS_DeInit(uint32_t Unit);


/*******************************************************************************
  Function: R_XBUS_SetErrorCallback

  Set a user function as error handler.
  
  When the driver detects any error, it will call this function.

  Parameters:
  ErrorCallback - Pointer to a user function
  
  Returns:
  void
*/

void R_XBUS_SetErrorCallback(void (*ErrorCallback )(uint32_t Unit, uint32_t Error));


/*******************************************************************************
  Function: R_XBUS_XCopy

  Copy data from <Src> to <Dst> until reaching source <End> address,
  This function is optimised for cached high-latency access over the XC Bus,
  such as VRAM, SDRA/B, Serial Flash on D1Lx and D1Mx.

  Parameters:
  Src   - Source address for copy operation
  Dst   - Destination address for copy operation
  End   - Source end address for copy operation
  
  Returns:
  void
*/
void R_XBUS_XCopy(uint32_t Src, uint32_t Dst, uint32_t End); 


#ifdef __cplusplus
}
#endif

#endif /* R_XBUS_API_H_  */