EETS4K 模塊應(yīng)用筆記（1）

9S12 系列單片機的通常包含4KB 的EEPROM。Freescale 將EEPROM 模塊稱之為 EETS4K。實際上，這里所謂的 EEPROM 其實是FLASH，只不過Freescale 特意將這里Flash 的 sector 做的很小（4Bytes），使得用戶用起來像是在用 EEPROM。

EEPROM 是直接映射到9S12 單片機的地址空間的，如果程序中只是讀取 EEPROM 中的內(nèi)容，而不涉及到對 EEPROM 中數(shù)據(jù)的修改。那就不需要特殊的編程。就像讀取RAM數(shù)據(jù)那樣直接訪問就可以了。

只有當(dāng)需要在程序中更新EEPROM 中內(nèi)容時，才需要學(xué)習(xí)下面的內(nèi)容。

初始化EETS4K

在向EETS4K寫入數(shù)據(jù)或擦除數(shù)據(jù)前要先配置EETS4K的時鐘。EETS4K的時鐘頻率必須在150KHz——200KHz之間，為此需要配置 ECLKDIV 寄存器。

ECLKDIV 寄存器(EEPROM Clock Divider Register)

PRDIV8是預(yù)分頻位：當(dāng)PRDIV8=1時輸入時鐘被預(yù)分頻為1/8。

EDIV5——EDIV8為分頻除數(shù)寄存器，最多可以產(chǎn)生1/64 的分頻比。簡單的計算可知，當(dāng)輸入時鐘大于12.8MHz 時需要將 PRDIV8 置位。

經(jīng)過PRDIV8和EDIV兩級分頻最多可將時鐘頻率分為1/512。

擦除和寫入和讀取

這里不詳細(xì)介紹每一個寄存器的用法。只對需要注意的地方加以說明。

EETS4K 模塊的最小擦除單位是4Bytes，EETS4K 模塊提供了兩條相關(guān)命令，一條是擦除一個 sector，也就是 4 字節(jié)，并且要求是字節(jié)對其的雙字。另一條命令擦除全部EEPROM 空間。

每次編程（寫入）單位為兩個字節(jié)。并且這兩個字節(jié)要是對其字。

當(dāng)EETS4K 模塊正在進行擦除或編程操作時是不能同時讀取EEPROM中內(nèi)容的。

有了這些介紹就夠了。下面給出一個具體的例子。

/*EETS4K.h*/  

#ifndef  NVM_H  

#define  NVM_H  

/* 

 *                                       CONSTANTS 

 */  

#define  NVM_NO_ERR                (1)  

#define  NVM_ODD_ACCESS_ERR       (-1)  

#define  NVM_ACCESS_ERR           (-2)  

#define  NVM_PROTECTION_ERR       (-3)  

/* 

 *                                           FUNCTION PROTOTYPES 

 */  

void  EEPROM_Init(unsigned long sysclk);  

char  EEPROM_Write_Word(unsigned int address, unsigned int data);  

char  EEPROM_Erase_Sector(unsigned int address);  

char  EEPROM_Erase_All (void);  

unsigned int EEPROM_Read_Word(unsigned int address);  

#endif                    /* End of file */  

/*EETS4K.C*/  

#include       /* common defines and macros */  

#include "derivative.h"      /* derivative-specific definitions */  

#include "eets4k.h"  

/**  @brief This function initializes the Non Volatile EEPROM control registers  

 *            and must be called before attempting to write or erase an EEPROM sector. 

 *   

 *   @para sysclk the CPU clock frequency (SYSCLK) driven by the onboard oscillator or the PLL if enabled. 

 */  

void  EEPROM_Init (unsigned long sysclk)  

