WHQL认证流程和测试环境介绍

1、LEADCORE联芯科技WHQL 认证流程和测试环境介绍项目名称 文档编号 版本号 作者版权所有联芯科技有限公司本资料及其包含的所有内容为联芯科技有限公司所有，受中国法律及适用之国际公约中有关著作权法律的保护。未经大唐移动书面授权，任何人不得以任何形式复制、传播、散布、改动 或以其它方式使用本资料的部分或全部内容，违者将被依法追究责任。1.0李玉忠2文档更新记录日期更新人版本备注2009-3-17李玉忠1.0初始版本3目录1引言 .错. 误！未定义书签1.1编写目的 . 错 误！未定义书签。1.2预期读者和阅读建议 . 错 误！未定义书签。1.3文档约定 . 错 误！未定义书签。1.4参考资料

2、 . 错 误！未定义书签。1.5缩写术语 . 错 误！未定义书签。2 WHQL 认证 .错. 误！未定义书签*什么是 WHQL 认证 . 错 误！未定义书签。*WHQL 认证流程 . 错 误！未定义书签。获得 Windows 徽标的优势 . 错 误！未定义书签。行为推荐 . 错 误！未定义书签。启动 WHQL 认证 . 错 误！未定义书签。WHQL 支持信息与技术合作 . 错 误！未定义书签。建立 Winqual 网站的在线账户 . 错误！未定义书签。申请公司帐号 . 错 误！未定义书签。设置帐号权限 . 错 误！未定义书签。签署法律协议 . 错 误！未定义书签。下载 WLK 工具 . 错 误

3、！未定义书签。使用 DTM 工具完成 WHQL 测试 . 错误！未定义书签。检查测试日志 . 错 误！未定义书签。在 Winqual 网站提交测试结果和驱动程序 . 错 误！未定义书签。为提交准备测试日志 . 错 误！未定义书签。提交测试结果 . 错 误！未定义书签。法律协议 . 错 误！未定义书签。提交费用 . 错 误！未定义书签。审核时间 . 错 误！未定义书签。管理提交 . 错 误！未定义书签。E-mail 消息 . 错 误！未定义书签。审核提交，生成测试报告 . 错 误！未定义书签。徽标图案 . 错 误！未定义书签。Windows Marketplace 和 HCL 列表 . 错 误！

4、未定义书签。添加到 Windows 更新 . 错 误！未定义书签。使用 Windows 错误报告服务 . 错 误！未定义书签。联系 WHQL 寻求帮助 . 错 误！未定义书签。WHQL 问题解答 . 错 误！未定义书签。微软中国提供的 DTM 技术支持： . 错误！未定义书签。3 DTM 测试环境搭建 .错. 误！未定义书签什么是 DTM . 错 误！未定义书签。DTM测试环境组成 . 错 误！未定义书签。DTM的控制系统要求 . 错 误！未定义书签。DTM环境搭建和测试 . 错 误！未定义书签。3.4.1DTM 安装 . 错 误！未定义书签。43.4.2 DTM 配置错误！未定义书签。3.4

5、.3 DTM 测试错误！未定义书签。4 后记.错. 误！未定义书签51 引言1.编写目的本文档介绍 WHQL 认证流程，给不熟悉 WHQL 认证流程的客户作为入门指导。1.预期读者和阅读建议预期读者：技术支持人员阅读建议：无1.文档约定无1.参考资料微软中国技术中心 WHQL 专栏/CTC/WHQL/whqlpage.asp1.缩写术语WHQL Microsoft Win dows Hardware Quality LabDTMDriver Test Man ager2WHQL 认证2.1什么是 WHQL 认证全球最大的个人操作系统软件生产商的微软公司为了保证系统的稳定与兼容推出了WHQL 认

6、证制度，它是 Microsoft Windows Hardware Quality Lab 的缩写，中文意思是 微软 操作系统硬件质量实验室认证”。这个实验室主要从事计算机硬件产品、驱动程序与 Windows操作系统的兼容性和稳定性测试，如果通过测试就证明这款产品与Windows 操作系统可以达到 100%兼容， 从而使计算机系统达到前所未有的稳定性， 所以你所购买电脑产品是否通 过微软 WHQL认证就成为了计算机运行稳定的关键所在。为了使消费者可以直观的了解到 产品是否通过了认证，微软规定凡是通过WHQL 认证的产品都被授予Designed forWindows ”标志，并且产品的品牌型号都

