"Fossies" - the Fresh Open Source Software Archive

Member "astrocam-2.7.6/INSTALL" (26 May 2009, 5165 Bytes) of package /linux/www/old/astrocam-2.7.6.tgz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 	HOW TO INSTALL AND CONFIGURE THE ASTROCAM SYSTEM
    2 	================================================
    3 
    4 	Written by Steffen Wendzel
    5 	(C) 2001-2009 Steffen Wendzel <steffen (at) ploetner-it (dot) de>
    6 	
    7 	project website: http://www.wendzel.de/?sub=softw&ssub=acam
    8 	authors website: http://www.wendzel.de/?sub=steffen
    9 	astrocam forum: http://sourceforge.net/forum/?group_id=85523
   10 
   11 1.0 Requirements
   12 ================
   13 
   14 HINT:
   15 There are two options: You can either use the PHP based webinterface or the
   16 other one written in Perl. Both look equal and provide equal functionality.
   17 
   18 Okay, here is what you need:
   19 
   20 - An OS (Linux 2.x (tested 2.2.x, 2.4.x and 2.6.x), FreeBSD, OpenBSD or NetBSD)
   21 - An Webserver (e.g. apache)
   22 - Server Side Scripting Environment:
   23 	* Either: PHP version 4.3.0 or newer since older versions don't support
   24 	  the needed ipc features. I recommend PHP 5.x.
   25 	* Or: CGI support for perl
   26 - A SMC-800 stepmotor control card (smc-1500 could work too, but  was not
   27   tested!)
   28 - webcam + software that uploads current pictures into the astrocam directory of
   29   your webserver
   30 
   31 2.0 Installation
   32 ================
   33 
   34 -- software installation --
   35 
   36 2.1. Run Make:
   37 
   38      # make
   39 
   40 2.2. Run install.sh:
   41      This script copies the astrocam files to your webservers directory and
   42      asks you a few questions to pre-configure it.
   43 
   44      # ./install.sh
   45 
   46 -- hardware installation --
   47 
   48 2.3. Place your webcam on the stepengine (this could be a little bit tricky)
   49 
   50 2.4. Connect the stepengine with the SMC card. And connect the SMC card
   51      with your computers parallel port.
   52 
   53 2.5. Connect your power supply to the SMC-card and turn it on (it does not
   54      need to provide more than 10[V] or so ...)
   55 
   56 2.6. Start your webcam software and let the software place a picture file
   57      on the location specified in the "picfile" configuration (see 3.0).
   58      Note: You should configure the software to automaticly place this
   59      picture under the same name every 30 seconds or so. Other good values
   60      are 2, 3, 4, 5, 10, 15, 30 and poor 60 seconds, what depends on the
   61      effort of your webcam and webcam software.
   62 
   63 3.0 Configuration
   64 =================
   65 
   66 - File: /etc/astrocam.conf
   67   Syntax: <Variable-Name> <Tab> <Value>
   68   
   69   Variable	Info
   70   ------------------------------------------------------------
   71   version       The astrocam version.
   72   ioport        The address of the parallel port connected to the SMC
   73                 stepengine card in decimal (0x378 = 888 in decimal).
   74   maxdreh	Maximal position of the stepengine (so the
   75                 cable cant wind up AND you can hide areas).
   76   mindreh       Minimal position of the stepengine.
   77   maxvdreh	Maximal _vertical_ position of the stepengine
   78 	        (don't care about this if only have ONE engine).
   79   minvdreh	Minimal vertical cam position.
   80   picfile	URL of the webcam image (examples:
   81                    'http://blah.com/myfile.gif'
   82 		   '/astrocam/myfile.jpg'
   83 		   'webcam.jpg').
   84   refreshtime	The time in seconds to wait before image/site reload.
   85   contenturl	The location were the webinterface can find the web files
   86   		(like design.css).
   87   design        The webinterface-design ('design' (default) or 'darkness').
   88   ipckey        The IPC key for the daemon and the webinterface.
   89   negation	If you click "left" on the webinterface and
   90   		your stepengine moves to the wrong direction,
   91   		you can use the "negative movement" to negate
   92   		all movements via the astrocam software.
   93 		possible values: 'on' or 'off' (default).
   94   imagesize-x/y	The size of the image displayed in the webinterface
   95   		in pixels for width (-x) and height(-y).
   96 
   97 4.0 Run and Test it
   98 ===================
   99 
  100 - Start the daemon process as user 'root':
  101 
  102   # /usr/sbin/astrocam
  103        version: 2.7.6
  104         iobase: 888
  105        maxdreh: 50
  106        mindreh: -50
  107       maxvdreh: 35
  108       minvdreh: -35
  109        picfile: http://127.0.0.1/some-url/some-pic.jpg
  110    refreshtime: 3
  111     contenturl: http://127.0.0.1/apache2-default/astrocam/
  112         design: design
  113         ipckey: 10245
  114       negation: off
  115    imagesize-x: 640
  116    imagesize-y: 480
  117 
  118    using IO address 0x378...
  119 
  120    storing astrocam process-id in /var/log/acam_pid! [4247]
  121    AstroCam Daemon 2.7.6p0  [ Written and Copyright 2001-2009 by
  122    Steffen Wendzel steffen (at) ploetner-it (dot) de ] running...
  123 
  124 - Start your external Hardware by acivating the connected power supply.
  125 
  126 - Now you have two choices:
  127 
  128 	1. Either you simply run the console test program acam_console.pl
  129 	   that will move your step engine to the left direction and back.
  130 	   If acam_console.pl prints errors, you should read the official
  131 	   astrocam FAQ on http://www.wendzel.de/?sub=softw&ssub=acam
  132 
  133 	2. Or you use one of the webinterfaces (astrocam.php or astrocam.pl):
  134 
  135 		- start the webcam software (see section 2.6 for details)
  136 
  137 		- test it with your browser. Good luck!
  138 
  139 5.0 Notes
  140 =========
  141 
  142 If an error occurs: check the error logfile of your webserver and the errors
  143 printed by astrocam.php. If you just can't find it, post a question in the
  144 astrocam forum: http://sourceforge.net/forum/?group_id=85523
  145 
  146 Please also read the astrocam FAQ first which you can find here:
  147 	http://www.wendzel.de/?sub=softw&ssub=acam
  148