--------------------------------------------------
########## readme.txt, v0.9 rev. 310308 ##########
--------------------------------------------------

Temma-tools : 

Perl/Tk multiplateforms scripts for Temma mounts remote control.
works on all Temma mounts versions after 2000's productions.
Linux, Windows and MacOSX +X11 compatible.

Main script for Temma remote controle (driver GUI) : temma.pl

- Other scripts :

eos.pl : Remote control for the shutter of Canon EOS DSRL (serial port or parallel port) Linux and Windows compatible.
For Windows this script needs Win32-API and Win32::SerialPort modules, see below for modules install.

autoguide.pl :
Autoguiding script via parallel port and autoguiding port, Linux only (with QAstrocam) compatible.
This script use "Device-ParallelPort" and "Device-ParallelPort-drv-parport" modules.
These modules are already installed inside temma-tools/libs directory and should work (ok with Debian system).
In case of module problem you have to install them with the Perl way (try as is before).
Download the modules from here :
http://www.cpan.org/authors/id/S/SC/SCOTT/Device-ParallelPort-1.00.tar.gz
http://www.cpan.org/authors/id/S/SC/SCOTT/Device-ParallelPort-drv-parport-1.0.tar.gz
See readme file for install instructions.

peview.pl :
Draw tracking tracking curves from temma.pl or autoguide.pl data. This script is Linux and Windows compatible.



driver home page :
http://www.optique-unterlinden.net/temma2/driver_pl/htm/temmadriver_en.htm

contact :
remi.petitdemange@wanadoo.fr



As follow in this file : help for install on Linux and Windows systems (Below) :

[Note 1] The driver works with Lin4Astro (dev version) and Astrolix live CD.

[Note 2] All scripts need Perl and Perl/Tk module.

[Note 3] The following steps should help MacOSX (with X11) users,
	specific details to this OS will be describe in a next futur


#########################################################################
#	install under Linux (RedHat, Mandrake, Suse and Debian)		#
#########################################################################


1) You need Perl 5.8x (still install on most Linux distrib)

Check the following command to control Perl version on your system :
	
	% perl -v
	or for verbose test
	% perl -V


2) Check with the following command to control if the Tk modules is present on your system :

	% perl -e 'use Tk'

Tk is present and ready if no message or no error message returned.
Probably not present for now,
Some Mandrake or Debian distribs include Tk package (rpm or deb for Tk-800.024 version or later)
if your are with Mandrake or Debian, install if from CD or from net repository.
else go on 3 for Perl way install.


3) Download (www.perl.com/CPAN) , unzip and install the Tk module :

	% tar zxvf Tk-800.025.tar.gz (user session)
	% cd ~/Tk-800.025
	% perl Makefile.PL
	% make
	# make install (use root at this step)

and check if Tk-800.025 is now present in your  system :

	% perl -e 'use Tk'

Tk is installed and ready if no message or no error message returned.

NOTE :	The Tk module can be directly installed from the net with the following root command line :

	# perl -MCPAN -e 'install "Tk"'


4) open the downloaded driver archive file (tarball) :

	% tar zxvf temma-tools.tar.gz

and put all the files in a same directory :
for example : /home/user/temma-tools/

Concerning the driver, you will need all the include files in driver archive,
see files_list.txt for complete list of necessery files.
temma.pl is the main script and you will execute it later.


5) note the serial port use for Temma RS-232 connector.
examples :
/dev/ttyS0 if you use first true serial port (equiv to COM1 under DOS/Windows systems).
/dev/ttyS1 if you use second true serial port (equiv to COM2 under DOS/Windows systems).
/dev/ttyUSB0 if you use USB2Serial cable for making serial port (equiv to COM1 under DOS/Windows systems).
/dev/cu.USA19H191P1.1 for MacOSX with USB2serial cable


6) check if rw permission is ok for user on your serial port.
   if not ok, set correct rights (rw) on the serial port for the user (from root terminal session).
	examples :
	
	# chmod 666 /dev/ttyS0
	or
	# chmod 666 /dev/ttyUSB0


7) run now the following commands in a user terminal :
- go in the directory of the driver, for example :

	% cd ~/temma-tools

- run the starting command :

	% perl temma.pl
	or (for scripts with x rights, do chmod +x *.pl)
	% ./temma.pl

and follow the first starting instructions in the driver.


8) for the first exec :
	choose the connected serial port on your computer : ttyS0 or ttyS1 or ttyUSB0 etc...
	and clic on "Set port config" button.
	the script will write the "~./temma-tools/config/temmaRS232.cfg" config file concerning the serial port used with the mount.
	Openning a Temma session will be possible only at this step.


9) for the first exec too :
	enter carefully the following informations in Site config window :
	- Name of site (10 chars max)
	- Latitude of your site : +/-DD:MM:SS
	- Longitude of your site : +/-DD:MM:SS (East of Greenwich negativ)
	and clic on the buttons "creat site1"
	the script will write the "~./temma-tools/config/site1.txt" file.
	It concern the site1 parameters.
	It is now possible to create 6 sites files.
	check if UT is ok (adjust it from the Site window if necessery, this does not affect your system time).

	enter now carefully your scope and CCD parameters,
	and clic on the buttons "apply" and "save".
	the script will write the "~./temma-tools/config/user_scope.txt" file.
	
	if you use QAstrocam and webcam for autoguiding :
	enter now carefully your guiding scope and webcam parameters,
	and clic on the buttons "apply" and "save".
	the script will write the "~./temma-tools/config/user_scope2.txt" file.

	if you use XEphem :
	set the path of XEphem fifos to setup the link between the driver and the Skyview
	
