Class OneWireContainer1A

java.lang.Object
com.dalsemi.onewire.container.OneWireContainer
com.dalsemi.onewire.container.OneWireContainer1A

public class OneWireContainer1A extends OneWireContainer

1-Wire container for 512 byte memory iButton with write cycle counters, DS1963L. This container encapsulates the functionality of the iButton family type 1A (hex)

This iButton is primarily used as a read/write portable memory device that provides tamper detection when utilizing the write counters.

Features

  • 4096 bits (512 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
  • Overdrive mode boosts communication to 142 kbits per second
  • Four 32-bit read-only non rolling-over page write cycle counters
  • 32 factory-preset tamper-detect bits to indicate physical intrusion
  • On-chip 16-bit CRC generator for safeguarding data transfers
  • Operating temperature range from -40 to +70
  • 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 Ex
    • 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 384 starting at physical address 0
    • Features Read/Write general-purpose non-volatile
    • Pages 12 pages of length 32 bytes giving 29 bytes Packet data payload
    • Page Features page-device-CRC
  • Memory with write cycle counter
    • Implements MemoryBank, PagedMemoryBank
    • Size 128 starting at physical address 384
    • Features Read/Write general-purpose non-volatile
    • Pages 4 pages of length 32 bytes giving 29 bytes Packet data payload
    • Page Features page-device-CRC
    • Extra information for each page Write cycle counter, length 8

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/DS1963L.pdf
See Also:
  • Constructor Details

    • OneWireContainer1A

      public OneWireContainer1A()
      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:
    • OneWireContainer1A

      public OneWireContainer1A(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:
    • OneWireContainer1A

      public OneWireContainer1A(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:
    • OneWireContainer1A

      public OneWireContainer1A(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:
  • Method Details