com.dalsemi.onewire.container
Class OneWireContainer08

java.lang.Object
  |
  +--com.dalsemi.onewire.container.OneWireContainer
        |
        +--com.dalsemi.onewire.container.OneWireContainer08

public class OneWireContainer08

extends OneWireContainer

1-Wire container for 128 byte memory iButton, DS1992. This container encapsulates the functionality of the iButton family type 08 (hex)

This iButton is primarily used as a read/write portable memory device.

Features

• 1024 bits (128 bytes) of read/write nonvolatile memory
• 256-bit (32-byte) scratchpad ensures integrity of data transfer
• Memory partitioned into 256-bit (32-byte) pages for packetizing data
• Data integrity assured with strict read/write protocols
• Operating temperature range from -40°C to +70°C
• Over 10 years of data retention

Memory

The memory can be accessed through the objects that are returned from the getMemoryBanks method.

The following is a list of the MemoryBank instances that are returned:

• Scratchpad
  • Implements MemoryBank, PagedMemoryBank
  • Size 32 starting at physical address 0
  • Features Read/Write not-general-purpose volatile
  • Pages 1 pages of length 32 bytes
  • Extra information for each page Target address, offset, length 3
• Main Memory
  • Implements MemoryBank, PagedMemoryBank
  • Size 128 starting at physical address 0
  • Features Read/Write general-purpose non-volatile
  • Pages 4 pages of length 32 bytes giving 29 bytes Packet data payload

Usage

See the usage example in OneWireContainer to enumerate the MemoryBanks.

See the usage examples in MemoryBank and PagedMemoryBank for bank specific operations.

DataSheet

http://pdfserv.maxim-ic.com/arpdf/DS1992-DS1994.pdf

Version:

0.00, 28 Aug 2000

See Also:

MemoryBank, PagedMemoryBank

Constructor Summary

OneWireContainer08()
Create an empty container that is not complete until after a call to setupContainer.

OneWireContainer08(DSPortAdapter sourceAdapter, byte[] newAddress)
Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.

OneWireContainer08(DSPortAdapter sourceAdapter, long newAddress)
Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.

OneWireContainer08(DSPortAdapter sourceAdapter, String newAddress)
Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.

Method Summary

String	getDescription() Get a short description of the function of this iButton or 1-Wire Device type.
Enumeration	getMemoryBanks() Get an enumeration of memory bank instances that implement one or more of the following interfaces: MemoryBank, PagedMemoryBank, and OTPMemoryBank.
String	getName() Get the Dallas Semiconductor part number of the iButton or 1-Wire Device as a string.

Methods inherited from class com.dalsemi.onewire.container.OneWireContainer

doSpeed, getAdapter, getAddress, getAddressAsLong, getAddressAsString, getAlternateNames, getMaxSpeed, isAlarming, isPresent, setSpeed, setupContainer, setupContainer, setupContainer

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OneWireContainer08

public OneWireContainer08()

Create an empty container that is not complete until after a call to setupContainer.

This is one of the methods to construct a container. The others are through creating a OneWireContainer with parameters.

See Also:

super.setupContainer()

OneWireContainer08

public OneWireContainer08(DSPortAdapter sourceAdapter,
                          byte[] newAddress)

Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.

This is one of the methods to construct a container. The other is through creating a OneWireContainer with NO parameters.

Parameters:

sourceAdapter - adapter instance used to communicate with this iButton

newAddress - Address of this 1-Wire device

See Also:

OneWireContainer08, utils.Address

OneWireContainer08

public OneWireContainer08(DSPortAdapter sourceAdapter,
                          long newAddress)

Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.

This is one of the methods to construct a container. The other is through creating a OneWireContainer with NO parameters.

Parameters:

sourceAdapter - adapter instance used to communicate with this 1-Wire device

newAddress - Address of this 1-Wire device

See Also:

OneWireContainer08, utils.Address

OneWireContainer08

public OneWireContainer08(DSPortAdapter sourceAdapter,
                          String newAddress)

Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.

This is one of the methods to construct a container. The other is through creating a OneWireContainer with NO parameters.

Parameters:

sourceAdapter - adapter instance used to communicate with this 1-Wire device

newAddress - Address of this 1-Wire device

See Also:

OneWireContainer08, utils.Address

Method Detail

getName

public String getName()

Get the Dallas Semiconductor part number of the iButton or 1-Wire Device as a string. For example 'DS1992'.

Overrides:

getName in class OneWireContainer

Returns:

iButton or 1-Wire device name

getDescription

public String getDescription()

Get a short description of the function of this iButton or 1-Wire Device type.

Overrides:

getDescription in class OneWireContainer

Returns:

device description

getMemoryBanks

public Enumeration getMemoryBanks()

Get an enumeration of memory bank instances that implement one or more of the following interfaces: MemoryBank, PagedMemoryBank, and OTPMemoryBank.

Overrides:

getMemoryBanks in class OneWireContainer

Returns:

Enumeration of memory banks