Keywords: OneWireViewer, install, iButton, software, Thermochron, 1-Wire, drivers
OneWireViewer and iButton Quick Start Guide
IntroductionMaxim's iButton® products are designed so that a personal computer (PC) can easily read from or write to an iButton device. The OneWireViewer is a convenient demonstration software program that allows users to easily read from and write to iButtons with a Windows-based PC that has a USB port. (The Getting started section discusses limitations when writing to EPROM-based iButtons.) The PC must also support Sun® Microsystems' Java® program.
The OneWireViewer requires additional software drivers to allow the PC to communicate with the adapter. Both OneWireViewer and the required
The OneWireViewer and
Getting startedTo communicate with your iButton, you need all of the items shown in Figure 1.
Figure 1. Required setup components.
Maxim provides two iButton kits that include the adapter, reader, and iButtons for evaluation:
Important note: if you intend to program EPROM-based iButtons (DS1982, DS1985, or DS1986), you must use a serial-port adapter, the DS9097U-E25 with an external 12V power supply. This adapter has a 25-pin serial connector and requires a 9-pin to 25-pin serial converter to work with most PCs. The USB adapter can read these EPROM devices, but not program them.
The reader/probe has an RJ-11 modular connector that plugs into the adapter. Most users find the
All iButton devices communicate using the
Step 1. Java installation
Many PCs have Java software installed at the factory. The OneWireViewer requires Java (version 5, update 8 or higher). To check if you have Java installed or what version you do have, go to the Java website. Click on the appropriate links that autodetect and verify the version. If your version is out of date, follow the links to download and install the latest version.
If you are running a 64-bit version of a Microsoft Windows operating system, make sure to visit the Java website with the 64-bit version of Internet Explorer® (IE) before downloading Java. If you do not take this step, you may download/install a version of Java that is incompatible with the 64-bit OneWireViewer. As can be seen in Figure 2 below, both 32-bit and 64-bit versions of IE are available on 64-bit Microsoft operating systems. To find the 64-bit IE on your computer, click the Microsoft Start button, then All Programs and you will see the IE icons. Launch the IE selected in Figure 2 and visit http://java.com.
Figure 2. Selection of the 64-bit Internet Explorer (IE) versions with which to download Java on 64-bit Windows.
Step 2. Download bundled OneWireViewer and
NOTE: DO NOT INSERT THE DS9490R# USB ADAPTER INTO THE PC YET. THIS SHOULD NOT BE DONE UNTIL STEP 4, AND WILL USUALLY CAUSE INSTALLATION PROBLEMS IF DONE BEFORE STEP 4.
Download the bundled OneWireViewer and 1-Wire drivers here. These pages have pulldown menus to help select the correct file for the operating system that you are running. Microsoft operating systems come in 32-bit and 64-bit versions. If you are not certain which version you have, the download page has a link to an applet that autodetects the correct version. Click on the hyperlink for the text, "Is my computer running a 32-bit or 64-bit operating system?" to run this autodetect applet.
Step 3. Install bundled OneWireViewer and
After clicking on the download button, click Run on the window that asks, "Do you want to run or save this file?" See Figure 3.
Figure 3. Download window.
After clicking Run, the window in Figure 4 will appear. If you want to run this software, click Run.
Figure 4. Window for running the installation software.
After this, you will be prompted to affirm the license agreement if you choose to use the
Step 4. Complete USB installation
Now plug the DS9490R# USB adapter into your PC, as shown in Figure 5. Follow the Microsoft new-hardware wizard instructions to complete the plug-and-play portion of the installation.
Figure 5. Plugging the USB adapter into the PC.
This phase of the installation uses a Microsoft driver called WinUSB that allows the
In Windows 7 and Windows Vista, the plug-and-play installation window (Figures 6 and 7) will appear. (See Figures 8 and 9 for the installation with Windows XP.):
Figure 6. Windows 7 and Windows Vista plug-and-play installation window.
Figure 7. Windows 7 and Windows Vista completion of plug-and-play installation.
Figure 8. Windows XP plug-and-play installation window.
Figure 9. Windows XP completion of plug-and-play installation.
Step 5. Start the OneWireViewer program
Follow these steps to launch the OneWireViewer from Windows 7, Windows Vista, or Windows XP:
Next, snap the iButton into one of the blue dots on the reader (Figure 10) and plug the reader into the adapter (Figure 11). The
Figure 10. Connect an iButton to the reader by snapping it into place.
Figure 11. Connect the reader to the adapter.
Step 7. Run the OneWireViewer
The OneWireViewer can communicate with all versions of iButtons, including Hygrochron™ and Thermochron® temperature loggers, memory iButtons, and simple identification iButtons. Each iButton type serves a different purpose, so for detailed information on how to use OneWireViewer for each application, see application note 3358, "OneWireViewer User's Guide."
The OneWireViewer program is open source, so software developers can use this as a foundation to develop their own applications. See our page with Software Development Kits for information on our open source-code examples.
Additionally, Maxim has many partners who have written software tailored for specific iButton applications. To search for partners who offer iButton software and system solutions, see our Solutions Search database.
Problem solvingIf you encounter problems getting the OneWireViewer to work, please file a support request using our Tech Support form. An Application Engineer will attempt to address your problem within one business day.
|DS1402D-DR8||1-Wire Network Cables|
|DS1921K||Thermochron iButton Starter Kit|
|DS9092K||iButton Starter Kit|
|EE-Mail||Subscribe to EE-Mail and receive automatic notice of new documents in your areas of interest.|
|Download||Download, PDF Format (218.4kB) Download, MOBI Format (Kindle)|
|© Mar 11, 2009, Maxim Integrated Products, Inc.|
APP 4373: Mar 11, 2009
TUTORIAL 4373, AN4373, AN 4373, APP4373, Appnote4373, Appnote 4373