WinCE Eboot中的OEM控制函数

作者：ARM-WinCE

在EBOOT中有很多以OEM开头的函数，这些函数都会直接或间接的被BLCOMMON模块调用，来完成相应的功能。这些OEM函数就是我们需要根据自己的平台来实现的。可以说，实现了这些OEM函数，EBOOT的功能就完成了。

在EBOOT中有很多OEM函数，有些是必须实现的，有些是不必实现的，而有些是根据你的EBOOT的功能需求来决定是否要实现的。下面会介绍一下直接由BLCOMMON调用的OEM控制函数：

1. void OEMDebugInit(void)

这应该是第一个被调用的OEM函数，用来初始化串口来打印调试信息。这里要提一下另一个函数叫OEMInitDebugSerial，是OAL中用于初始化串口的函数。所以一般会实现OEMInitDebugSerial函数，然后在OEMDebugInit中调用它就可以了。实际上这只是一个初始化函数，如果想实现串口调试，还需要实现另外几个函数，如下；

OEMWriteDebugString

OEMWriteDebugByte

OEMReadDebugByte

上述三个函数在我以前的博客“WinCE BSP中打印信息的实现介绍”中有介绍，这里不再重复了。

2. BOOL OEMPlatformInit(void)

这个函数用于初始化硬件平台，就是说出实话硬件板子的相关外设。一般会先初始化RTC，然后初始化Nandflash控制器，初始化硬件中断，初始化网卡，如果需要，还可以在这个时候初始化Display，然后显示一个Logo。下面是微软提供的该函数的模板：

<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

1. BOOLOEMPlatformInit(void)
2. {
3. BOOLfRet=FALSE;
4. BOOT_ARGS*pBootArgs;
5. ETH_HARDWARE_SETTINGS*pEdbgSettings;
6. EDBG_ADDR*pMyAddr;
9. //打印版本号和时间日期信息
10. EdbgOutputDebugString("MicrosoftWindowsEmbeddedCEEthernetBootloader%d.%dforPlatformExample(%s%s)\n\n",EBOOT_VERSION_MAJOR,EBOOT_VERSION_MINOR,__DATE__,__TIME__);
13. //初始化DriverGlobals区域中的Boot引导参数信息
14. pBootArgs=(BOOT_ARGS*)BOOT_ARGS_PHYSICAL_MEMORY_START;
15. memset(pBootArgs,0,sizeof(BOOT_ARGS));
17. pBootArgs->dwSig=BOOTARG_SIG;
18. pBootArgs->dwLen=sizeof(BOOT_ARGS);
19. pBootArgs->dwEdbgDebugZone=EdbgDebugZone;
21. //添加按键输入判断，允许用户进入Shell
22. if(WaitForKeyPress())
23. {
24. //允许用户设置网络相关的信息，比如IP地址等
25. LoaderMainMenu();
26. }
28. //初始化以太网控制器
29. pEdbgSettings=&pBootArgs->Edbg;
30. fRet=InitEthernet(pEdbgSettings);
32. if(!fRet)
33. {
34. EdbgOutputDebugString("ERROR:Ethernetinitializationfailed\r\n");
35. SpinForever();
36. }
38. pMyAddr=&pEdbgSettings->Adapter.Addr;
39. EdbgOutputDebugString("INFO:DebugEthernetMACAddress:%B:%B:%B:%B:%B:%B\r\n",pMyAddr->wMAC[0]&0x00FF,pMyAddr->wMAC[0]>>8,
40. pMyAddr->wMAC[1]&0x00FF,pMyAddr->wMAC[1]>>8,
41. pMyAddr->wMAC[2]&0x00FF,pMyAddr->wMAC[2]>>8);
43. return(TRUE);
44. }

3. DWORD OEMPreDownload(void)

该函数一般用于初始化网络，初始化用于下载WinCE image的TFTP。首先调用OALKitlCreateName函数根据MAC地址创建设备名称。然后判断是否是DHCP，并分配IP地址。调用EbootInitEtherTransport函数初始化TFTP，该函数属于eboot模块代码，在”\WINCE600\PUBLIC\COMMON\OAK\DRIVERS\ETHDBG\EBOOT”下面可以找到，该函数返回pfJumpImg，返回值作为OEMPreDownload的返回值，决定是下载WinCE image还是直接跳转执行。

4. void OEMLaunch(DWORD dwImageStart, DWORD dwImageLength, DWORD dwLaunchAddr, const ROMHDR* pRomHdr)

该函数用于运行WinCE，首先会根据需要将EBOOT的引导参数进行更新，并写入存储设备，然后会判断变量g_DownloadImage的值，有时候可能是g_bWaitForConnect的值，但是意思都是一样的。如果该值为0，则表示不是下载的WinCE image，是从Flash中load出来的，就会直接调用Launch函数运行WinCE，Launch函数一般是汇编写的，就是直接把PC指针指到WinCE image加载的地址开始运行；如果值为1，则调用EbootWaitForHostConnect函数等待Platform Builder发送信息，把该函数的返回值更新到Driver Globals内存中，这样WinCE启动后，OAL模块的代码可以访问到，然后调用Launch函数运行WinCE image。微软提供了该函数的模板：

1. voidOEMLaunch(DWORDdwImageStart,DWORDdwImageLength,DWORDdwLaunchAddr,constROMHDR*pRomHdr)
2. {
3. DWORDdwPhysLaunchAddr;
4. EDBG_OS_CONFIG_DATA*pCfgData;
5. EDBG_ADDREshellHostAddr;
6. EBOOT_CFGEbootCfg;
8. memset(&EshellHostAddr,0,sizeof(EDBG_ADDR));
9. memset(&EbootCfg,0,sizeof(EBOOT_CFG));
12. //从Flash中读取Eboot的参数信息
13. ReadEbootConfig(&EbootCfg);
15. if(g_bWaitForConnect)
16. {//等待PlatformBuilder发送信息
17. if(!(pCfgData=EbootWaitForHostConnect(&pDriverGlobals->eth.TargetAddr,&EshellHostAddr)))
18. {
19. EdbgOutputDebugString("ERROR:OEMLaunch:EbootWaitForHostConenctfailed.\r\n");
20. SpinForever();
21. }
23. if(pCfgData->Flags&EDBG_FL_DBGMSG)
24. {//支持基于Ethernet的Debug信息，更新DriverGlobals中的IP和端口号
25. memcpy(&pDriverGlobals->eth.DbgHostAddr.wMAC,&EshellHostAddr.wMAC,6);
26. pDriverGlobals->eth.DbgHostAddr.dwIP=pCfgData->DbgMsgIPAddr;
27. pDriverGlobals->eth.DbgHostAddr.wPort=pCfgData->DbgMsgPort;
28. }
29. if(pCfgData->Flags&EDBG_FL_PPSH)
30. {//支持基于Ethernet的TargetControl，更新DriverGlobals中的IP和端口号
31. memcpy(&pDriverGlobals->eth.PpshHostAddr.wMAC,&EshellHostAddr.wMAC,6);
32. pDriverGlobals->eth.PpshHostAddr.dwIP=pCfgData->PpshIPAddr;
33. pDriverGlobals->eth.PpshHostAddr.wPort=pCfgData->PpshPort;
34. }
35. if(pCfgData->Flags&EDBG_FL_KDBG)
36. {//支持基于Ethernet的kerneldebugger，更新DriverGlobals中的IP和端口号
37. memcpy(&pDriverGlobals->eth.KdbgHostAddr.wMAC,&EshellHostAddr.wMAC,6);
38. pDriverGlobals->eth.KdbgHostAddr.dwIP=pCfgData->KdbgIPAddr;
39. pDriverGlobals->eth.KdbgHostAddr.wPort=pCfgData->KdbgPort;
40. }
42. memcpy(&pDriverGlobals->eth.DownloadHostAddr,&EshellHostAddr,sizeof(EDBG_ADDR));
43. pDriverGlobals->eth.etherFlags=pCfgData->Flags;
44. pDriverGlobals->eth.KitlTransport=pCfgData->KitlTransport;
45. }
47. //保存WinCEkernel的launch地址
48. if(dwLaunchAddr&&(EbootCfg.NKRegion.LaunchAddress!=dwLaunchAddr))
49. {
50. EbootCfg.NKRegion.LaunchAddress=dwLaunchAddr;
51. WriteEbootConfig(&EbootCfg);
52. }
53. else
54. {
55. dwLaunchAddr=EbootCfg.NKRegion.LaunchAddress;
56. }
58. //跳转到WinCEImage的地址开始执行
59. Launch(dwPhysLaunchAddr);
61. //死循环
62. SpinForever();
63. }