MI_DmaFill*

構文

#include <nitro/mi.h>

void MI_DmaFill32( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u32 data,
　　　　　　　　　　u32 size );

void MI_DmaFill32_SetUp( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u32 data,
　　　　　　　　　　u32 size );

void MI_DmaFill16( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u16 data,
　　　　　　　　　　u32 size );

void MI_DmaFill16_SetUp( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u16 data,
　　　　　　　　　　u32 size );

void MI_DmaFill32Async( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u32 data,
　　　　　　　　　　u32 size,
　　　　　　　　　　MIDmaCallback callback,
　　　　　　　　　　void* arg );

void MI_DmaFill32Async_SetUp( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u32 data,
　　　　　　　　　　u32 size,
　　　　　　　　　　MIDmaCallback callback,
　　　　　　　　　　void* arg );

void MI_DmaFill16Async( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u16 data,
　　　　　　　　　　u32 size,
　　　　　　　　　　MIDmaCallback callback,
　　　　　　　　　　void* arg );

void MI_DmaFill16Async_SetUp( u32 dmaNo,
　　　　　　　　　　void* dest,
　　　　　　　　　　u16 data,
　　　　　　　　　　u32 size,
　　　　　　　　　　MIDmaCallback callback,
　　　　　　　　　　void* arg );

引数

返り値

なし。

説明

DMA を用いて、メモリを指定のデータで埋めます。

*_SetUp() は実際にはDMAを行なわず、その設定のみを行います。実際のDMA開始は MI_DmaRestart() を呼んで下さい。

MI_DmaFill16*() は 16ビット単位でメモリを指定のデータで埋めます。転送先アドレスは2バイトアラインメントする必要があります。
MI_DmaFill32*() は 32ビット単位でメモリを指定のデータで埋めます。転送先アドレスは4バイトアラインメントする必要があります。

MI_DmaFill16(), MI_DmaFill32() はDMAの終了を関数内で待ちます。
MI_DmaFill16Async*(), MI_DmaFill32Async*() は、DMA終了時にコールバック callback を呼びます。コールバックは MIDmaCallback 型 ( void* 引数1つを取る void 型関数 ) です。callback は システムのDMA割り込みハンドラ内から呼び出されますので、割り込み禁止状態で呼び出されます。

DMAコントローラの不具合

MI_DmaCopy() のリファレンス中の「DMAコントローラの不具合」を参照してください。

内部動作

IOレジスタのDMAnソースレジスタ(0x40000B0 + 12n)、DMAnデスティネーションレジスタ(0x40000B4 + 12n)、DMAnコントロールレジスタ(0x40000B8 + 12n)を使用します。( n は 使用するDMAチャンネルです。)
また、フィルのために HW_DMA_CLEAR_DATA_BUF 領域を使用しています。これは、TEG では Shared Memory に取られていますが、TSではIOレジスタにマッピングされます。

参照

MI_DmaCopy*, MI_DmaClear*, MI_DmaSend*,MI_CpuFill*, MI_DmaRestart


履歴

2009/11/30 16bitデータを扱う関数で data 引数が u32となっていたのを u16 に修正
2009/11/20 DMAコントローラの不具合について追記
2007/10/31 _SetUp() 追加
2005/03/08 用語統一 [割込み] → [割り込み]
2004/12/22 callback の呼び出しについての記述を追加
2003/12/01 初版