|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.dalsemi.onewire.adapter.DSPortAdapter | +--com.dalsemi.onewire.adapter.USerialAdapter
The USerialAdapter class implememts the DSPortAdapter interface for a DS2480 based serial adapter such as the DS9097U-009 or DS9097U-S09.
Fields inherited from class com.dalsemi.onewire.adapter.DSPortAdapter |
CONDITION_AFTER_BIT, CONDITION_AFTER_BYTE, CONDITION_NOW, DELIVERY_CURRENT_DETECT, DELIVERY_EPROM, DELIVERY_FOUR_SECONDS, DELIVERY_HALF_SECOND, DELIVERY_INFINITE, DELIVERY_ONE_SECOND, DELIVERY_SMART_DONE, DELIVERY_TWO_SECONDS, LEVEL_BREAK, LEVEL_NORMAL, LEVEL_POWER_DELIVERY, LEVEL_PROGRAM, RESET_ALARM, RESET_NOPRESENCE, RESET_PRESENCE, RESET_SHORT, SPEED_FLEX, SPEED_HYPERDRIVE, SPEED_OVERDRIVE, SPEED_REGULAR |
Constructor Summary | |
USerialAdapter()
Constructs a DS9097U serial adapter class |
Method Summary | |
boolean |
adapterDetected()
Detect adapter presence on the selected port. |
boolean |
beginExclusive(boolean blocking)
Gets exclusive use of the 1-Wire to communicate with an iButton or 1-Wire Device. |
boolean |
canBreak()
Returns whether adapter can physically support 0 volt 'break' mode. |
boolean |
canDeliverPower()
Returns whether the adapter can physically support strong 5 volt power mode. |
boolean |
canDeliverSmartPower()
Returns whether the adapter can physically support "smart" strong 5 volt power mode. |
boolean |
canFlex()
Returns whether the adapter can physically support flex speed mode. |
boolean |
canHyperdrive()
Returns whether the adapter can physically support hyperdrive mode. |
boolean |
canOverdrive()
Returns whether adapter can physically support overdrive mode. |
boolean |
canProgram()
Returns whether adapter can physically support 12 volt power mode. |
void |
dataBlock(byte[] dataBlock,
int off,
int len)
Sends a block of data and returns the data received in the same array. |
void |
endExclusive()
Relinquishes exclusive control of the 1-Wire Network. |
void |
excludeFamily(byte[] familyID)
Takes an array of bytes containing family codes to avoid when finding iButtons or 1-Wire devices. |
void |
excludeFamily(int familyID)
Takes an integer family code to avoid when searching for iButtons. |
boolean |
findFirstDevice()
Returns true if the first iButton or 1-Wire device
is found on the 1-Wire Network. |
boolean |
findNextDevice()
Returns true if the next iButton or 1-Wire device
is found. |
void |
freePort()
Free ownership of the selected port if it is currently owned back to the system. |
java.lang.String |
getAdapterAddress()
Retrieve the address of the adapter if it has one. |
java.lang.String |
getAdapterName()
Retrieve the name of the port adapter as a string. |
java.lang.String |
getAdapterVersion()
Retrieve the version of the adapter. |
void |
getAddress(byte[] address)
Copies the 'current' iButton address being used by the adapter into the array. |
boolean |
getBit()
Gets a bit from the 1-Wire Network. |
void |
getBlock(byte[] arr,
int len)
Get a block of data from the 1-Wire Network and write it into the provided array. |
void |
getBlock(byte[] arr,
int off,
int len)
Get a block of data from the 1-Wire Network and write it into the provided array. |
byte[] |
getBlock(int len)
Get a block of data from the 1-Wire Network. |
int |
getByte()
Gets a byte from the 1-Wire Network. |
java.lang.String |
getClassVersion()
Retrieve a version string for this class. |
java.lang.String |
getPortName()
Retrieve the name of the selected port as a String . |
java.util.Enumeration |
getPortNames()
Retrieve a list of the platform appropriate port names for this adapter. |
java.lang.String |
getPortTypeDescription()
Retrieve a description of the port required by this port adapter. |
int |
getSpeed()
This method returns the current data transfer speed through a port to a 1-Wire Network. |
boolean |
isAlarming(byte[] address)
Verifies that the iButton or 1-Wire device specified is present on the 1-Wire Network and in an alarm state. |
boolean |
isPresent(byte[] address)
Verifies that the iButton or 1-Wire device specified is present on the 1-Wire Network. |
void |
putBit(boolean bitValue)
Sends a bit to the 1-Wire Network. |
void |
putByte(int byteValue)
Sends a byte to the 1-Wire Network. |
int |
reset()
Sends a Reset to the 1-Wire Network. |
boolean |
selectPort(java.lang.String newPortName)
Specify a platform appropriate port name for this adapter. |
void |
setAddress(byte[] address)
Copies the provided 1-Wire device address into the 'current' array. |
void |
setNoResetSearch()
Set the 1-Wire Network search to not perform a 1-Wire reset before a search. |
void |
setPowerDuration(int timeFactor)
Sets the duration to supply power to the 1-Wire Network. |
void |
setPowerNormal()
Sets the 1-Wire Network voltage to normal level. |
void |
setProgramPulseDuration(int timeFactor)
Sets the duration for providing a program pulse on the 1-Wire Network. |
void |
setSearchAllDevices()
Set the 1-Wire Network search to find all iButtons and 1-Wire devices whether they are in an 'Alarm' state or not and restores the default setting of providing a 1-Wire reset command before each search. |
void |
setSearchOnlyAlarmingDevices()
Set the 1-Wire Network search to find only iButtons and 1-Wire devices that are in an 'Alarm' state that signals a need for attention. |
void |
setSpeed(int speed)
This method takes an int representing the new speed of data transfer on the 1-Wire Network. |
void |
startBreak()
Sets the 1-Wire Network voltage to 0 volts. |
boolean |
startPowerDelivery(int changeCondition)
Sets the 1-Wire Network voltage to supply power to an iButton device. |
boolean |
startProgramPulse(int changeCondition)
Sets the 1-Wire Network voltage to eprom programming level. |
void |
targetAllFamilies()
Removes any selectivity during a search for iButtons or 1-Wire devices by family type. |
void |
targetFamily(byte[] familyID)
Takes an array of bytes to use for selectively searching for acceptable family codes. |
void |
targetFamily(int familyID)
Takes an integer to selectively search for this desired family type. |
Methods inherited from class com.dalsemi.onewire.adapter.DSPortAdapter |
getAddressAsLong, getAddressAsString, getAllDeviceContainers, getDeviceContainer, getDeviceContainer, getDeviceContainer, getDeviceContainer, getFirstDeviceContainer, getNextDeviceContainer, isAlarming, isAlarming, isPresent, isPresent, registerOneWireContainerClass, select, select, select |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public USerialAdapter()
Method Detail |
public java.lang.String getAdapterName()
getAdapterName
in class DSPortAdapter
String
representation of the port adapter.public java.lang.String getPortTypeDescription()
getPortTypeDescription
in class DSPortAdapter
String
description of the port type required.public java.lang.String getClassVersion()
getClassVersion
in class DSPortAdapter
public java.util.Enumeration getPortNames()
OneWireException
exception.getPortNames
in class DSPortAdapter
String
that contains the port
namespublic boolean selectPort(java.lang.String newPortName) throws OneWireIOException, OneWireException
PortInUseException
will be thrown.selectPort
in class DSPortAdapter
newPortName
- name of the target port, retrieved from
getPortNames()true
if the port was aquired, false
if the port is not available.OneWireIOException
- OneWireException
- WHEN port does not existpublic java.lang.String getPortName() throws OneWireException
String
.getPortName
in class DSPortAdapter
String
of selected portOneWireException
- public void freePort() throws OneWireException
freePort
in class DSPortAdapter
OneWireException
- public boolean adapterDetected() throws OneWireIOException, OneWireException
adapterDetected
in class DSPortAdapter
true
if the adapter is confirmed to be connected to
the selected port, false
if the adapter is not connected.OneWireIOException
- OneWireException
- public java.lang.String getAdapterVersion() throws OneWireIOException, OneWireException
getAdapterVersion
in class DSPortAdapter
String
of the adapter version. It will return
"OneWireIOException
- OneWireException
- public java.lang.String getAdapterAddress() throws OneWireIOException, OneWireException
getAdapterAddress
in class DSPortAdapter
String
of the adapter address. It will return "OneWireIOException
- OneWireException
- public boolean canOverdrive() throws OneWireIOException, OneWireException
canOverdrive
in class DSPortAdapter
true
if this port adapter can do OverDrive,
false
otherwise.OneWireIOException
- OneWireException
- public boolean canHyperdrive() throws OneWireIOException, OneWireException
canHyperdrive
in class DSPortAdapter
true
if this port adapter can do HyperDrive,
false
otherwise.OneWireIOException
- OneWireException
- public boolean canFlex() throws OneWireIOException, OneWireException
canFlex
in class DSPortAdapter
true
if this port adapter can do flex speed,
false
otherwise.OneWireIOException
- OneWireException
- public boolean canProgram() throws OneWireIOException, OneWireException
canProgram
in class DSPortAdapter
true
if this port adapter can do Program voltage,
false
otherwise.OneWireIOException
- OneWireException
- public boolean canDeliverPower() throws OneWireIOException, OneWireException
canDeliverPower
in class DSPortAdapter
true
if this port adapter can do strong 5 volt
mode, false
otherwise.OneWireIOException
- OneWireException
- public boolean canDeliverSmartPower() throws OneWireIOException, OneWireException
canDeliverSmartPower
in class DSPortAdapter
true
if this port adapter can do "smart" strong
5 volt mode, false
otherwise.OneWireIOException
- OneWireException
- public boolean canBreak() throws OneWireIOException, OneWireException
canBreak
in class DSPortAdapter
true
if this port adapter can do break,
false
otherwise.OneWireIOException
- OneWireException
- public boolean findFirstDevice() throws OneWireIOException, OneWireException
true
if the first iButton or 1-Wire device
is found on the 1-Wire Network.
If no devices are found, then false
will be returned.findFirstDevice
in class DSPortAdapter
true
if an iButton or 1-Wire device is found.OneWireIOException
- OneWireException
- public boolean findNextDevice() throws OneWireIOException, OneWireException
true
if the next iButton or 1-Wire device
is found. The previous 1-Wire device found is used
as a starting point in the search. If no more devices are found
then false
will be returned.findNextDevice
in class DSPortAdapter
true
if an iButton or 1-Wire device is found.OneWireIOException
- OneWireException
- public void getAddress(byte[] address)
getAddress
in class DSPortAdapter
address
- An array to be filled with the current iButton address.public void setAddress(byte[] address)
address
- An array to be copied into the current iButton
address.public boolean isPresent(byte[] address) throws OneWireIOException, OneWireException
isPresent
in class DSPortAdapter
address
- device address to verify is presenttrue
if device is present else
false
.OneWireIOException
- OneWireException
- public boolean isAlarming(byte[] address) throws OneWireIOException, OneWireException
isAlarming
in class DSPortAdapter
address
- device address to verify is present and alarmingtrue
if device is present and alarming else
false
.OneWireIOException
- OneWireException
- public void setSearchOnlyAlarmingDevices()
setSearchOnlyAlarmingDevices
in class DSPortAdapter
public void setNoResetSearch()
setNoResetSearch
in class DSPortAdapter
public void setSearchAllDevices()
setSearchAllDevices
in class DSPortAdapter
public void targetAllFamilies()
targetAllFamilies
in class DSPortAdapter
public void targetFamily(int familyID)
targetFamily
in class DSPortAdapter
family
- the code of the family type to target for searchespublic void targetFamily(byte[] familyID)
targetFamily
in class DSPortAdapter
family
- array of the family types to target for searchespublic void excludeFamily(int familyID)
excludeFamily
in class DSPortAdapter
family
- the code of the family type NOT to target in searchespublic void excludeFamily(byte[] familyID)
excludeFamily
in class DSPortAdapter
family
- array of family cods NOT to target for searchespublic boolean beginExclusive(boolean blocking) throws OneWireException
beginExclusive
in class DSPortAdapter
blocking
- true
if want to block waiting
for an excluse access to the adaptertrue
if blocking was false and a
exclusive session with the adapter was aquiredOneWireException
- public void endExclusive()
endExclusive
in class DSPortAdapter
public void putBit(boolean bitValue) throws OneWireIOException, OneWireException
putBit
in class DSPortAdapter
bitValue
- the bit value to send to the 1-Wire Network.OneWireIOException
- OneWireException
- public boolean getBit() throws OneWireIOException, OneWireException
getBit
in class DSPortAdapter
OneWireIOException
- OneWireException
- public void putByte(int byteValue) throws OneWireIOException, OneWireException
putByte
in class DSPortAdapter
byteValue
- the byte value to send to the 1-Wire Network.OneWireIOException
- OneWireException
- public int getByte() throws OneWireIOException, OneWireException
getByte
in class DSPortAdapter
OneWireIOException
- OneWireException
- public byte[] getBlock(int len) throws OneWireIOException, OneWireException
getBlock
in class DSPortAdapter
len
- length of data bytes to receiveOneWireIOException
- OneWireException
- public void getBlock(byte[] arr, int len) throws OneWireIOException, OneWireException
getBlock
in class DSPortAdapter
arr
- array in which to write the received byteslen
- length of data bytes to receiveOneWireIOException
- OneWireException
- public void getBlock(byte[] arr, int off, int len) throws OneWireIOException, OneWireException
getBlock
in class DSPortAdapter
arr
- array in which to write the received bytesoff
- offset into the array to startlen
- length of data bytes to receiveOneWireIOException
- OneWireException
- public void dataBlock(byte[] dataBlock, int off, int len) throws OneWireIOException, OneWireException
dataBlock
in class DSPortAdapter
dataBlock
- array of data to transfer to and from the 1-Wire Network.off
- offset into the array of data to startlen
- length of data to send / receive starting at 'off'OneWireIOException
- OneWireException
- public int reset() throws OneWireIOException, OneWireException
reset
in class DSPortAdapter
OneWireIOException
- OneWireException
- public void setPowerDuration(int timeFactor) throws OneWireIOException, OneWireException
Note: to avoid getting an exception, use the canDeliverPower() and canDeliverSmartPower() method to check it's availability.
setPowerDuration
in class DSPortAdapter
timeFactor
- OneWireIOException
- OneWireException
- public boolean startPowerDelivery(int changeCondition) throws OneWireIOException, OneWireException
Note: to avoid getting an exception, use the canDeliverPower() and canDeliverSmartPower() method to check it's availability.
startPowerDelivery
in class DSPortAdapter
changeCondition
- true
if the voltage change was successful,
false
otherwise.OneWireIOException
- OneWireException
- public void setProgramPulseDuration(int timeFactor) throws OneWireIOException, OneWireException
Note: to avoid getting an exception, use the canDeliverPower() method to check it's availability.
setProgramPulseDuration
in class DSPortAdapter
timeFactor
- OneWireIOException
- OneWireException
- public boolean startProgramPulse(int changeCondition) throws OneWireIOException, OneWireException
Note: to avoid getting an exception, use the canProgram() method to check it's availability.
startProgramPulse
in class DSPortAdapter
changeCondition
- true
if the voltage change was successful,
false
otherwise.OneWireIOException
- OneWireException
- public void startBreak() throws OneWireIOException, OneWireException
startBreak
in class DSPortAdapter
OneWireIOException
- OneWireException
- public void setPowerNormal() throws OneWireIOException, OneWireException
setPowerNormal
in class DSPortAdapter
OneWireIOException
- OneWireException
- public void setSpeed(int speed) throws OneWireIOException, OneWireException
setSpeed
in class DSPortAdapter
speed
- OneWireIOException
- OneWireException
- public int getSpeed()
getSpeed
in class DSPortAdapter
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |