WINCE入门的第一个驱动程序_wince binary bsp 添加驱动程序-优快云博客

本文详细介绍了在Windows CE系统中开发一个简单驱动的过程，包括Makefile、source文件、SimpleDriver.def文件等内容，以及如何配置注册表和platform.bib文件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

WINCE的第一个驱动程序是什么呢？有的说是GPIO，有的说是LED，也有的说是SimpleDriver,我个人也是同意后者的。

因此这里就以SimpleDriver为例讲解如何开始自己的第一个驱动程序。

首先，要认识到一个驱动有哪些开发模型。这个相信大家都知道，比如本机驱动，分层驱动，流接口驱动等等，这些都闭着眼睛都知道，可是真正的实现呢？具体什么情况用什么模型呢？

关于分层驱动，介绍饿时最多的，尤其是网上和教科书还有一些所谓的论文，真正在产品中用这种方法的又有几个呢？不是分层驱动不好，只是要看具体情况，这个主要看个人喜好，个人能力还有就是在PUBLIC目录下是否有驱动的MDD。

因此，对于一个外设来说，尤其是一片子来说，个人认为单体驱动和流接口驱动用的更实际点，尤其涉及数据的传输，个人认为流接口驱动更容易一些。以上仅代表个人观点，欢迎拍砖。

其次，对于一个驱动我们要认清楚里面到底有哪些文件，他们的作用又是干什么的呢？下面以SimpleDriver为例，进行第一个简单流接口驱动的讲解。

1.Makefile文件

这里的Makefile文件请不要和其他环境下（GCC,VS2005）的Makefile文件弄混，它是BSP里面的Makefile。Windows CE中的Makefile比较特别，它包含对所有项目都通用的配置信息。

其内容很简单，只有一句话：

!INCLUDE $(_MAKEENVROOT)\makefile.def

当build.exe查找dirs和source文件之后，它就会设置一个内部环境变量。这个环境变量可以被Nmake.exe传递给编译器、连接器或其他工具。

2.source文件

source也是一个文本文件，它为子目录中的源代码设置了不少宏定义。

 
TARGETNAME=SimpleDriver

RELEASETYPE=PLATFORM

TARGETTYPE=DYNLINK

TARGETLIBS=$(_COMMONSDKROOT)\lib\$(_CPUINDPATH)\coredll.lib    

DEFFILE=$(TARGETNAME).def

DLLENTRY=DllEntry

SOURCES=SimpleDriver.c

以上是simpledriver里面source的内容，具体解释如下：

TARGETNAME=SimpleDriver；指定生成最终生成的.exe,.lib,.dll文件的名称，这里是SimpleDriver.dll

RELEASETYPE=PLATFORM；它设置两种旗标：RELEASEDIR和RELEASELIBDIR，用于指定编译生成二进制和库文件存放的目录。默认情况下，为目标生成的二进制和库文件存放在

;目录%_PROJECTROOT%\oak下,这里存放在D:\WINCE600\PLATFORM\Mini2440\target\ARMV4I\retail目录下。

TARGETTYPE=DYNLINK;这个宏定义指定构建文件的最终类型，可以把TARGETTYPE类型设置为一下四种类型中的任意一种。

1）MANAGED_EXE;

2) MANAGED_DLL;

3) MANAGED_WINEXE;

4) MANAGED_MODULE;

这里设置的最终类型为dll。

TARGETLIBS=$(_COMMONSDKROOT)\lib\$(_CPUINDPATH)\coredll.lib ；它指定了额外的库文件（.lib）和目标文件（.Obj）链接为目标可执行文件（.exe或.dll).

;这里将 coredll.lib 链接生成最终的目标文件SimpleDriver.dll

DEFFILE=$(TARGETNAME).def；它指定模块定义文件（.def）的名称，这里指定了模块定义文件的名称为SimpleDriver.def

DLLENTRY=DllEntry；它为一个DLL文件指定DLL的入口函数，此时TARGETTYPE被设置为DYNLINK。如果 DLLENTRY对应的值没有被设置时，那么_DllMainCRTStartUp是DLL的C程序

；运行入口点。这里 DLLENTRY的入口函数被指定为DllEntry，因而，上面的 TARGETTYPE被设置成DYNLINK;

