WinCE EBOOT中的Optional函数

在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循环中调用该函数直到超时时间到以后自动跳出。

时间: 2024-09-17 05:15:45

WinCE EBOOT中的Optional函数的相关文章

WinCE Eboot中的OEM Flash函数

在EBOOT中提供了操作Flash的功能,可以将下载的WinCE image烧到Flash当中,这需要实现一些Flash相关的OEM函数. 这些OEM函数会在BLCOMMON模块中被调用,也就是在blcommon.c文件的DownloadImage函数中被调用.在DownloadImage函数中,一般image文件的header会被先下载并进行解析.然后调用OEMIsFlashAddr判断image所在的区域,如果是在Flash的地址空间内,那么接下来会下载image文件并调用Flash相关的O

WinCE Eboot中的网络函数

一般使用EBOOT下载WinCE image都是通过网络,就是指以太网,当然也有通过USB下载的,不过网络下载是最常用的了.实际上下载的工作是在BLCOMMON模块中完成的,它会调用OEMReadData函数来下载数据,OEMReadData由用户来实现,一般如果是网络下载,都会在OEMReadData中直接调用EbootEtherReadData函数来从网络读取数据,该函数由微软实现,这个函数会再调用OEMEthGetFrame函数从网卡读取数据,这个函数是要用户根据自己使用的网卡芯片实现的网

WinCE Eboot中的OEM控制函数

在EBOOT中有很多以OEM开头的函数,这些函数都会直接或间接的被BLCOMMON模块调用,来完成相应的功能.这些OEM函数就是我们需要根据自己的平台来实现的.可以说,实现了这些OEM函数,EBOOT的功能就完成了. 在EBOOT中有很多OEM函数,有些是必须实现的,有些是不必实现的,而有些是根据你的EBOOT的功能需求来决定是否要实现的.下面会介绍一下直接由BLCOMMON调用的OEM控制函数: 1. void OEMDebugInit(void) 这应该是第一个被调用的OEM函数,用来初始化

WinCE EBOOT中的BootPart分析

应该说BootPart算是微软提供的一个用于分区的模块,可以在EBOOT中使用.不过说实话,我很少使用它,知道有些厂商的BSP里面支持这个功能,而且也算是EBOOT的一部分,所以还是介绍一下.先看一下架构,如图: 在EBOOT中,BLCOMMON处于最上层,这个在以前已经介绍过,BootPart模块会被OEM函数来调用,而BootPart模块要操作存储设备需要Flash Driver的支持.这里要说的是Flash Driver是指WinCE下的Flash驱动,也就是FMD_xxx接口的驱动.所以

WinCE Eboot中的BLCOMMON

在EBOOT中,从Startup.s跳转到C程序入口以后,程序就可以用C语言来编写了,这样感觉就好多了.一般C语言的入口就是一个Main函数,也可能叫其他的名字.在这个Main函数中会掉用BootloaderMain函数,该函数在BLCOMMON模块中被定义的.一般Main函数的写法如下: void (void) { // Common boot loader (blcommon) main routine. BootloaderMain(); // Should never get here.

WinCE EBOOT中的Boot Args与Driver Globals

在EBOOT中包含的一个重要的缓冲区叫Driver Globals,它用于在设备驱动和WinCE OS之间共享数据.而在EBOOT中会用到的启动参数结构被称为Boot Args,是指用于EBOOT和WinCE OS之间共享一些参数信息.一般来说Boot Args会在EBOOT运行的时候被赋值或者更新,最常用的就是网络设备的相关信息设置,比如IP地址,MAC地址,中断等信息. Driver Globals包含了Boot Args,也就是说Driver Globals是一块内存缓冲区,其中里面也包含

wincewinmain-关于WinMain函数在windows及wince系统中定义不同

问题描述 关于WinMain函数在windows及wince系统中定义不同 WinMain函数在windows及wince系统中定义不同,其中windows中LPTSTR lpCmdLine,而wince中LPWSTR lpCmdLine,但我创建了一个win32程序,需要应用到wince系统中,但使用LPWSTR总是报错说WinMain函数不能重定义,但如果我把这个改成LPTSTR,然后xamlruntime.h(wince系统自带的头文件)中很多需要重新修改,非常麻烦,这样做也是不合理的(我

WinCE BSP中的Dirs文件和Sources文件

1.Dirs文件 关于Dirs文件,就是指定要编译的路径,这个地球人都知道.还是简单介绍一下.按照文档上面介绍有三种定义:DIRS,DIRS_CE和OPTIONAL_DIRS. DIRS:就是指定要编译的目录. DIRS_CE:只有目录下的源代码用于WinCE的映像文件时,才编译该目录. OPTIONAL_DIRS:指定可以选择编译的目录.比如:OPTIONAL_DIRS=proj1,如果想编译proj1目录,可以设置BUILD_OPTIONS=proj1,然后运行build命令就可以了. 举个

access-Access中定义GroupConcat函数时, .显示用户定义类型未定义,怎么修改?

问题描述 Access中定义GroupConcat函数时, .显示用户定义类型未定义,怎么修改? 定义的函数如下:Public Function GroupConcat(sColumn As String sTable As String Optional sCriteria As String Optional sDelimiter As String = "")On Error GoTo ErrHandlerDim rs As New ADODB.RecordsetDim sSQL