Manual

ManualsBrandsMaxim Integrated ManualsHardwareOneWireViewer, Version 1.5

Maxim > Design Support > Technical Documents > User Guides > APP 3358

Keywords: onewireviewer, 1-wire,ibutton, onewire, viewer, software, evaluation, eval kit, java, web start, webstart, user's guide, manual, howto, debugging

USER GUIDE 3358

OneWireViewer User's Guide, Version 1.5

By: Bernhard Linke, Principal Member Technical Staff

Sep 25, 2009

Abstract:

This User's

Guide explains the OneWireViewer software program and how it can be used to evaluate the unique features of 1-Wire® and iButton®

devices.

Introduction

The OneWireViewer is a Java™-based software package to explore Maxim's 1-Wire and iButton devices with a personal computer. The 1-Wire and iButton devices

communicate over a single data line plus ground reference, using the 1-Wire protocol. Several 1-Wire adapters are available for USB and serial ports. The

OneWireViewer provides a user interface to evaluate the unique features of 1-Wire and i

Button products, including Thermochron® (temperature logging),

Hygrochron™ (real-time temperature and humidity), A to D (analog to digital), clock, memory, and file operations.

Installation

Refer to application note 4373, "OneWireViewer and iButton® Quick Start Guide" for the installation instructions for the 1-Wire Drivers, which also install the

OneWireViewer. For additional/expanded help, see application note 5057, "OneWireViewer Tips and Tricks," starting with the section Identifying the System.

Uninstalling

Refer to the application note 5057, "OneWireViewer Tips and Tricks," section How to Install a Newer OneWireViewer Version.

Program Main Window

The main window of the OneWireViewer consists of four areas: Device List (top left), 1-Wire Search Mode (bottom left), Tab area (to the right) and menus (top

row). The width of the device list/search mode area can be adjusted by horizontally moving the vertical scroll bar that separates these areas from the tab area. The

Device List/1-Wire Search Mode areas can be removed/restored by clicking on one of the tiny triangles to the right of the device list.

Viewer Menus

File

Close (to exit program)

Has a subtitle Alt-1 (instead of Alt+F4). The Program will end with Alt+F4 as well as Alt+1. The '1' must be pressed on the normal keypad, not the numeric keypad,

to be accepted.

View

Show Message Log (to read error messages)

Opens a new window that displays a device access log and error messages.

Page 1 of 21

Summary of content (21 pages)

