如何在 Windows CE 5.0 中开发和测试设备驱动程序[一]

摘要：本文介绍如何开发和测试 Windows CE 5.0 设备驱动程序。本文循序渐进地介绍如何创建流驱动程序，如何创建自定义 Windows CE Test Kit (CETK) 测试，以及如何编写应用程序来测试驱动程序。这要花费大约 60 分钟来完成。

第一部分：建立设备驱动程序

在本练习中，您将使用 Platform Builder 来添加作为设备驱动程序的项目。

在开始编写驱动程序之前，您应该了解设备驱动程序的用途。驱动程序将基础硬件从操作系统中抽象出来，使之更好地面对应用程序开发人员。应用程序开发人员无需知道显示硬件或串行硬件的详细信息 — 例如，串行设备是用 Universal Asynchronous Receiver/Transmitter (UART) 实现的还是用 field-programmable gate array (FPGA) 实现的。在大多数情况下，应用程序开发人员根本不需要知道硬件是如何实现的。

Microsoft Windows 为开发人员公开了调用硬件的应用程序编程接口 (API)，他们不需要知道物理硬件的情况。例如，为了向串行端口写入数据，应用程序开发人员只需调用 COMx 上的 CreateFile( )（其中 x 表示您要打开的串行端口编号，例如 COM1 代表串行端口 1），再调用 WriteFile( ) 以将一些字节数据写入串行端口，然后调用 CloseHandle( ) 以关闭串行端口。不管基础串行硬件是什么（也不管您运行的是哪个 Windows 操作系统），API 都会以同样的顺序执行。

相同的情况也适用于其他 API：如果您希望在显示表面画一条线，那么您只需调用 PolyLine( )、MoveToEx( ) 或 LineTo( )。作为应用程序开发人员，大多数情况下您都不需要知道显示硬件的情况。此处调用的 API 将返回显示表面的维数、颜色深度等等。

好消息是开发人员可以调用一个一致的、众所周知的 API 集。这些 API 将他们的应用程序从基础硬件中抽象出来。这至关重要，因为应用程序开发人员无法知道应用程序是运行在便携式计算机上，还是运行在 Tablet PC 上，抑或运行在桌面计算机上。无论电脑以 1024×768 还是 1600×1200 的分辨率运行，应用程序开发人员都可以在运行时查询屏幕分辨率和颜色深度，因此不需要构建只在特定硬件上运行的应用程序。

驱动程序只是一个动态链接库(DLL)。将 DLL 加载到父进程地址空间；然后父进程就可以调用从该 DLL 公开的任何接口。通常，父进程通过调用 LoadLibrary( ) 或 LoadDriver( ) 来加载驱动程序。LoadDriver 不仅将 DLL 加载到父进程地址空间中，而且还要确保 DLL 没有“paged out”。

调用进程如何知道从您的 DLL 或驱动程序公开了哪些 API 或函数呢？父进程调用 GetProcAddress( )，后者可以获取函数名称和所加载的 DLL 的 hInstance。如果函数存在，调用返回该函数指针；如果没有从 DLL 公开该函数，则返回 NULL。

流驱动程序也公开了一个众所周知的函数集。对于流驱动程序，您会希望能够将字节流写入设备中，或者从设备中读取字节流。因此，在前面使用的串行端口示例中，您可能希望从您的驱动程序公开如下函数集：Open、Close、Read 和 Write。流驱动程序还公开一些其他函数：PowerUp、PowerDown、IOControl、Init 和 DeInit。

您可以将现有的操作系统映像用于模拟器平台（Basic Lab MyPlatform 平台最理想）。然后，您就可以将 DLL/驱动程序项目添加到该平台了。

在构建并下载了该平台之后（这表明操作系统启动并运行良好），您需要创建您的主干驱动程序。您可以使用 File 菜单上的 Platform Builder New Project or File 命令创建一个 Microsoft Windows CE DLL。创建用于公开函数或资源的 DLL 与创建用作驱动程序的 DLL 之间没有什么不同；唯一的不同之处在于 DLL 公开哪些函数，以及如何在平台上注册或使用 DLL。

此外，一种创建国际化应用程序的方法是，首先创建包含一组核心语言字符串、对话框和资源的基本应用程序，然后创建许多外部 DLL，其中每个都包含针对特定区域设置的对话框、字符串和资源。然后，应用程序就可以在运行时加载相应的语言资源。只需要添加 DLL 文件，您就可以将语言添加到应用程序中。在 一书中描述了与此相关的主题以及其他一些有趣的主题，可以在 Microsoft Press 网站上获得此书。