SOURCES=SimpleDriver.c；它包含编译过程的文件列表，这些列表中包含汇编文件和源文件，这些文件的类型有.cxx,.cpp,.c,.asm,.s,.src,.rc,.obj,.ire,.res,.odl,.tlb,.i,.cs,.resx等。

；这些文件编译之后可能是静态库文件（.lib），也有可能是动态库文件（.dll）。这里编译过程中需要用到的源文件有SimpleDriver.c，

；编译之后的生成SimpleDriver.dll的动态链接库文件。

3.SimpleDriver.def文件

.def文件定义了DLL的导出函数列表。
这里包括的内容如下：

LIBRARY SimpleDriver

EXPORTS 

    SPL_Init

    SPL_Deinit

    SPL_Open

    SPL_Close

    SPL_Read

    SPL_Write

    SPL_Seek

    SPL_IOControl

    SPL_PowerDown

    SPL_PowerUp

主要是针对当前流接口函数，将相应的函数导出。

4. SimpleDriver.h

这个而就不用多介绍了吧，主要是一些头文件的声明，定义等等

5.SimpleDriver.c

下面给出基本的代码，有些函数给出了空定义，方便以后实现，同时方便理解。

#include <windows.h>

#include <types.h>

static BYTE g_Tmp = 0;                        /* 暂存数据变量 */

static DWORD g_OpenCount = 0;                /* 驱动打开计数器 */ 

/*******************************************************************************************

函数名称: DllEntry

描    述: 驱动程序动态库入口

输入参数:     

输出参数:

返    回: 

*******************************************************************************************/

BOOL WINAPI DllEntry(HANDLE hInstDll, DWORD dwReason, LPVOID lpvReserved)

{

    switch ( dwReason ) 

    {

        case DLL_PROCESS_ATTACH:

            RETAILMSG(1, (TEXT("SPL: DLL_PROCESS_ATTACH.\r\n")));    /* 提示动态库加载 */

            DisableThreadLibraryCalls((HMODULE) hInstDll);            

            break;

        case DLL_PROCESS_DETACH:

            RETAILMSG(1, (TEXT("SPL: DLL_PROCESS_DETACH.\r\n")));    /* 提示动态库卸载 */

            break;

    }

    return (TRUE);

}

/*******************************************************************************************

函数名称: SPL_Init

描    述: 驱动程序初始化函数

输入参数: DWORD dwContext: 设备管理器传递给本驱动的参数, 通常为流接口驱动在注册表内的位置     

输出参数: 无

返    回: 驱动程序句柄

*******************************************************************************************/

DWORD SPL_Init(DWORD dwContext)

{

    RETAILMSG(1, (TEXT("::: SPL_Init.\r\n")));        /* 提示驱动加载 */

    g_Tmp = 0;                                        /* 初始化全局变量的值 */

    g_OpenCount = 0; 

    return 1;                                        /* 返回一个不为零的数表示成功 */

}

/*******************************************************************************************

函数名称: SPL_Deinit

描    述: 驱动程序卸载函数

输入参数: DWORD dwContext: 驱动程序句柄

输出参数: 无

返    回: FALSE: 失败    TRUE: 成功

*******************************************************************************************/

BOOL SPL_Deinit(DWORD dwContext)

{

    RETAILMSG(1, (TEXT("::: SPL_Deinit.\r\n")));    /* 提示驱动卸载 */

    g_Tmp = 0;                                        /* 恢复全局变量的值 */

    g_OpenCount = 0; 

    return TRUE;

}

/*******************************************************************************************

函数名称: SPL_Open

描    述: 打开驱动程序

输入参数: DWORD hDeviceContext: 设备驱动程序引用实例句柄

          DWORD AccessCode    : 访问请求代码,是读和写的组合

          DWORD ShareMode      : 共享模式  

输出参数:

返    回: 驱动程序引用事例句柄

*******************************************************************************************/

DWORD SPL_Open(DWORD hDeviceContext, DWORD AccessCode, DWORD ShareMode)

{

    RETAILMSG(1, (TEXT("::: SPL_Open.\r\n")));         /* 提示驱动打开 */

    // 不允许多个应用程序打开本驱动

    if (g_OpenCount != 0)

    {

        RETAILMSG(1, (TEXT("SPL Open failed.\r\n")));/* 提示驱动打开失败 */

        return 0;

    }

    g_OpenCount++;                                     /* 驱动打开计数器加1 */

    return g_OpenCount;                                 /* 必须返回一个不为空的句柄 */

}

