README FIRST
============

STABLE RELEASE:
This software is used with no problems by some users!

MY PLAN AFTER STABLE VERSION:
I'll release a new version with daemon patch that Christophe Lucas
sent to me. It allows to run in daemon mode sn9c102-webcam-lk.

DOWNLOAD
This software is under development so you could found new good releases
in my little home-page:
http://www.lookee.it/index.php?p=5

FRESHMEAT PAGE (Thanks to the owner imipak)
http://freshmeat.net/projects/sn9c102fg
you could subscribe to project if you wish to know when new releases are
relased.

I WISH TO THANKS:
- Christophe Lucas for his help and his patches
- Luca Risolia for his drivers and for the link to my software
- Marco Comparato for his support to fix the memory leak bug on device.c
- Igor Lopes Guerreiro for his bugreport and suggestions
- Nathan Hurst for his patch to make bmp2jpg.c (gcc 3.4 compliant)
- Gabry for his helps to debug
- Ian McGhie, lvaro Lpez for their interesting bugreports
- SDLCam Project [http://sdlcam.raphnet.net] 
  for its GNU/GPL v.2 code (capture.c dump_thomas.c)

THIS PROGRAM IS BASED ON:
sn9c102-tools  from http://go.lamarinapunto.com
sn9c102-webcam form http://odie.mcom.fr/~clucas/articles/sn9c102.html
ftplib         from http://nbpfaus.net/~pfau/ftplib

and it requires:
- SDL library (http://www.libsdl.org)
- libjpeg (http://freshmeat.net/projects/libjpeg)
- linux kernel > version 2.6.10 (for sn0c10x driver)
- snc9c10x driver installed (or other?)

GET AND LOAD THE SN9C10X DRIVER:
more information about sn9c10x driver available on:
http://www.linux-projects.org/modules/news
available only for linux kernel >= 2.6.10

Other interesting guide to use this software (thanks to Patrick Zima):
http://www.weasner.com/etx/astrophotography/2005/lpi-linux.htm

HOW TO COMPILE:
enter in sn9c102-webcam-lk dir:
$ make

HOW TO RUN:
load the sn9c10x module in your kernel!
enter in sn9c102-webcam-lk dir (you need writing access):
$ ./webcam

FIRST USE:
run this software without touch configuration file!
if it works well as webcam player you can customize the webcam.conf file.

UNDERSTANDING THE CONFIGURATION FILE
file webcam.conf contains parameters for grabbing and ftp uploading. 

don't touch these parameters (if you don't know what you're doing):
xres,yres (x,y resolution of images grabbed)

dev -> /dev/video0 or other webcam device

insert 'y' in the enable_ftp key if you wish activate the ftp_upload
funcion.

insert 'y' in the enable_ftp_monitor if you wish show an image when
images are uploaded by ftp

the following: user, password, host: I hope are self explanatory :-) 

ftp_rate: choose your auto ftp upload delay (10 means about 15 sec)
you could see the right ftp rate time in sec by interface after first 2 upload

remote_file: is the name (with full path) for the remote file after upload!

TIPS:
for slow connection: the program uploads a file called as remote_file but
with .tmp in tail of the name. after the full upload, by an ftp command,
the program rename the .tmp tailed filename in the real remote file name.

for eg.
remote_file name is: /webcam/luke.jpg

programs uploads and overwrite by ftp: /webcam/luke.jpg.tmp
and after the upload it quickly renames:
/webcam/luke.jpg.tmp in /webcam/luke.jpg

you can ignore this procedure :-) but don't put important information
on file called as remote_file followed by .tmp :-)

HELP
Please send me your comment, greets, patches and bugfixes!
I hope to reply to all!

REQUEST
If you have interesting grabs taked with this software, I'll be happy to use them as demo
images! (with credits off course!)


have fun!

--
lookee
luca at lookee.it
http://www.lookee.it
http://siracusa.linux.it
GnuPG/PGP Key: #7643F9AF @ pgp.mit.edu
