Welcome to iButton-TMEX

Runtime Environment Version 3.21

 

 

iButton-TMEX Runtime Environment (a.k.a. 1-Wire Drivers) is a set of drivers used to facilitate communications between TMEX applications and Dallas Semiconductor�s one wire devices.Included in the Runtime Environment installation are the following:

 

iButton Viewer {32-Bit} - a Windows program for communicating with iButtons and other 1-Wire Net compatible 1-Wire devices. It integrates most of the iButton-TMEX utilities in a single, user-friendly piece of software. The iButton Viewer supports a true network environment. Device-specific viewers allow evaluation of special function devices.

 

iButton Viewer Help {32-Bit} � a hyperlinked Windows help file that describes in detail the full usage of the iButton viewer.This help file is also accessed through the help system of the iButton Viewer.

 

Default 1-Wire Net {32-Bit} � a Windows program for selecting the default 1-Wire Net port to be used by TMEX applications.Note that TMEX applications such as the iButton Viewer, only use this default port on the first invocation.Thereafter, they store their own current 1-Wire Net port.TMEX 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.

 

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

 

 

New for Version 3.21

 

1.        Upgraded the ib90usb.dll (for 1-Wire USB adapters) to allow for proper functioning in compiler debug environments.

2.        Removed .NET optional install introduced in version 3.21 beta 3.The .NET optional install will be provided by versions 4.00 beta 3 and up of the 1-Wire Drivers.

3.        Upgraded the iButton Viewer to allow printing from the debug window, to show DS1921G support, and to correct minor display issues.

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

5.        The �SourcePath� registry key used during the installation process (through chkusr.exe) is now restored to its original state when the installation program exits.

6.        Upgraded 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 it's 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.

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

8.        Updated DS1410D.SYS to support PCI parallel port add-on cards in Windows NT/2000/XP.

9.        Corrected overflow problem in the number of samples in the iButton Viewer�s Thermochon �sub-viewer.�

10.     Fixed bug in TMCrc that truncated any CRC8 seed value that was bigger than 4 bits.

11.     Changed speed flex parameters to be able use 19200 baud in data byte mode under Windows NT.

12.     Added a check to a flag in the registry (for IB97U32.DLL and IB97E32.DLL):

 

Key: Software\Dallas Semiconductor\iButton TMEX\3.00

Value: DeviceStdCOM

Contents: Anything

 

If this value is present then open the COM port without the leading slashes, i.e.: COM2 instead of \\.\COM2.This is required for some types of serial ports.

 

13.     Fixed bug in IB90USB.DLL that did not clear out the search when TMNext returns FALSE.

14.     DS1921H and DS1921Z Thermochrons now supported in iButton Viewer.

15.     USB driver now supports alarming DS1994/DS2404's.

16.     DS1973/DS2433 write bug fixed.

17.     More robust native interface driver for Java applications.

18.     Updated JIB drivers: JIBAPI.DLL, JIBCOMM.DLL

19.     Fix for the end of search problem with USB driver: IB90USB.DLL

20.     Update to support �The Link�: www.iButtonLink.com

 

How to Get Started

 

1.        Attach a 1-Wire Adapter to your COM, LPT, or USB port.

2.        Attach iButtons or other 1-Wire Net compatible 1-wire devices to the adapter.

3.        Double Click the iButton Viewer 32-bit icon created with the install. The viewer icon is also listed under the windows start menu, under programs, under iButton-TMEX, unless otherwise directed during the install.

 

To create your own iButton-TMEX applications, download the TMEX SDK at the site listed below in �Information�.This kit contains source code examples in C, Pascal, and Basic for Windows (32-bit, 16-bit) and DOS.It also includes help files and complete documentation of the TMEX 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

Win 2000

Win XP

DS9490R

DS9490B,

2-in-1Fob,
DS2490,

DS1490

 

USB

 

X

X

 

X

X

DS1410E,
DS1410D

 

Parallel

X

X

X

X

X

X

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

 

Serial

X

X

X

X

X

X

DS9097E,
DS9097,
DS1413,
HA2,
HA3,
HA4

 

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 (TMEX)

 

Provides general-purpose access to all 1-Wire devices.The API is outlined in the iButton-TMEX SDK.This installation is a driver-only version of the iButton-TMEX RTE (32-bit).

 

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 2003

<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 2003

<windows\system32\drivers\>ds1410d.sys

 

Windows 98, Windows ME

<windows\INF>\DS2490.inf

 

 

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

 

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\iButton Viewer32]

[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas Semiconductor\iButton Viewer32\3.00]

[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas Semiconductor\iButton-TMEX (32-Bit) V3.21]

[HKEY_LOCAL_MACHINE\SOFTWARE\Dallas Semiconductor\iButton-TMEX (32-Bit) V3.21\3.21]

 

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

 


License

 

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 iButton-TMEX Runtime Environment Documentation and Software Downloads

http://www.ibutton.com/software/tmex

iButton information:

http://www.iButton.com/

Dallas Semiconductor MAXIM information:

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

Technical Support:

http://www.ibutton.com/geninfo/support/ibutton.html