Camwire installation notes
==========================


Requirements

Camwire needs:

  * Linux kernel 2.4.22 or later.

  * libdc1394 version 1.0 or later, but not version 2.0.

  * Whatever other libraries libdc1394 needs in turn (libraw1394,
    raw1394, ieee1394, video1394, and ohci1394).  See their
    documentation on http://www.linux1394.org/.

The cammonitor example also needs:

  * SDL (http://www.libsdl.org/index.php).

  * Xv (http://www.xfree86.org/4.2.1/Xv.3.html)

  * Netpbm (http://sourceforge.net/projects/netpbm)

You may use the UNIX `locate' tool to check if and where these libraries
are installed on your system.


Download

You can download the latest Camwire release from
http://kauri.auck.irl.cri.nz/~johanns/camwire/distribution/

There should be two archives for each release a camwire-x.x.x-src.tar.gz
and a camwire-x.x.x-util.tar.gz.  You only need the source archive
camwire-x.x.x-src.tar.gz to build the Camwire library.  The utilities
archive contains tools and example programs.


Compile

Camwire does not (yet) have the usual autotools/configure build.  The
provided Makefiles are examples for use at your own risk.

With luck, the following might work:

  * Copy the camwire-x.x.x.-src.tar.gz file to a temporary build directory.

  * tar -zxvf camwire-x.x.x-src.tar.gz

  * cd camwire-x.x.x

  * Edit Makefile.custom, change the DC1394DIR variable to where
    your installation of libdc1394 resides, and change the INSTALLDIR
    variable to the directory where you want to install Camwire.

  * make lib

  * If you would like to build the utilities as well, repeat the above
    with camwire-x.x.x.-util.tar.gz.


Install

  * If you have not already done so, edit Makefile.custom and change the
    INSTALLDIR variable directory to the directory where you want to
    install Camwire.

  * make install
    It also install the utilities if you built them.

  * [Optional] make clean


Uninstall

  * make uninstall


Troubleshooting

Bear in mind that Camwire is development code.  Any bug reports are much
appreciated.  Having said that, it has worked very nicely for us for
some years now.

  * Camwire won't compile without SDL/Xv/Netpbm: The Makefiles in the
    various subdirectories can be run on their own.  Only the cammonitor
    example needs SDL, Xv and Netpbm.  You can avoid having to compile
    it by changing into the src subdirectory and run `make lib' from
    there to compile and archive only libcamwire_1394.  Same for util/
    and etc/.  Or you could edit util/Makefile and comment out the
    cammonitor target.  Or you could get the missing libraries.

  * make install causes "cannot create regular file" errors: My simple
    makefiles do not create directories.  You will have to manually
    mkdir the necessary bin, include/camwire, lib/camwire, and
    etc/camwire directories off the INSTALLDIR.

  * "Permission denied" error messages while installing: You don't have
    sufficient privilege to create files in the installation directory.
    Try being root if you can, or install it somewhere where you have
    write permission.  Remember to update your LD_LIBRARY_PATH
    environment variable if it's in a non-standard place.  See man ld
    for more.

  * Camwire can't find a configuration file when I first run it:
    Carefully read and follow the instructions on the screen.  There are
    configuration files for some of my cameras in the etc/camwire
    directory.  Feel free to add your own, and send it to me for
    inclusion in the release.

  * Auto-generated configuration suggests a strange mode: Camwire
    searches for the highest-numbered mode.  This works well for most
    people, but in some cases you may want to select another mode or
    format from you camera's user's manual and edit that into the
    configuration file instead.

  * Camwire error messages while everything appears to be normal
    otherwise: You caught me debugging.  Some of the C source files use
    a preprocessor macro called CAMWIRE_DEBUG which causes printing of
    run-time diagnostics.  If you prefer (almost) silent operation then
    remove the -D CAMWIRE_DEBUG option in Makefile.common (and
    re-compile).

Johann Schoonees
Industrial Research Limited, PO Box 2225, Auckland, New Zealand

$Id: INSTALL,v 8.3 2009/07/08 06:44:28 johanns Exp $