# Teleskopkontrolle mit INDI

KStars bietet eine Schnittstelle, die anbietet, astronomische Instrumente einzurichten und zu kontrollieren mittels des INDI-Protokolls.

Das INDI-Protokoll unterstützt ein weites Feld von astronomischen Instrumenten, wie CCD-Kamaras und Fokussierern. Zur Zeit unterstützt KStars die folgenden Geräte:

## Unterstützte Teleskope

Teleskope | Gerätetreiber | Version
--- | --- | ---
LX200 8"-12" Classic | LX200 Classic | 0.5
LX-90, LX50, ETX90 | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.2
LX200 Classic 16" | LX00 16" | 0.2
Celestron GPS | Celestron GPS | 0.2
Celestron NexStar | Celestron GPS | 0.2
Astro-Physics AP | LX200 Generic | 0.1
Astro-Electronic FS-2 | LX200 Generic | 0.1
Losmandy Gemini | LX200 Generic | 0.1
Mel Bartels Controllers | LX200 Generic | 0.1

## Unterstützte Fokussierer

Fokussierer | Gerätetreiber | Version
--- | --- | ---
Meade LX200GPS Microfocuser | LX200 GPS | 0.1
Meade 1206 Primary Mirror Focuser | LX200 Generic | 0.1
JMI NGF Series | LX200 Generic | 0.1
JMI MOTOFOCUS | LX200 Generic | 0.1

## Fokussiererverbindung

Die Fokussierer müssen mit dem Fokussiereranschluss nur im LX200 GPS, Autostar oder Classic Teleskop verbunden werden.

KStars kann lokale und entfernte Geräte ohne Probleme kontrollieren mittels der INDI Server/Client-Architektur. Die lokal/Server-Einstellung wird benutzt, um ein lokales Geräte zu kontrollieren (d.h. ein Gerät, das an Ihren Rechner angeschlossen ist) und dient gleichzeitig als Server, zu dem sich entfernte Clients verbinden können. Die entfernte/Client-Einstellung wird benutzt, um einen Client an einen entfernen Rechner zu verbinden, auf dem ein INDI-Server liegt.

Ein paar Schritte sind notwendig, um Ihr Teleskop mit KStars zu kontrollieren. Es ist lebensnotwendig jeden Schritt zu vollenden, bevor zum nächsten weitergegangen wird.

## Teleskopeinrichtung

Die meisten Teleskop sind mit der RS232 Schnittstelle für die Fernsteuerung ausgerüstet. Verbinden Sie den RS232-Anschluss in Ihrem Teleskop mit dem seriellen oder USB-Port Ihres Rechners. Traditionell verbindet sich der RS232 mit der seriellen Schnittstelle, da aber viele neuer Laptops den seriellen Port zugunsten von USB/FireWire-Ports verbannt haben, brauchen Sie für diese einen Seriell-USB-Adapter.

Nachdem Sie das Teleskop mit Ihrer seriellen bzw. USB-Schnittstelle verbunden haben, schalten Sie Ihr Teleskop an. Es wird stark empfohlen, dass Sie die neueste Firmware für Ihren Teleskopkontroller herunterladen und installieren.

Das Teleskop muss ausgerichtet werden, bevor es benutzt werden kann. Richten Sie Ihr Teleskop aus, wie es im Teleskophandbuch beschrieben ist (ein oder zwei Sterne-Ausrichtung).

## KStars INDI-Einrichtung

&kstars; muss die Zeit und Ortseinstellungen sicherstellen, bevor es sich mit dem Teleskop verbindet. Das stellt saubere Verfolgung und Synchronisation zwischen dem Teleskop und &kstars; sicher. Die folgenden Schritte ermöglichen es Ihnen, sich mit einem an Ihrem Computer angeschlossenen Teleskop zu verbinden. Um entfernte Geräte zu verwenden, schauen Sie bitte in den Abschnitt Fernsteuerungskontrolle.

Um ein lokales Teleskop zu verbinden, vollführen Sie bitte die folgenden Schritte:

1. Wählen Sie Ihren geographischen Ort. Öffnen Sie das Fenster Ort festlegen indem Sie Ort festlegen... aus dem Menü Einstellungen auswählen, drücken Sie das Symbol Weltkugel in der Werkzeugleiste oder drücken Sie &Ctrl;G.

2. Setzen Sie Ihre lokale Zeit und das Datum fest. Sie können es auf jedes Datum setzen, indem Sie Zeit einstellen aus dem Menü Zeit wählen oder das Symbol Zeit in der Werkzeugleise auswählen. Das Fenster Zeit einstellen benutzt ein normales &kde;-Zeitauswahlfeld, das mit drei Wahlfeldern für die Stunden, Minuten und Sekunden gekoppelt ist. Wenn Sie die Uhr auf die aktuelle Zeit setzen wollen, wählen Sie einfache Aktuelle Zeit einstellen aus dem Menü Zeit.

3. Klicken Sie auf das Menü Geräte und wählen den Gerätemanager.

4. In der Spalte Gerät wählen Sie Ihr Teleskopmodell.

5. Klicken Sie mit der rechten Maustaste auf ein Gerät und wählen Sie Service starten.

6. Klicken Sie auf Ok um den Gerätemanagerdialog zu verlassen.

Hier ist ein Bildschirmfoto des Gerätemanagerfensters:

Laufende Gerätetreiber
Gerätetreiber starten

Sie sind imstande, die Gerätefunktionen zu benutzen, &kstars; bietet Ihnen zwei unterschiedliche Oberflächen, um Teleskop zu kontrollieren:

### Teleskopkontrolle

1. Himmelskartenkontrolle: Für jedes Gerät, das Sie im Gerätemanager starten, erscheint ein Eintrag im Aufklappmenü, das Ihnen erlaubt, die Eigenschaften des Gerätes zu steuern. Sie können dann Kommandos wie `Slew, Sync` (Bewegung, Synchronisation) und `Track` (Verfolgen) direkt aus der Sternenkarte starten.

   Hier ist ein Bildschirmfoto vom Menü mit einem aktiven LX200 Classic-Gerät:

   Geräte von der Himmelskarte aus kontrollieren

2. INDI Kontrollfeld: Das Feld bietet dem Benutzer alle Funktionen, die ein Gerät für die feinere Kontrolle unterstützt. Eigenschaften wie die Schnittstelleneinstellungen, Seitenmanagement und Bewegungskontrollen können von hier aus verändert werden.

   Das Feld ist in drei Hauptabschnitte unterteilt:

   - Gerätereiter: Jedes zusätzliche Geräte belegt einen Karteireiter im INDI-Feld. Mehre Geräte können ohne Probleme parallel betrieben werden.

   - Eigenschaftenansicht: Eigenschaften sind das Schlüsselelement in der INDI-Architektur. Jedes Geräte setzt eine Anzahl von Eigenschaften fest, um mit dem Client zu kommunizieren. Die aktuelle Position des Teleskops ist z.B. eine solche Eigenschaft. Themenmäßig zusammenpassende Einstellungen werden in logischen Blöcken oder Gruppierungen zusammengefasst.

   - Logbetrachter: Geräte geben Ihren Status bekannt und bestätigen Befehle, indem Sie INDI-Nachrichten schicken. Jedes Gerät hat seinen eigenen Logbetrachter und alle Geräte haben einen gemeinsamen. Ein Gerät sendet die Nachrichten nur an seinen Gerätetreiber, aber es ist ihnen erlaubt, sofern notwendig, auch allgemeine Nachrichten zu verschicken.

   INDI Kontrollfeld

Sie sind nicht darauf beschränkt, eine Oberfläche der andern vorzuziehen, da sie beide benutzt werden können. Aktionen von der Himmelskarte werden automatisch in das INDI-Kontrollfeld übernommen und umgekehrt.

Um nun Ihr Teleskop letztendlich zu verbinden, wählen Sie entweder Connect (Verbinden) aus dem Aufklappmenü des Gerätes oder wählen Connect (Verbinden) aus dem entsprechenden Abschnitt des INDI-Kontrollfeldes.

Standardmäßig versucht KStars sich über die Schnittstelle `/dev/ttyS0` zu verbinden. Um den Verbindungsport zu verändern, wählen Sie INDI-Kontrollfeld aus dem Menü Geräte und ändern den Port im entsprechenden Geräteabschnitt.

