EETS4K模块应用笔记（1）

9S12系列单片机的通常包含4KB的EEPROM。Freescale将EEPROM模块称之为EETS4K。实际上，这里所谓的EEPROM其实是FLASH，只不过Freescale特意将这里Flash的sector做的很小（4Bytes），使得用户用起来像是在用EEPROM。

EEPROM是直接映射到9S12单片机的地址空间的，如果程序中只是读取EEPROM中的内容，而不涉及到对EEPROM中数据的修改。那就不需要特殊的编程。就像读取RAM数据那样直接访问就可以了。

只有当需要在程序中更新EEPROM中内容时，才需要学习下面的内容。

初始化EETS4K

在向EETS4K写入数据或擦除数据前要先配置EETS4K的时钟。EETS4K的时钟频率必须在150KHz——200KHz之间，为此需要配置ECLKdiv寄存器。

ECLKdiv寄存器(EEPROMClockDividerRegister)

图1ECLKdiv寄存器

PRdiv8是预分频位：当PRdiv8=1时输入时钟被预分频为1/8。

Ediv5——Ediv8为分频除数寄存器，最多可以产生1/64的分频比。简单的计算可知，当输入时钟大于12.8MHz时需要将PRdiv8置位。

经过PRdiv8和Ediv两级分频最多可将时钟频率分为1/512。

擦除和写入和读取

这里不详细介绍每一个寄存器的用法。只对需要注意的地方加以说明。

EETS4K模块的最小擦除单位是4Bytes，EETS4K模块提供了两条相关命令，一条是擦除一个sector，也就是4字节，并且要求是字节对其的双字。另一条命令擦除全部EEPROM空间。

每次编程（写入）单位为两个字节。并且这两个字节要是对其字。

当EETS4K模块正在进行擦除或编程操作时是不能同时读取EEPROM中内容的。

有了这些介绍就够了。下面给出一个具体的例子。

1. /*EETS4K.h*/
2. #ifndefNVM_H
3. #defineNVM_H
5. /*
6. *CONSTANTS
7. */
9. #defineNVM_NO_ERR(1)
10. #defineNVM_ODD_ACCESS_ERR(-1)
11. #defineNVM_ACCESS_ERR(-2)
12. #defineNVM_PROTECTION_ERR(-3)
14. /*
15. *FUNCTIONPROTOTYPES
16. */
18. voidEEPROM_Init(unsignedlongsysclk);
19. charEEPROM_Write_Word(unsignedintaddress,unsignedintdata);
20. charEEPROM_Erase_Sector(unsignedintaddress);
21. charEEPROM_Erase_All(void);
22. unsignedintEEPROM_Read_Word(unsignedintaddress);
24. #endif/*Endoffile*/

1. /*EETS4K.C*/
2. #include/*commondefinesandmacros*/
3. #include"derivative.h"/*derivative-specificdefinitions*/
4. #include"eets4k.h"
7. /**@briefThisfunctioninitializestheNonVolatileEEPROMcontrolregisters
8. *andmustbecalledbeforeattemptingtowriteoreraseanEEPROMsector.
9. *
10. *@parasysclktheCPUclockfrequency(SYSCLK)drivenbytheonboardoscillatororthePLLifenabled.
11. */
12. voidEEPROM_Init(unsignedlongsysclk)
13. {
14. unsignedchareclk_val;
17. if(sysclk>=12000){/*IftheSYSCLKis>12MHz,thensetFdiv8bit*/
18. eclk_val=(sysclk/(8*200))-1;/*Computethecorrectdividervalue*/
19. ECLKdiv|=ECLKdiv_PRdiv8_MASK|eclk_val;/*WritetheECLKdivregisterwiththecorrectsettings*/
20. }else{
21. eclk_val=(sysclk/200)-1;/*Computethecorrectdividervalue*/
22. ECLKdiv|=eclk_val;/*WritetheECLKdivregisterwiththecorrectsettings*/
23. }
25. ESTAT|=(ESTAT_PVIOL_MASK|ESTAT_ACCERR_MASK);/*Clearanyerrorflags*/
26. }
28. /**@briefThisfunctionwritesa16-bitwordtoEEPROM
29. *@paramaddress,thedestinationEEPROMaddresstowritethedata
30. *@paramdata,thedatatowritetoargumentaddress.
31. *@return
32. *NVM_NO_ERR-EEPROMWriteSuccess
33. *NVM_ODD_ACCESS_ERR-EEPROMWriteError,Addressnotonanevenaddressboundry
34. *NVM_ACCESS_ERR-EEPROMWriteError,AccessViolation
35. *NVM_PROTECTION_ERR-EEPROMWriteError,Attemptedtowriteaprotectedsector
36. */
37. charEEPROM_Write_Word(unsignedintaddress,unsignedintdata)
38. {
39. while(!ESTAT_CBEIF){/*WaitforEEPROMaccesscontrollertobecomeready*/
40. ;
41. }
43. ESTAT=(ESTAT_ACCERR_MASK|ESTAT_PVIOL_MASK);/*Clearexistingerrorflags*/
45. if(address&0x0001){
46. return(NVM_ODD_ACCESS_ERR);/*AddressisNOTalignedonanevenboundry?*/
47. }
49. (*(unsignedint*)address)=data;/*Writethedatatothespecifiedaddress*/
51. ECMD=ECMD_CMDB5_MASK;/*StoreprogrammingcommandinFCMD*/
52. ESTAT_CBEIF=1;/*Executethecommand*/
54. if(ESTAT_ACCERR){/*Checkiftherehasbeenanaccesserror*/
55. return(NVM_ACCESS_ERR);/*ReturnanAccessErrorcode*/
56. }
58. if(ESTAT_PVIOL){/*Checkiftherehasbeenaprotectionerror*/
59. return(NVM_PROTECTION_ERR);/*ReturnaProtectionErrorcode*/
60. }
62. return(NVM_NO_ERR);/*ReturnNoError*/
63. }
65. /**@briefThisfunctionerasesa4-bytesectorof