readme


/*
	$Id: README,v 2.11 1999/03/22 05:59:31 lightner Exp $
*/

/*
	Copyright (c) 1997,1998 Eugene G. Crosser
	Copyright (c) 1998 Bruce D. Lightner (DOS/Windows support)

	You may distribute and/or use for any purpose modified or unmodified
	copies of this software if you preserve the copyright notice above.

	THIS SOFTWARE IS PROVIDED AS IS AND COME WITH NO WARRANTY OF ANY
	KIND, EITHER EXPRESSED OR IMPLIED.  IN NO EVENT WILL THE
	COPYRIGHT HOLDER BE LIABLE FOR ANY DAMAGES RESULTING FROM THE
	USE OF THIS SOFTWARE.
*/

/*
	$Log: README,v $
	Revision 2.11  1999/03/22 05:59:31  lightner
	Fix docs: Windows binaries go to win32/

	Revision 2.10  1999/03/21 20:21:04  crosser
	mention configure

	Revision 2.9  1999/01/17 09:51:16  crosser
	change Bruce's address

	Revision 2.8  1998/10/18 13:18:27  crosser
	Put RCS logs and I.D. into the source

	Revision 2.7  1998/07/21 22:56:52  crosser
	fix CP 900
	
	Revision 2.6  1998/06/07 13:55:20  crosser
	compatibilities and credits
	
	Revision 2.5  1998/05/09 18:22:42  crosser
	say that devices with modem control are allowable,
	minor fixes
	
	Revision 2.4  1998/03/01 18:57:04  crosser
	more credits
	
	Revision 2.3  1998/02/06 09:04:59  crosser
	mention DOS version
	
	Revision 2.2  1998/01/18 02:22:28  crosser
	change copyright
	
	Revision 2.1  1998/01/05 22:02:14  crosser
	add reference to Bruce's site
	
	Revision 2.0  1998/01/02 19:20:11  crosser
	Added support for Win32
	
	Revision 1.4  1997/12/24 00:30:14  crosser
	add vendors, add url, add credits.
	
	Revision 1.3  1997/11/15 19:29:47  crosser
	update for release 1.7
	
	Revision 1.2  1997/11/12 09:50:27  crosser
	mention photopc600, minor changes
	
	Revision 1.1  1997/08/17 09:06:54  crosser
	Initial revision
	
*/

This is a library and a command-line frontend to manipulate digital
still cameras based on Fujitsu chipset and Sierra Imaging firmware.  The
program is known to work with Agfa, Epson, Olympus, Sanyo and Nikon (at
least CoolPix 900, but not CoolPix 600!) cameras.

The cameras typically come with software for Windows and for Mac, and no
description of the protocol.  With this tool, they are managable from a
UNIX box.  Bruce D. Lightner <lightner@lightner.net> has added support
for Win32 and DOS platforms.  Note that the program does not have any
GUI, it is plain command-line even on Windows.

I tried it under Linux/x86, FreeBSD and Solaris/SPARC, and it should be
straightforward for other UNIX systems.

Generally, UNIX system requirements are:
- ANSI C compiler
- select() system call
- POSIX termios
- presence of a 16bit integer type
- serial port (with or without `modem control').

On UNIX, first run "./configure".  Then, typing `make' will result in
building the library and executables in the current directory.
`make install' will install the executables and manual pages.
`make install.lib' will install the library and the .h file.

To build on DOS, run `make -f makefile.dos', on Windows run
`nmake -f makefile.win'; binaries will be placed in `msdos' and `win32'
subdirectories respectively.

The executable parameters are rather clear (hopefully).  Running
`photopc -h | more' will print the list of options and commands.  If you
are going to use the library for your own application and need the docs,
tell me and I will write them.

Included file `protocol.htm' contains description of the protocol used
by the camera.

`usage.htm' is a "casual" user's guide, full description is in the man
pages.

If you run the program on a DOS box, you may want a JPEG viewer; I've
been told that a good free viewer `LXPIC' can be found at
http://home.t-online.de/home/stefan.peichl.

Many commands may not be implemented, esp. those specific for newer
models.  If you know how to do things that the program currently cannot
do, please let me know.

I can be contacted at <crosser@average.org>, fresh version of this tool
(if any) is at ftp://ftp.average.org/pub/photopc/, related information
is at http://www.average.org/digicam/.  The same code accompanied by
Win32 and DOS executables and archived in .zip format can be found at
http://www.lightner.net/lightner/bruce/photopc/

Thanks to Jeff Tranter for contributing the man page and a few bugfixes,
Bruce Lightner for Windows and DOS support, Thierry Bousch for many
details of the protocol and advice, and other people who helped me to
track down problems and learn more about the protocol.

Trademarks are properties of their respective respected owners.

Back