.\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH INDISERVER 1 "October 16, 2004" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: .\" .nh disable hyphenation .\" .hy enable hyphenation .\" .ad l left justify .\" .ad b justify to both left and right margins .\" .nf disable filling .\" .fi enable filling .\" .br insert line break .\" .sp insert n+1 empty lines .\" for manpage-specific macros, see man(7) .SH NAME indiserver \- INDI server for telescope control under KStars .SH SYNOPSIS .B indiserver [ \fB\-p\fP \fIport\fP ] [ \fB\-r\fP \fIattempts\fP ] [ \fB\-vv\fP ] \fIdriver\fP [ \fIdriver\fP ... ] .SH DESCRIPTION KStars allows you to configure and control astronomical instruments such as telescopes and focusers via the INDI protocol. \fBindiserver\fP is a server that sits between the KStars user interface and the low-level hardware drivers. .PP The INDI server is a network server, in that either local or remote clients may connect to it to control astronomical instruments. The INDI server must be running on the machine that is physically connected to the astronomical instruments. .PP Note that there is no need for you to run the INDI server directly. Using the KStars device manager, you can set up astronomical instruments and start or stop the INDI server all from within KStars. .PP You may however choose to run the INDI server manually from the command line. In this case you must pass the names of one or more drivers for individual astronomical instruments. The current list of available drivers is: .PP .RS celestrongps (Celestron GPS) .br fliccd (Finger Lakes Instruments CCD) .br lx200_16 (LX200 16") .br lx200autostar (LX200 Autostar) .br lx200classic (LX200 Classic) .br lx200generic (LX200 Generic) .br lx200gps (LX200 GPS) .br temma (Temma Takahashi) .br v4ldriver (Video4Linux Generic) .br v4lphilips (Philips Webcam) .RE .PP Much more detailed information can be found in the KStars Handbook, as described below. .PP KStars is a graphical desktop planetarium for TDE, and forms part of the official TDE edutainment module. .SH OPTIONS .TP \fB\-p\fP \fIport\fP Specify the port to listen on (defaults to 7624). .TP \fB\-r\fP \fIattempts\fP Specify the maximum number of restart attempts for each driver (defaults to 2). .TP \fB\-vv\fP Write more verbose output to stderr. .SH EXAMPLE To start an INDI server running an LX200 GPS driver and listening to connections on port 8000: .PP .RS \fIprompt$\fP indiserver -p 8000 lx200gps .RE .SH SEE ALSO .BR celestrongps (1), .BR fliccd (1), .BR lx200_16 (1), .BR lx200autostar (1), .BR lx200classic (1), .BR lx200generic (1), .BR lx200gps (1), .BR kstars (1), .BR temma (1), .BR v4ldriver (1), .BR v4lphilips (1). .PP The KStars Handbook contains detailed information on how to use INDI for telescope control. You can read this handbook in the TDE Help Centre. Alternatively you can enter the URL \fIhelp:/kstars/indi.html\fP directly into konqueror or you can run `\fIkhelpcenter help:/kstars/indi.html\fP' from the command-line. .PP If the TDE Help Centre is not installed then you can install the package \fItdeedu-doc-html\fP and read this documentation in HTML format from \fI/opt/trinity/share/doc/tde/HTML/en/kstars/indi.html\fP. .SH AUTHOR KStars was written by Jason Harris , Heiko Evermann , Thomas Kabelmann , Pablo de Vicente , Jasem Mutlaq , Carsten Niehaus , Mark Hollomon , Vincent Jagot and Martin Piskernig . .br This manual page was prepared by Ben Burton for the Debian GNU/Linux system (but may be used by others).