7、会出现在微软官方网站和操作系统的硬件兼容列表 (HCL)中，以方便查询。WHQL 认证过程十分严格，因此一款通过了WHQL 认证的驱动程序可以说在 Windows 系统中基本不存在兼容性问题。2.2WHQL 认证流程2.2.1 获得 Windows 徽标的优势获取 Windows 徽标不仅保证用户更好地得到Windows 应用体验，获得 Windows 徽标对于制造商来说具有很多优势：6被授权在硬件产品上和该产品的包装上使用 Windows 徽标，获得微软 Windows 品牌及 用户对产品与 Windows 兼容认可的优势。选择在全球 Windows Marketplace 以及硬件兼容性列

8、表 HCL 列入产品。 政府机关， 大公 司的 IT管理部门和教育机构在购买硬件产品之前，常常会优先考虑该列表中的产品。获得硬件驱动程序的数字签名。表示该驱动程序已经通过了 Windows 兼容性检测，这 是个高质量的驱动程序。这样也可以减少产品召回，降低售后服务成本。通过 Windows 更新发布经过数字签名的驱动程序， 因此客户会很容易得到最新的更新。访问 Windows 错误报告服务，使用微软联机崩溃分析 (OCA) 技术，从用户返回的出错 数据中定位问题，保证硬件产品和驱动程序在整个生命周期中的质量。2.2.2行为推荐确认您的硬件产品归属的 Windows 徽标系统或设备分类。详细阅读

9、 Windows 徽标计划要求文档， DTM 工具中的测试基于这些要求。用最新的 DTM 工具进行产品测试提交测试结果到 Winqual 网站使用 Windows 错误报告跟踪产品及设备驱动程序的售后运行质量。在你的设计过程中尽早考虑 Windows 徽标技术要求将 WHQL 认证融入您产品的研发流程中2.2.3启动 WHQL 认证建立 Winqual 网站的在线账户从 Microsoft Connect 网站获得最新测试工具使用 DTM 工具完成 WHQL 测试在 Winqual 网站提交测试结果和驱动程序取得 Windows 徽标使用资格以及下载驱动程序数字签名2.2.4WHQL 支持信息

10、与技术合作WHQL 支持信息与 DTM 支持信息微软中国硬件创新中心提供的免费 WHQL 技术合作72.2.5建立 Winqual 网站的在线账户提交的所有硬件分类的驱动程序和系统都通过 Windows 徽标计划资格认证服务 (Winqual) 网 站完成。申请 WHQL 认证要获得 Winqual 网站的账号。 Windows Logo 计划资格认证服务 Winqual 网站：Winqual 网站帮助信息：2.2.6申请公司帐号建立一个 Winqual 在线账户的过程见：/流程中需要从 Verisign 网站上获取一个 VeriSign Class 3 Code signature ID/w

11、inlogo/Verisign 是一家独立的网上信息安全认证提供商。 Verisign 在中国的代理公司是天威诚信公 司。天威诚信公司网址：.cn2.2.7设置帐号权限申请 Winqual 帐号时，首先获得 2 个管理员权限的帐号。 管理员有权在贵公司范围内新增帐 号，并为这些帐号授予提交测试结果、签署法律协议、下载数字签名等不同行为的权限。2.2.8签署法律协议获取 Winqual 帐号后， 必须签署相关的法律协议后才能进行在线提交。 这些协议必须由您所 在公司的至少总监级人员在线签署。大部分的合同是“庇护”合同。主协议一旦签订，为了 保护每个独立产品提交的细节信息， Exhibit 补充合

12、同还必须每次提交。从 Microsoft Connect 网站获得最新测试工具选择可供参与的计划打开，使用您的 Windows Live? ID 登陆，选择左侧“可供参与的计划” ，在列表里选择 MicrosoftWindows Driver Kit (WDK) and Windows Logo Kit (WLK)。参与 Microsoft Windows Driver Kit (WDK) and Windows Logo Kit (WLK)计划后， 您就可以下载 WLK 工具。2.2.9下载 WLK 工具8打开右侧“我的参与” ，点击左侧“下载”选项，在下载列表中找到 Windows Log

