【转载】WinCE Eboot中的OEM控制函数

转载自：http://blog.csdn.net/nanjianhui/archive/2008/11/05/3228159.aspx

在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。下面是微软提供的该函数的模板：

BOOL OEMPlatformInit(void) 
{ 
    BOOL                    fRet = FALSE; 
    BOOT_ARGS              *pBootArgs;  
    ETH_HARDWARE_SETTINGS  *pEdbgSettings;  
    EDBG_ADDR              *pMyAddr;

    //打印版本号和时间日期信息 
    EdbgOutputDebugString("Microsoft Windows Embedded CE Ethernet Bootloader %d.%d for Platform Example (%s %s)\n\n",  EBOOT_VERSION_MAJOR,EBOOT_VERSION_MINOR, __DATE__, __TIME__);

    //初始化Driver Globals区域中的Boot引导参数信息 
    pBootArgs = (BOOT_ARGS*)BOOT_ARGS_PHYSICAL_MEMORY_START; 
    memset(pBootArgs, 0, sizeof(BOOT_ARGS));

    pBootArgs->dwSig            = BOOTARG_SIG; 
    pBootArgs->dwLen            = sizeof(BOOT_ARGS); 
    pBootArgs->dwEdbgDebugZone  = EdbgDebugZone;

    //添加按键输入判断，允许用户进入Shell 
    if (WaitForKeyPress()) 
    { 
        //允许用户设置网络相关的信息，比如IP地址等 
        LoaderMainMenu();      
    }

    //初始化以太网控制器 
    pEdbgSettings = &pBootArgs->Edbg; 
    fRet          = InitEthernet(pEdbgSettings);

   if (!fRet)  
   { 
        EdbgOutputDebugString("ERROR: Ethernet initialization failed\r\n"); 
        SpinForever(); 
    }

    pMyAddr = &pEdbgSettings->Adapter.Addr; 
    EdbgOutputDebugString("INFO: Debug Ethernet MAC Address: %B:%B:%B:%B:%B:%B\r\n", pMyAddr->wMAC[0] & 0x00FF, pMyAddr->wMAC[0] >> 8, 
        pMyAddr->wMAC[1] & 0x00FF, pMyAddr->wMAC[1] >> 8, 
        pMyAddr->wMAC[2] & 0x00FF, pMyAddr->wMAC[2] >> 8);

    return(TRUE); 
}
 
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。微软提供了该函数的模板：

void OEMLaunch(DWORD dwImageStart, DWORD dwImageLength, DWORD dwLaunchAddr, const ROMHDR *pRomHdr) 
{ 
    DWORD dwPhysLaunchAddr; 
    EDBG_OS_CONFIG_DATA *pCfgData;     
    EDBG_ADDR EshellHostAddr; 
    EBOOT_CFG EbootCfg;

    memset(&EshellHostAddr, 0, sizeof(EDBG_ADDR)); 
    memset(&EbootCfg, 0, sizeof(EBOOT_CFG));

    //从Flash中读取Eboot的参数信息 
    ReadEbootConfig(&EbootCfg);

    if (g_bWaitForConnect) 
    {//等待Platform Builder发送信息 
        if (!(pCfgData = EbootWaitForHostConnect(&pDriverGlobals->eth.TargetAddr, &EshellHostAddr))) 
        { 
            EdbgOutputDebugString("ERROR: OEMLaunch: EbootWaitForHostConenct failed.\r\n"); 
            SpinForever(); 
        }

        if (pCfgData->Flags & EDBG_FL_DBGMSG) 
        {//支持基于Ethernet的Debug信息，更新Driver Globals中的IP和端口号     
            memcpy(&pDriverGlobals->eth.DbgHostAddr.wMAC,& EshellHostAddr.wMAC, 6); 
            pDriverGlobals->eth.DbgHostAddr.dwIP  = pCfgData->DbgMsgIPAddr; 
            pDriverGlobals->eth.DbgHostAddr.wPort = pCfgData->DbgMsgPort; 
        } 
        if (pCfgData->Flags & EDBG_FL_PPSH) 
        {//支持基于Ethernet的Target Control，更新Driver Globals中的IP和端口号     
            memcpy(&pDriverGlobals->eth.PpshHostAddr.wMAC, &EshellHostAddr.wMAC, 6); 
            pDriverGlobals->eth.PpshHostAddr.dwIP  = pCfgData->PpshIPAddr; 
            pDriverGlobals->eth.PpshHostAddr.wPort = pCfgData->PpshPort; 
        } 
        if (pCfgData->Flags & EDBG_FL_KDBG) 
        {//支持基于Ethernet的kernel debugger，更新Driver Globals中的IP和端口号     
            memcpy(&pDriverGlobals->eth.KdbgHostAddr.wMAC, &EshellHostAddr.wMAC, 6); 
            pDriverGlobals->eth.KdbgHostAddr.dwIP  = pCfgData->KdbgIPAddr; 
            pDriverGlobals->eth.KdbgHostAddr.wPort = pCfgData->KdbgPort; 
        }

        memcpy(&pDriverGlobals->eth.DownloadHostAddr, &EshellHostAddr, sizeof(EDBG_ADDR)); 
        pDriverGlobals->eth.etherFlags    = pCfgData->Flags; 
        pDriverGlobals->eth.KitlTransport = pCfgData->KitlTransport; 
    }

    //保存WinCE kernel的launch地址 
    if (dwLaunchAddr && (EbootCfg.NKRegion.LaunchAddress != dwLaunchAddr)) 
    { 
        EbootCfg.NKRegion.LaunchAddress = dwLaunchAddr; 
        WriteEbootConfig(&EbootCfg);  
    } 
    else 
    { 
        dwLaunchAddr= EbootCfg.NKRegion.LaunchAddress; 
    }

    // 跳转到WinCE Image的地址开始执行 
    Launch(dwPhysLaunchAddr);

    //死循环 
    SpinForever(); 
}