Rationale

Hobbyboards sells a onewire serial interface and hub. You connect various onewire devvices to this interface/hub. I want to connect these device to my XPL network. There, I developed a gateway.

Functionality

The gateway has the following functionality:

• Support for XPL trigger messages for onewire devices, using the sensor.basic scheme.
• Support for XPL commands to retrieve the status of the onewire devices.
• The gateway keeps track of the minimum and maximum values of the sensors.
• These min/max values can be reset hourly, daily, weekly, monthly, or yearly by the gateway (the min / max values do not survive a power failure).
• The following sensors are supported by the gateway:

• Onewire device

  DS 18/920

  DS 2438

  DS 2805

• Also, DS 2409 microlan chips are supported

Installation

The distribution below are two jars with the gateway. Additionally you need (in your classpath):

• log4j (I used version 1.2.13).
• 1 Wire SDK for Java
• RXTX (serial API for Java). You have to install the runtime files of RXTX (in short putting rxtxParallel.dll and rxtxSerial.dll in the bin directory of your Java distribution, see the RXTX documentation for more information), and have the jar in your classpath.
• XPL4Java the jar with a programming framework for XPL
• jdring

Furthermore, you need xpl-1wire-gateway.jar, and xpl-sensor-actuator-gateway.jar which you need to start (see xpl-1wire-gateway.cmd for an example).

The gateway can also be used in combination with Gerry Duprey's xpl4java server. Then you need to drop the jars in the jar folder of the xpl java server

There are a number parameters to beconfigured:

• the serial port your onewire interface is connected to (COM1,...)
• the frequency of resetting the min/max values of the measures (hourly, daily, weekly, monthly, yearly)
• a configuration file. The configuration file can be used to set user fiendly names for sensors, and in case sensors need to be polled, the polling frequency (lowest, low, average, high, highest)
• the scaninterval, which is the time period after which the gateway re-reads the configuration file
• lowest, low, average, high, highest: the time (in seconds) after which the gateway polls sensors for new values

At www.gordijn.org/gordijn.xml you find a plug-in for use with XPLHal tools.

Limitations

• This is version 0.2. Meaning: experimental, not stable, using at your own risk, and so on. But you may give it a try

This software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.