13、o Kit 1_0_c 。DTM 测试工具包含在 Windows Logo Kit (WLK) 里，目前的最新版本是 WLK1.0.c2.2.10使用 DTM 工具完成 WHQL 测试DTM 测试环境准备阅读 DTM 联机文档，了解 DTM 工具的软件和硬件要求，以及测试人员所需知识，每个提 交分类的准备过程。正确按照配置 DTM 测试环境。在 DTM 的菜单 Explorer - Job Monitor 中创建该测试的 Machine Pool ，并按照分类设置 MCU PolicyDTM 工具包括侦测软件，因此在安装工具之前，必须在测试前配置好所有的硬件。详细阅读 DTM 测试工具文档运行

14、选定分类下的所有测试项在菜单 Explorer - Device Console 中，创建新的 Submission 时，选择适合的硬件分类和测试 平台。运行选定分类下的所有测试项在菜单 Explorer - Job Monitor 中管理和查看 DTM 测试进程， 完成所有测试。 如遇失败测试 项，必须重新测试直至通过为止。2.2.11检查测试日志 检查由测试生成的测试日志和留意所有的失败点。反复核对列在网站的勘误表中的每个错 误。勘误表中描述了已知错误解决方案和指明什么样的错误在提交中可以接受。您也可以登 录后下在勘误表过滤器并将其合并到 DTM Controller 中以自动滤除相关的

15、Errata。?如果你的错误在勘误表中， 但没有被勘误表过滤器自动滤除， 请您从 /whql/WHQLdwn.mspx 网站下载 WHQL Readme 文档模板，完整填写这个表格， 并与你的测试提交一起返回 WHQL 。?如果你的错误没有覆盖在勘误表中，关于测试原因的更多信息在DTM 工具文档中的测试规范中。你可以使用他们更正错误以便通过测试。在 /whql/WHQLdwn.mspx 网站下载 DTM Log Viewer 工具将有助于查看和分析 DTM 测试结 果。2.2.12在 Winqual 网站提交测试结果和驱动程序WHQL 对每种类型的提交有文档记录他们的日志审查过程并提供 DTM

16、 提交过程工具帮助 你在向Winqual 网站上传日志文件以前预测你的提交是否通过。 另外，也包括提交过程程序， 来检查那些测试日志中可以导致提交失败的问题。DTM 提交过程工具和提交过程程序都可以从 Winqual 网站下载。2.2.13为提交准备测试日志9按照 DTM 工具测试过程中的向 WHQL 提交测试日志包的说明规定。测试结果将被压缩为 一个 CPK 文件。保证所有的测试日志中的错误被勘误表覆盖并且以前面所描述的 Readme 文档形式记录下 来。如果在测试审核中存在未记录的错误，提交是不会成功的。将上述两个文件放置在一个文件夹中。除此之外， 如果您的提交需要包括驱动程序， 请将驱动

17、程序放置在另外一个文件夹中。 并将 该驱动程序相对应的符号文件（ pdb 文件）放置在第三个文件夹中。以上 3 个文件夹的名称可以任意指定。2.2.14提交测试结果所有的 Windows 徽标计划提交通过 Winqual 网站完成。在你的测试完成以后，你可以签约 并上传你的测试结果。2.2.15法律协议在提交测试日志以前，你所在公司必须具备一份以签署的 WHQL 测试协议和驱动发布协议 的文件拷贝。每个产品的提交必须在线签署 Exhibit A（ 来自 WHQL 测试协议 ）。如果你想拥有 Windows 徽标的使用权，你必须运行产品列表工具，并对每次提交点击“接 受” Exhibit3徽标许

18、可协议。2.2.16提交费用 不 同类型内容的提交费用已列在 WHQL 网站上。 在线提交过程中， 你将被要求提供你所在 公司或部门的帐户地址。在每个季度结束时， WHQL 将根据这个季度所有 的提交给你所在 的公司开具账单。如果你所在的公司的发票需要订单号码，请你务必在在线提交过程中输入 PO number 。成功的徽标测试提交之后2.2.17审核时间目前从提交开始到最后确认的平均在线提交时间少于20 个小时。 WHQL 会继续努力维持或减小当前的平均时间。2.2.18管理提交每次新的提交或更新将对应于唯一的提交 ID 号。你的管理员或联系人用这个登录 ID 号来 跟踪每次提交的过程。102