添加一个作为设备驱动程序的项目

1. 用 Platform Builder 打开现有的 MyPlatform 工作区。

2. 在 File 菜单上，单击 New Project or File。

3. 选择 WCE Dynamic-Link Library，给它一个合适的名称（例如，StreamDrv），然后单击 OK，如下图所示。

4. 在下图所显示的页面中多少填写一些您需要的信息，然后单击 Next。

5. 单击 A simple Windows CE DLL project，如下图所示。

6. 单击 Finish 完成此向导。

此时，DLL 只包含一个空的 DllMain 函数。您可以公开一些应用程序要调用的函数，并公开一些资源（可能使之成为识别语言/文化的应用程序的一部分），或者使之成为一个设备驱动程序。在本文中，您将使用 Windows CE Stream Driver Wizard 创建您的主干流驱动程序。

在 Windows CE 中，打开流驱动程序就像打开文件一样，只需根据唯一的三字母前缀（例如，COM）。

7. 为您的驱动程序选择一个唯一的三字母标识符。在 Location 框中输入您之前创建的流驱动程序的完整路径。或者使用“browse”按钮定位到 Platform Builder 安装中的 PBWorkspaces 目录，找到您前面创建的平台，然后找到流驱动程序的名称（在前面的示例中，此路径为 PBWorkspaces\TuxPlat\StreamDrv）。

8. 在 Driver Filename 框中输入驱动程序的名称。如下图所示，使用与您前面使用名称 (StreamDrv) 相同的名称，以确保改写在 Platform Builder 中创建的原始文件。

9. 按 Go，将生成流驱动程序源代码。

第二部分：测试流驱动程序测试代码

现在您已经编写了用于 Windows CE 的自定义流驱动程序的基本代码。此时，驱动程序还没有与任何硬件连接。

在编写完驱动程序之后，您需要为开发人员提供一种测试它的方法。Windows CE 附带了 Windows CE Test Kit (CETK)，它提供了用于各种驱动程序类型的驱动程序测试，包含网络连接、蓝牙、串行端口以及显示。您编写的驱动程序是一种自定义的流驱动程序，它没有公开与现有的驱动程序测试一样的功能，因此您需要为该驱动程序编写一个自定义测试。虽然您完全可以编写一个应用程序来演练驱动程序，但提供一个 CETK 模块或许更好些，在开发期间可以使用此模块，并且还可以将此模块提供给客户，供他们在装配硬件上测试驱动程序。

在这一部分的练习中，您将执行以下过程：

·   创建主干 Tux 模块

·   将自定义驱动程序的测试代码添加到 Tux DLL 中

·   重新构建操作系统

·   设置断点

创建主干 Tux 模块

1. 在 Platform Builder 中，在 File 菜单上单击 New Project or File。

2. 选择 WCE TUX Dynamic-Link Library，键入 TuxTest 作为项目名称，输入一个位置，单击 Workspace Project，然后单击 OK，如下图所示。（实际上，您可以选择任意一个项目类型；对于本文，单击 Workspace Project）。

3. 在下图显示的页面中多少填写一些您需要的信息，然后单击 Next。

4. 阅读下图所显示的屏幕上的信息，然后单击 Next。

5. 在最后一页上，您可以选择选取 Release Type 下的 CETK，如下图所示。该选项关闭了某些二进制的优化，以提高调试工作效率。单击 Finish。

6. 单击 View | File View，然后展开 Projects 树显示 tux 源代码，如下图所示。

前图中需要注意的重要文件是：

·       ft.h — 该文件包含 tux DLL 所用的函数表。

·       test.cpp — 该文件包含从该函数表中调用的测试过程。

TuxStreamTest.cpp — 该文件包含 DLLMain 和 ShellProc，后者是从 Tux.exe 调用的。

将自定义驱动程序测试代码添加到 Tux DLL 中

1. 打开源代码 Test.cpp。

2. 使用 CodeClip 来获得 Tux_Custom_Test | TuxCode 源代码。

3. 用 CodeClip 中的代码替代函数 TestProc 中的内容。