that's all, you are now ready to start your goto operations.




####################################################################
# 		install under Windows 98/2000/XP 		   #
####################################################################


Windows step by step install with screen copies here (in french language) :
http://www.optique-unterlinden.net/temma2/driver_pl/htm/doc-win/install-win.htm

1) - Get the following package from : http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl
	
	a) for Windows 95/98SE only : get and install MSI (Microsoft installer for the Perl package)
	MSI is still present with Windows Millenium, 2000 and XP.
	
	b) for all Windows versions : get and install Perl 5.8 MSI version
	(actual version : ActivePerl-5.8.4.811-MSWin32-x86.msi)
	this package normaly include Tk module.
	use this windows command (or from DOS window) to check if module is present (% is command prompt) :
	
	% perl -e "use Tk"
	
	install is ok if no message and no error message

   - Get the Win32-API module from :
	http://www.optique-unterlinden.net/temma2/driver_pl/Win32-API-0.41.zip
	or from
	http://ppm.activestate.com/PPMPackages/zips/

	(Win32-API-0.41 will be installed later from hard disk dezziped copy)

   - Get the SerialPort0.19 module from :
	http://www.optique-unterlinden.net/temma2/driver_pl/SerialPort-0_19.zip
	or from
	http://ppm.activestate.com/PPMPackages/zips/

	(SerialPort0_19.zip will be installed later from hard disk dezziped copy)


2) Install Perl MSI package (with Perl set option in your path).


3) - Unzip Win32-API-0.41.zip file.
   - From directory of Win32-API-0.41 module :
	% cd \...\Win32-API-0.41 (key press enter)

   - Make the install with Perl Package Manager (ppm), a windows command (or DOS) program :
	% ppm install Win32-API.ppd (key press enter)

   - check if Win32-API is now present in your  system :
	% perl -e "use Win32::API" (key press enter)
   install is ok if no message and no error message

   [note]  install of this module is also possible from an open internet connexion


4) - Unzip SerialPort0_19.zip file.
   - From directory of SerialPort-0.19 module (internet connexion is not need here) :

	% cd \...\SerialPort-0.19 (key press enter)
	% perl Makefile.PL	(key press enter)
	% perl install.pl	(key press enter)
	
   - check if SerialPort-0.19 is now present in your  system :
	% perl -e "use Win32::SerialPort"
   install is ok if no message and no error message
	

5) unzip temma-tools.zip and let all the files in a same directory :
	for example in : c:\..\temma-tools

Concerning the driver, you will need all the include files in driver zip archive,
see files_list.txt for details about files list.
temma.pl is the main script you will exec it later.


6)  - from files explorer go in the directory of driver (or from windows command % cd \..\temma-tools).
    - double click on temma.pl file
    (or from windows command : % perl temma.pl).
    and follow the first starting instructions in the driver.

7) for the first exec :
	choose the connected serial port on your computer : COM1 or COM2 etc...
	and clic on "Set port config" button.
	The script will write the "temma-tools/config/temmaRS232.cfg" config file.
	It concern the serial port used with the mount.


8) for the first exec too :
	enter carefully the following informations in Site window :
	- Name of site (optionnal)
	- Latitude of your site : +/-DD:MM:SS
	- Longitude of your site : +/-DD:MM:SS
	and clic on the buttons "creat site1"
	the script will write the "~./temma-tools/config/site1.txt" file.
	It concern the site1 parameters.
	It is now possible to create 6 sites files.
	check if UT is ok (adjust it from the Site window if necessery, this does not affect your system time).

	enter now carefully your scope and CCD parameters,
	and clic on the buttons apply and save.
	the script will write the "temma-tools/config/user_scope.txt" file.

that's all, you are now ready to start your goto operations.




#########################
#	Notes :		#
#########################

- Actual laptops come without builting serial port.
The driver needs a connected USB2Serial cable to configure a serial port for the Temma.
Only COM1 to COM9 are working with the serial port module.

- In case of problem with serial port connexion, delete the "temmaRS232.cfg" config file and
redo serial config with correct port name.

- Connexion with Temma system is possible only if the mount power source switch is ON.
- Many driver windows and functions will work only when Temma connection will run.

- The use in South hemisphere location should work but need some test under real conditions.

- Mosaic of images function need some improvements for better accuraccy.

- Other softwares Temma compatibles still exist for GNU/Linux, MacOSX and Windows plateformes :
	Audela-1.3.0 for GNU/Linux and Windows.
	INDI Temma driver for GNU/Linux (for SkyChart, XEphem, KStars ...).
	ASCOM Temma driver for Windows (for Carte du Ciel, TheSky, GuideDog ...).



| --------------------------------------------------------------------------------------------- |
|	Thanks to Franck Sicard for his time for making the link with QAstrocam possible.	|
|	Thanks to François Meyer for his help concerning the autoguiding algorithm.		|
| --------------------------------------------------------------------------------------------- |



#################################################################################################
#	WARNING :										#
#	Use this driver to your own risk and responsability.					#
#	I can't be responsible of any damage cause on your system or on your instrument.	#
#################################################################################################