19、.2.19E-mail 消息在提交过程中每个重要的阶段， Winqual 会用 e-mail 方式发消息给所有提交过程中列出的联 系人。2.2.20审核提交，生成测试报告WHQL 工作人员将审核和确认收到的测试日志，并生成一份测试报告。当审核完成后，WHQL 会向提交者和指定的联系人发电子邮件，以通知他们审核的结果。2.2.21徽标图案如果成功通过审核，你可以登录 Winqual 网站，运行产品列表工具，签署 Exhibit3 徽标许可 协议。当完成这些步骤后，就可以下载 Windows 徽标图案。2.2.22Windows Marketplace 和 HCL 列表在提交过程中， 你有机会指定

20、产品在 Windows Marketplace 和 HCL 网站上的发布日期。 如果 你提交成功并且符合其他所有要求， WHQL 会在指定的日期起在网站上列出该产品。如果 提交过程中没有输入发布日期，则产品不会被列出。Windows Marketplace 和 HCL 网站：注意： 所有获得 Windows 徽标的产品都会在 HCL 网站中列出， 但您可以自行决定是否将产 品显示在中，请登录 Windows Markeplace 工具网站：/2.2.23添加到 Windows 更新如果在提交过程中提出申请，并且你的产品满足 Windows 更新标准， WHQL 将把你产品的 签名驱动放入 Wi

21、ndows 更新网站，以便用户下载。 Windows Update 网站：使用驱动分发中心向 Windows 更新中添加驱动程序和更新规则。/maintain/DrvUpdate.mspx2.2.24使用 Windows 错误报告服务Windows 错误报告服务是微软提供的一项免费服务。 你可以利用这项服务获取最终用户通过 微软 OCA技术反馈的错误数据， 从动态的数据中掌握您产品在整个生命周期中的质量情况。 关于 Windows 错误报告服务，请参考：/maintain/StartWER.mspx112.2.25联系 WHQL 寻求帮助如果你在测试过程中或阅读测试日志时有任何的问题，你可以联

22、系 WHQL 工作人员寻求帮 助。2.2.26WHQL 问题解答2.2.27微软中国提供的 DTM 技术支持：微软中国为客户提供付费的 DTM 技术支持服务。 我们通过 “专业技术支持” 和“高级服务” 两种方式对 WHQL （包含 DTM ）和 WDK 进行技术支持。1)专业技术支持和高级服务都可以提供完整的 WHQL 支持。2)面向专业客户，我们提供完整的 WHQL 支持和基本的 WDK 支持。3)面向高级客户，我们提供完整的 WHQL 支持和完整的 WDK 支持。4)专业技术支持和高级服务的主要区别在于 WDK 部分的技术支持。专业技术支持仅提供 一般性指导并且我们不审核、修改、 调试客

23、户代码， 也不调试客户的设备。高级服务包含对 客户代码提出直接的建议和在必要时直接调试客户的代码和设备。3DTM 测试环境搭建3.1什么是 DTMDTM 是 Driver Test Manager ，是微软 Windows 徽标计划的测试工具。 使用 DTM 工具对 硬件进行测试并把测试结果提交给微软，就可以获得 Windows Logo 。3.2DTM 测试环境组成在进行 WHQL 测试前需要配置测试环境，由于我们在测试中使用的测试工具为 DTM （Driver TestManager ），因此先要对 DTM 工具进行了解， DTM 可分为三层逻辑结构： DTM clients/DTMcon

24、trollers/DTM Studio.DTM clients 端是由不同配置的测试机组成，每台测试机模拟一种实际操作环境，被测试的 驱动程序在每台测试机上运行。DTM controllers 端 DTM clients 端运行的的测试进行控制，测试的结果会存储在 controllers 端的 SQL 数据库中。DTM Stadio 提供了用户接口，测试者可以在stadio 端创建测试场景和分配运行时间。3.3DTM 的控制系统要求12注意 :DTM 控制器目前只支持对英文版本的 Windows Server 2003 带有 Service Pack 1 （SP1 的）或 Service Pa