/*******************************************************************************************

函数名称: SPL_Close

描    述: 驱动程序关闭函数

输入参数: DWORD hOpenContext：驱动程序引用事例句柄

输出参数: 无

返    回: FALSE: 失败    TRUE: 成功 

*******************************************************************************************/

BOOL SPL_Close(DWORD hOpenContext)

{

    RETAILMSG(1, (TEXT("::: SPL_Close.\r\n")));             /* 提示驱动关闭 */

    if (g_OpenCount != 0) 

        g_OpenCount--;                                     /* 驱动打开计数减1 */

    return TRUE;

}

/*******************************************************************************************

函数名称: SPL_IOControl

描    述: 驱动程序 I/O 请求

输入参数: 

输出参数:

返    回: TRUE: 成功   FALSE: 失败

*******************************************************************************************/

BOOL SPL_IOControl(DWORD hOpenContext,

                   DWORD dwCode,

                   PBYTE pBufIn,

                   DWORD dwLenIn,

                   PBYTE pBufOut,

                   DWORD dwLenOut,

                   PDWORD pdwActualOut)

{

    RETAILMSG(1, (TEXT("::: SPL_IOControl.\r\n")));         /* 提示I/O请求函数执行 */

    return TRUE;

}

/*******************************************************************************************

函数名称: SPL_Read

描    述: 从本驱动读取数据

输入参数: DWORD hOpenContext: 驱动程序引用事例句柄

          DWORD Count        : 要读的字节数

输出参数: LPVOID pBuffer    : 接收缓冲区

返    回: 实际读到的字节数

*******************************************************************************************/

DWORD SPL_Read(DWORD hOpenContext, LPVOID pBuffer, DWORD Count)

{

    uchar *pReadBuffer;

    RETAILMSG(1, (TEXT("::: SPL_Read.\r\n")));                  /* 提示执行读函数 */

    if ((pBuffer == NULL) || (Count <= 0))

    {                                                          /* 读函数入口参数错误 */

        RETAILMSG(1, (TEXT("::: SPL_Read() parameter is error.\r\n")));            

        return 0;

    }

    // 映射地址空间

    pReadBuffer = MapPtrToProcess(pBuffer, GetCallerProcess());

    *pReadBuffer = g_Tmp;                                      /* 返回数据 */

    return 1;                                                /* 返回读取的字节数 */

}

/*******************************************************************************************

函数名称: SPL_Write

描    述: 向本驱动写入数据

输入参数: DWORD hOpenContext: 驱动程序引用事例句柄

          LPVOID pBuffer    : 发送缓冲区

          DWORD Count        : 要写入的字节数

输出参数: 无

返    回: 实际写入的字节数

*******************************************************************************************/

DWORD SPL_Write(DWORD hOpenContext, LPCVOID pBuffer, DWORD Count)

{

    uchar *pWriteBuffer;

    RETAILMSG(1, (TEXT("::: SPL_Write.\r\n")));                  /* 提示执行写函数 */

    if ((pBuffer == NULL) || (Count <= 0))

    {                                                          /* 写函数入口参数错误 */

        RETAILMSG(1, (TEXT("::: SPL_Write() parameter is error.\r\n")));            

        return 0;

    }

    // 获取应用程序地址空间数据指针

    pWriteBuffer = MapPtrToProcess((LPVOID)pBuffer, GetCallerProcess());

    g_Tmp = *pWriteBuffer;                                    /* 保存数据 */

    return 1;

}

/*******************************************************************************************

函数名称: SPL_Seek

描    述: 对设备的数据指针进行操作,本驱动不支持该函数

输入参数: 

输出参数:

返    回:

*******************************************************************************************/

DWORD SPL_Seek(DWORD hOpenContext, long Amount, DWORD Type)

{

    RETAILMSG(1, (TEXT("::: SPL_Seek.\r\n")));                  /* 提示执行本函数 */

    return 0;

}

/*******************************************************************************************

函数名称: SPL_PowerUp

描    述: 电源上电驱动处理函数

输入参数: 

输出参数:

返    回: 无

*******************************************************************************************/

void SPL_PowerUp(void)

{

    RETAILMSG(1, (TEXT("::: SPL_PowerUp.\r\n")));             /* 提示执行本函数 */

}

