Class OneWireContainer23


  • public class OneWireContainer23
    extends OneWireContainer

    1-Wire container for 512 byte EEPROM memory iButton, DS1973 and 1-Wire Chip, DS2433. This container encapsulates the functionality of the 1-Wire family type 23 (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 small non-volatile storage.

    Features

    • 4096 bits (512 bytes) Electrically Erasable Programmable Read Only Memory (EEPROM)
    • 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
    • Reduces control, address, data and power to a single data pin
    • Reads and writes over a wide voltage range of 2.8V to 6.0V from -40@htmlonly °C @endhtmlonly to +85@htmlonly °C @endhtmlonly environments

    Alternate Names

    • DS2433

    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 512 starting at physical address 0
      • Features Read/Write general-purpose non-volatile
      • Pages 16 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.

    DataSheets

    http://pdfserv.maxim-ic.com/arpdf/DS1973.pdf
    http://pdfserv.maxim-ic.com/arpdf/DS2433.pdf
    See Also:
    MemoryBank, PagedMemoryBank, OneWireContainer14
    • Constructor Detail

      • OneWireContainer23

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

        public OneWireContainer23​(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:
        OneWireContainer23(), utils.Address
      • OneWireContainer23

        public OneWireContainer23​(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:
        OneWireContainer23(), utils.Address
      • OneWireContainer23

        public OneWireContainer23​(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:
        OneWireContainer23(), 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