&kstars; aktualisiert automatisch die Länge, Breite und Zeit des Teleskops basierend auf den aktuellen Einstellungen in &kstars;. Sie können diese Aktualisieren ein- bzw. ausschalten im INDI einrichten...-Dialog im Menü Geräte.

Falls &kstars; mit dem Teleskop erfolgreich kommunizieren kann, wird es die aktuellen Koordinaten RA und NEIG vom Teleskop beziehen und ein Fadenkreuz in der Himmelskarte anzeigen, das die Teleskopposition anzeigt.

### Ihr Teleskop synchronisieren

Falls Sie Ihr Teleskop ausgerichtet haben und der letzte Ausrichtungsstern war zum Beispiel die Wega, dann sollte das Fadenkreuz auf der Wega zentriert sein. Falls es vom Ziel abweichen sollte, können Sie mit der rechten Maustaste auf die Wega in der Himmelskarte klicken und `Sync` (Synchronisieren) aus dem Teleskopmenü wählen. Die Aktion instruiert das Teleskop, seine internen Koordinaten auf die von der Wega zu setzen und das Fadenkreuz des Teleskop sollte auf der Wega zentriert sein.

Das war's! Ihr Teleskop ist nun fertig, um den Himmel zu entdecken!

### WARNUNG

Benutzen Sie nie ein Teleskop, um in oder auf die Sonne zu schauen. Das direkte Schauen in die Sonne kann nicht behebbare Schäden an ihren Augen und an Ihrer Ausrüstung hervorrufen

## INDI-Konzepte

Das INDI-Kontrollfeld bietet viele Geräteeigenschaften, die nicht von der Himmelskarte aus erreichbar sind. Die Eigenschaften unterscheiden sich von Gerät zu Gerät. Nichtsdestotrotz haben alle gemeinsame Funktionen, die standardisiert angezeigt werden und benutzt werden können:

- Berechtigung: Alle Eigenschaften können zu lesen, zu schreiben oder zu lesen und zu schreiben sein. Ein Beispiel eine Schreib-Lese-Eigenschaft ist die Rechte Aszension des Teleskops. Sie können eine neue Rechte Aszension eingeben und das Teleskop wird sich, basierend auf den aktuellen Einstellungen, auf die neue Eingabe bewegen oder synchronisieren. Daneben wird jedoch auch die Rechte Aszension aktualisiert, wenn sich das Teleskop bewegt und zum Client gesendet.

- Status: Vor jeder Eigenschaft befindet sich ein Statusindikator (runde Leuchtdiode). Jede Eigenschaft hat einen Status und eine dazugehörige Farbe:

  ### INDI-Statusfarben

  Status | Farbe | Beschreibung
  --- | --- | ---
  Leerlauf | Grau | Das Gerät vollführt keine Aktion für diese Eigenschaft
  Ok | Grün | Die letzte Operation mit dieser Eigenschaft war erfolgreich und aktiv
  Beschäftigt | Gelb | Die Eigenschaft vollführt gerade eine Aktion
  Warnung | Red | Die Eigenschaft ist in einem kritischen Zustand und braucht sofortige Aufmerksamkeit

  Der Gerätetreiber aktualisiert den Eigenschaftenstatus in Realzeit, sofern notwendig. Wenn das Teleskop zum Beispiel zu einem Ziel bewegt wird, dann werden die RA/DEC-Koordinaten als Beschäftigt angezeigt. Wenn der Prozess erfolgreich beendet wurde, zeigen die Eigenschaften Ok.

- Kontext: Numerische Eigenschaften können Zahlen in zwei Formaten akzeptieren: Dezimal und Sexagesimal. Das sexagesimale Format ist bequem, um die Zeit oder äquatoriale/geographische Koordinaten anzugeben. Sie können jedes Format beliebig verwenden. Zum Beispiel sind alle folgenden Zahlen gleich:

  - -156.40

  - -156:24:00

  - -156:24

- Zeit: Die Standardzeit für alle INDI-bezogenen Kommunikationen ist die Universalzeit UTC, die nach ISO 8601 als YYYY-MM-DDTHH:MM:SS angegeben wird. &kstars; gibt den Geräte automatische die richtige UTC-Zeit. Sie können die automatischen Zeitaktualisierungen im Dialog INDI einrichten aus dem Menü Geräte ausschalten.

