RL78 データフラッシュメモリ（EEL）ライブラリの使い方を分かりやすく

//======================================================================================
//
// データフラッシュ（0xF1000～の4K）をEELでアクセスする 2015/08/12 
// ・どの関数も1秒以内に終わるからWDTのリセットはしていない
// 
//======================================================================================
#include "r_cg_macrodriver.h"
#include "r_cg_cgc.h"
#include "r_cg_port.h"
#include "r_cg_userdefine.h"
#include "r_cg_wdt.h"

#include <string.h>             
#include "fdl.h"                    /* FDL library header file               */
#include "fdl_types.h"              /* FDL types definition header file      */
#include "fdl_descriptor.h"         /* FDL descriptor header file            */
#include "eel.h"                    /* EEL library header file               */
#include "eel_types.h"              /* EEL types definition header file      */
#include "eel_descriptor.h"         /* EEL descriptor header file            */
#include "eel_user_types.h"         /* EEL user types definition header file */

//  IDでR/Wするbyte数を指定する（例えばID=1なら2byte,ID=8なら255byteだ）。
//  変更したいなら eel_descriptor.c を見れ（まぁ255byteにしておけば万能だろうと思う）。
#define IDNUM   8      // 255byteのR/Wを行う

// global variable
#define SAM_WRITE_SIZE  255         // テスト用のR/Wバッファのサイズ
eel_request_t   dtyEelReq;
eel_u08         dubWriteBuffer[ SAM_WRITE_SIZE ];
eel_u08         dubReadBuffer[ SAM_WRITE_SIZE ];
fdl_status_t    fdlStatus = 0; 
eel_u08         err_flag = 0;

//======================================================================================
// EELの初期化
//  formatflag:TRUEなら強制的にFormatを行う
//======================================================================================
bool eel_Init(bool formatflag)
{
    dtyEelReq.address_pu08   = 0;
    dtyEelReq.identifier_u08 = 0;
    dtyEelReq.command_enu    = 0;
    dtyEelReq.status_enu     = 0;
    // 開始
    fdlStatus = FDL_Init( &fdl_descriptor_str );    // FDLの初期化
    if( fdlStatus == FDL_OK ) {                     // OKなら
        FDL_Open();                                 // FDLオープン
        dtyEelReq.status_enu = EEL_Init();          // EELの初期化
        if( dtyEelReq.status_enu == EEL_OK ) {      // OKなら
            EEL_Open();                             // EELオープン
            do {
                // EEL開始コマンド発行
                dtyEelReq.command_enu = EEL_CMD_STARTUP;                    // コマンドをセットし
                EEL_Execute( &dtyEelReq );                                  // 実行し
                while( dtyEelReq.status_enu == EEL_BUSY ) EEL_Handler();    // 実行完了を待つ
                // EELブロック不整合エラーならFormatを実行する
                if (formatflag == true || dtyEelReq.status_enu == EEL_ERR_POOL_INCONSISTENT ) {
                    dtyEelReq.command_enu = EEL_CMD_FORMAT;
                    EEL_Execute( &dtyEelReq );
                    while( dtyEelReq.status_enu == EEL_BUSY ) EEL_Handler();
                    formatflag = false;
                }
            // Formatしたら再度EEL開始コマンドを実行する
            } while((dtyEelReq.command_enu == EEL_CMD_FORMAT) && (dtyEelReq.status_enu  == EEL_OK));
        }
    }
    return ( dtyEelReq.status_enu == EEL_OK )? true:false;
}
//======================================================================================
// EELでの書き込み
//======================================================================================
bool eel_Write(void)
{
    int i;
    do {
        // 適当にデータをセットしてやる
        for (i=0;i<SAM_WRITE_SIZE; ++i) dubWriteBuffer[i] = (uint8_t)i;
        dubWriteBuffer[254] = 0x10;
        dubWriteBuffer[253] = 0x20;
        // EEL書き込みコマンド発行
        dtyEelReq.address_pu08   = dubWriteBuffer;
        dtyEelReq.identifier_u08 = IDNUM;   // IDで書き込みbyte数を指定（ID8＝255byte）
        dtyEelReq.command_enu    = EEL_CMD_WRITE;
        EEL_Execute( &dtyEelReq );
        while( dtyEelReq.status_enu == EEL_BUSY ) EEL_Handler();
        // データを書き込める領域が存在しないエラーならRefreshを実行する
        if (dtyEelReq.status_enu == EEL_ERR_POOL_FULL) {
            dtyEelReq.command_enu    = EEL_CMD_REFRESH;
            EEL_Execute( &dtyEelReq );
            while( dtyEelReq.status_enu == EEL_BUSY ) EEL_Handler();
        }
        // Refreshしたら再度EEL書き込みコマンドを実行する
    } while((dtyEelReq.command_enu == EEL_CMD_REFRESH) && (dtyEelReq.status_enu  == EEL_OK));
    return ( dtyEelReq.status_enu == EEL_OK )? true: false;
}
//======================================================================================
// EELでの読み出し
//======================================================================================
bool eel_Read(void)
{
    // EEL読み出しコマンド発行
    dtyEelReq.address_pu08   = dubReadBuffer;
    dtyEelReq.identifier_u08 = IDNUM;   // IDで読み出しbyte数を指定（ID8=255byte）
    dtyEelReq.command_enu    = EEL_CMD_READ;
    EEL_Execute( &dtyEelReq );
    while( dtyEelReq.status_enu == EEL_BUSY ) EEL_Handler();
    return  (dtyEelReq.status_enu == EEL_OK )? true:false;
}
//======================================================================================
// EELの終了処理
//======================================================================================
void eel_Finish(void)
{
    dtyEelReq.command_enu = EEL_CMD_SHUTDOWN;
    EEL_Execute( &dtyEelReq );
    while( dtyEelReq.status_enu == EEL_BUSY ) EEL_Handler();
    EEL_Close();
    FDL_Close();
}
//-----------------------------------------------
// EELのコマンド実行と完了待ち（未使用）
//-----------------------------------------------
eel_status_t _eelCmd(eel_command_t cmd)
{
    dtyEelReq.command_enu = cmd;                            // コマンドをセットし
    EEL_Execute(&dtyEelReq);                                // 実行し
    while(dtyEelReq.status_enu==EEL_BUSY) EEL_Handler();    // 実行完了を待つ
    return dtyEelReq.status_enu;                            // 結果を返す
}