Class OneWireContainer1A
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.
- 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
- Implements
- 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
- Implements
- 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
- Implements
Usage
- See the usage example in
OneWireContainer
to enumerate the MemoryBanks.- See the usage examples in
MemoryBank
andPagedMemoryBank
for bank specific operations. - See the usage examples in
DataSheet
- See Also:
-
Field Summary
Fields inherited from class com.dalsemi.onewire.container.OneWireContainer
adapter, address, speed, speedFallBackOK
-
Constructor Summary
ConstructorDescriptionCreate an empty container that is not complete until after a call tosetupContainer
.OneWireContainer1A
(DSPortAdapter sourceAdapter, byte[] newAddress) Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.OneWireContainer1A
(DSPortAdapter sourceAdapter, long newAddress) Create a container with the provided adapter instance and the address of the iButton or 1-Wire device.OneWireContainer1A
(DSPortAdapter sourceAdapter, String newAddress) Create a container with the provided adapter instance and the address of the iButton or 1-Wire device. -
Method Summary
Modifier and TypeMethodDescriptionGet the alternate Maxim Integrated Products part numbers or names.Get a short description of the function of this iButton or 1-Wire Device type.int
Get the maximum speed this iButton or 1-Wire device can communicate at.Get an enumeration of memory bank instances that implement one or more of the following interfaces:MemoryBank
,PagedMemoryBank
, andOTPMemoryBank
.getName()
Get the Maxim Integrated Products part number of the iButton or 1-Wire Device as a string.Methods inherited from class com.dalsemi.onewire.container.OneWireContainer
doSpeed, equals, getAdapter, getAddress, getAddressAsLong, getAddressAsString, hashCode, isAlarming, isPresent, setSpeed, setupContainer, setupContainer, setupContainer, toString
-
Constructor Details
-
OneWireContainer1A
public OneWireContainer1A()Create an empty container that is not complete until after a call tosetupContainer
.This is one of the methods to construct a container. The others are through creating a OneWireContainer with parameters.
- See Also:
-
OneWireContainer1A
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 iButtonnewAddress
-Address
of this 1-Wire device- See Also:
-
OneWireContainer1A
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 devicenewAddress
-Address
of this 1-Wire device- See Also:
-
OneWireContainer1A
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 devicenewAddress
-Address
of this 1-Wire device- See Also:
-
-
Method Details
-
getName
Get the Maxim Integrated Products part number of the iButton or 1-Wire Device as a string. For example 'DS1992'.- Overrides:
getName
in classOneWireContainer
- Returns:
- iButton or 1-Wire device name
-
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 classOneWireContainer
- Returns:
- 1-Wire device alternate names
-
getDescription
Get a short description of the function of this iButton or 1-Wire Device type.- Overrides:
getDescription
in classOneWireContainer
- Returns:
- device description
-
getMaxSpeed
public 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).- Overrides:
getMaxSpeed
in classOneWireContainer
- Returns:
- maximum speed
- See Also:
-
getMemoryBanks
Get an enumeration of memory bank instances that implement one or more of the following interfaces:MemoryBank
,PagedMemoryBank
, andOTPMemoryBank
.- Overrides:
getMemoryBanks
in classOneWireContainer
- Returns:
Enumeration
of memory banks- See Also:
-