Large 1-Wire networks can be sub-divided into branches for load, location, or organizational reasons. Once 1-Wire devices are placed on this branches there needs to be a mechanism to reach these devices. The OWPath class was designed to provide a convenient method to open and close 1-Wire paths to reach remote devices.
Open the path 'path' to the 1-Wire temperature device 'tc' and read the temperature:
// open a path to the temp device
path.open();
// read the temp device
byte[] state = tc.readDevice();
tc.doTemperatureConvert(state);
state = tc.readDevice();
System.out.println("Temperature of " +
address + " is " +
tc.getTemperature(state) + " C");
// close the path to the device
path.close();
com.dalsemi.onewire.container.SwitchContainer
com.dalsemi.onewire.container.OneWireContainer05
Public Member Functions | |
OWPath (DSPortAdapter adapter) | |
Create a new 1-Wire path with no elemements. | |
OWPath (DSPortAdapter adapter, OWPath currentOWPath) | |
Create a new path with a starting path. | |
void | copy (OWPath currentOWPath) |
Copy the elements from the provided 1-Wire path into this 1-Wire path. | |
void | add (OneWireContainer owc, int channel) |
Add a 1-Wire path element to this 1-Wire path. | |
boolean | equals (OWPath compareOWPath) |
Compare this 1-Wire path with another. | |
Enumeration | getAllOWPathElements () |
Get an enumeration of all of the 1-Wire path elements in this 1-Wire path. | |
String | toString () |
Get a string representation of this 1-Wire path. | |
void | open () throws OneWireException, OneWireIOException |
Open this 1-Wire path so that a remote device can be accessed. | |
void | close () throws OneWireException, OneWireIOException |
Close each element in this 1-Wire path in reverse order. |
OWPath | ( | DSPortAdapter | adapter | ) |
Create a new 1-Wire path with no elemements.
Elements can be added by using copy
and/or add
.
adapter | where the path is based |
OWPath | ( | DSPortAdapter | adapter, | |
OWPath | currentOWPath | |||
) |
Create a new path with a starting path.
New elements can be added with add
.
adapter | where the 1-Wire path is based | |
currentPath | starting value of this 1-Wire path |
void copy | ( | OWPath | currentOWPath | ) |
Copy the elements from the provided 1-Wire path into this 1-Wire path.
currentOWPath | path to copy from |
void add | ( | OneWireContainer | owc, | |
int | channel | |||
) |
Add a 1-Wire path element to this 1-Wire path.
owc | 1-Wire device switch | |
channel | of device that represents this 1-Wire path element |
boolean equals | ( | OWPath | compareOWPath | ) |
Compare this 1-Wire path with another.
compareOWPath | 1-Wire path to compare to |
true
if the 1-Wire paths are the same Enumeration getAllOWPathElements | ( | ) |
Get an enumeration of all of the 1-Wire path elements in this 1-Wire path.
String toString | ( | ) |
Get a string representation of this 1-Wire path.
void open | ( | ) | throws OneWireException, OneWireIOException |
Open this 1-Wire path so that a remote device can be accessed.
OneWireIOException | on a 1-Wire communication error such as no device present or a CRC read from the device is incorrect. This could be caused by a physical interruption in the 1-Wire Network due to shorts or a newly arriving 1-Wire device issuing a 'presence pulse'. | |
OneWireException | on a communication or setup error with the 1-Wire adapter. |
void close | ( | ) | throws OneWireException, OneWireIOException |
Close each element in this 1-Wire path in reverse order.
OneWireIOException | on a 1-Wire communication error such as no device present or a CRC read from the device is incorrect. This could be caused by a physical interruption in the 1-Wire Network due to shorts or a newly arriving 1-Wire device issuing a 'presence pulse'. | |
OneWireException | on a communication or setup error with the 1-Wire adapter. |