OneWireContainer0F Class Reference

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

List of all members.

Public Member Functions
	OneWireContainer0F ()
	Create an empty container that is not complete until after a call to setupContainer.
	OneWireContainer0F (DSPortAdapter sourceAdapter, byte[] newAddress)
	Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.
	OneWireContainer0F (DSPortAdapter sourceAdapter, long newAddress)
	Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.
	OneWireContainer0F (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	getAlternateNames ()
	Get the alternate Maxim Integrated Products part numbers or names.
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 Add-Only memory (EPROM) iButton, DS1986 and 1-Wire Chip, DS2506. This container encapsulates the functionality of the 1-Wire family type 0F (hex)

The iButton package for this device is primarily used as a read/write portable memory device. The 1-Wire Chip version is used for non-volatile storage.

Features

• 65536 bits (8192 bytes) Electrically Programmable Read-Only Memory (EPROM) communicates with the economy of one signal plus ground
• EPROM partitioned into 256-bit (32-byte) pages for randomly accessing packetized data
• Each memory page can be permanently write-protected to prevent tampering
• Device is an "add only" memory where additional data can be programmed into EPROM without disturbing existing data
• Architecture allows software to patch data by superseding an old page in favor of a newly programmed page
• Overdrive mode boosts communication to 142 kbits per second
• Reads over a wide voltage range of 2.8V to 6.0V from -40 °C to +85 °C ; programs at 11.5V to 12.0V from -40 °C to +50 °C

Alternate Names

• D2506

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:

• Main Memory
  • Implements MemoryBank, PagedMemoryBank, OTPMemoryBank
  • Size 8192 starting at physical address 0
  • Features Write-once general-purpose non-volatile needs-program-pulse
  • Pages 256 pages of length 32 bytes giving 29 bytes Packet data payload
  • Page Features page-device-CRC pages-redirectable pages-lockable redirection-lockable
  • Extra information for each page Inverted redirection page, length 1
• Write protect pages
  • Implements MemoryBank, PagedMemoryBank, OTPMemoryBank
  • Size 32 starting at physical address 0 (in STATUS memory area)
  • Features Write-once not-general-purpose non-volatile needs-program-pulse
  • Pages 4 pages of length 8 bytes
  • Page Features page-device-CRC
• Write protect redirection
  • Implements MemoryBank, PagedMemoryBank, OTPMemoryBank
  • Size 32 starting at physical address 32 (in STATUS memory area)
  • Features Write-once not-general-purpose non-volatile needs-program-pulse
  • Pages 4 pages of length 8 bytes
  • Page Features page-device-CRC
• Bitmap of used pages for file structure
  • Implements MemoryBank, PagedMemoryBank, OTPMemoryBank
  • Size 24 starting at physical address 64 (in STATUS memory area)
  • Features Write-once not-general-purpose non-volatile needs-program-pulse
  • Pages 3 pages of length 8 bytes
  • Page Features page-device-CRC
• Page redirection bytes
  • Implements MemoryBank, PagedMemoryBank, OTPMemoryBank
  • Size 256 starting at physical address 256 (in STATUS memory area)
  • Features Write-once not-general-purpose non-volatile needs-program-pulse
  • Pages 32 pages of length 8 bytes
  • Page Features page-device-CRC

Usage

See the usage example in OneWireContainer to enumerate the MemoryBanks. See the usage examples in MemoryBank, PagedMemoryBank, and OTPMemoryBank for bank specific operations.

DataSheets

http://pdfserv.maxim-ic.com/arpdf/DS2506.pdf http://pdfserv.maxim-ic.com/arpdf/DS1986.pdf

See also:

com.dalsemi.onewire.container.MemoryBank

com.dalsemi.onewire.container.PagedMemoryBank

com.dalsemi.onewire.container.OTPMemoryBank

com.dalsemi.onewire.container.OneWireContainer09

com.dalsemi.onewire.container.OneWireContainer0B

Version:

0.00, 28 Aug 2000

Author:

DS

---

Constructor & Destructor Documentation

OneWireContainer0F

(

)

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()

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

OneWireContainer0F() OneWireContainer0F

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

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

OneWireContainer0F() OneWireContainer0F

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

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

OneWireContainer0F() OneWireContainer0F

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

---

Member Function Documentation

String getAlternateNames

(

)

Get the alternate Maxim Integrated Products part numbers or names.

A 'family' of 1-Wire Network devices may have more than one part number depending on packaging. There can also be nicknames such as 'Crypto iButton'.

Returns:

1-Wire device alternate names

Reimplemented from OneWireContainer.

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:

• OneWireContainer0F.java