/*******************************************************************************************

函数名称: SPL_PowerDown

描    述: 电源下电驱动处理函数

输入参数: 

输出参数:

返    回: 无

*******************************************************************************************/

void SPL_PowerDown(void)

{

    RETAILMSG(1, (TEXT("::: SPL_PowerDown.\r\n")));             /* 提示执行本函数 */

}

OK！

到这里点击编译就可以了。这个新驱动程序的动态链接库将会被编译进内核。当调用CreateFile()函数（第一个参数是SPL）时就搜索注册表，设备管理器可以找到这个驱动，驱动的入口点可以用到其他程序。

上文介绍了WINCE一个简单驱动的编写，这节我们接着介绍一些配置文件的编写。涉及到的文件有.platform.bib，platform.reg,dirs,source,SimpleDriver.def,其中后面两个文件在前文已有介绍，这里就以前两个配置文件为主。

首先，从注册表说起，先简单的介绍一下注册表：Makeimg.exe使用.reg文件来为CE镜像建立注册表并添加默认的键值。也就是说，在.reg中写入的注册表的键值会被默认地放入CE镜像的初始化注册表中。其中Platform.reg定义了目标设备硬件的注册表设置，Project.reg定义基于Windows CE项目工程的注册表设置。注册表键值的类型如下：

1. REG_SZ表示一个字符串类型，如reg_sz:”my string”。

2. REG_DWORD表示一个双字节类型，如dword:12345678(十六进制数)。

3. REG_MULTI_SZ表示多字符串类型，如multi_sz：“my string”,“my string”。

4. REG_BINARY 二进制类型。

在实际应用中可以使用IF/ENDIF关键字来引入一个注册表设置块，通过设置一个环境变量或一个特殊的值来达到这个目的。

为了包含一个注册表设置块，当一个环境变量没有被设置或者没有等于一个特定的值的时候，引入的注册表设置块的行尾应使用一个空格和“！”。

这里比较好找，一目了然，在目录D:\WINCE600\PLATFORM\SMDKXXXX\Files\platform.reg下添加：

[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SPL]

   "Prefix"="SPL"

   "Dll"="SimplDriver.Dll"

   "FriendlyName"="Simple Driver"

   "Order"=dword:0

   "Index"=dword:0

这样在WINCE启动时，就自动加载该驱动了。

接着我们介绍platform.bib文件，关于bib文件，这里做一个简要的介绍：二进制镜像文件构建文件（.bib）定义了哪个模块或者文件被包含到运行时的CE镜像中。在编译期间，makeimg.exe使若干个.bib文件合并成ce.bib文件，然后，romimage.exe使用ce.bib决定哪些文件应该被打包进运行时CE镜像中，它同时还使用ce.bib来决定如何加载模块和文件到CE镜像（下载到目标设备的CE镜像）所在的内存中。

按照功能划分，.bib文件可以分为如下几种类型。

（1） Platform.bib。Platform.bib位于目录D:\WINCE600\PLATFORM\SMDK6410\Files，它包含硬件平台相关的模块和文件，如目标设备的驱动文件。这些模块和文件是CE镜像的入口，比如.exe文件，如波形音频文件（.wav）等。

（2） Project.bib。Project.bib weiyumulu D:\WINCE600\PUBLIC\CEBASE\OAK\FILES,如果我们新建一个工程项目（OSDesign1）则这个工程位于目录：D:\WINCE600\OSDesigns\OSDesign1\OSDesign1\Wince600\SMDK6410_ARMV4I\OAK\files下。Project.bib文件定义与创建CE镜像的工程相关的模块，如果在OSDesign1中创建了一个自己的模块或者应用程序，那么就要把它们添加到Project.bib文件中的MODILES部分。

（3） Common.bib。Common.bib位于目录D:\WINCE600\PUBLIC\COMMON\OAK\FILES下，它定义了CE镜像文件包含的通用显示驱动和核心系统模块。

（4） Config.bib。Config.bib位于目录D:\WINCE600\PLATFORM\SMDK6410\Files下，它定义了ROM和RAM的配置信息。它同样包含了CE镜像文件的MEMORY和CONFIG部分。Config.bib的MEMORY部分定义了运行时CE镜像内存分配表，指定了名称、地址、大小和MEMORY区域的类型。