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

., . .WHQL认证流程和测试环境介绍项目名称文档编号版 本 号1.0作 者李玉忠版权所有联芯科技有限公司本资料及其包含的所有内容为联芯科技有限公司所有,受中国法律及适用之国际公约中有关著作权法律的保护。未经大唐移动书面授权，任何人不得以任何形式复制、传播、散布、改动或以其它方式使用本资料的部分或全部内容，违者将被依法追究责任。文档更新记录日期更新人版本备注2009-3-17李玉忠1.0初始版本目 录1引言51.1编写目的51.2预期读者和阅读建议51.3文档约定51.4参考资料51.5缩写术语52WHQL认证52.1什么是WHQL认证52.2WHQL认证流程52.2.1获得Windows徽标的优势52.2.2行为推荐62.2.3启动WHQL认证62.2.4WHQL支持信息与技术合作62.2.5建立Winqual网站的在线账户72.2.6申请公司帐号72.2.7设置帐号权限72.2.8签署法律协议72.2.9下载WLK工具82.2.10使用DTM工具完成WHQL测试82.2.11检查测试日志82.2.12在Winqual网站提交测试结果和驱动程序92.2.13为提交准备测试日志92.2.14提交测试结果92.2.15法律协议92.2.16提交费用102.2.17审核时间102.2.18管理提交102.2.19E-mail消息102.2.20审核提交，生成测试报告102.2.21徽标图案102.2.22Windows Marketplace和HCL列表102.2.23添加到Windows更新112.2.24使用Windows错误报告服务112.2.25联系WHQL寻求帮助112.2.26WHQL问题解答112.2.27微软中国提供的DTM技术支持：113DTM测试环境搭建123.1什么是DTM123.2DTM测试环境组成123.3DTM的控制系统要求123.4DTM环境搭建和测试153.4.1DTM安装153.4.2DTM配置163.4.3DTM测试164后记17参考.资料1 引言1.1 编写目的本文档介绍WHQL认证流程，给不熟悉WHQL认证流程的客户作为入门指导。1.2 预期读者和阅读建议预期读者：技术支持人员阅读建议：无1.3 文档约定无1.4 参考资料微软中国技术中心WHQL专栏/china/CTC/WHQL/whqlpage.asp1.5 缩写术语WHQLMicrosoft Windows Hardware Quality LabDTM Driver Test Manager2 WHQL认证2.1 什么是WHQL认证全球最大的个人操作系统软件生产商的微软公司为了保证系统的稳定与兼容推出了WHQL认证制度，它是Microsoft Windows Hardware Quality Lab的缩写，中文意思是“微软操作系统硬件质量实验室认证”。这个实验室主要从事计算机硬件产品、驱动程序与Windows操作系统的兼容性和稳定性测试，如果通过测试就证明这款产品与Windows操作系统可以达到100%兼容，从而使计算机系统达到前所未有的稳定性，所以你所购买电脑产品是否通过微软WHQL认证就成为了计算机运行稳定的关键所在。为了使消费者可以直观的了解到产品是否通过了认证，微软规定凡是通过WHQL认证的产品都被授予 “Designed for Windows”标志，并且产品的品牌型号都会出现在微软官方网站和操作系统的硬件兼容列表(HCL)中，以方便查询。WHQL认证过程十分严格，因此一款通过了WHQL认证的驱动程序可以说在Windows系统中基本不存在兼容性问题。2.2 WHQL认证流程2.2.1 获得Windows徽标的优势获取Windows徽标不仅保证用户更好地得到Windows应用体验，获得Windows徽标对于制造商来说具有很多优势： 被授权在硬件产品上和该产品的包装上使用Windows徽标，获得微软Windows品牌及用户对产品与Windows兼容认可的优势。 选择在全球Windows Marketplace以及硬件兼容性列表HCL列入产品。政府机关，大公司的IT管理部门和教育机构在购买硬件产品之前，常常会优先考虑该列表中的产品。 获得硬件驱动程序的数字签名。表示该驱动程序已经通过了Windows兼容性检测，这是个高质量的驱动程序。这样也可以减少产品召回，降低售后服务成本。 通过Windows更新发布经过数字签名的驱动程序，因此客户会很容易得到最新的更新。 访问Windows错误报告服务，使用微软联机崩溃分析(OCA)技术，从用户返回的出错数据中定位问题，保证硬件产品和驱动程序在整个生命周期中的质量。2.2.2 行为推荐 确认您的硬件产品归属的Windows徽标系统或设备分类。 详细阅读Windows徽标计划要求文档，DTM工具中的测试基于这些要求。 用最新的DTM工具进行产品测试 提交测试结果到Winqual网站 使用Windows错误报告跟踪产品及设备驱动程序的售后运行质量。 在你的设计过程中尽早考虑Windows徽标技术要求 将WHQL认证融入您产品的研发流程中2.2.3 启动WHQL认证 建立Winqual网站的在线账户 从Microsoft Connect网站获得最新测试工具WLK1.0.c。 使用DTM工具完成WHQL测试 在Winqual网站提交测试结果和驱动程序 取得Windows徽标使用资格以及下载驱动程序数字签名2.2.4 WHQL支持信息与技术合作 WHQL支持信息与DTM支持信息 微软中国硬件创新中心提供的免费WHQL技术合作2.2.5 建立Winqual网站的在线账户提交的所有硬件分类的驱动程序和系统都通过Windows徽标计划资格认证服务(Winqual)网站完成。申请WHQL认证要获得Winqual网站的账号。Windows Logo计划资格认证服务Winqual网站：Winqual网站帮助信息：/help2.2.6 申请公司帐号建立一个Winqual在线账户的过程见：/SignUp/流程中需要从Verisign网站上获取一个VeriSign Class 3 Code signature ID/products/winlogo/Verisign是一家独立的网上信息安全认证提供商。Verisign在中国的代理公司是天威诚信公司。天威诚信公司网址：2.2.7 设置帐号权限申请Winqual帐号时，首先获得2个管理员权限的帐号。管理员有权在贵公司范围内新增帐号，并为这些帐号授予提交测试结果、签署法律协议、下载数字签名等不同行为的权限。2.2.8 签署法律协议获取Winqual帐号后，必须签署相关的法律协议后才能进行在线提交。这些协议必须由您所在公司的至少总监级人员在线签署。大部分的合同是“庇护”合同。主协议一旦签订，为了保护每个独立产品提交的细节信息，Exhibit补充合同还必须每次提交。从Microsoft Connect网站获得最新测试工具 选择可供参与的计划打开，使用您的Windows Live? ID登陆，选择左侧“可供参与的计划”，在列表里选择Microsoft Windows Driver Kit (WDK) and Windows Logo Kit (WLK)。参与Microsoft Windows Driver Kit (WDK) and Windows Logo Kit (WLK)计划后，您就可以下载WLK工具。2.2.9 下载WLK工具打开右侧“我的参与”，点击左侧“下载”选项，在下载列表中找到Windows Logo 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测试工具文档 运行选定分类下的所有测试项在菜单Explorer - Device Console中，创建新的Submission时，选择适合的硬件分类和测试平台。运行选定分类下的所有测试项在菜单Explorer - Job Monitor中管理和查看DTM测试进程，完成所有测试。如遇失败测试项，必须重新测试直至通过为止。2.2.11 检查测试日志检查由测试生成的测试日志和留意所有的失败点。反复核对列在/ec网站的勘误表中的每个错误。勘误表中描述了已知错误解决方案和指明什么样的错误在提交中可以接受。您也可以登录后下在勘误表过滤器并将其合并到DTM Controller中以自动滤除相关的Errata。?如果你的错误在勘误表中，但没有被勘误表过滤器自动滤除，请您从/whdc/whql/WHQLdwn.mspx网站下载WHQL Readme文档模板，完整填写这个表格，并与你的测试提交一起返回WHQL。?如果你的错误没有覆盖在勘误表中，关于测试原因的更多信息在DTM工具文档中的测试规范中。你可以使用他们更正错误以便通过测试。在/whdc/whql/WHQLdwn.mspx网站下载DTM Log Viewer工具将有助于查看和分析DTM测试结果。2.2.12 在Winqual网站提交测试结果和驱动程序WHQL对每种类型的提交有文档记录他们的日志审查过程并提供DTM提交过程工具帮助你在向Winqual网站上传日志文件以前预测你的提交是否通过。另外，也包括提交过程程序，来检查那些测试日志中可以导致提交失败的问题。DTM提交过程工具和提交过程程序都可以从Winqual网站下载。2.2.13 为提交准备测试日志按照DTM工具测试过程中的向WHQL提交测试日志包的说明规定。测试结果将被压缩为一个CPK文件。保证所有的测试日志中的错误被勘误表覆盖并且以前面所描述的Readme文档形式记录下来。如果在测试审核中存在未记录的错误，提交是不会成功的。将上述两个文件放置在一个文件夹中。除此之外，如果您的提交需要包括驱动程序，请将驱动程序放置在另外一个文件夹中。并将该驱动程序相对应的符号文件（pdb文件）放置在第三个文件夹中。以上3个文件夹的名称可以任意指定。2.2.14 提交测试结果所有的Windows徽标计划提交通过Winqual网站完成。在你的测试完成以后，你可以签约并上传你的测试结果。2.2.15 法律协议在提交测试日志以前，你所在公司必须具备一份以签署的WHQL测试协议和驱动发布协议的文件拷贝。每个产品的提交必须在线签署Exhibit A(来自WHQL测试协议)。如果你想拥有Windows徽标的使用权，你必须运行产品列表工具，并对每次提交点击“接受”Exhibit3徽标许可协议。2.2.16 提交费用不 同类型内容的提交费用已列在WHQL网站上。在线提交过程中，你将被要求提供你所在公司或部门的帐户地址。在每个季度结束时，WHQL将根据这个季度所有 的提交给你所在的公司开具账单。如果你所在的公司的发票需要订单号码，请你务必在在线提交过程中输入PO number。成功的徽标测试提交之后2.2.17 审核时间目前从提交开始到最后确认的平均在线提交时间少于20个小时。WHQL会继续努力维持或减小当前的平均时间。2.2.18 管理提交每次新的提交或更新将对应于唯一的提交ID号。你的管理员或联系人用这个登录ID号来跟踪每次提交的过程。2.2.19 E-mail消息在提交过程中每个重要的阶段，Winqual会用e-mail方式发消息给所有提交过程中列出的联系人。2.2.20 审核提交，生成测试报告WHQL工作人员将审核和确认收到的测试日志，并生成一份测试报告。当审核完成后，WHQL会向提交者和指定的联系人发电子邮件，以通知他们审核的结果。2.2.21 徽标图案如果成功通过审核，你可以登录Winqual网站，运行产品列表工具，签署Exhibit3徽标许可协议。当完成这些步骤后，就可以下载Windows徽标图案。2.2.22 Windows Marketplace和HCL列表在提交过程中，你有机会指定产品在Windows Marketplace和HCL网站上的发布日期。如果你提交成功并且符合其他所有要求，WHQL会在指定的日期起在网站上列出该产品。如果提交过程中没有输入发布日期，则产品不会被列出。Windows Marketplace和HCL网站：/hcl注意：所有获得Windows徽标的产品都会在HCL网站中列出，但您可以自行决定是否将产品显示在中，请登录Windows Markeplace工具网站：/getlisted/2.2.23 添加到Windows更新如果在提交过程中提出申请，并且你的产品满足Windows更新标准，WHQL将把你产品的签名驱动放入Windows更新网站，以便用户下载。Windows Update网站：/使用驱动分发中心向Windows更新中添加驱动程序和更新规则。/whdc/maintain/DrvUpdate.mspx2.2.24 使用Windows错误报告服务Windows错误报告服务是微软提供的一项免费服务。你可以利用这项服务获取最终用户通过微软OCA技术反馈的错误数据，从动态的数据中掌握您产品在整个生命周期中的质量情况。关于Windows错误报告服务，请参考：/whdc/maintain/StartWER.mspx2.2.25 联系WHQL寻求帮助如果你在测试过程中或阅读测试日志时有任何的问题，你可以联系WHQL工作人员寻求帮助。2.2.26 WHQL问题解答系统相关问题设备相关问题2.2.27 微软中国提供的DTM技术支持：微软中国为客户提供付费的DTM技术支持服务。我们通过“专业技术支持”和“高级服务”两种方式对WHQL（包含DTM）和WDK进行技术支持。a.专业技术支持和高级服务都可以提供完整的WHQL支持。b.面向专业客户，我们提供完整的WHQL支持和基本的WDK支持。c.面向高级客户，我们提供完整的WHQL支持和完整的WDK支持。d.专业技术支持和高级服务的主要区别在于WDK部分的技术支持。专业技术支持仅提供一般性指导并且我们不审核、修改、调试客户代码，也不调试客户的设备。高级服务包含对客户代码提出直接的建议和在必要时直接调试客户的代码和设备。51Testing软件测试网%w%tF|51Testing软件测试网C9du;I3Dh$pKG3q51Testing软件测试网5S _wj k3 DTM测试环境搭建3.1 什么是DTMDTM是Driver Test Manager，是微软Windows徽标计划的测试工具。使用DTM工具对硬件进行测试并把测试结果提交给微软，就可以获得Windows Logo。3.2 DTM测试环境组成在进行WHQL测试前需要配置测试环境，由于我们在测试中使用的测试工具为DTM（Driver Test Manager），因此先要对DTM工具进行了解，DTM可分为三层逻辑结构：DTM clients/DTM controllers/DTM Studio.DTM clients端是由不同配置的测试机组成，每台测试机模拟一种实际操作环境，被测试的驱动程序在每台测试机上运行。DTM controllers端DTM clients端运行的的测试进行控制，测试的结果会存储在controllers端的SQL数据库中。DTM Stadio提供了用户接口，测试者可以在stadio端创建测试场景和分配运行时间。3.3 DTM的控制系统要求注意:DTM控制器目前只支持对英文版本的Windows Server 2003带有Service Pack 1 （ SP1的）或Service Pack 2 （ SP2 ）.ComponentMinimum Optimum ProcessorSingle x86based processor running in x86 mode, with a speed of 2.0 GHz Multicore or multiple x64based processors running in x86 mode, with a speed of 2.0 GHz or fasterSystemMemory2 GB main memory 4 GB main memory HardDiskCapacity300 GB. This value is considered a minimum because of the volume of logs that can be generated and their storage requirements. JBOD array NetworkConnection100 megabits per second (Mbps) OperatingSystemx86based version of WindowsServer2003 with ServicePack1(SP1) or ServicePack2(SP2) installed.Notes: DTM Controller is not supported on WindowsServer2008, WindowsVista, WindowsXP, or Microsoft Windows2000. DTM Controller is not supported on a WindowsServer2003 installation that has already been set up as a domain controller. DTM Controller is not supported in a virtual PC environment. DTM Studio 系统需求 ComponentMinimum Processorx86based, or Itaniumbased, or x64based architectures OperatingSystem WindowsServer2008 for x86based or x64based architectures, or WindowsVista (all versions) for x86based or x64based architectures, or WindowsServer2003 with ServicePack1(SP1) for x86based, x64based, or Itaniumbased architectures, or WindowsXP with ServicePack2(SP2) for x86based or x64based architectures Notes: WindowsVista and WindowsXP are supported when DTM is deployed in the domainjoined scenario. However, in the workgroup deployment scenario, you must install DTM Studio directly on the DTM Controller, which must have WindowsServer2003 installed. DTM Studio is not supported in a virtual PC environment. DTM客户端系统需求 ComponentMinimum Optimum Processorx86based, or Itaniumbased, or x64based architectures SystemMemory128 MB main memory (for free builds) 256 MB or more (for checked builds) OperatingSystem WindowsVista (all versions) for x86based or x64based architectures, or WindowsServer2003 with ServicePack1(SP1) for x86based, x64based, or Itaniumbased architectures, or WindowsXP with the latest release ServicePack To test and obtain a Windows Server 2008 logo, you must use Windows Server 2008 Datacenter (x64-based) or Windows Server 2008 for Itanium-based systems (IA-64). x64-based systems may be AMD64 or Intel64. IA64-based systems must be Itanium 2 or later because Windows Server 2008 does not support Itanium 1 (Merced) processors. Notes: When selecting a computer name for the client, you must choose a unique name with 15 or fewer characters. Windows2000 is supported for testing purposes only. There is no logo support for Windows2000. DTM Client is not supported in a virtual PC environment. 3.4 DTM环境搭建和测试用DTM进行测试的时候可以有两种环境搭建方式：一、 工作组模式，在一个工作组内，这样至少需要2台机器，要求DTM Studio和DTM Controller在同一台机器上二、 域模式，这样至少需要3台机器，要求DC与DTMController分离下面以第一种为例说明搭建和测试过程3.4.1 DTM安装1. 在 计划要安装DTM Controller的计算机上安装Windows Server 2003 with Service Pack 1 (SP1) or Service Pack 2 (SP2)操作系统，经过测试中文/英文都可以，并不像DTM.chm中描述只能用英文的操作系统. 2. 在计划要做DTM Studio的计算机上安装干净的操作系统，Windows XP和 Windows Server 2003都可以，可以把DTM Studio 也安装在Controller的计算机上。 3. 在计划要做DTM Client的计算机上安装干净的要测试的操作系统，比如我要做的Windows Server 2008 Datacenter Edition. 4. 在每一台计算机上，以管理员权限登陆执行以下操作： 1. 启用guest帐户 2. 关闭防火墙5. 在计划要做DTM Controller 的计算机上, 运行KitSetup.exe（一 般来说下载下来的是一个ISO文件，需要用虚拟光驱载入）选择相应的测试用例按照提示安装。比如我选择的Device Test. 程序会自动安装Microsoft .NET Framework 2.0.，Microsoft SQL Desktop Engine (MSDE)，Microsoft Driver Test Manager (DTM)和相应的测试用例。 6. 在计划要做DTM Studio的计算机上，在 开始 菜单 点击 运行, 输入 Controller计算机的名称DTMInstallStudioSetup.exe，通过共享安装Studio. 7. 在计划的所有 Client 的计算机上，在 开始 菜单 点击 运行, 输入 Controller计算机的名称DTMInstallClientSetup.exe，通过共享安装Client，安装完成后重启计算机。3.4.2 DTM配置1. 通过DTM Controller添加ControllerNameGuest到DTM_DSUSERS组。 1) 运行DTM Studio,点击 Tools/Management Console. 2) 展开 Console Root, 展开 Datastore, 右键Users, 点击New User. 3) 输入 ControllerNameGuest 并选择 dtm_DSusers，最后确定。2. 在DTM Client上配置自动登陆。 1) 在 开始 菜单，点击 运行，输入control userpasswords2。 2) 选择administrator用户，设置为自动登陆。3. 更新DTM Controller 的WLK updated filters。 1) 获取WLK updated filters：/member/SubmissionWizard/LegalExemptions/updatefilters.cab 2) 把下载的updatefilter.cab解压后把updatefilter.sql拷贝到DTM Controller的安装目录。 3) 运行updatefilter.exe。程序会自动把sql语句写入数据库。 3.4.3 DTM测试1. 在所有的Client上安装要测试的设备和驱动，并共享其Windows目录。 2. 准备要测试的Client。 1) 点击Explorer菜单/Job Monitor，右键$，点击Add Machine Pool建立新的 Machine pool，比如我的是WS2008，在MCU Policy标签添加与你要做的测试相应的dimensions，比如我的是WdkConfigureUnclassified. 2) 安装完Client后，在$/default pool里可以看见所有的已经安装的Client。把要进行测试的Client通过拖拽或者右键方式添加到新建的Machine Pool中，此时Client计算机的状态为Manule，右键Client计算机把其状态更改为Reset。3. 创建Submisstion，这里以Unclassified Signature Tests为例。 1) 在Studio，点击Explorers/ Device Console，选择View By Submission。在Submission下拉菜单中点击New Submission进入一个新的Submission的配置向导。 2) 在Select OS列表选择与Client对应的名称，比如我的是Windows Server 2008 X64，点击Next。 3) 在Select Category中选择要你要进行的测试的类别，比如我的是Device Submission，