series8217 / linuxaldl Goto Github PK

 Limitation of Liability.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

LICENSING INFORMATION:
 This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.


INTRODUCTION
------------
Thank you for downloading linuxaldl from:
http://www.steventsnyder.com/linuxaldl.html

The goal of this project is to develop software that provides
access to the GM ALDL interface over a serial connection from
Unix-based operating systems.

Currently linuxaldl is a GUI application with a basic command line
interface. The command line interface will be improved in a later 
version. For now, all features are supported in the GUI.


HOW TO USE
----------


Compiling linuxaldl
-------------------

You will need the popt and gtk+-2.0 libraries, as well as gcc for compiling
and linking. A makefile is included.

Unzip the contents of of the linuxaldl tar file to any location. Go to
the /src subdirectory from a terminal window, and run make. If all goes well,
the executable will be created with the name "linuxaldl". You can put
this executable wherever you want. There are no additional files required and
linuxaldl does not use temporarily files. 


GUI Operation
-------------
 
To open the linuxaldl GUI use the command:
	linuxaldl -serial=/dev/ttyUSB0
where /dev/ttyUSB0 is the address to your ALDL interface.

If you want to use a launcher shortcut to open the GUI interface, choose
"application in terminal" as the type. Important diagnostic information is
printed to the terminal in the current version. A future version will make this
all part of the GUI.



Command Line Operation
----------------------
Not yet implemented


(c) copyright 2008, Steven Snyder, All Rights Reserved