CARD_WriteFlash

構文

#include <nitro/card.h>

BOOL CARD_WriteFlash(u32 dst, const void *src, u32 len);

引数

dst	転送先の FLASH アドレス
src	転送元のメモリアドレス
len	書き込むデータのバイト長

返り値

処理が正しく成功すれば TRUE を、そうでないなら FALSE を返します。

説明

FLASH デバイスへデータを書き込みます。
この関数は処理が完了するまで制御を返しません。
処理が正しく成功すれば TRUE を、失敗した場合は FALSE を返します。
失敗時の詳細な結果値を取得するにはCARD_GetResultCode( )を呼び出してください。

注意

この関数を使用する場合、事前にアクセスバスをCARD_LockBackup( )でロックしている必要があります。
この関数は内部でPXIを介してARM7プロセッサと通信しています。PXIの割り込みが有効でないと処理が完了しない点に注意してください。
一部の大容量FLASHデバイスは"Write"操作に対応できないため、この関数を呼び出してもCARD_RESULT_UNSUPPORTEDを返して失敗します。「バックアップアクセス概要」に記載された詳細をご参照の上、必要に応じてCARD_WriteFlashSector( )などで代替してください。

参照

CARD_GetResultCode, CARD_IsBackupFlash, CARD_WriteFlashAsync, CARD_ReadFlash, CARD_VerifyFlash, CARD_WriteAndVerifyFlash

履歴

2007/11/13 一部の大容量FLASHがこの関数を使用できない旨の記述追加
2004/12/09 記述修正「IOプロセッサ」→「ARM7プロセッサ」
2004/08/31 CARD_GetResultCode( )についての記述を追加
2004/08/23 初版