介绍

本白皮书讨论了以下Microsoft Windows的1-Wire驱动程序的安装过程32位和64位操作系统:Windows 7、Windows Server 2008、Windows Vista和Windows XP (service pack 2或更高版本)。有两种方法可以完成a机的驱动程序安装。第一种选择是使用Maxim的1-Wire驱动程序安装程序，第二种选择是开发自定义安装程序。

1-Wire Drivers安装程序

对于1-Wire软件开发人员来说，最简单的选择是使用Maxim创建的安装程序。也称为TMEX运行时环境(RTE)， 1-Wire Drivers安装程序执行所有1-Wire适配器驱动程序的全面安装。安装的其他文件包括称为TMEX的应用程序编程接口(API)库，以及支持的dll和文档。安装过程还会为软件的正常运行写入必要的注册表项。1-Wire Drivers安装程序可供下载。

在部署自定义1-Wire应用程序时，有两种方法可以分发1-Wire Drivers安装包。一种方法是通知最终客户下载并安装1-Wire Drivers包。这是最简单的方法，但它要求最终用户安装两个独立的软件:1-Wire Drivers包和软件开发人员自定义的1-Wire应用程序。第二种方法是制作一个定制的安装程序，它不仅安装开发人员自己的程序，而且生成1-Wire驱动程序。这很容易做到，因为1-Wire Drivers包可以静默安装，无需任何用户交互。有关更多信息，请参阅下面的1-Wire Drivers Installation Project部分。

创建自定义安装程序

一些1-Wire软件应用程序开发人员希望或被要求制作一个单独的安装程序，其中包括他们自定义的1-Wire应用程序、必要的1-Wire驱动程序和其他API库。许多开发人员不需要整个1-Wire Drivers安装，而只需要其应用程序所需的驱动程序。要进行自定义驱动程序安装，软件开发人员必须了解不同的1-Wire驱动程序和API库之间的相互依赖关系。下面的图1说明了这些相互依赖关系。

确定定制安装需要哪些文件需要开发人员知道正在使用哪些API以及将支持哪些硬件适配器。该API可以是Java 的1-Wire API(例如。net支持)的衍生物，也可以是TMEX API。有关api和1-Wire驱动程序支持的硬件适配器列表的更完整讨论，请参阅可下载的1-Wire软件开发工具包(SDK)中包含的文档。

表1列出了1- wire Drivers自定义安装中涉及的文件和适配器依赖项。描述了每个文件，以及该文件在客户计算机上的目标目录。请注意，变量用于表示目标目录，因为这些目录对于每个Microsoft安装可能不同。例如，默认的windows\system目录取决于所使用的操作系统(例如，C:\windows\system32或C: \ winnt \ system32系统）. 这些系统目录在表1中用%SYS%表示。将1-Wire应用程序复制到的应用程序目录用%APP%表示。表2列出了完成自定义安装所需的适当注册表项。

*注意:DLL名称中的XX对于32位Windows为“32”，对于64位Windows为“64”。

在64位操作系统上运行32位应用程序的注意事项

64位Microsoft (x64)操作系统允许在其中运行32位代码。为此，您需要执行以下操作:

1. 确保需要为1-Wire适配器安装的任何设备驱动程序都是64位版本(称为x64或AMD64)。

2. 请注意，以“IB”开头的32位API dll文件应复制到C:\Windows\SysWOW64目录。

.NET文件的安装

. net 1-Wire软件需要在它运行的Windows操作系统(32位或64位)上安装。net运行时，以及可重新发行的Visual j#。具体来说，需要。net Framework 2.0版本和Visual j#可重新发布的2.0版本第二版。这些文件可以从微软的。net网站上下载。

下载完成后，在搜索框中使用相应的关键字进行搜索。对于。net框架，使用“。net 2.0 redistributable”作为关键字;对于j# redistributable，使用“j# 2.0 redistributable”作为关键字。在每个搜索的结果列表中单击相应的项。应该出现下载和安装说明。

. net 1-Wire支持是针对Java的1-Wire API的Microsoft Visual j#编译版本。它以单个dll文件的形式出现，即OneWireAPI.NET.dll。要安装此文件，只需将其复制到父应用程序(即需要. net文件的应用程序)所在的文件夹中。因此，开发人员只需要将.dll文件复制到1-Wire . net程序复制到的文件夹中。

除了OneWireAPI.NET.dll，开发人员还必须安装TMEX API文件和驱动程序。有关此安装的完整说明，请参阅下面的TMEX API文件和驱动程序的安装部分。

TMEX API文件和驱动程序的安装

有关所有TMEX API文件和驱动程序的列表以及需要复制这些文件的位置的描述，请参见表1。此外，请查看表2中相关文件和驱动程序的必要注册表项。

TMEX API文件和驱动程序由一个主dll库IBFS XX . dll(其中XX是32或64，取决于操作系统是32位还是64位)以及适配器相关文件组成。开发人员可以在TMEX API文件中选择需要安装的dll文件和驱动程序。例如，如果开发人员只希望支持基于ds2480b的适配器(例如，DS9097U)，则自定义安装程序只需要安装主要的TMEX dll库和依赖于适配器的库文件IB97U XX . dll。(同样，XX是32或64，表示32位或64位操作系统。)开发人员的自定义安装还必须确保写入了适当的注册表项。在这种情况下，指定的注册表项需要从表2中的registry Keys列中写入。

USB的特殊注意事项

安装1-Wire USB文件有一些特殊的注意事项。所有的设备驱动程序USB文件一起被称为“驱动程序包”。鼓励开发人员编写安装程序来“预安装”1-Wire USB驱动程序包。此过程不会完全安装设备驱动程序文件。相反，它只是让操作系统意识到设备驱动程序可用，并标记在哪里可以找到设备驱动程序文件。驱动程序包预安装后，用户可以插入1线USB适配器。产生的即插即用事件完成了安装过程。

为了预安装USB驱动程序包，微软开发了特殊的驱动程序安装框架(DIFx)工具。这些工具允许即插即用设备驱动程序安装“正常工作”。DIFx工具有三种类型:DIFxApp、DPInst和DIFxAPI。1-Wire Drivers安装中使用的类别是DIFxApp，它代表“应用程序的驱动程序安装框架”。使用DIFxApp, Microsoft Windows安装程序可以安装签名的驱动程序包，以及使用该驱动程序的自定义应用程序。这是大多数定制1-Wire软件供应商使用的方法。这也是当前1-Wire Drivers安装中使用的方法。DIFxApp工具位于Windows驱动程序工具包(WDK)中的redist\DIFx子目录下。DIFxApp工具包括一个用于Windows Installer项目的合并模块和一个用于Windows Installer for XML (WiX)项目的WixLib对象。1-Wire Drivers安装项目是一个WiX项目。有关1线USB适配器(DS9490)安装帮助的详细信息，请参阅附录A。

1-线驱动安装工程

如上所述，1-Wire Drivers安装项目是作为Microsoft的Windows Installer for XML (WiX)项目编写的。WiX是微软发布的一个开源工具集，它从XML源代码构建Windows安装包。该工具集支持命令行环境，开发人员可以将其集成到构建过程中，以创建自定义的MSI安装包。可以下载WiX工具集。

1-Wire Drivers安装项目的WiX源代码可以免费下载。特别寻找“WiX Toolset Download Version x.x”超链接并下载最新的1-Wire Drivers安装源。此下载包含一个zip归档文件，其中包含安装的XML源文件和重新创建1-Wire Drivers MSI安装包所需的每个文件。除了WiX工具集，1-Wire Drivers WiX项目只需要Windows Driver Kit (WDK)。WDK是“。对象，用于通过DIFxApp安装即插即用驱动程序。WDK可以从微软下载中心免费下载(搜索关键字“WDK”)。

编译时，1-Wire Drivers WiX项目输出一个MSI安装包。当双击安装包时，实际执行的是msiexec.exe程序。Msi文件作为程序的输入。这意味着msiexec.exe程序可以通过其他安装或从命令行以编程方式调用。这个过程就是使用1-Wire驱动程序执行“静默”安装的方式。在命令行中输入:msiexec /package 1-WireDriversMsi /quiet /norestart。这将启动一个静默(或“安静”)安装，不需要UI或用户交互。更换1-WireDrivers。上面命令行示例中的msi文件名使用最新的1-Wire Drivers msi文件名。有关msiexec.exe命令行语法的其他文档，请参阅Windows Installer SDK。Windows安装SDK与微软SDK捆绑在一起，可以从微软下载中心免费下载(搜索关键字“Microsoft SDK”)。

结论

本白皮书帮助软件开发人员创建1-Wire驱动程序和API文件的自定义安装。安装过程包括以下Microsoft Windows 32位和64位操作系统的1线驱动程序:Windows 7、Windows Server 2008、Windows Vista和Windows XP (service pack 2及以上版本)。如果需要对特定文件的安装进行更多的说明，或者出现其他软件技术支持问题，我们鼓励开发人员通过我们的在线支持请求系统向Maxim的应用工程师提交问题。

附录A: 1线USB适配器(DS9490)安装帮助

本附录提供1线USB适配器安装的故障排除提示。有关最新信息和可下载的安装包，请参阅Maxim网站上的1-Wire Drivers页面。

1线USB设备驱动安装故障处理

1. 确保已经下载了最新版本的1-Wire Drivers。

2. 以管理员权限登录一个帐户。这是安装设备驱动程序所必需的。见本文档末尾的注释。

3. 卸载以前的1-Wire Drivers版本。

4. 通过双击安装程序的图标并严格按照说明安装最新版本的1-Wire驱动程序。请参阅应用说明4373，“OneWireViewer和iButton快速开始指南”，以逐步指导安装1线驱动程序。

5. 安装后，如果困难仍然存在，请在设备管理器中查看1-Wire USB适配器是否已正确安装。(它将出现在计算机附带的硬件设备列表中。)使用Windows XP，在控制面板中双击“系统”即可。然后单击正确的选项卡(通常是Hardware选项卡)。然后点击设备管理器按钮。在Windows Vista或Windows 7中，在控制面板中单击系统和安全，然后单击设备管理器。

6. 插入USB适配器后，设备管理器应该显示两个条目中的一个:1Wire Devices或1-Wire Devices。下图显示在Windows XP上成功安装(插入USB适配器)。




7. 如果出现以下错误(在“1Wire Devices”项下用带有感叹号的黄色圆圈表示)，请右键单击该项，然后单击“Update Drivers”菜单选项，尝试“更新”设备驱动程序。(请保持USB适配器的插入状态。)




8. 当提示输入新驱动程序时，浏览<应用程序>文件夹中。这是安装程序放置helper实用程序和自述文件的默认应用程序文件夹。对于32位操作系统，这是:
   C:\Program Files\Maxim集成\1线驱动程序x32\WinUSB_Driver。对于64位操作系统，这是:
   C:\Program Files\Maxim集成\1线驱动程序x64\WinUSB_Driver。然后继续完成更新驱动程序向导。

9. 驱动程序现在应该正确安装了。参见上面步骤6中的图像，其中成功安装了带有1-Wire USB适配器驱动程序的设备管理器。

手动安装1线USB适配器的设备驱动程序

1. 手动安装1-Wire USB适配器(DS9490)设备驱动程序需要五个文件。前三个文件是coinstaller dll: WDFCoInstaller01009.dll、winusbcoinstaller2.dll和WUDFUpdate_01009.dll。这些文件安装Windows驱动程序框架(WDF)和WinUSB。根据操作系统的类型(即，32位或64位)，最后两个文件的名称略有不同。第一个文件是签名的目录文件ds2490winusb_x86。Cat或ds2490winusb_amd64.cat;第二个是inf文件ds2490winusb_x86。文件ds2490winusb_amd64.inf。安装1-Wire Drivers后，这些文件可以在<applications>\WinUSB_Driver文件夹中找到。

2. 或者，下载最新的1-Wire Drivers的WiX工具集。将文件解压缩到指定目录。包括在这些文件将是在步骤1中提到的USB驱动程序文件。

3. 以管理员权限登录一个帐户。这是安装设备驱动程序所必需的。关于如何确定帐户权限，请参阅下面的说明。

4. 插入DS9490 1线USB适配器。

5. 如果插入DS9490后没有运行添加硬件(或添加新硬件)向导，则可能已经安装失败。有关如何修复此安装的详细信息，请参阅“1线USB设备驱动程序安装故障排除”部分。

6. 当被要求浏览驱动程序时，请按照说明进行操作。浏览到包含上面步骤1中列出的文件的目录。

7. 完成添加硬件向导。

请注意要确定Windows帐户权限，请遵循以下步骤:

1. 使用相关用户帐户登录到Windows。

2. 点击开始>控制面板。

3. 双击User Accounts图标。

4. 帐户被列为计算机管理员和密码保护XP，和计算机管理员密码保护，和简单的密码保护Windows 7和Windows Vista。

请联系技术支持以确定遗留1-Wire适配器的软件驱动程序的可用性。