OneWireContainer0C Class Reference

Inherits com::dalsemi::onewire::container::OneWireContainer.

List of all members.

Public Member Functions
	OneWireContainer0C ()
	Create an empty container that is not complete until after a call to setupContainer.
	OneWireContainer0C (DSPortAdapter sourceAdapter, byte[] newAddress)
	Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.
	OneWireContainer0C (DSPortAdapter sourceAdapter, long newAddress)
	Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.
	OneWireContainer0C (DSPortAdapter sourceAdapter, String newAddress)
	Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.
String	getName ()
	Get the Maxim Integrated Products part number of the iButton or 1-Wire Device as a string.
String	getDescription ()
	Get a short description of the function of this iButton or 1-Wire Device type.
int	getMaxSpeed ()
	Get the maximum speed this iButton or 1-Wire device can communicate at.
Enumeration	getMemoryBanks ()
	Get an enumeration of memory bank instances that implement one or more of the following interfaces: MemoryBank, PagedMemoryBank, and OTPMemoryBank.

---

Detailed Description

1-Wire container for 8192 byte memory iButton, DS1996. This container encapsulates the functionality of the iButton family type 0C (hex)

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

Features

• 65536 bits (8192 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
• Overdrive mode boosts communication to 142 kbits per second
• 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 8192 starting at physical address 0
  • Features Read/Write general-purpose non-volatile
  • Pages 256 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/DS1996.pdf

See also:

com.dalsemi.onewire.container.MemoryBank

com.dalsemi.onewire.container.PagedMemoryBank

Version:

0.01, 11 Dec 2000

Author:

DS

---

Constructor & Destructor Documentation

OneWireContainer0C

(

)

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:

setupContainer(com.dalsemi.onewire.adapter.DSPortAdapter,byte[]) super.setupContainer()

OneWireContainer0C	(	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:

OneWireContainer0C() OneWireContainer0C

com.dalsemi.onewire.utils.Address utils.Address

OneWireContainer0C	(	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:

OneWireContainer0C() OneWireContainer0C

com.dalsemi.onewire.utils.Address utils.Address

OneWireContainer0C	(	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:

OneWireContainer0C() OneWireContainer0C

com.dalsemi.onewire.utils.Address utils.Address

---

Member Function Documentation

String getDescription

(

)

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

Returns:

device description

Reimplemented from OneWireContainer.

int getMaxSpeed

(

)

Get the maximum speed this iButton or 1-Wire device can communicate at.

Override this method if derived iButton type can go faster then SPEED_REGULAR(0).

Returns:

maximum speed

See also:

com.dalsemi.onewire.container.OneWireContainer.setSpeed super.setSpeed

com.dalsemi.onewire.adapter.DSPortAdapter.SPEED_REGULAR DSPortAdapter.SPEED_REGULAR

com.dalsemi.onewire.adapter.DSPortAdapter.SPEED_OVERDRIVE DSPortAdapter.SPEED_OVERDRIVE

com.dalsemi.onewire.adapter.DSPortAdapter.SPEED_FLEX DSPortAdapter.SPEED_FLEX

Reimplemented from OneWireContainer.

Enumeration getMemoryBanks

(

)

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

Returns:

Enumeration of memory banks

Reimplemented from OneWireContainer.

String getName

(

)

Get the Maxim Integrated Products part number of the iButton or 1-Wire Device as a string.

For example 'DS1992'.

Returns:

iButton or 1-Wire device name

Reimplemented from OneWireContainer.

---

The documentation for this class was generated from the following file:

• OneWireContainer0C.java