{  

    unsigned char  eclk_val;  

    if (sysclk >= 12000) {                /* If the SYSCLK is > 12MHz, then set FDIV8 bit */            

        eclk_val  =  (sysclk  / (8*200)) - 1;    /* Compute the correct divider value */  

        ECLKDIV  |=   ECLKDIV_PRDIV8_MASK | eclk_val;   /* Write the ECLKDIV register with the correct settings */  

    } else {  

        eclk_val  =  (sysclk / 200) - 1;         /* Compute the correct divider value */  

        ECLKDIV  |=   eclk_val;                  /* Write the ECLKDIV register with the correct settings */  

    }  

    ESTAT        |=  (ESTAT_PVIOL_MASK | ESTAT_ACCERR_MASK); /* Clear any error flags  */  

}  

/**  @brief This function writes a 16-bit word to EEPROM 

 *   @param  address, the destination EEPROM address to write the data 

 *   @param  data,    the data to write to argument address. 

 *   @return  

 *               NVM_NO_ERR           - EEPROM Write Success 

 *               NVM_ODD_ACCESS_ERR   - EEPROM Write Error, Address not on an even address boundry 

 *               NVM_ACCESS_ERR       - EEPROM Write Error, Access Violation 

 *               NVM_PROTECTION_ERR   - EEPROM Write Error, Attempted to write a protected sector 

 */  

char  EEPROM_Write_Word (unsigned int address, unsigned int data)  

{  

    while (!ESTAT_CBEIF) {    /* Wait for EEPROM access controller to become ready */  

        ;  

    }  

    ESTAT = (ESTAT_ACCERR_MASK | ESTAT_PVIOL_MASK); /* Clear existing error flags */  

    if (address & 0x0001) {  

        return (NVM_ODD_ACCESS_ERR);                /* Address is NOT aligned on an even boundry? */  

    }  

    (*(unsigned int *)address) = data;              /* Write the data to the specified address */  

    ECMD = ECMD_CMDB5_MASK;                          /* Store programming command in FCMD */  

    ESTAT_CBEIF = 1;                                /* Execute the command */  

    if (ESTAT_ACCERR) {                             /* Check if there has been an access error */  

        return (NVM_ACCESS_ERR);                    /* Return an Access Error code */  

    }  

    if (ESTAT_PVIOL) {                              /* Check if there has been a protection error  */  

        return (NVM_PROTECTION_ERR);                /* Return a Protection Error code */  

    }  

    return (NVM_NO_ERR);                            /* Return No Error */  

}  

/**  @brief This function erases a 4-byte sector of EEPROM 

 *   @param address, the start of the 4-byte sector to address 

 *   @return   

 *          NVM_NO_ERR           - EEPROM Write Success 

 *          NVM_ODD_ACCESS_ERR   - EEPROM Write Error, Address not on an even address boundry 

 *          NVM_ACCESS_ERR       - EEPROM Write Error, Access Violation 

 *          NVM_PROTECTION_ERR   - EEPROM Write Error, Attempted to write a protected sector 

 */  

char  EEPROM_Erase_Sector (unsigned int address)  

{  

    while (!ESTAT_CBEIF) {                            /* Wait for EEPROM access controller to become ready */  

        ;  

    }  

    ESTAT = (ESTAT_ACCERR_MASK | ESTAT_PVIOL_MASK);   /* Clear existing error flags  */  

    if (address & 0x0001) {  

        return (NVM_ODD_ACCESS_ERR);                  /* Address is NOT aligned on an even boundry? */  

    }  

    (*(unsigned int *)address) = 0xFFFF;              /* Write the data to the specified address */  

    ECMD = ECMD_CMDB6_MASK;                           /* Store programming command in FCMD */  

    ESTAT_CBEIF = 1;                                  /* Execute the command  */  

    if (ESTAT_ACCERR) {                               /* Check if there has been an access error */  

        return (NVM_ACCESS_ERR);                      /* Return an Access Error code */  

    }  

    if (ESTAT_PVIOL) {                                /* Check if there has been a protection error */  

        return (NVM_PROTECTION_ERR);                  /* Return a Protection Error code */