在WinCE的EBOOT中,有一些函数属于Optional的OEM函数,也就是可选择实现的。这些函数会在BLCOMMON模块中被调用,我们需要在EBOOT中实现它们,然后把实现的函数赋值给BLCOMMON中的相应的函数指针上面就可以了,这样BLCOMMON模块在调用这些Optional函数的时候,会首先检查他们是否为NULL,如果为NULL就不执行,如果不是NULL就运行这些函数。
可以先看一下BLCOMMON模块的代码,在blcommon.c中有如下的定义:
- PFN_OEMVERIFYMEMORY g_pOEMVerifyMemory;
- PFN_OEMREPORTERROR g_pOEMReportError;
- PFN_OEMCHECKSIGNATURE g_pOEMCheckSignature;
- PFN_OEMMULTIBINNOTIFY g_pOEMMultiBINNotify;
这4个Optional函数指针在EBOOT中一般会对应下面的函数:
- BOOL OEMVerifyMemory(DWORD dwStartAddr, DWORD dwLength)
- BOOL OEMReportError(DWORD dwReason, DWORD dwReserved)
- BOOL OEMCheckSignature(DWORD dwImageStart, DWORD dwROMOffset, DWORD dwLaunchAddr, BOOL bDownloaded)
- void OEMMultiBINNotify(const PMultiBINInfo pInfo)
下面介绍一些这些OEM函数:
1. BOOL OEMVerifyMemory(DWORD dwStartAddr, DWORD dwLength)
该函数主要用于对要被下载WinCE image的存储设备进行验证,它在BLCOMMON模块中的DownloadImage函数中被调用,用于下载前验证存储设备。dwStartAddr为被下载的image在存储器中的起始地址,dwLength为image的长度,成功返回TRUE。
2. BOOL OEMReportError(DWORD dwReason, DWORD dwReserved)
该函数用于报告错误,用户可以通过串口打印的方式来实现。在BLCOMMON模块中,它会被HALT函数调用,而HALT函数会在BLCOMMON模块中的BootloaderMain函数出错时被调用来报告错误。dwReason为错误原因,dwReserved为预留,目前没有被使用。
3. BOOL OEMCheckSignature(DWORD dwImageStart, DWORD dwROMOffset, DWORD dwLaunchAddr, BOOL bDownloaded)
该函数用于验证WinCE image中的署名并检查其有效性。它会被BLCOMMON模块中的DownloadImage中被调用,主要验证下载后的WinCE image。dwImageStart为被下载image的存储起始地址,dwROMOffset为config.bib文件中定义的ROMOFFSET的值,dwLaunchAddr为被加载的地址,bDownloaded为TURE表示是被下载的image文件。其实在BLCOMMON模块中已经提供了一个通用的署名检查函数CheckSignature(..)在signimage.c文件中,可以在该函数中调用这个函数来验证image的署名。
4. void OEMMultiBINNotify(const PMultiBINInfo pInfo)
该函数用于告诉用户在下载多个bin文件的时候,每个文件的区域信息。它会被BLCOMMON模块的DownloadImage函数调用。Platform Builder本身是支持一次下载多个Bin文件的,所以EBOOT下载的时候,可以通过该函数要下载的Bin文件数以及每个Bin文件的起始地址和长度,这些信息在pInfo中体现。
上面的这些OEM函数是用户根据自己的需要来实现的,如果想让他们被BLCOMMON模块调用,还需要将他们赋值给相应的函数指针,如下:
- g_pOEMVerifyMemory = OEMVerifyMemory(..)
- g_pOEMReportError = OEMReportError(..)
- g_pOEMCheckSignature = OEMCheckSignature(..)
- g_pOEMMultiBINNotify = OEMMultiBINNotify(..)
上面的赋值操作最好在OEMDebugInit函数中完成。
最后还要提一个EBOOT中的函数,该函数应该不算是Optional的OEM函数,但是也是可以根据EBOOT的需要来选择实现的:
DWORD OEMEthGetSecs (void):
该函数实际上是一个Timer函数,用于返回当前的秒数。它在EBOOT中主要用于Polling模式下的超时判断,一般会在OEMPlatformInit函数中被调用。在OEMPlatformInit中,常会等待用户从串口输入信息来决定是否直接加载运行WinCE还是进入Bootloader菜单进行设置。这个等待用户输入会有一定的时间限制,就是通过在while循环中调用该函数直到超时时间到以后自动跳出。
在WinCE的EBOOT中,有一些函数属于Optional的OEM函数,也就是可选择实现的。这些函数会在BLCOMMON模块中被调用,我们需要在EBOOT中实现它们,然后把实现的函数赋值给BLCOMMON中的相应的函数指针上面就可以了,这样BLCOMMON模块在调用这些Optional函数的时候,会首先检查他们是否为NULL,如果为NULL就不执行,如果不是NULL就运行这些函数。
可以先看一下BLCOMMON模块的代码,在blcommon.c中有如下的定义:
- PFN_OEMVERIFYMEMORY g_pOEMVerifyMemory;
- PFN_OEMREPORTERROR g_pOEMReportError;
- PFN_OEMCHECKSIGNATURE g_pOEMCheckSignature;
- PFN_OEMMULTIBINNOTIFY g_pOEMMultiBINNotify;
这4个Optional函数指针在EBOOT中一般会对应下面的函数:
- BOOL OEMVerifyMemory(DWORD dwStartAddr, DWORD dwLength)
- BOOL OEMReportError(DWORD dwReason, DWORD dwReserved)
- BOOL OEMCheckSignature(DWORD dwImageStart, DWORD dwROMOffset, DWORD dwLaunchAddr, BOOL bDownloaded)
- void OEMMultiBINNotify(const PMultiBINInfo pInfo)
下面介绍一些这些OEM函数:
1. BOOL OEMVerifyMemory(DWORD dwStartAddr, DWORD dwLength)
该函数主要用于对要被下载WinCE image的存储设备进行验证,它在BLCOMMON模块中的DownloadImage函数中被调用,用于下载前验证存储设备。dwStartAddr为被下载的image在存储器中的起始地址,dwLength为image的长度,成功返回TRUE。
2. BOOL OEMReportError(DWORD dwReason, DWORD dwReserved)
该函数用于报告错误,用户可以通过串口打印的方式来实现。在BLCOMMON模块中,它会被HALT函数调用,而HALT函数会在BLCOMMON模块中的BootloaderMain函数出错时被调用来报告错误。dwReason为错误原因,dwReserved为预留,目前没有被使用。
3. BOOL OEMCheckSignature(DWORD dwImageStart, DWORD dwROMOffset, DWORD dwLaunchAddr, BOOL bDownloaded)
该函数用于验证WinCE image中的署名并检查其有效性。它会被BLCOMMON模块中的DownloadImage中被调用,主要验证下载后的WinCE image。dwImageStart为被下载image的存储起始地址,dwROMOffset为config.bib文件中定义的ROMOFFSET的值,dwLaunchAddr为被加载的地址,bDownloaded为TURE表示是被下载的image文件。其实在BLCOMMON模块中已经提供了一个通用的署名检查函数CheckSignature(..)在signimage.c文件中,可以在该函数中调用这个函数来验证image的署名。
4. void OEMMultiBINNotify(const PMultiBINInfo pInfo)
该函数用于告诉用户在下载多个bin文件的时候,每个文件的区域信息。它会被BLCOMMON模块的DownloadImage函数调用。Platform Builder本身是支持一次下载多个Bin文件的,所以EBOOT下载的时候,可以通过该函数要下载的Bin文件数以及每个Bin文件的起始地址和长度,这些信息在pInfo中体现。
上面的这些OEM函数是用户根据自己的需要来实现的,如果想让他们被BLCOMMON模块调用,还需要将他们赋值给相应的函数指针,如下:
- g_pOEMVerifyMemory = OEMVerifyMemory(..)
- g_pOEMReportError = OEMReportError(..)
- g_pOEMCheckSignature = OEMCheckSignature(..)
- g_pOEMMultiBINNotify = OEMMultiBINNotify(..)
上面的赋值操作最好在OEMDebugInit函数中完成。
最后还要提一个EBOOT中的函数,该函数应该不算是Optional的OEM函数,但是也是可以根据EBOOT的需要来选择实现的:
DWORD OEMEthGetSecs (void):
该函数实际上是一个Timer函数,用于返回当前的秒数。它在EBOOT中主要用于Polling模式下的超时判断,一般会在OEMPlatformInit函数中被调用。在OEMPlatformInit中,常会等待用户从串口输入信息来决定是否直接加载运行WinCE还是进入Bootloader菜单进行设置。这个等待用户输入会有一定的时间限制,就是通过在while循环中调用该函数直到超时时间到以后自动跳出。