/*---------------------------------------------------------------------------*
  Project:  TwlSDK - MI
  File:     mi_dma.h

  Copyright 2003-2008 Nintendo.  All rights reserved.

  These coded instructions, statements, and computer programs contain
  proprietary information of Nintendo of America Inc. and/or Nintendo
  Company Ltd., and are protected by Federal copyright law.  They may
  not be disclosed to third parties or copied or duplicated in any form,
  in whole or in part, without the prior written consent of Nintendo.

  $Date:: 2008-09-18#$
  $Rev: 8573 $
  $Author: okubata_ryoma $
 *---------------------------------------------------------------------------*/
#ifndef NITRO_COMMON_MI_DMA_H_
#define NITRO_COMMON_MI_DMA_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <nitro.h>

//================================================================================
//          DMA system work
//================================================================================
#ifdef SDK_ARM9
# define MIi_DMA_CLEAR_DATA_BUF    REG_DMA0_CLR_DATA_ADDR      // ARM9-TS:  defined ARM9/ioreg_MI.h
#else  // ifdef SDK_ARM9
# define MIi_DMA_CLEAR_DATA_BUF     HW_PRV_WRAM_DMA_CLEAR_DATA_BUF      // ARM7:  defined ARM7/mmap_wram.h
#endif // ifdef SDK_ARM9

typedef union
{
    u32     b32;
    u16     b16;
}
MIiDmaClearSrc;

//================================================================================
//          setting DMA
//================================================================================
//---------------- set parameters
#define MIi_DMA_MODE_NOINT		1
#define MIi_DMA_MODE_WAIT		2
#define MIi_DMA_MODE_NOCLEAR	4
#define MIi_DMA_MODE_SRC32      0x10
#define MIi_DMA_MODE_SRC16      0x20

void MIi_DmaSetParameters(u32 dmaNo, u32 src, u32 dest, u32 ctrl, u32 mode);

//================================================================================
//          CALLBACK
//================================================================================
extern void OSi_EnterDmaCallback(u32 dmaNo, MIDmaCallback callback, void *arg);

static inline void MIi_CallCallback(MIDmaCallback callback, void *arg)
{
    if (callback)
    {
        (callback) (arg);
    }
}

//================================================================================
//          WAIT
//================================================================================
//----------------------------------------------------------------
//     for waiting DMA busy
#define MIi_Wait_BeforeDMA( dmaCntp, dmaNo )                  \
    do {                                                      \
      dmaCntp = &((vu32*)REG_DMA0SAD_ADDR)[dmaNo * 3 + 2];    \
      MIi_ASSERT_DMANO( dmaNo );                              \
      while ( *dmaCntp & REG_MI_DMA0CNT_E_MASK ) {}           \
    }while(0)

#define MIi_Wait_AfterDMA( dmaCntp )                          \
    do {                                                      \
      while ( *dmaCntp & REG_MI_DMA0CNT_E_MASK ) {}           \
    }while(0)


//================================================================================
//         ASSERT
//================================================================================
#define MIi_ASSERT_DMANO( dmaNo )        SDK_ASSERTMSG( (dmaNo) <= MI_DMA_MAX_NUM, "illegal DMA No." )
#define MIi_ASSERT_MUL2( size )          SDK_ASSERTMSG( ((size) & 1) == 0, "size & 1 must be 0" )
#define MIi_ASSERT_MUL4( size )          SDK_ASSERTMSG( ((size) & 3) == 0, "size & 3 must be 0" )
#define MIi_ASSERT_SRC_ALIGN512( src )   SDK_ASSERTMSG( ((u32)(src) & 511) == 0, "source address must be in 512-byte alignment" )
#define MIi_ASSERT_SRC_ALIGN4( src )     SDK_ASSERTMSG( ((u32)(src) & 3) == 0, "source address must be in 4-byte alignment" )
#define MIi_ASSERT_SRC_ALIGN2( src )     SDK_ASSERTMSG( ((u32)(src) & 1) == 0, "source address must be in 2-byte alignment" )
#define MIi_ASSERT_DEST_ALIGN4( dest )   SDK_ASSERTMSG( ((u32)(dest) & 3) == 0, "destination address must be in 4-byte alignment" )
#define MIi_ASSERT_DEST_ALIGN2( dest )   SDK_ASSERTMSG( ((u32)(dest) & 1) == 0, "destination address must be in 2-byte alignment" )

#ifdef SDK_ARM9
#  define MIi_ASSERT_SIZE( dmaNo, size ) SDK_ASSERTMSG( (size) <= 0x1fffff, "size too large" );
#else  //SDK_ARM7
#  define MIi_ASSERT_SIZE( dmaNo, size )                        \
    do{                                                         \
        if ( dmaNo <= 2 )                                       \
        {                                                       \
            SDK_ASSERTMSG( (size) <= 0x3fff, "size too large" );\
        }                                                       \
        else                                                    \
        {                                                       \
            SDK_ASSERTMSG( (size) <= 0xffff, "size too large" );\
        }                                                       \
    } while(0)
#endif


//================================================================================
//         CHECK
//================================================================================
//----------------------------------------------------------------
//      Check if specified area is in ITCM/DTCM.
//
#if defined( SDK_ARM9 ) && defined( SDK_DEBUG )
void    MIi_CheckAddressInTCM(u32 addr, u32 size);
#define MIi_WARNING_ADDRINTCM( addr, size )  MIi_CheckAddressInTCM( (u32)addr, (u32)size )
#else
#define MIi_WARNING_ADDRINTCM( addr, size )  ((void)0)
#endif


//----------------------------------------------------------------
//      for DMA check
//      (must avoid multiple auto start DMA)
//
#ifdef SDK_ARM9
void    MIi_CheckAnotherAutoDMA(u32 dmaNo, u32 dmaType);
#endif

//----------------------------------------------------------------
//      for DMA0 check
//       Source address which is in I/O register or cartridge bus
//       is not available.
void    MIi_CheckDma0SourceAddress(u32 dmaNo, u32 src, u32 size, u32 dir);

//================================================================================
//           dummy DMA for multi DMA problem
//================================================================================
#define MIi_DUMMY_DMA_NO   0
#define MIi_DUMMY_SRC      0
#define MIi_DUMMY_DEST     0
#define MIi_DUMMY_CNT      ( MI_DMA_ENABLE | MI_DMA_SRC_FIX | MI_DMA_DEST_FIX | MI_DMA_16BIT_BUS | 1 )

#ifdef __cplusplus
} /* extern "C" */
#endif

/* MI_COMMON_MI_DMA_H_ */
#endif