Menu ▾ ▴

Tree [20b589] default tip /
 History

Read Only access

File Date Author Commit
 debian 2012-06-07 Joerg Desch Joerg Desch [77e82f] some minor 'build fixes'
 doc 2012-02-22 Joerg Desch Joerg Desch [034650] fixed Makefile for working with subdirectories.
 ezV24 2011-04-21 Joerg Desch Joerg Desch [bef535] start with new directory layout and autotools s...
 samples 2011-04-21 Joerg Desch Joerg Desch [bef535] start with new directory layout and autotools s...
 src 2011-04-21 Joerg Desch Joerg Desch [bef535] start with new directory layout and autotools s...
 .cvsignore 2011-04-12 jdesch jdesch [a11b66] *** empty log message ***
 .hgtags 2011-04-20 convert-repo convert-repo [717912] update tags
 AUTHORS 2002-09-10 jdesch jdesch [8f3099] Release 0.1.0
 BUGS 2002-06-20 jdesch jdesch [e432d9] Initial revision
 COPYING 2002-06-20 jdesch jdesch [e432d9] Initial revision
 COPYRIGHT 2002-06-20 jdesch jdesch [e432d9] Initial revision
 ChangeLog 2013-02-08 Joerg Desch Joerg Desch [20b589] added note to changelog
 HISTORY 2011-04-11 jdesch jdesch [08f192] *** empty log message ***
 Makefile 2013-02-08 Joerg Desch Joerg Desch [aceccf] minor glitch in Makefile running Ubuntu 12.10
 Makefile.cygwin 2006-06-03 jdesch jdesch [478e4f] Release 0.1.2: news functions and minor fixes
 README 2003-10-13 jdesch jdesch [27f9d9] minor build-problems and typos fixed
 libezV24.spec 2011-04-11 jdesch jdesch [08f192] *** empty log message ***

Read Me

                                                      -*- indented-text -*-
Project:    ezV24-Library
File:       libezv24/README
Time-stamp: <03/05/13 09:04:05 jd>
----------------------------------------------------------------------------

The goal of the `ezV24' library is to provide an easy to use interface to the
serial ports of an linux/unix system. At the current stage, it comes with
rudimentary support for the CYGWIN toolchain (see
http://www.cygwin.com/). Due to the great work of the cygwin folks, only
minimal changes are needed. I know that that the cygwin-stuff isn't the final
stuff, but it's a first step and it works.


HOME ON THE NET
---------------

The project it hosted at sourceforge. You can find the latest release of the
`ezV24' library at http://ezv24.sourceforge.net/. If you have some
questions, feel free to write me an email <jdesch@users.sourceforge.net>. To
ease the mail handling, please put a [ezV24] into the subject line of the
mail.


INSTALLATION
------------

To install the libary, just unpack the archive (you may have done this ;) and
execute the following steps:

(1) compile the library by typing `make'. The result should be a executable
    shared library named `libezV24.so.*' and the sample `test-v24'.

    $ make

    To see what `test-v24' do, you must have a look into the source code.


(2) become root and install the library and the header files. This call will
    update you ldd-cache too! Note that this doen's install the html
    documentation! I'm not shure where to install it, so you can put it into 
    your prefered directory.

    > su
    > make install
    > exit

    Some systems don't use /usr/local/lib as possible path for libraries. In
    this case, you should add /usr/local/lib to /etc/ld.so.conf before
    calling `make install'!



UPDATE
------

Previous releases of `ezV24' have installed the unnecessary header
ezV24_conf.h. If you update to V0.1.0, you should either call the old
Makefile with `make uninstall' or remove the file manually.


USAGE
-----

To use the libary for your own applications, you have to include the main
header:

	#include <ezV24/ezV24.h>

To link the shared library to your application, you just have to specify the
basename of the library with `-lezV24'. The whole call could look like this:

	gcc -o foo foo.c -lezV24

For more information, just have a look into the html documentation.


PACKAGING
---------

At the time being, ezV24 supports the debian package format .deb and the Red
Hat format RPM. Both package type are `unofficial'. This means, these
packages are not build by official members of the corresponding
organizations.

The spec file for RPM's is made by Pascal Bleser <guru@unixtech.be>! 
Thanx. Binary build for SuSE-Linux could be found at
http://guru.unixtech.be/rpm/packages/Development/libezV24/.  Note that I
neither build RPM's nor test the RPM build process. If you have any questions
about RPM's, please contact Pascal Bleser.


-- 
Joerg Desch
-----------------------------------------------------------[end of file]----
MongoDB Logo MongoDB