OneWireContainer43 Class Reference

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

List of all members.

Public Member Functions
	OneWireContainer43 ()
	Default Constructor OneWireContainer43.
	OneWireContainer43 (DSPortAdapter sourceAdapter, byte[] newAddress)
	Create a container with a provided adapter object and the address of the iButton or 1-Wire device.
	OneWireContainer43 (DSPortAdapter sourceAdapter, long newAddress)
	Create a container with a provided adapter object and the address of the iButton or 1-Wire device.
	OneWireContainer43 (DSPortAdapter sourceAdapter, String newAddress)
	Create a container with a provided adapter object and the address of the iButton or 1-Wire device.
void	setupContainer (DSPortAdapter sourceAdapter, byte[] newAddress)
	Provide this container the adapter object used to access this device and provide the address of this iButton or 1-Wire device.
void	setupContainer (DSPortAdapter sourceAdapter, long newAddress)
	Provide this container the adapter object used to access this device and provide the address of this iButton or 1-Wire device.
void	setupContainer (DSPortAdapter sourceAdapter, String newAddress)
	Provide this container the adapter object used to access this device and provide the address of this iButton or 1-Wire device.
String	getName ()
	Retrieve the Maxim Integrated Products part number of the iButton as a string.
String	getAlternateNames ()
	Retrieve the alternate Maxim Integrated Products part numbers or names.
String	getDescription ()
	Retrieve a short description of the function of the iButton type.
int	getMaxSpeed ()
	Returns the maximum speed this iButton 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.
boolean	isPageWriteOnce (int page) throws OneWireIOException, OneWireException
	Query to see if current memory bank is write write once such as with EPROM technology.
void	setPageWriteOnce (int page) throws OneWireIOException, OneWireException
	Lock the specifed page in the current memory bank.
Static Public Attributes
static final byte	WRITEONCE_FLAG = ( byte ) 0xAA
	Page Lock Flag.

---

Detailed Description

1-Wire® container for the '1K-Bit protected 1-Wire EEPROM family type 43 (hex), Maxim Integrated Products part number: DS28EC20.

Features

• 20480 bits of 5V EEPROM memory partitioned into 80 pages of 256 bits
• Individual 8-Page Groups of Memory Pages (Blocks) can be Permanently Write Protected or Put in OTP EPROM-Emulation Mode ("Write to 0")
• 200k Write/Erase Cycle Endurance at +25C
• 256-Bit Scratchpad with Strict Read/Write Protocols Ensures Integrity of Data Transfer
• Unique Factory-Programmed 64-Bit Registration Number Ensures Error-Free Device Selection and Absolute Part Identity
• Switchpoint Hysteresis and Filtering to Optimize Performance in the Presence of Noise
• Communicates to Host at 15.4kbps or 125kbps Using 1-Wire Protocol
• Reduces control, address, data and power to a single data pin
• Low cost TO92 package or 6-pin TSOC package
• Reads and writes at 5.0V + or - 5% from -40C to +85C.
• IEC 1000-4-2 Level 4 ESD Protection (8kV Contact, 15kV Air, Typical) for I/O Pin

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

Version:

0.00, 19 February 2008

Author:

DS

---

Constructor & Destructor Documentation

OneWireContainer43

(

)

Default Constructor OneWireContainer43.

Must call setupContainer before using.

OneWireContainer43	(	DSPortAdapter	sourceAdapter,
		byte[]	newAddress
	)

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

Parameters:

sourceAdapter	adapter object required to communicate with this iButton.
newAddress	address of this 1-Wire device

OneWireContainer43	(	DSPortAdapter	sourceAdapter,
		long	newAddress
	)

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

Parameters:

sourceAdapter	adapter object required to communicate with this iButton.
newAddress	address of this 1-Wire device

OneWireContainer43	(	DSPortAdapter	sourceAdapter,
		String	newAddress
	)

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

Parameters:

sourceAdapter	adapter object required to communicate with this iButton.
newAddress	address of this 1-Wire device

---

Member Function Documentation

String getAlternateNames

(

)

Retrieve the alternate Maxim Integrated Products part numbers or names.

A 'family' of MicroLAN devices may have more than one part number depending on packaging.

Returns:

the alternate names for this iButton or 1-Wire device

Reimplemented from OneWireContainer.

String getDescription

(

)

Retrieve a short description of the function of the iButton type.

Returns:

string represetation of the function description.

Reimplemented from OneWireContainer.

int getMaxSpeed

(

)

Returns the maximum speed this iButton can communicate at.

Returns:

max. communication speed.

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

(

)

Retrieve the Maxim Integrated Products part number of the iButton as a string.

For example 'DS1992'.

Returns:

string represetation of the iButton name.

Reimplemented from OneWireContainer.

boolean isPageWriteOnce

(

int

page

)

throws OneWireIOException, OneWireException

Query to see if current memory bank is write write once such as with EPROM technology.

Returns:

'true' if current memory bank can only be written once

void setPageWriteOnce

(

int

page

)

throws OneWireIOException, OneWireException

Lock the specifed page in the current memory bank.

Not supported by all devices. See the method 'canLockPage()'.

Parameters:

page	number of page to lock

Exceptions:

OneWireIOException
OneWireException

void setupContainer	(	DSPortAdapter	sourceAdapter,
		long	newAddress
	)

Provide this container the adapter object used to access this device and provide the address of this iButton or 1-Wire device.

Parameters:

sourceAdapter	adapter object required to communicate with this iButton.
newAddress	address of this 1-Wire device

Reimplemented from OneWireContainer.

void setupContainer	(	DSPortAdapter	sourceAdapter,
		String	newAddress
	)

Provide this container the adapter object used to access this device and provide the address of this iButton or 1-Wire device.

Parameters:

sourceAdapter	adapter object required to communicate with this iButton.
newAddress	address of this 1-Wire device

Reimplemented from OneWireContainer.

void setupContainer	(	DSPortAdapter	sourceAdapter,
		byte[]	newAddress
	)

Provide this container the adapter object used to access this device and provide the address of this iButton or 1-Wire device.

Parameters:

sourceAdapter	adapter object required to communicate with this iButton.
newAddress	address of this 1-Wire device

Reimplemented from OneWireContainer.

---

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

• OneWireContainer43.java