## Fernsteuerungskontrolle

KStars bietet eine einfache Schicht zur Kontrolle entfernter Geräte. Eine detaillierte Beschreibung der Schicht wird im in diesem Dokument zu INDI beschrieben.

Sie müssen sowohl den Server- als auch den Client-Rechner für die Fernsteuerung einrichten:

1. Server: Um ein Gerät für die Fernsteuerung vorzubereiten, folgen Sie denselben Schritten wie in der Einrichtung für lokale Geräte. Wenn Sie ein Geräteservice im Gerätemanager starten, wird eine Portnummer in der Spalte Benutzter Port. Zusätzlich zu der Portnummer brauchen Sie noch den Rechnernamen oder die IP-Adresse Ihres Servers.

2. Client: Wählen Sie den Gerätemanager aus dem Menü Geräte und klicken auf den Reiter Client. Sie können hier Server hinzufügen, bearbeiten und löschen. Fügen Sie einen Server mittels des Knopfes Hinzufügen hinzu. Geben Sie den Rechnernamen bzw. die IP-Adresse des Servers in das Feld Rechner ein und geben Sie die Portnummer des Serverrechners aus Schritt 1 in das Feld darunter ein.

INDI-Client

Nachdem Sie einen Server hinzugefügt haben, klicken Sie mit der rechten Maustaste darauf um zu verbinden oder die Verbindung zu trennen. Wenn eine Verbindung hergestellt wurde, können Sie das Teleskop von der Himmelskarte oder aus dem INDI-Kontrollfeld kontrollieren genau wie es im Abschnitt Lokal/Server beschrieben ist. Es ist so leicht!

### Einen INDI-Server von der Kommandozeile starten

Während &kstars; Ihnen erlaubt, einfach einen INDI-Server bereitzustellen, können Sie einen INDI-Server auch von der Kommandozeile aus starten.

Da INDI eine unabhängige Hintergrundkomponente ist, können Sie einen INDI-Server auf einem Rechner ohne KStars starten. INDI kann separat kompiliert werden um auf entfernten Rechnern laufen zu können. Weiterhin schreiben die Gerätetreiber Ihre Lognachrichten nach `stderr` und können in Fehlerbehebungssituationen hilfreich sein. Die Syntax für den INDI-Server ist wie folgt:

$ `indiserver` [optionen] [`treiber` ...]

Optionen:

-p p : anderer IP-Port, Standard ist 7624

-r n : maximale Startversuche, Standard ist 2

-v : viel mehr Informationen nach stderr

Zum Beispiel, wenn Sie einen INDI-Server für einen LX200 GPS-Treiber starten wollen, der auf Verbindungen am Port 8000 wartet, würden Sie folgenden Befehl ausführen:

$ `indiserver` -p 8000 `lx200gps`

### Sichere entfernte Ausführung

Suppose we want to run an indiserver with INDI drivers on a remote host, `remote_host`, and connect them to &kstars; running on the local machine.

From the local machine log onto the remote host, `remote_host`, by typing:

$ `ssh` -L `local_port`:`remote_host`:`remote_port`

This binds the `local_port` on the local machine to the `remote_port` on the `remote_host`. After logging in, run indiserver on the remote host:

$ `indiserver` -p `remote_port` [`driver`...]

Back on the local machine, start &kstars; then open the Device Manager and add a host under the Client tab. The host should be the local host (usually 127.0.0.1) and the port number should be the `local_port` used in the steps above. Right-click on the host and select Connect from the popup menu. &kstars; will connect to the remote INDI server securely. The host information will be saved for future sessions.

## Häufig gestellte Fragen zu INDI

Was ist INDI?

INDI ist das Instrument-Neutral-Distributed-Interface (Deutsch etwa: Instrumentneutrale verteilte Schnittstelle) Kontrollprotokoll von Elwood C. Downey vom ClearSky-Institut. &kstars; beinhaltet Gerätetreiber, die mit dem INDI-Protokoll kompatibel sind. INDI hat viele Vorteile, einschließlich der losen Verbindung zwischen Hardwaregeräten und Softwaretreibern. Clients, die die Gerätetreiber benutzen (wie &kstars;) haben keine Ahnung von den Gerätemöglichkeiten. Zu Laufzeit kommuniziert &kstars; mit den Gerätetreibern und erstellt eine komplett dynamische Oberfläche mit den Funktionen, die das Gerät bietet. Deshalb können neue Gerätetreiber geschrieben oder aktualisiert werden und KStars kann sie ohne Änderungen auf der Clientseite übernehmen.

