Class 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:
    MemoryBank, PagedMemoryBank, OneWireContainer18
    • Constructor Detail

      • 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:
        super.setupContainer()
      • 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, utils.Address
      • 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, utils.Address
      • OneWireContainer1A

        public OneWireContainer1A​(DSPortAdapter sourceAdapter,
                                  java.lang.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:
        OneWireContainer1A, utils.Address
    • Method Detail

      • getName

        public java.lang.String getName()
        Get the Maxim Integrated Products 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
      • getAlternateNames

        public java.lang.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'.
        Overrides:
        getAlternateNames in class OneWireContainer
        Returns:
        1-Wire device alternate names
      • getDescription

        public java.lang.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