您会注意到，Test.cpp 中的代码加载了一个名为 Demo.dll 的驱动程序。对于本文，您创建了一个名为 StreamDrv 的驱动程序。您需要修改源代码以加载您的 StreamDrv.dll 驱动程序。

4. 找到 Test.cpp 中调用 LoadLibrary 的源代码的位置，然后将要从 Demo.dll 中加载的驱动程序的名称修改为 StreamDrv.dll。

5. 在 Platform Builder 文件视图中，右键单击 TuxTest 项目，然后单击 Build Current Project。

您还需要从该目录中添加 Windows CE Test Kit 组件。

6. 在 Device Drivers 下，找到该目录中 Windows CE Test Kit 组件的位置，然后选择 Add the Windows CE Test Kit，将该组件添加到您的平台中。

注 将该组件添加到您的平台上并没有将任何文件添加到最后的操作系统映像中；它将 Clientside 文件添加到 build release 文件夹中。您可以从 Platform Builder 下载 Clientside 应用程序，并在目标设备上运行该应用程序。

现在您需要重新构建您的操作系统，以便合并这些变更。

重新构建操作系统

·   在 Platform Builder 中，选择 Build OS | Sysgen。

构建过程将会花大约 5 分钟完成。

当加载驱动程序时，在流驱动程序的入口点设置一个断点来观察非常有用。

设置断点

1. 单击 File View，打开 StreamDrv 项目，然后打开 Source files。

2. 找到并打开 StreamDrv.cpp。

3. 找到 DllMain，然后找到并单击 switch 语句。

4. 按 F9 设置断点。

5. 单击 Target | Attach，将操作系统下载到模拟环境中。

您会看到以下调试输出，断点将启用。注意，在加载操作系统的用户接口 (UI) 之前，这早就发生了。

4294780036 PID:23f767b6 TID:23f767e6 0x83fa6800: >>> Loading module streamdrv.dll at address 0x01ED0000-0x01ED5000

Loaded symbols for 'C:\WINCE500\PBWORKSPACES\DRVDEMO\RELDIR\EMULATOR_X86_DEBUG\STREAMDRV.DLL'

6. 单击 switch 语句，然后按 F9 禁用断点。

7. 按 F5，允许操作系统继续加载。

现在，您已经构建了一个 Windows CE 5.0 操作系统，它包含一个自定义流驱动程序，并且您已经在操作系统引导顺序的过程中看到了驱动程序加载。

第三部分：检验驱动程序

在这一部分的练习中，您将执行以下过程：

·   使用命令行工具查看从驱动程序公开的函数

·   使用远程系统信息 (Remote System Information) 工具检验驱动程序

·   确定驱动程序已加载

检验您所创建的设备驱动程序的第一种方法是查看从该驱动程序公开的函数。Windows CE 附带了一个名为 Dumpbin 的命令行工具，可以用于检验导入应用程序或模块的内容，或者从 DLL（或驱动程序）导出的内容。

使用命令行工具查看从驱动程序公开的函数

1. 在 Platform Builder 中，单击 Build OS | Open Release Directory。该操作为当前的工作区打开 build release 文件夹中的 Command Prompt 窗口。

2. 键入 dumpbin exports StreamDrv.dll

下图显示输出。您可以看到，所有需要的流驱动程序函数都是从驱动程序公开的；函数是从 DLL 公开的（通过该项目的 .def 文件）。

3. 键入 Exit 关闭 Command Prompt 窗口

StreamDrv.def 文件的内容如下所示。

LIBRARY DemoDriver

EXPORTS

   DEM_Init

   DEM_Deinit

   DEM_Open

   DEM_Close

   DEM_IOControl

   DEM_PowerUp

   DEM_PowerDown

   DEM_Read

   DEM_Write

   DEM_Seek

   CustomFunction

   CustomFunctionEx

您可以检验驱动程序的第二种方法是通过远程系统信息工具。

通过远程系统信息工具检验驱动程序

1. 在 Platform Builder 中，单击 Tools | Remote System Information。

2. 选择 Windows CE Default Platform | Default Device，然后单击 OK，如下图所示。

此过程将远程系统信息应用程序连接到 Platform Builder 正在使用的当前活动平台上。下图显示了结果。

您也可以使用加载模块列表来确定已加载了您的驱动程序。

确定驱动程序已加载

·   在 Platform Builder 中，使用 Target Control 窗口 (gi mod) 或 View | Debug Windows | Modules and Symbols。

下图显示了此过程的结果。