PAGE 1
Maxim > Design Support > Technical Documents > User Guides > APP 3358 Keywords: onewireviewer, 1-wire,ibutton, onewire, viewer, software, evaluation, eval kit, java, web start, webstart, user's guide, manual, howto, debugging USER GUIDE 3358 OneWireViewer User's Guide, Version 1.5 By: Bernhard Linke, Principal Member Technical Staff Sep 25, 2009 Abstract: This User's Guide explains the OneWireViewer software program and how it can be used to evaluate the unique features of 1-Wire® and iButton® devices.
PAGE 2
Show Tab in New Window (to view multiple functions or devices simultaneously) To use this function, first select a device, then select one of the available tabs. Then use Show Tab in New Window, which moves the selected tab into a window of its own. The main window will then revert back to the Description tab.
PAGE 3
The 1-Wire and iButton products support a broad set of features. The following table, sorted by family code, shows the applicable device function viewers.
PAGE 4
Supported Devices Supported Devices Family Code DS1990A, DS1990R 01 DS1993L 06 DS1992L 08 DS1982, DS2502 09 DS1995L 0A DS1985, DS2505 0B DS1996L 0C DS1920, DS1820 10 DS2406 12 DS1971,¹ DS2430A¹ 14 DS28E04 1C DS2450 20 DS1921 21 DS1822 22 DS1973, DS2433 23 DS1904, DS2415 24 DS2438 26 DS2417 27 DS18B20 28 DS2408 29 DS2431 2D DS2760, DS2762 30 DS1977 37 DS2413 3A DS1922,² DS2422² 41 DS1923 41 DS28EA00³ 42 DS28EC20 43 Thermochron Mission Temperature H
PAGE 5
Sample Thermochron Viewer Tab Thermochron Viewer Commands Refresh Mission Results (to read device status, temperature, histogram, and alarm log) This allows a mission to be monitored in progress without changing device viewers. Start New Mission (to allow the user to enter all data necessary to start a new mission) This command opens a new window in which the user enters the parameters for the next mission. Disable Mission (to stop a running mission) This command stops a mission.
PAGE 6
Sample Temperature Log Graphic Sample Histogram Sample Alarm Log Page 6 of 21
PAGE 7
Start New Mission Window (default) It is recommended that you synchronize the device's real-time clock (RTC) to the PC. Enter the mission start delay in minutes. Sampling rate, mission start delay, temperature alarms, and rollover depend on the technical requirements of the mission. See the respective DS1921-series data sheets for guidelines. The clock alarm functions are not relevant for a device on a mission. The default settings, therefore, can be accepted. Notes: The time reference in the alarm log (e.
PAGE 8
Sample Mission Viewer Tab Mission Viewer Commands Refresh Mission Results (to read device status, temperature log, and data log) This allows a mission in progress to be watched without changing device viewers. If passwords are enabled for the device, the user must first use the Password viewer command Set Software Passwords before access is granted to device data.
PAGE 9
Sample Temperature Data Log Graphic (Humidity Data Log looks similar) Start New Mission Window (default) It is recommended that you synchronize the device's RTC to the PC. Enter the sampling rate in seconds (between samples). Enter the mission's Start Delay in minutes. SUTA means Start mission Upon Temperature Alarm. Sampling rate, mission start delay, resolution, alarms, and rollover depend on the technical requirements of the mission. See the respective device data sheets for details and guidelines.
PAGE 10
Password The Password viewer allows the user to set, enable, and disable passwords on a 1-Wire device, and to input the device-specific read and write passwords into the viewer. The tab structure of the Password viewer consists of two areas: Info (top) and Config (bottom). The Config tab has three buttons to set the software passwords, set the device passwords, and to enable/disable the password protection on the 1-Wire device.
PAGE 11
Sample Real-Time Temperature Tab When the Real-Time Temperature tab is active, the Real-Time Temperature viewer: Continuously issues the device-specific command to perform a temperature conversion. After each conversion reads the temperature registers of the selected device. Converts the reading from the device-specific format into a conventional format. Displays the result as a number, graph, and thermometer scale. Compresses the horizontal scale of the graph, as needed, to display additional readings.
PAGE 12
Sample Real-Time Humidity Tab When the Real-Time Humidity tab is active, the Real-Time Humidity viewer: Continuously issues the device-specific command to perform a humidity conversion. After each conversion reads the humidity registers of the selected device. Converts the reading from the device-specific format into a conventional format. Displays the result as a number, graph, and humidity scale. Compresses the horizontal scale of the graph, as needed, to display additional readings.
PAGE 13
Sample Switch Tab Switch Viewer Channel Commands Toggle State (to toggle the state of the switch between on and off) This command allows the switch's state to be changed through the 1-Wire network. Clear Activity (to clear the channel's activity latch) This command allows the switch's activity latch to be cleared through the 1-Wire network. When the Switch tab is active, the Switch viewer: Continuously reads the state of all channels of the selected device.
PAGE 14
Sample A to D Tab When the A to D tab is active, the A to D viewer: Continuously reads/converts the input voltage of the selected channels. For the selected channels, automatically updates the voltage reading in the Channels area. Allows the channels that are monitored (see Include in Poll) to be selected. Notes: If a channel is not included in the poll, the display for this channel will "freeze", and not show the actual input voltage.
PAGE 15
When the Clock tab is active, the Clock viewer: Continuously reads the time registers of the selected device. Converts the reading from the device-specific format into a conventional format. Displays the time read from the device (automatically updated with every reading). Allows the RTC oscillator to be stopped and restarted. Allows the time/date of the computer (PC or workstation) to be copied to the time registers in the device (i.e.
PAGE 16
Allows the contents of the selected bank to be changed. Allows the new data to be copied to the selected bank. Sample Memory Tab with Scratchpad Selected Notes: The number of the memory banks and their respective names depend on the type of the device viewed. The display format in the content field varies with the device and memory bank selected. For most devices there are 2 x 16 bytes per page. With EPROM devices, there are n x 8 bytes (special function registers only).
PAGE 17
Sample File Tab (DS1922L) File Viewer Commands Format Device (to create a root directory in the device) The device must be formatted before files can be created. See application note 114 (cited above) for additional information. Formatting does not erase the memory. Data from previous sessions will eventually be overwritten. Create New Directory (to create a file directory or subdirectory) Directory names are up to four ASCII characters long.
PAGE 18
Sample File Tab with Directory and File Data Displayed Notes: The 1-Wire File Structure allows multiple devices to be formatted as one cluster. For this reason when formatting a device, the device needs to be selected again, even if the File viewer already accesses it. Before data can be written to a file, the file must first be created as a new file. The file size is a multiple of 28 bytes (59 bytes with the DS1977).
PAGE 19
Hex Editor with File Viewer Editing Area Multiple rows of 16 bytes each in the Hex tab of the viewer; the last row can be shorter (partially editable). Each row is treated as an independent entity. More than one row can be updated before committing the changes. Use the Resize button to set the size of the editing area, as needed. The description below assumes that the editing area contains data, which was obtained by selecting a file in the directory area and then clicking the Read File button.
PAGE 20
EPROM Programming iButton and 1-Wire devices that are one-time-programmable (OTP) incorporate technology called electrically programmable read only memory (EPROM). EPROM programming requires 12V programming for writing. Although all adapters can read an EPROM iButton, only adapters with EPROM programming capability can write to them. NetAdapter The NetAdapter is a virtualized 1-Wire adapter.
PAGE 21
Application Note 3358: http://www.maximintegrated.com/an3358 USER GUIDE 3358, AN3358, AN 3358, APP3358, Appnote3358, Appnote 3358 Copyright © by Maxim Integrated Additional Legal Notices: http://www.maximintegrated.