DDL - Digital Direct for Linux

This Software is for direct driving your model railroad. You don't need
central units or interfaces from your model railroad manufacturer. The
only thing you need is a booster and a special cable to connect the booster
to your pc. The softare supports all protocols of the Maerklin digital system
and mostly of the NMRA-DCC stuff.

There is no warranty the software works correct. You use this
software on your own risk.

This software underlies the GNU public license.

Requirements:

        For a full installation you need a java development kit.
        Recommended are the jdk's from ibm or blackdown.org.
        If you want to compile the package on your system the presence
        of lex and yacc or flex and bison is required. It is usefull
        to have an installation of the GNU readline library, but
        the programs will still work without.

Quick installation:

        To compile the whole DDL sources you need a working java 
        installation on your system. Check if the following programs
        are reachable in your execution path: javac, javah, jar.
        If not, expand your environment variable PATH.

        % gunzip ddl.tgz
        % tar -xvf ddl.tar
	% cd DDL
        % ./configure
        % make
        % su
        Password:
        % make install

        Now you will find a binary installation of DDL in
        directory /opt/DDL

Complete installation guide:

        Please read the file INSTALL.

Starting up:

        Define the following variables in file .bashrc of your
        home directory. 

        export JAVAHOME=<top level directory of your java installation>
        export JAVAVM=<your java virtual machine>
        export DDLHOME=/opt/DDL

        e.g.:

        export JAVAHOME=/usr/bin/java
        export JAVAVM=java
        export DDLHOME=/opt/DDL

        To make changes affect you must start a 
        new session (e.g. open a new terminal window).

        * runnning the daemon:
          $ cd /opt/DDL/bin; ./ddld

            Note: ddld is a wrapper for erddcd. 

        * running a client:
          $ cd /opt/DDL/bin; j-man

Thats it. 

For more information (in german only) look at the website of DDL: 
http://www.vogt-it.com/OpenSource/DDL 

december 2001, Torsten Vogt
