Dallas Semiconductor TINI 1.01 OneWire Program Building Tool
9-15-00 KLA

The release of the OneWire API means that until TINI 1.02 is released,
developers must slightly alter their building process to create
programs that access the one-wire.  This is because of extensive
name changes.  The BuildOneWireProgram class allows developers to do
this easily.


***********************************************************************

I. How it works
Your class file must already be compiled for the TINI board.  In order
to make the name change for TINI 1.01, we have created a wrapper layer
between the old iButton API and the new OneWire API.  Since this new
API is not built into the firmware, the wrapper layer must be built into
your applications.  We have assembled to basic, necessary wrapper layer 
and created the file TINI_101_Overlay_OneWireAPI.jar file from it.  We
have also created a dependency list for containers so that the user needs
only specify which container to use, and the program will gather all necessary
optional files.  The database file is called tini_dependencies.txt.  The 
format of the file follows:
	CONTAINER [DEPENDENCY+]
For instance, the line:
	1F ../utils/Bit OneWireSensor SwitchContainer
means that com.dalsemi.onewire.container.OneWireContainer1F requires
com.dalsemi.onewire.utils.Bit, com.dalsemi.onewire.container.OneWireSensor,
and com.dalsemi.onewire.container.SwitchContainer to operate.

***********************************************************************

II. How to use the program

The easiest way to use the program is to unpack the file OneWireAPI.jar in
the working directory and copy the files tini.db (from the TINI 1.01 distribution),
tini_dependencies.txt, and TINI_101_Overlay_OneWireAPI.jar to the working 
directory.  Then you can use the program like this:

	java BuildOneWireProgram demo.class utility.class 10 0C 21

This program would build the files demo.class and utility.class into a file called
application.tini, and would include the containers for the 1920 (10), the 1996 (0C),
and the 1921 (21).  Notice that BuildOneWireProgram calls TINIConvertor, so 
not only must tini.jar (from the TINI1.01 distribution) be in your classpath,
but one of the classes you build should also have a main() function.  To name
your output file something else, use:

	java BuildOneWireProgram -o demo.tini demo.class utility.class 10 0C 21

For other options of BuildOneWireProgram, type:

	java BuildOneWireProgram