The Java X10 Project

Version 1.3

TJX10P-13

Copyright

All files contianed within this package are the copyright of Wade Wassenberg with the exception of the LICENSE.txt file which is copyrighted by GNU.  All files within this package are subject to the GNU.

License

By using this package you agree to the terms specified by the GNU PUBLIC LICENSE (GPL).  This package is distributed under the GPL without warranty.

Change Log

This release has been elevated to version 1.3.  This release includes a synchronization enhancement that should help eliminate the CM11ASerialController from getting into a race condition with the actual CM11A hardware module. This release also includes a change that should eliminate the possibility of losing commands due to the CM11A arbitrarily deciding to split commands across multiple messages.

Download

To download this package, please visit http://www.agaveblue.org or follow this link:

Download Binaries Now

Or choose from the following list:

Version Binary Package Source Package
Version 1.3 Download Now Download Now
Version 1.2 Available By Request Only Available By Request Only
Version 1.1 Available By Request Only Available By Request Only
Version 1.0 Available By Request Only Available By Request Only
Beta 0.4 Available By Request Only Source not released
Alpha 0.3 Available By Request Only Source not released
Pre-Alpha 0.2 Available By Request Only Source not released
Pre-Alpha 0.1 Available By Request Only Source not released

Installation

This package requires the use of the Java Communications package (COMM).  You can obtain a copy of this package from Sun's website:

http://java.sun.com/products/javacomm/

Download the Java Communications package and follow the instructions for installation.  Make a copy of the comm.jar file from the Java Communications package in the lib directory of this distribution (This is only necessary to get the examples to work without modification).

For linux users, I've put together a Java Comm How-To.

Examples

Directory Explanation
/examples/light/ Example of a dimmable light controller.
/examples/appliance/ Example of an On/Off appliance controller.
/examples/master/ Example of a master controller.
/examples/server/ Network X10 server.


Each of the examples come with shell scripts to run them.  These shell scripts assume that the Comm API has already been installed and is on the classpath.  The other assumption made by these scripts is that the Java interpreter (java) is on the executable path.  There are shell scripts for both Linux (these may work on Unix, but haven't been tested) and Windows.

The light, appliance, and master examples all require that the server example is already running. 

Contact Information

The official website of The Java X10 Project is http://www.agaveblue.org.  Bug reports, questions, or comments may be mailed to x10@wass.homelinux.net.

Project Plan

To see the current project plan, and to learn about what is to come in this project, see the project plan.

Additional Information

There will be additional packages and functionalities added in future releases. 


Copyright 2000-2008 Wade Wassenberg.
On the web: http://www.agaveblue.org.
Send bug reports to x10@wass.homelinux.net.

Last Modified: January 8, 2008