Welche Geräte unterstützt KStars?

Zur Zeit unterstützt &kstars; die Geräte LX200 Classic, LX200 Autostar, LX200 GPS, LX200 16" und Celestron GPS.

Sind weitere Geräte in Planung?

Ja. Wir planen wichtige CCD-Kameras und Fokussierer zu unterstützen und die Unterstützung für weitere Teleskope zu erweitern. Falls INDI ein spezielles Gerät unterstützen sollte, schreiben Sie bitte eine E-Mail an indi-devel@lists.sourceforge.net

Ich habe keine serielle Schnittstelle, wie kann ich mein Teleskop verbinden?

Viele moderne Laptops haben keine seriellen Schnittstellen. Sie brauchen einen Seriell-USB-Adapter, der von Linux unterstützt wird. Zum Beispiel wird der USA-19QW Seriell-USB-Adapter von Keyspan von Linux gut unterstützt und wurde mit &kstars; getestet. Sie müssen dann in der Dokumentation Ihres Adapters herausfinden, welche Schnittstellen er bereitstellt (z.B. `/dev/ttyUSB0 ... /dev/ttyUSB9`).

Wenn mich zu verbinden versuche, wird gemeldet, dass mein Teleskop nicht mit der seriellen/USB-Schnittstelle verbunden ist. Was kann ich tun?

Diese Nachricht wird von &kstars; ausgelöst, wenn nicht mit dem Teleskop kommuniziert werden konnte. Hier sind einige Dinge, die Sie tun können:

1. Prüfen Sie das Verbindungskabel, stellen Sie sicher, dass es in einem guten Zustand ist und testen Sie es mit anderen Anwendungen.

2. Prüfen Sie die Spannungsversorgung des Teleskops, stellen Sie sicher, dass es eingeschaltet ist und dass das Teleskop ausreichend versorgt ist.

3. Setzen Sie die korrekte Schnittstelle im INDI-Kontrollfeld aus dem Menü Geräte ein. Die Standardschnittstelle ist `/dev/ttyS0`

4. Starten Sie &kstars; neu und versuchen Sie es erneut.

&kstars; berichtet, das das Teleskop verbunden und bereit ist, aber ich kann das Fadenkreuz nicht finden. Wo ist es?

&kstars; erhält die Koordinaten des Teleskops bei der Verbindung. Wenn die Ausrichtung korrekt ausgeführt wurde, sollten Sie das Fadenkreuz auf dem Ziel der Ausrichtung in der Himmelskarte finden. Wenn jedoch die Koordinaten vom Teleskop falsch sind (vielleicht sogar unter dem Horizont) müssen Sie das Teleskop auf das aktuelle Ziel Synchronisieren.

Das Teleskop bewegt sich nicht flüssig oder bewegt sich überhaupt nicht. Was kann ich tun?

Dieses Verhalten beruht meistens auf falschen Einstellungen, bitte prüfen Sie folgende Stichwortliste:

1. Ist das Teleskop ausgerichtet?

2. Ist die Ausrichtungsmethode korrekt? Benutzen Sie das INDI-Kontrollfeld um diese Einstellungen zu überprüfen oder zu verändern (`Alt/Az, Polar, Land`).

3. Ist die Zeit und das Datum des Teleskops korrekt?

4. Sind die Längen- und Breiteneinstellungen des Teleskops korrekt?

5. Ist die UTC-Einstellung des Teleskops korrekt?

6. Sind die Teleskopachsen für RA und NEIG ordentlich geschlossen?

7. Ist die Einstellung für die Erdhalbkugel (falls vorhanden) richtig?

8. Ist das Kabel zwischen dem Teleskop und dem Computer in einem guten Zustand?

Wenn Sie denken, dass alle Einstellungen richtig sind, aber Ihr Teleskop sich immer noch unstet bewegt oder überhaupt nicht, senden Sie bitte einen Bericht an kstars-devel@kde.org