Welcome to the 1-Wire Drivers Installation
Version 4.00 Beta 4
The 1-Wire Drivers installation (formerly known as iButton-TMEX RTE) is a set of drivers used to facilitate communications between software applications and Dallas Semiconductor’s 1-Wire devices. Included in the installation are the following:
OneWireViewer - a JavaTM program for communicating with iButtons and other 1-Wire Net compatible 1-Wire devices. It integrates most iButton and other 1-Wire utilities in a single, user-friendly piece of software. The OneWireViewer supports a true network environment. Device-specific viewers allow evaluation of special function devices.
Default 1-Wire Net {32-Bit} – a Windows program for selecting the default 1-Wire Net port to be used by 1-Wire applications. Note that 1-Wire applications only use this default port on the first invocation. Thereafter, they store their own current 1-Wire Net port. Applications without a means to select a new 1-Wire Net port, may rely chiefly on the default port selected by this program.
Special Considerations for USB
1. Unplug any 1-Wire USB devices when prompted during installation to allow the device driver to be updated.
2. Please plug in the 1-Wire USB device when prompted by the install program and wait for the Windows “Install Wizard” to complete the installation of the USB driver. If necessary, please point the wizard to the default installation directory, which is:
“C:\Program Files\Dallas Semiconductor\iButton-TMEX (32-Bit) V3.21”.
3. If it is not recognized, then RE-BOOT and try again.
USB Adapter Port Numbering Notes
1. The way 1-Wire USB adapter (specifically, the DS9490R or DS9490B) enumeration occurs is a bit different from other 1-Wire adapters as some TMEX USB port numbers are reserved.
2. The 1-Wire USB driver supports hot-swap for the default device on Port number 1.
3. Port numbers 2 though 15 are assigned to a particular adapter based on it's unique number. This port will remain the same even after the PC is rebooted or devices are removed and reinserted.
4. Port 0 is reserved for DS2490-based adapters with no unique number assigned.
Port |
Description |
0 |
Reserved for adapters with no ROM ID detected |
1 |
Reserved for duplicate handle to first adapter found in USB enumeration |
2-15 |
Assigned port based on ROM ID found |
1. Upgraded the ib90usb.dll (for 1-Wire USB adapters) to allow for proper functioning in compiler debug environments.
2. Upgraded the OWCOM API to support new iButton and 1-Wire devices, specifically, the DS2408, the DS1922L/T, DS2422, the DS2431 and the DS1977.
3. Consolidated the DS2490.inf file into a single file for installing the driver for DS2490-based 1-Wire USB adapters across all Windows 32-bit platforms.
4. The “SourcePath” registry key used during the installation process (through chkusr.exe) is now restored to its original state when the installation program exits.
5. Changed deployment package from InstallShield to the Microsoft Installer (MSI) found in Visual Studio 2003.
6. 1-Wire Microsoft .NET support has been upgraded:
a. DotNetAdapter – The new adapter class is exactly like the TMEX adapter, except it utilizes a the TMEX DLLs directly (instead of the TMEX wrapper ibtmjava.dll). Interface and use is unchanged from the standard 1-Wire API for Java. Specify adapters with a ‘curly brace (i.e. {DS9097U}, {DS9490})’.
b. The new name of the 1-Wire API support DLL is: OneWireAPI.NET.dll
c. The file, ibtmvjsharp.dll is no longer required.
d. New .NET example programs are available:
i. owio.exe - A C# general purpose utility for arbitrary 1-Wire communication.
ii. HygrochronViewer.exe - A C# application for the DS1922H Hygrochron iButton.
e. Required Support Libraries:
i. .NET Runtime or .NET SDK: http://msdn.microsoft.com/netframework/downloads/howtoget.aspx
ii. Visual J# .NET: http://msdn.microsoft.com/vjsharp/downloads/howtoget.asp
New for Version 4.00 Beta 3
1. Upgrade to DS9490 USB (DS2490 chip) driver. Now supports hot-swap for default device on Port number 1. Port number 2 though 15 are assigned to a particular adapter based on its unique number. This port will remain the same even after PC is rebooted or devices are removed and reinserted. Port 0 is reserved for DS2490 based adapters with no unique number assigned.
2. 12V Vpp detection requirement removed from DS9097U (DS2480B chip) driver. This detection was shown not to work under all conditions so it was removed. The 12V pulse for programming EPROM 1-Wire devices will work unchanged for the DS9097U-E25.
3. Initial Microsoft .NET support implemented through the ibtmvjsharp.dll (native interface) and the OneWireAPI.dll. A separate installation program is available that will install these files correctly, along with a small C# example program and the following Microsoft packages (if missing):
1. The DS1410D.SYS driver has been updated to support PCI parallel port add-on cards.
2. The OWCOM API object is “safe for scripting” when used in the Internet Explorer web browser. This means no pop-up warning messages appear when using the COM object in a web page (IE only).
1. The name of this software package has changed from iButton-TMEX RTE to 1-Wire Drivers.
2. The 1-Wire API for Java is now accessible to other Microsoft programming languages through a COM object that gets installed by default. It allows for easy VBScript, JavaScript, and Visual Basic programming using high-level objects encapsulating the full functionality of each 1-Wire device. Of course, the standard API is also still available.
3. The iButton Viewer has been replaced with the OneWireViewer (a Java program). It will require further installation after the 1-Wire Drivers package has been installed.
4. XML 1-Wire Tagging through the COM object is now available. For more information about 1-Wire tagging, please see Application Note 158 at http://pdfserv.maxim-ic.com/arpdf/AppNotes/app158.pdf.
1.
Attach a 1-Wire
Adapter to your COM, LPT, or USB.
2.
Attach iButtons
or other 1-Wire Net compatible 1-wire devices to the adapter.
3.
Double-Click the
OneWireViewer icon created with the install. The viewer icon is also listed
under the windows start menu, under programs, under 1-Wire Drivers, unless
otherwise directed during the install.
To create your own 1-Wire applications, download the 1-Wire SDK at the site listed below in ‘Information’. This kit contains source code examples in C, Pascal, and Basic for 32-Bit Windows. It also includes help files and complete documentation of the 1-Wire Application Program Interfaces (APIs).
These 32-bit Windows Drivers support the following Dallas Semiconductor 1-Wire adapters.
Adapter |
Port |
Win 95 |
Win 98 |
Win ME |
Win NT |
Win2000 |
Win XP |
DS9490R, DS9490B, 2-in-1Fob, DS1490 |
USB |
|
X |
X |
|
X |
X |
DS1410E,
|
Parallel |
X |
X |
X |
X |
X |
X |
DS9097U-009, |
Serial |
X |
X |
X |
X |
X |
X |
DS9097E, |
Serial |
X |
X |
X |
X |
X |
X |
Building Custom 1-Wire Drivers Installation Packages
For detailed information on building custom 1-Wire Drivers installation packages, please see White Paper 6: “White Paper 6: 1-Wire Drivers Installation Guide for Windows.” It is available on Dallas Semiconductor MAXIM’s website here:
http://www.maxim-ic.com/appnotes.cfm/appnote_number/1740/ln/en. It covers the installation process of 1-Wire drivers, including which drivers and DLLs go with which 1-Wire port adapter (USB, serial port, and parallel port), the correct directories to which the drivers need to be copied, their associated registry entries, and any special system checks.
Drivers Installed
The following drivers are installed with this utility. The location the drivers will be copied-to is described in the generic location specified by <>. This location is system depended and will automatically be changed for your system.
General
Provides general-purpose access to all 1-Wire devices through the standard API. The API is outlined in the 1-Wire SDK.
Drivers:
All Platforms
<windows\system>\ibfs32.dll
<windows\system>\ib97u32.dll
<windows\system>\ib97e32.dll
<windows\system>\ib10e32.dll
Windows 98, Windows 2000, Windows ME, Windows XP
<windows\system>\ib90usb.dll
<windows\system32\drivers\>ds2490.sys
Windows 95, Windows 98, Windows ME
<windows\system>\vsauthd.vxd
Windows NT, Windows 2000, Windows XP
<windows\system32\drivers\>ds1410d.sys
Windows 98, Windows ME
<windows\INF>\DS2490.inf
An optional install provides a .NET friendly dll that encapsulates the entire 1-Wire API for Java (OneWireAPI.NET.dll). This file requires the .NET framework to be installed, along with Visual J# .NET Redistributable Package available from Microsoft.
Drivers:
* The 1-Wire .NET support has been made available through an optional install (OneWireAPI.NET_Setup.msi). The install provides the above-mentioned OneWireAPI.NET.dll, along with example programs written in C#).
Provides native access 1-Wire drivers to Java. This library layers on top of the ‘General’
library detailed above. See the 1-Wire
API for Java on this web site: http://www.ibutton.com/software/1wire/1wire_api.html
Drivers:
<windows\system>\ibtmjava.dll
Java powered iButton
Provides the Java iButton Application Programmer Interface (JiB-API). See the Java-Powered Cryptographic iButton here:
http://www.ibutton.com/ibuttons/java.html
<windows\system>\jibcomm.dll
<windows\system>\jibapi.dll
COM Object
The 1-Wire COM object allows Windows programming languages, including scripting languages like VBScript and JavaScript, the ability to access 1-Wire devices through the 1-Wire API for Java. The COM object is made up of the 1-Wire API for Java classes along with the owapi.dll. For successful operation, Microsoft’s Java Virtual Machine (JVM) is required. Most Windows installations (except early versions of XP) already come with Microsoft’s JVM pre-installed. For more information on Microsoft’s JVM, please visit http://www.microsoft.com/java.
<windows\system>\owapi.dll
<windows\JAVA\TrustLib>\com\dalsemi\onewire\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\adapter\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\application\file\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\application\monitor\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\application\sha\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\application\tag\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\container\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\debug\*.class
<windows\JAVA\TrustLib>\com\dalsemi\onewire\utils\*.class
<windows\JAVA\TrustLib>\nanoxml\*.class
<windows\JAVA\TrustLib>\nanoxml\sax\*.class
<windows\JAVA\TrustLib>\org\xml\sax\*.class
<windows\JAVA\TrustLib>\org\xml\sax\helpers\*.class
The following is a list of registry keys added during this installation.
All Platforms
[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas
Semiconductor]
[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas
Semiconductor\iButton TMEX]
[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas
Semiconductor\iButton TMEX\3.00]
"MainDriver"="IBFS32.DLL"
"TYPE1"="IB97E32.DLL"
"TYPE2"="IB10E32.DLL"
"TYPE5"="IB97U32.DLL"
"TYPE6"="IB90USB.DLL"
"DefaultPortNum"="1" *set by “Default 1-Wire Net” program
"DefaultPortType"="6"
*set by “Default 1-Wire Net”
program
[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas
Semiconductor\1-Wire Drivers]
Windows NT, Windows 2000, Windows XP, Windows 2003
[HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\DS1410D]
"ErrorControl"=dword:00000001
"Group"="Extended Base"
"Start"=dword:00000002
"Tag"=dword:00000002
"Type"=dword:00000001
Copyright (C) 2004 Dallas
Semiconductor MAXIM Corporation, All Rights Reserved.
Permission is hereby granted,
free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use, copy, modify,
merge, publish, distribute, sublicense, and/or sell copies of the Software, and
to permit persons to whom the Software is furnished to do so, subject to the
following conditions:
The above copyright notice
and this permission notice shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED
"AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
SHALL DALLAS SEMICONDUCTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Except as contained in this
notice, the name of Dallas Semiconductor MAXIM shall not be used except as
stated in the Dallas Semiconductor MAXIM Branding Policy.
Information
The complete 1-Wire Drivers Documentation and Software Downloads
http://www.ibutton.com/software
iButton information:
Dallas Semiconductor MAXIM
information:
Technical
Support: