wince流驱动入门讲解Word文件下载.docx
《wince流驱动入门讲解Word文件下载.docx》由会员分享,可在线阅读,更多相关《wince流驱动入门讲解Word文件下载.docx(19页珍藏版)》请在冰点文库上搜索。
\src\drivers\中,这些驱动都是与平台相关的。
移植工作所修改的源代码有可能仅仅只有几十行甚至几行代码,但在修改之前却需要花费大量的时间了解驱动架构、熟悉驱动接口、分析源程序代码、找出需要修改的位置。
本质上讲,移植与从头开发一个驱动的差别仅仅在于少写了很多程序。
省去了编写这部分程序的时,但对驱动程序开发者的水平要求似乎并没有丝毫的降低。
第三章流接口函数
流接口函数也称作流接口驱动程序的入口点,每个流接口驱动程序必须实现一组标准的函数,用来实现标准的文件I/O函数和电源管理函数,这些函数提供给WindowsCE操作系统的内核使用。
这些函数通常叫做流接口驱动程序的DLL接口。
以下介绍几个主要的流接口驱动接口函数。
(1)DWORDXXX_Open(DWORDhDeviceContext,
DWORDAccessCode,
DWORDShareMode)
参数:
DWORDhDeviceContext,设备驱动的句柄,由XXX_Init函数创建的时候返回。
DWORDAccessCode,传给驱动程序使用的地址,这个地址跟读和写有关。
DWORDShareMode,共享模式,这个参数用于一些特殊的设备。
例如一些PC卡的设备读或写的时候是否可以共享。
返回值:
返回驱动程序引用事例句柄。
描述:
这个函数用于打开一个设备驱动程序,当应用程序准备对某一个设备进行读或写操作时,系统必须先执行CreateFile()这个函数用于打开这个设备。
这个函数执行以后系统才能够执行读和写操作。
(2)BOOLXXX_Close(DWORDhOpenContext)
DWORDhOpenCnntext,设备驱动的引用事例句柄,由XXX_Open创建。
调用成功返回TRUE,失败返回FALSE口
这个函数用于关闭一个驱动程序的引用实例。
应用程序通过CloseHandle()来调用这个函数,当执行完这个函数的时候驱动程序引用的事例,hOpenContext将不再有效。
(3)DWORDXXX_Init(DWORDdwContext)
DWORDdwContext,指向字符串的指针。
通常这个参数都为一个流接口驱动在注册表内的设置。
如果调用成功返回一个驱动程序的句柄。
当用户开始使用一个设备的时候,例如,当PC卡初始化的时候,设备管理器调用这个函数来初始化PC卡设备。
这个函数并不是由应用程序直接调用的,而是通过设备管理器提供的ActivateDeviceEx()函数来调用的。
函数执行后如果成功则返回一个设备的句柄。
(4)BDOLXXX_Deinit(DWORDhDeviceContext)
DWORDhDeviceContext,由xxx_Init创建时生成的设备句柄。
调用成功返回TRUE,失败返回FALSE。
当一个用户需要卸载一个驱动程序的时候,设备管理器调用这个函数来卸载这个驱动程序,应用程序不能够直接调用这个函数,设备管理器通过DeactivateDeviec()函数调用这个函数。
(5)DWORDXXX_Read(DWORDhOpenContext,
LPVOIDpBuffer,
DWORDCount)
DWORDhOpenContext,CreateFile()函数返回的句柄。
LPVOIDpBuffer,一个缓冲区地址用于从驱动读数据。
DWORDCount,需要读缓冲区的长度。
实际读取字节的长度。
这个函数与ReadFile很相似,当一个流接口驱动程序已经被打开后,应用程序可以使用ReadFile()函数对这个设备进行读操作,ReadFile()里面的hFile参数就是这个设备的引用实例句柄hOpenContext,而参数lpBuffer将传给pBuffer,用于表示要读/写缓冲区的地址。
参数nNumberofBytesToRead将传送给Count,用于表示要读写缓冲区的长度。
同样,返回的参数,如果操作成功则返回实际读/写的地址,如果操作失败则返回值为-1。
(6)DWORDXXX_Write(DWDRDhOpenContext,
LPCVOIDpuffer,
DWDRDCount)
参数:
DWDRDhOpenContext,由CreateFile()函数返回的句柄。
LPVOIDpBuffer,一个缓冲区地址,用于从驱动写数据。
DWORDCount,需要写缓冲区的长度。
实际写入字节的长度。
当一个流接口驱动程序打开以后,应用程序可以使用WriteFile()函数进行写操作。
(7)BOOLXXX_IOControl(DWORDhQpenContext.
WORDdwCode,
PBYTEpBufIn,
DWORDdwLenIn,
PBYTEpBufOut,
DWORDdwLenDut,
PDWORDpdwActualOut)
DWORDhOpenContext,由CreateFile()函数返回的句柄。
WORDdwCode,特殊的WORD型用于描述这次IOControl操作的语义,一般这个都由用户自己定义。
PBYTEpBufIn,缓冲区指针指向需要传送给驱动程序使用的数据。
DWORDdwLenIn,要传送给驱动程序使用数据的长度。
PI3YTEpBufOut,缓冲区指针指向驱动程序传给应用程序使用的数据:
DWDRDdwLEnOut,要传送给应用程序使用数据的长度。
PDWORDpdwActualOut,DWORD型指针用于返回实际处理数据的长度。
调用成功返回TRUE,调用失败返回FALSE。
这个函数通常用于向设备发送命令。
应用程序使用DeviceIOControl函数来通知操作系统调用这个函数。
通过参数dwCode来通知驱动程序要执行的操作。
这个函数扩展了流接口驱动程序的功能
(8)VOIDXXX_PowerDown(DWORDhDeviceContext)
DWORDhDeviceContext,由XXX_Init创建时生成的设备句柄。
无返回值。
(9)VOIDXXX_PowerUp(DWORDhDeviceContext)
WORDhDeviceContext,由XXX_init创建时生成的设备句柄。
PowerDown和PowerUp这两个函数通常都必须要硬件的支持才能够有效,也是说相关的硬件必须支持PowerDown和PowerUp这两个模式。
(10)VOIDXXX_Seek(hDeviceContext,
LongAmount,
WORDType)
hDeviceContext,由XXX_init创建时生成的设备句柄。
LongAmount定义要移动的设备数据的指针的字节数
WORDType定义数据指针的起始点
无返回值
当一个应用程序调用SetFilePointer函数移动设备数据指针时,操作系统会调用XXX_Seek函数。
如果一个设备可以被多次打开,这个函数只修改由hDeviceContext定义的设备实例的数据指针。
第四章最简单的流接口函数
对于一个驱动我们要认清楚里面到底有哪些文件,他们的作用又是干什么的呢?
下面以SimpleDriver为例,进行第一个简单流接口驱动的讲解。
*1.Makefile文件
这里的Makefile文件请不要和其他环境下(GCC,VS2005)的Makefile文件弄混,它是BSP里面的Makefile。
WindowsCE中的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。
;
_COMMONSDKROOT等价于\WINCE600\public\common\sdk
它指定了额外的库文件(.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的导出函数列表。
这里包括的内容如下:
LIBRARYSimpleDriver
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
下面给出基本的代码,有些函数给出了空定义,方便以后实现,同时方便理解。
*6.platform.reg
配置文件的编写。
涉及到的文件有.platform.bib,platform.reg,dirs,source,SimpleDriver.def,其中后面两个文件在前文已有绍,这里就以前两个配置文件为主。
首先,从注册表说起,先简单的介绍一下注册表:
Makeimg.exe使用.reg文件来为CE镜像建立注册表并添加默认的键值。
也就是说,在.reg中写入的注册表的键值会被默认地放入CE镜像的初始化注册表中。
其中Platform.reg定义了目标设备硬件的注册表设置,Project.reg定义基于WindowsCE项目工程的注册表设置。
注册表键值的类型如下:
1.
REG_SZ表示一个字符串类型,如reg_sz:
”mystring”。
2.
REG_DWORD表示一个双字节类型,如dword:
12345678(十六进制数)。
3.
REG_MULTI_SZ表示多字符串类型,如multi_sz:
“mystring”,“mystring”。
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"
0//驱动名的数字部分
注:
Order
给所有的驱动设置相对安装顺序。
Order为0的驱动先安装,依次安装Order为1,2,…的驱动。
Oder可以让开发者保证有相到依赖关系的多个驱动以适当的顺序进行安装。
Index
指定在文件系统中的驱动名的数字部分。
在默认情况下,带有前缀COM的驱动在文件系统中分配名字为COM1,下一个即为COM2。
为了保证驱动总是安装成COM2,必须提供Index=2。
这样在WINCE启动时,就自动加载该驱动了。
*7.platform.bib
接着我们介绍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位于目录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区域的类型。
.bib文件可以被分为四个部分,分别是MEMORY、CONFIG、MODULES和FILES。
下面将分别说明这四个部分各自的含义。
MEMORY。
定义可用的物理内存,包括起始地址、大小和内存类型。
CONFIG。
定义romimage.exe输出的配置选项。
默认情况下,这个区域是在config.bib文件中。
不过,也并不是.bib文件中必须要包含CONFIG部分。
FILES。
指定放在CE镜像中的文件列表。
MODULES。
指定放在CE镜像总的模块列表,包括EXE和DLL文件,与FILES的区别是放在MODULES中的文件通常是代码文件,并且构建系统时不会压缩这些文件。
这里我们主要介绍Modules部分。
Modules部分指定了哪些基于WindowsCE的模块包含到CE镜像中,以及如何给加载到config.bib文件中的MEMORY部分建立内存表。
这个部分可以包含200个模块,这些模块有源代码和数据两个部分组成。
MODULES的语法格式如下:
;
Name
Path
Memoryblock
Sectionoverride
MemoryType
---
-----
------------
---------
--------
各参数之间用空格分隔。
NAME:
这个参数指定了MODULES模块的名称。
通常情况下,它就像被路径引用的文件名称一样。
PATH:
指定要打包进CE镜像的MODULES模块的完整路径。
MEMORYBLOCK:
这个参数指定romimage.exe加载目标模块到内存区域的ramimage(镜像)部分。
这个内存位于config.bib文件中memory部分指定的某一段内存。
SECTIONOVERRIDE:
这个参数的设置时可选的,它可以为modules、files或者空。
如果设置了这个参数,那么构建系统就会根据它来决定这一项是modules还是files。
TYPE:
这个参数指定文件的类型,主要有以下几种类型,在实际的使用中可以选用其中的一种或者多种组合。
S:
定义一个系统文件
H:
定义一个隐藏文件
R:
压缩资源,只应用于MODULES部分
C:
如果应用于一个模块,则压缩全部内容
5.
D:
运行时不允许调试。
6.
N:
标记一个模块为不可信任的,只应用MODULES部分。
7.
K:
指定romimage.exe必须修正模块到一个内核地址。
在这个过程中,romimage.exe分配一个固定的虚拟地址给DLL,设置了此标志的模块只可以被loadKernelLibrary()函数加载。
8.
P:
指定romimage.exe禁止在头文件中检查指定的CPU类型。
这个旗标只用于资源dll,可以在一种CPU伤编译,在不同CPU上使用。
9.
M:
表示对此页