Overview
 The OneWireViewer is a Java™ demonstration application for exploring iButton or 1-Wire® chip features from your PC. It automatically finds iButtons or 1-Wire chips on the 1-Wire network, and then displays their serial numbers and a description of relevant features and menu options. The OneWireViewer supports the features of most 1-Wire devices, including temperature/humidity/data logging, potentiometer, switch, analog-to-digital conversion, SHA-1 authentication, and memory. The screenshot here shows the simple OneWireViewer interface and highlights the temperature log viewer for the Thermochron. For more extensive OneWireViewer documentation, please see the OneWireViewer User's Guide.
Quick Install Guide
- Obtain the required hardware. (Example: DS9490R + DS1402D-DR8 or other combination as explained below.)
- Install 1-Wire Drivers for Windows. (Other platforms should check the Open Source Drivers section below.)
- Install the latest version of Java.
- Launch the OneWireViewer by clicking the button shown below.
- Read the OneWireViewer User's Guide.
- If the need or desire to run the OneWireViewer without an internet connection arises, see the off-line instructions for how to set this up.
Required Hardware
Special hardware is required to interface iButtons and/or 1-Wire ICs to the PC. A 1-Wire port adapter plugs into the respective PC port, and an iButton reader connects to the adapter. The 1-Wire port adapter comes in three configurations: USB (DS9490R), serial (DS9097U-S09), and parallel (DS1410E-001). Our most popular iButton readers are called Blue Dot™ receptors, and come in two forms: one has an RJ11 cable and plugs directly into the USB or serial adapters (DS1402D-DR8), and the other plugs directly into the parallel-port adapter (DS1402D-DB8). If demonstrating and/or programming 1-Wire chips are desired, the OneWireViewer can be used in conjunction with the DS9090K evaluation kit. This kit has a circuit board with sockets that can handle most 1-Wire chips in TSOC, PR35, and TO92 packages.
System Setup
To use the OneWireViewer, you need Java Web Start, which is included in the latest Java Runtime Environment (JRE) and can be downloaded from http://www.java.com. To use another version of the JRE, please see the Java
Web Start section below.
For Windows® users, if you do not have the 1-Wire drivers installed, the OneWireViewer can only access a serial-port adapter like the DS9097U. To use the USB or parallel-port adapters, a complete install of the 1-Wire Drivers is necessary. If your platform is not a Windows operating system, see the Drivers section below.
To install and start the OneWireViewer application, click here to load the OneWireViewer JNLP file. If the application fails to load, see the Installing OneWireViewer section below.
Java Web Start
The OneWireViewer is web-enabled through Java Web Start. Java Web Start is included in the most recent versions of the Java SDK. However, if you are using the Java SDK version 1.3 (the minimum required to run the OneWireViewer), you must download the Java Web Start Runtime separately (as it does not come with the Java SDK). The Web Start Runtime is available for Windows, Solaris™ SPARC®, Solaris X86, or Linux™. If you already have an older Java SDK installed, you only need to download the Web Start Update Package. An alternative implementation of Java Web Start for other platforms is available from OpenJNLP.
1-Wire Drivers or Open-Source Drivers
You need a communication driver to give Java access to the 1-Wire adapter. For Win32 platforms with serial ports, you can choose between either the native 1-Wire drivers for the serial port or the open-source RXTX serial-communications API.
All other platforms require the RXTX API for communicating with the DS9097U serial-port adapter. If your platform is not listed below, you can look for (or compile from source) a version for your platform at www.rxtx.org. Install RXTX by simply copying rxtxSerial.dll into your <JRE>/bin folder, and copying RXTXcomm.jar into your <JRE>/lib/ext folder.
Installing OneWireViewer
If clicking on the OneWireViewer JNLP file fails to start the application, right-click on the URL and save the file to your desktop. Then double-click on the file to launch Java Web Start. Now you can delete the *.jnlp file from your desktop. You can then launch the OneWireViewer, first by loading Java Web Start and then by selecting the OneWireViewer.
The OneWireViewer can also be run as a stand-alone application, without the need for internet connectivity. For the step-by-step process on how to set this up, see the Offline OneWireViewer Installation instructions.
Troubleshooting
To help debug problems with your installation of the OneWireViewer, click on File, then Preferences, then the Advanced tab in the Java Web Start application. Select the Log Output option, and specify the filename of the log file in a location where it is easily recovered. Any output to this log can be useful in troubleshooting some problems. Post this output to the online 1-Wire Discussion Forum and someone will help you debug the problem.
Additionally, the OneWireViewer application has a built-in message log, which will display any 'normal' exceptions like those generated by intermediate contact or some lack of 1-Wire adapter features. This message log is available under View, then Message Log after you start the OneWireViewer.
|
