WinCE Eboot中的OEM Flash函数

作者：ARM-WinCE

在EBOOT中提供了操作Flash的功能，可以将下载的WinCE image烧到Flash当中，这需要实现一些Flash相关的OEM函数。

这些OEM函数会在BLCOMMON模块中被调用，也就是在blcommon.c文件的DownloadImage函数中被调用。在DownloadImage函数中，一般image文件的header会被先下载并进行解析。然后调用OEMIsFlashAddr判断image所在的区域，如果是在Flash的地址空间内，那么接下来会下载image文件并调用Flash相关的OEM函数将Flash擦除并写入。下面简单介绍一下这些函数：

1. BOOL OEMIsFlashAddr(DWORD dwAddr)

该函数用于判断下载的WinCE image文件是在Flash区域中还是在RAM区域中，dwAddr是image文件的地址，如果在Flash区域中返回TRUE，否则返回FALSE，给个微软的例子：<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

1. #defineFLASH_START0
2. #defineFLASH_LENGTH0x02000000
3. BOOLOEMIsFlashAddr(DWORDdwAddr)
4. {
5. //根据Flash的起始地址和长度判断该地址是否在Flash区域内
6. if((dwAddr>=FLASH_START)&&(dwAddr<(FLASH_START+FLASH_LENGTH)))
7. {
8. return(TRUE);
9. }
11. return(FALSE);
12. }

2. BOOL OEMStartEraseFlash(DWORD dwStartAddr, DWORD dwLength)

该函数用于初始化Flash的擦除，dwStartAddr表示要擦除的起始地址，dwLength为长度。通过这两个参数计算Flash中要被擦除的起始block和最后一个block，以及要擦除多少个block，给个微软的例子：

1. BOOLOEMStartEraseFlash(DWORDdwStartAddr,DWORDdwLength)
2. {
3. ULONGi=0;
4. ULONGnNumBlocks=0;
6. //判断起始地址和终止地址是否都在Flash区域内
7. if(!OEMIsFlashAddr(dwStartAddr)||!OEMIsFlashAddr(dwStartAddr+dwLength-1))
8. {
9. return(FALSE);
10. }
12. //确认该起始地址是Block对齐的
13. if(dwStartAddr%FLASH_BLOCK_SIZE)
14. {
15. return(FALSE);
16. }
17. //确认长度是4字节对齐
18. if(dwLength&0x03)
19. {
20. return(FALSE);
21. }
23. //根据Flash的基地址和Flash的Block大小计算要擦除的起始block和最后一个
24. //block以及多少个Block
25. gnStartBlock=(dwStartAddr-FLASH_BASE)/FLASH_BLOCK_SIZE;
26. gnEndBlock=((dwStartAddr+dwLength+(FLASH_BLOCK_SIZE-1)-FLASH_BASE)/FLASH_BLOCK_SIZE);
27. gnBlocks=(int)(gnEndBlock-gnStartBlock);
28. gnBlockCount=gnStartBlock;
30. EdbgOutputDebugString("Erasingflashblocks:startblock=%dendblock=%d\r\n",gnStartBlock,gnEndBlock);
33. return(TRUE);
34. }

3. void OEMContinueEraseFlash (void)

该函数用于擦除Flash区域，它会在image下载后被调用来擦除Flash中的block，给个微软的例子：

1. voidOEMContinueEraseFlash(void)
2. {
3. UCHARnEraseCount=BLOCK_ERASE_STEP;//要擦除的块
6. //确认所有需要擦除的block都被擦除了
7. if(!gnBlocks||(gnBlockCount==gnEndBlock))
8. return;
10. //擦除block
11. while((gnBlockCount<gnEndBlock)&&nEraseCount)
12. {
13. if(CFI_Erase_Block((unsigned32*)BLOCK_ADDR(gnBlockCount),0,NULL)!=PASS)
14. {
15. EdbgOutputDebugString("ERROR:OEMContinueEraseFlash-flasheraseerror(blocknumber%d).\r\n",gnBlockCount);
16. return;
17. }
19. ++gnBlockCount;
20. --nEraseCount;
21. }
24. return;
25. }

4. BOOL OEMFinishEraseFlash (void)

该函数用于确认Flash中所有的block都被擦除完成，给个微软的例子：

1. BOOLOEMFinishEraseFlash(void)
2. {
3. EdbgOutputDebugString("INFO:Finishingflasherase...\r\n");
5. while(gnBlocks&&(gnBlockCount!=gnEndBlock))
6. {
7. OEMContinueEraseFlash();
8. }
10. return(TRUE);
11. }

5. BOOL OEMWriteFlash(DWORD dwImageStart, DWORD dwImageLength)

该函数用于将下载的image写入到Flash当中，dwImageStart为被写入image在Flash中的起始地址，dwImageLength为image的大小，给个微软的例子：

1. BOOLOEMWriteFlash(DWORDdwImageStart,DWORDdwImageLength)
2. {
3. DWORDdwFlashAddr,dwExtraBytes=0;
4. LPBYTEpbCache=NULL;
5. UCHARnNumBlocks=0;
8. //确认起始地址和长度都在Flash区域内
9. if(!OEMIsFlashAddr(dwImageStart)||!OEMIsFlashAddr(dwImageStart+dwImageLength-1))
10. {
11. return(FALSE);
12. }
14. //确认起始地址是Block字节对齐的
15. if(dwImageStart%FLASH_BLOCK_SIZE)
16. {
17. return(FALSE);
18. }
20. //计算要写入的block数量
21. nNumBlocks=(UCHAR)(dwImageLength/FLASH_BLOCK_SIZE);
22. dwExtraBytes=(dwImageLength%FLASH_BLOCK_SIZE);
23. dwFlashAddr=dwImageStart;
24. pbCache=OEMMapMemAddr(dwImageStart,dwFlashAddr);
27. //写Flash
28. while(nNumBlocks)
29. {
30. if(CFI_Write_Block((unsigned32*)dwFlashAddr,(unsigned32*)pbCache,FLASH_BLOCK_SIZE,NULL)!=PASS)
31. {
32. EdbgOutputDebugString("ERROR:OEMWriteFlash-unabletowritetoblock(blockaddress=0x%x).\r\n",dwFlashAddr);
33. return(FALSE);
34. }
36. dwFlashAddr+=FLASH_BLOCK_SIZE;
37. pbCache=OEMMapMemAddr(dwImageStart,dwFlashAddr);
38. --nNumBlocks;
39. }
41. //将额外的数据写入Flash中
42. if(dwExtraBytes)
43. {
44. if(CFI_Write_Block((unsigned32*)dwFlashAddr,(unsigned32*)pbCache,dwExtraBytes,NULL)!=PASS)
45. {
46. EdbgOutputDebugString("ERROR:OEMWriteFlash-unabletowritetoblock(blockaddress=0x%x).\r\n",dwFlashAddr);
47. return(FALSE);
48. }
49. }
51. return(TRUE);
52. }

上面的5个函数用于在eboot中支持Flash操作功能。一般在开发BSP的时候，如果需要在EBOOT中实现Flash的功能，会在EBOOT中创建一个Flash.c文件，在该文件中实现上述这些函数。建议看看blcommon.c中的DownloadImage函数，可以帮助理解。