Welcome to the 1-Wire Drivers Installation

Version 4.00

 

 

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.   This program can be optionally installed.

 

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 (by default) is:

“C:\Program Files\Dallas Semiconductor\1-Wire Drivers Version 4.00”.

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.

 

USB Adapter Port Number Mapping

 

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

 

Special Considerations for OWCOM API

1.        The OWCOM API (owapi.dll) is dependent upon the presence of the Microsoft Java Virtual Machine (MSJVM).  It comes default on many Microsoft 32-bit platforms, but is now not officially supported by Microsoft.  The MSJVM can be downloaded from the following websites:

a.        http://www.linktivity.com/get_java.asp

b.       http://www.big-foot.de/dateien/msjava.exe

2.        If upgrading from an earlier version of the OWCOM API the developer may need to recompile any apps that "cache the vtable".  This is primarily a notice for Visual Basic 6 developers.

 


New for Version 4.00

 

1.        The name of this software package has changed from iButton-TMEX RTE to 1-Wire Drivers.

2.        Changed deployment package from InstallShield to the Microsoft Installer (MSI) found in Visual Studio 2003.

3.        Changed from iButton Viewer to OneWireViewer (which is optionally installed).  For more information on the OneWireViewer, please see the following website:  http://www.maxim-ic.com/products/ibutton/software/1wire/OneWireViewer.cfm.

4.        1-Wire Drivers .NET support now included (OneWireAPI.NET.dll).  It is installed in its own directory and is available to be referenced by other .NET applications.  Example .NET 1-Wire programs can be found on-line on our software “Examples Search”:  http://www.maxim-ic.com/products/ibutton/example/.  On the “Examples Search” web page, click on “1-Wire .NET” in the list of APIs and then click on the “Search” button.  The list of returned example programs will be included in a future 1-Wire SDK.   Since the .NET 1-Wire support is our 1-Wire API for Java compiled with Microsoft’s J#, the behavior of the 1-Wire .NET support is identical to the 1-Wire API for Java.  Please note the following:

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.       Required Support Libraries:

                                                   i.      .NET Runtime or .NET SDK:  http://msdn.microsoft.com/netframework/downloads/howtoget.aspx

                                                  ii.      Visual J# .NET redistributable:  http://msdn.microsoft.com/vjsharp/downloads/howtoget.asp

5.        1-Wire COM (OWCOM API) object now optionally included.  This is also based on the 1-Wire API for Java and is dependent upon the “unsupported” Microsoft Java Virtual Machine (MSJVM).  Other sites that allow for downloading of the MSJVM:

c.        http://www.linktivity.com/get_java.asp

d.       http://www.big-foot.de/dateien/msjava.exe

6.        Added support for new 1-Wire devices (to .NET and OWCOM): 

a.        Since Version 4.00 beta 4:  OneWireContainer1C (DS28E04), and OneWireContainer3A (DS2413). 

b.       Other new containers:  OneWireContainer29 (DS2408), OneWireContainer41 (DS1922L/T, DS2422, DS1923), OneWireContainer2D (DS2431), and the OneWireContainer37 (DS1977).

7.        Misc. updates to 1-Wire .NET support:

e.        Updated ibfs32.dll for .NET -- masked data byte to remove possible sign extension bits (such as 0xE3, the cmd-mode for DS2480).

f.         The name of the 1-Wire API support DLL was changed from original name to:  OneWireAPI.NET.dll

c.        The file, ibtmvjsharp.dll is no longer required (since first release of OneWireAPI.NET.dll).

8.        Misc. updates to OWCOM API:

g.       The OWCOM API object is marked as “safe for scripting” in the system registry (although, it technically is not). When used in the Internet Explorer (IE) web browser under Windows 2000 and below (excluding XP), no pop-up warning messages appear when using the COM object in a web page (IE only).

h.       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.

9.        USB 1-Wire adapter updates:

a.        Updated DS2490.sys to allow for proper recovery from sleep states (putting laptops into standby, hibernation, etc.).

b.       Upgraded ib90usb.dll to implement the USB port mapping as described above.

c.        Upgraded the ib90usb.dll to allow for proper functioning in compiler debug environments.

d.       Updated ib90usb.dll to fix a problem when doing a targeted search, followed by a non-targeted search.

e.        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.

10.     Serial 1-Wire adapter updates:

i.         Updated ib97u32.dll to fix an incompatibility with some DS9097Us.

j.         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.

11.     Parallel port 1-Wire adapter updates:

k.        The DS1410D.SYS driver has been updated to support PCI parallel port add-on cards.

 


How to Get Started

 

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).

 

Adapters Supported

 

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,

(Other DS2490–based adapters)

 

USB

 

X

X

 

X

X

DS1410E,
DS1410D

 

Parallel

X

X

X

X

X

X

DS9097U-009,
DS9097U-S09,
DS9097U-E25,
DS1411

iButtonLink

 

Serial

X

X

X

X

X

X

DS9097E,
DS9097,
DS1413,
HA2,
HA3,
HA4

 

Serial (Legacy)

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

 

.NET

 

The install package provides a .NET friendly dll that encapsulates the entire 1-Wire API for Java (OneWireAPI.NET.dll).  To use, install the .NET framework  along with the Visual J# .NET Redistributable Package available from Microsoft:

 

Windows 98, Windows 2000, Windows ME, Windows XP

<application\1-Wire.NET>\OneWireAPI.NET.dll

 

.NET Runtime or .NET SDK:  http://msdn.microsoft.com/netframework/downloads/howtoget.aspx

Visual J# .NET redistributable:  http://msdn.microsoft.com/vjsharp/downloads/howtoget.asp

 

Java

 

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

Drivers:

<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.  Keep in mind that Microsoft’s JVM is currently “unsupported”.  However, it can be downloaded from the following websites:

http://www.linktivity.com/get_java.asp

http://www.big-foot.de/dateien/msjava.exe

 

 

 

Drivers:

<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

 

 


Registry Keys Added

 

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

[HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\DS1410D]
"ErrorControl"=dword:00000001
"Group"="Extended Base"
"Start"=dword:00000002
"Tag"=dword:00000002
"Type"=dword:00000001

 

 


License

 

Copyright (C) 2005 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:

http://www.ibutton.com/

Dallas Semiconductor MAXIM information: 

http://www.maxim-ic.com/

Technical Support:

http://discuss.dalsemi.com