25、ck 2（ SP2）.ComponentMinimumOptimumProcessorSingle x86-based processorrunning in x86 mode, with a speedof 2.0 GHzMulticore or multiplex64-based processorsrunning in x86 mode, witha speed of 2.0 GHz orfasterSystem Memory2 GB main memory4 GB main memoryHard Disk Capacity300 GB. This value is considered

26、a minimum becauseJBOD arrayi13of the volume of logs that can be gen erated and their storagerequireme nts.100 megabits per sec ond (Mbps)x86-based versi on of Win dowsServicePack 1 (SP1) orServicePack 2 (SP2) in stalled.Notes:* DTM Con troller is not supported onWindows Server 2008, Windows Vista,Wi

27、ndows XP, or Microsoft Windows2000. DTM Con troller is not supported on aWindows Server 2003 installation that has alreadybee n set up as a doma in con troller. DTM Controller is not supported in a virtualPC en vir onment.DTM Studio 系统需求Ita niu m-based, orx64-based architectures1)Windows Server 2008

28、 for x86-based or x64-basedarchitectures, or2)Windows Vista (all versions) for x86-based or x64-basedarchitectures, or1)Windows Server 2003 withService Pack 1(SP1) for x86-based,x64-based, or Itanium-based architectures, or2)Windows XP with Service Pack 2 (SP2) for x86-based orx64-based architecture

29、sNotes: Windows Vista and WindowsXP are supportedwhe n DTM is deployed in the doma in-joined sce nario.Network Conn ecti onOperat ing SystemServer 2003 withComponentProcessorx86-based, orMinimumOperat ing System14However, i n the workgroup deployme nt sce nario, youmust in stall DTM Studio directly

30、on the DTM Controller,which must have Win dows Server 2003 in stalled. DTM Studio is not supported in a virtual PC en vir onment.DTM 客户端系统需求Comp onentMi nimumOptimumProcessorx86-based, orIta niu m-based, orx64-based architecturesSystem Memory 128 MBmain memory(for free 256 MBor more (for checked bui

31、lds)builds)Operating System * Windows Vista (all versions) for x86-based or x64-basedarchitectures, orWindows Server 2003 withService Pack 1(SP1) for x86-based,x64-based, or Itanium-based architectures, or3)Windows XP with the latest release Service Pack4)To test and obta in a Win dows Server 2008 l

32、ogo, youmust use Win dows Server 2008 Datace nter(x64-based) or Win dows Server 2008 forIta niu m-based systems (IA-64). x64-based systemsmay be AMD64 or In tel64. IA64-based systems must beIta nium 2 or later because Win dows Server 2008 doesnot support Ita nium 1 (Merced) processors.Notes:3)Whe n

33、select ing a computer n ame for the clie nt,15you must choose a unique n ame with 15 or fewercharacters. Windows 2000 is supported for testing -purposes only.There is no logo support for Windows 2000. DTM Clie nt is not supported in a virtual PC en vir onment.3.4DTM 环境搭建和测试用 DTM 进行测试的时候可以有两种环境搭建方式：一

34、、工作组模式，在一个工作组内，这样至少需要和 DTM Controller 在同一台机器上域模式，这样至少需要 3 台机器，要求 DC 与 DTMController 分ServerirrEtaii DTM Control lr onZ DTM StiM炖 8Computerf)IIWMc wfrwri Tert Sewrer alteieelv,T Serw#Ermaii 1&TM CswtTOliw c*iF 面以第一种为例说明搭建和测试过程02 台机器，要求 DTM StudioWCwnflaHCofitWflrt-itaSHDniffomTett ServerDIMrnTest Ser

35、vernstall DTM Co nt roller onand DTM Studio anTest Cornputer(s)Install DTM Client onfrom Test Serveritstr：ram TesH16DTM 安装在 计划要安装 DTMController 的计算机上安装 Windows Server 2003 with Service Pack 1(SP1) or Service Pack 2 (SP2) 操作系统，经过测试中文 / 英文都可以，并 不像 DTM.chm 中描述只能用英文的操作系统在计划要做 DTM Studio 的计算机上安装干净的操作系统，W

36、indows XP 和 WindowsServer 2003 都可以，可以把 DTM Studio 也安装在 Controller 的计算机上。在计划要做 DTM Client 的计算机上安装干净的要测试的操作系统，比如我要做的 WindowsServer 2008 Datacenter Edition.在每一台计算机上，以管理员权限登陆执行以下操作：启用 guest 帐户关闭防火墙在计划要做 DTMController 的计算机上 , 运行 KitSetup.exe (一 般来说下载下来 的是一个 ISO文件，需要用虚拟光驱载入)选择相应的测试用例按照提示安装。比 如我选择的 Device

37、Test.程序会自动安装 Microsoft .NET Framework 2.0.，Microsoft SQL Desktop Engine (MSDE) ， Microsoft Driver Test Manager (DTM) 和相应的测试用例。在计划要做 DTMStudio 的计算机上， 在 开始 计算机的名称 DTMInstallStudioSetup.exe在计划的所有 Client 的计算机上， 在 开始 计算机的名称 DTMInstallClientSetup.exe 重启计算机。DTM 配置通过 DTM Controller 添加 ControllerNameGuest至 U

38、 DTM_DSUSERtS。运行 DTM Studio, 点击 Tools/Management Console.展开 Console Root, 展开 Datastore, 右键 Users, 点击 New User.输入 ControllerNameGuest 并选择 dtm_DSusers ，最后确定。在 DTM Client 上配置自动登陆。在 开始 菜单，点击 运行，输入 control userpasswords2 。选择 administrator 用户，设置为自动登陆。更新 DTM Controller 的 WLK updated filters 。获取 WLK updated

39、 filters ： /SubmissionWizard/LegalExemptions/updatefilters.cab把下载的 updatefilter.cab 解压后把 updatefilter.sql 拷贝至 DTM Controller 的安装目录。运行 updatefilter.exe 。程序会自动把 sql 语句写入数据库。DTM 测试在所有的 Client 上安装要测试的设备和驱动，并共享其Windows 目录。准备要测试的 Client 。113-4d16-91b1-655ce0271eac-Numbered_619350ea-9b9f-4b 点击 Explorer 菜单

40、/JobMonitor ，右键 $，点击 Add Machine Pool 建立新 的 Machine pool ，比如我的是WS2008 在 MCU Policy 标签添加与你要做 的测试相应的 dimensions ，比如我的是菜单 点击 运行 , 输入 Controller ，通过共享安装 Studio.菜单 点击 运行 , 输入 Controller ，通过共享安装 Client ，安装完成后17WdkConfigureUnclassified.113-4d16-91b1-655ce0271eac-Numbered_619350ea-9b9f-4b安装完Client 后，在$/defa

41、ult pool 里可以看见所有的已经安装的Client。把要进行测试的 Client 通过拖拽或者右键方式添加到新建的 Machine Pool 中，此时Client 计算机的状态为 Manule，右键 Client 计算机把其状态更 改为 Reset。创建 Submisstion ，这里以 Unclassified Signature Tests 为例。3-4823-b0bc-257237d3c7c2-Bulleted_8bab3f7d-5e2b-45在 Studio ，点击 Explorers/Device Console ，选择 View By Submission 。 在 Submi

42、ssion 下拉菜单中点击 NewSubmission 进入一个新的 Submission 的配置向导。3-4823-b0bc-257237d3c7c2-Bulleted_8bab3f7d-5e2b-45在 Select OS 列表选择与Client 对应的名称，比如我的是 Windows Server 2008 X64 ，点击 Next。3-4823-b0bc-257237d3c7c2-Bulleted_8bab3f7d-5e2b-45在 Select Category 中选择要你要进行的测试的类别，比如我的是 Device Submission ，点击 Next。3-4823-b0bc-2

43、57237d3c7c2-Bulleted_8bab3f7d-5e2b-45 在 Logo Program 列表中选择你要进行的具体测试，比如我的是Unclassified ，点击 Next。3-4823-b0bc-257237d3c7c2-Bulleted_8bab3f7d-5e2b-45在 Qualification 窗口，选择Unclassified Signature ，点击 Next。3-4823-b0bc-257237d3c7c2-Bulleted_8bab3f7d-5e2b-45输入 Submission 的名称，并点击对应的 Machine Pool ， 比如我的是 Submission的名称是 SSR对应的 machine p