# Contrôle de télescope avec INDI

KStars fournit une interface pour configurer et piloter les instruments astronomiques par le protocole INDI.

Le protocole INDI gère une grande variété d'instruments astronomiques, comme les caméra CCD et les viseurs. Actuellement, KStars gère les périphériques suivants :

## Télescopes gérés

Télescope | Pilote de matériel | 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

## Viseurs gérés

Viseur | Pilote de matériel | 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

## Connexion du viseur

Le viseur ne doit être connecté au port de viseur que dans les télescopes LX200 GPS, Autostar ou Classic.

KStars peut contrôler du matériel local et distant sans peine par l'architecture client / serveur INDI. Le réglage serveur / local sert à contrôler un matériel local (c'est-à-dire un périphérique raccordé à votre machine) et est aussi utilisé pour établir un serveur auquel les clients distants peuvent se connecter. Un réglage cilent / distant sert à connecter un client à un hôte distant qui fait fonctionner un serveur INDI.

Le pilotage de votre télescope par KStars nécessite quelques étapes simples. Il est vital de compléter chaque étape avant d'aller à la suivante.

## Réglage du télescope

La plupart des télescopes sont équipés d'une interface RS232 pour la télécommande. Connectez la prise RS232 de votre télescope dans la prise série / USB de votre ordinateur. Habituellement, le RS232 se connecte au port série de votre ordinateur, mais, comme beaucoup de nouveaux portables ont abandonné le port série en faveur de ports USB / FireWire, vous pouvez avoir besoin de vous procurer un adaptateur USB pour utilisation avec les nouveaux portables.

Après avoir connecté votre télescope au port Série / USB, allumez votre télescope. Il est hautement recommandé que vous téléchargiez et installiez le firmware (logiciel embarqué) le plus récent pour votre contrôleur de télescope.

Le télescope doit être aligné avant de pouvoir être utilisé correctement. Alignez votre télescope (une ou deux étoiles d'alignement) comme illustré dans le manuel de votre télescope.

## Réglage INDI de KStars

&kstars; a besoin de vérifier les réglages d'heure et d'emplacement avant de se connecter au télescope. Ceci assure un suivi propre et une synchronisation entre le télescope et &kstars;. Les étapes suivantes vous permettront de connecter un matériel qui est connecté à votre ordinateur ; pour connecter et contrôler les périphériques distants, veuillez vous rapporter à la section Contrôle des périphériques distants.

Pour connecter un télescope local, veuillez effectuer les étapes suivantes :

1. Déterminez votre emplacement géographique.. Ouvrez la fenêtre Fixer le lieu géographique en choisissant Fixer le lieu géographique... dans le menu Configuration ou en actionnant l'icône de Globe dans la barre d'outils, ou en tapant &Ctrl;g.

2. Déterminez vos heure et date locales. Vous pouvez changer en n'importe quelle heure ou date en sélectionnant Définir l'heure... dans le menu Heure ou en actionnant l'icône Heure dans la barre d'outils. La fenêtre Fixer l'heure utilise un élément graphique de choix de date standard dans &kde;, couplé avec trois compteurs pour déterminer les heures, minutes et secondes. Si vous avez besoin de remettre l'horloge à l'heure actuelle, actionnez simplement Positionner l'heure à maintenant du menu Heure.

3. Cliquez sur le menu Périphériques et sélectionnez Gestionnaire de périphériques.

4. Sous la colonne Matériel, sélectionnez votre modèle de télescope.

5. Cliquez du bouton droit sur le périphérique et sélectionnez Démarrer le service.

6. Cliquez sur le bouton OK pour fermer la boîte de dialogue du gestionnaire de matériel.

Voici une capture d'écran de la fenêtre de Gestionnaire de matériel :

Lancer les pilotes de périphérique
Démarrer les pilotes de périphériques

Vous êtes maintenant prêt à utiliser les fonctions du périphérique. &kstars; fournit deux interfaces graphiques interchangeables pour contrôler les télescopes :

### Contrôler votre télescope

1. Contrôle de la carte du ciel : pour chaque périphérique que vous lancez dans le gestionnaire de périphériques, une entrée correspondants s'affichera dans un menu contextuel qui vous permet de contrôler les propriétés du périphérique. Vous pouvez exécuter des commandes comme `Slew, Sync,` et `Track` directement depuis la carte du ciel.

   Voici une capture d'écran du menu contextuel avec un périphérique actif LX200 Classic :

   Contrôle des périphériques depuis la carte du ciel

2. Panneau de contrôle d'INDI : le panneau offre à l'utilisateur toutes les fonctions qu'un périphérique gère pour un contrôle plus fin du télescope. Les propriétés comme les réglages des ports, la gestion de site et les contrôles de mouvement oblique parmi d'autres peuvent être manipulés depuis le panneau de contrôle d'INDI.

   Le panneau est divisé en trois sections principales :

   - Onglets des périphériques : chaque périphérique actif additionnel occupe un onglet dans le panneau INDI. De multiples périphériques peuvent fonctionner simultanément sans affecter les opérations des autres périphériques.

   - Affichage des propriétés : les propriétés sont l'élément-clé dans l'architecture INDI. Chaque périphérique définit un jeu de propriétés pour communiquer avec le client. La position courante du télescope est un exemple de propriété. Des propriétés semblables sémantiquement sont habituellement contenues dans des blocs logiques ou des groupes.

   - Afficheur de journaux : les périphériques rapportent leur état et accusent réception des commandes en envoyant des messages INDI. Chaque périphérique a son propre journal, et tous les périphériques partagent un afficheur de journaux générique. Un périphérique n'envoie habituellement des messages qu'à son pilote de périphérique, mais un périphérique peut envoyer un message générique lorsque c'est approprié.

   Panneau de contrôle INDI

Vous n'êtes pas limité à l'utilisation d'une interface par le chevauchement, car les deux peuvent être utilisées simultanément. Les actions de Carte du ciel sont reflétés automatiquement dans le Panneau de contrôle INDI et vice versa.

Enfin, pour connecter votre télescope, vous pouvez soit sélectionner Connecter du menu contextuel des périphériques, soit actionner Connecter sous votre onglet de périphérique dans le panneau de contrôle d'INDI.

Par défaut, KStars essayera de se connecter au port `/dev/ttyS0`. Pour changer le port de connexion, sélectionnez Panneau de contrôle d'INDI dans le menu Périphériques et changez le port sous l'onglet de votre périphérique.

&kstars; met à jour automatiquement la latitude, la longitude et l'heure en fonction sur les réglages en cours de &kstars;. Vous pouvez activer / désactiver ces mises à jour dans la boîte de dialogue Configurer INDI sous le menu Périphériques.

Si &kstars; réussit à communiquer avec le télescope, il retrouvera l'AD et la Déc courantes depuis le télescope et affichera un croix sur la carte du ciel, indiquant la position du télescope.

### Synchronisation de votre télescope

Si vous avez aligné votre télescope et que la dernière étoile d'alignement a été, par exemple, Vega, la croix doit être centrée autour de Vega. Si la croix était hors cible, vous pouvez cliquer du bouton droit sur la carte du ciel et sélectionner `Sync` du menu du télescope. Cette action dira au télescope de synchroniser ses coordonnées internes pour qu'elles correspondent à celles de Vega et la croix du télescope doit maintenant être centrée autour de Vega.

Voilà ! Votre télescope est prêt à explorer les cieux !

### AVERTISSEMENT

N'utilisez jamais le télescope pour regarder le Soleil. L'observation du Soleil peut causer des dommages irréversibles à vos yeux et à votre équipement.

## Concepts INDI

Le panneau de contrôle INDI offre beaucoup de propriétés de périphériques inaccessibles de la carte du ciel. Les propriétés offertes diffèrent d'un périphérique à l'autre. Néanmoins, toutes les propriétés partagent des fonctionnalités communes qui déterminent comment elles sont affichées et utilisées.

- Permissions : toutes les propriétés peuvent être soit en lecture seule, écriture seule ou les deux. Un exemple de propriété en écriture seule est l'ascension droite du télescope. Vous pouvez donner une nouvelle ascension droite et le télescope, selon sur les réglages courants, se déplacera obliquement ou se synchronisera à la nouvelle entrée. De plus, lorsque le télescope se déplace obliquement, son ascension droite se met à jour et est renvoyée au client.

- État : avant pour chaque propriété se trouve un état d'indicateur (LED ronde). Chaque propriété a un état et un code de couleur associé :

  ### Code de couleur d'état INDI

  État | Couleur | Description
  --- | --- | ---
  En attente | Gris | Le périphérique ne réalise pas d'action respectant cette propriété
  Ok | Vert | La dernière opération effectuée sur cette propriété a réussi et est active.
  Occupé | Jaune | La propriété effectue une action
  Alerte | Rouge | La propriété est dans un état critique et a besoin d'une attention immédiate

  Le pilote de périphérique met à jour l'état de propriété en temps réel lorsque nécessaire. Par exemple, si le télescope est dans le processus de mouvement oblique vers une cible, puis les propriétés d'AD et de Déc seront signalées comme Occupé. Quand le processus de déplacement oblique est terminé avec succès, les propriétés seront signalées comme OK.

- Contexte : les propriétés numériques peuvent accepter et traiter des nombres en deux formats : décimal et sexagésimal. Le format sexagésimal est pratique lors de l'expression d'heures ou coordonnées équatoriales / galactiques. Vous pouvez utiliser n'importe quel format selon vos besoins. Par exemple, tous les nombres suivants sont égaux :

  - -156,40

  - -156:24:00

  - -156:24

- Heure : l'heure standard pour toutes les communications en relation avec INDI est l'heure UTC, spécifié en AAAA-MM-JJTHH:MM:SS selon ISO 8601. &kstars; communique l'heure UTC correcte avec les pilotes de périphériques automatiquement. Vous pouvez activer / désactiver la mise à jour automatique de l'heure depuis le dialogue Configuration d'INDI sous le menu Périphériques.

## Contrôle de périphériques à distance

KStars fournit une couche de contrôle de périphérique à distance simple, mais puissante. Une description détaille de la couche est décrite dans l'article sur INDI.

Vous avez besoin de configurer à la fois les machines serveur et client pour le contrôle à distance :

1. Serveur : pour préparer un matériel pour le contrôle distant, suivez les mêmes étapes que dans le réglage local / serveur. Lorsque vous lancez un service de matériel dans le gestionnaire de périphériques, un numéro de port s'affiche sous la colonne Port écoutant. En plus du numéro de port, vous avez aussi besoin du nom d'hôte ou adresse IP de votre serveur.

2. Client : sélectionnez le gestionnaire de périphériques dans le menu Périphériques et cliquez sur l'onglet Client. Vous pouvez ajouter, modifier ou supprimer des hôtes sous l'onglet Client. Ajoutez un hôte en cliquant sur le bouton Ajouter. Donnez un nom d'hôte / adresse IP sur le serveur dans le champ Hôte et donnez le numéro de port obtenu de la machine serveur dans l'étape 1.

Client INDI

Après que vous aurez ajouté un hôte, cliquez du bouton droit sur l'hôte à connecter ou déconnecter. Si une connexion est établie, vous pouvez contrôler le télescope depuis la Carte du ciel ou le panneau de contrôle INDI exactement comme décrit dans la section local / serveur. c'est aussi facile que ça !

### Lancement d'un serveur INDI depuis la ligne de commande

Comme &kstars; vous permet de déployer un serveur INDI, vous pouvez lancer un serveur INDI depuis la ligne de commande.

Comme INDI est indépendant du composant d'arrière-plan, vous pouvez lancer un serveur INDI sur un hôte sans KStars. INDI peut être compilé séparément pour fonctionner sur des hôtes distants. De plus, les pilotes de périphériques journalisent des messages dans `stderr` et cela peut être utile pour les situations de recherche d'erreur. La syntaxe pour le serveur INDI est la suivante :

$ `indiserver` [options] [`driver` ...]

Options :

-p p : port IP alternatif, 7624 par défaut

-r n : tentatives maximales de redémarrage, 2 par défaut

-v : plus de bavardage vers stderr

Par exemple, si vous voulez démarrer un serveur INDI gérant un pilote LX200 GPS et écouter les connexions sur le port 8000, vous devez lancer la commande suivante :

$ `indiserver` -p 8000 `lx200gps`

### Sécurisation des opérations distantes

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.

## Foire aux questions d'INDI

Qu'est INDI ?

INDI est le protocole de contrôle Instrument-Neutral-Distributed-Interface développé par Elwood C. Downey du ClearSky Institute. &kstars; emploie des pilotes de périphériques qui sont compatibles avec le protocole INDI. INDI a beaucoup d'avantages, y compris le couplage non lié entre les périphériques et les pilotes logiciels. Les clients qui utilisent les pilotes de périphériques (comme &kstars;) sont complètement ignorants des possibilités du matériel. En fonctionnement, &kstars; communique avec les pilotes de périphériques et construit une interface graphique complètement dynamique basée sur les services fournis par le matériel. De ce fait, les nouveaux pilotes de périphériques peuvent être écrits ou mis à jour, et KStars peut en tirer avantage sans changement du côté client.

Quel matériel KStars gère-t-il ?

Actuellement, &kstars; gère les LX200 Classic, LX200 Autostar, LX200 GPS, LX200 16", et Celestron GPS.

Comptez-vous gérer plus de périphériques ?

Oui. Nous comptons gérer la plupart des caméras CCD et viseurs et étendre la gestion pour les télescopes. Si vous vouliez gérer un matériel particulier, veuillez envoyer un message électronique à indi-devel@lists.sourceforge.net

Je n'ai pas de port série, comment puis-je connecter le télescope ?

Beaucoup de portables modernes n'ont pas de port série. Vous aurez besoin d'un adaptateur série vers USB géré par Linux. Par exemple, le Keyspan USA-19QW est bien géré sous Linux et a été testé avec &kstars;. Vous avez besoin de vous rapporter à la documentation de votre adaptateur pour trouver les ports fournis (par ex. `/dev/ttyUSB0 .... /dev/ttyUSB9`).

Lorsque j'essaye de connecter, &kstars; rapporte que le télescope n'est pas connecté au port série / USB. Que puis-je faire ?

Ce message est déclenché lorsque &kstars; ne peut pas communiquer avec le télescope. Voici quelques choses que vous pouvez faire :

1. Vérifiez la connexion du câble, assurez-vous qu'il est en bon état et testez-le avec d'autres applications.

2. Vérifiez l'alimentation de votre télescope, assurez-vous que le contact est mis et que le télescope reçoit assez d'énergie.

3. Déterminez le port correct dans le panneau de contrôle INDI sous le menu Périphériques. Le port par défaut est `/dev/ttyS0`

4. Redémarrez &kstars; et réessayez.

&kstars; rapporte que le télescope est en ligne et prêt, mais je ne peux pas trouver la croix du télescope. Où est-elle ?

&kstars; trouve les coordonnées AD et Déc du télescope en connexion. Si votre alignement a été effectué correctement, vous pouvez voir la croix autour de votre cible dans la carte du ciel. Cependant, les coordonnées AD et Déc fournies par le télescope peuvent être incorrectes (même sous l'horizon) et vous avez besoin de synchroniser votre télescope vers votre cible courante.

Le télescope se déplace d'une manière erratique ou pas du tout. Que puis-je faire ?

Ce comportement est la plupart du temps dû à des réglages incorrects. Veuillez vérifier la liste suivante :

1. Le télescope est-il aligné ?

2. Le mode d'alignement du télescope est-il correct ? Utilisez le panneau de contrôle INDI pour le vérifier et changez ces réglages (`Alt / Az, Polar, Land`).

3. Les réglages d'heure et date du télescope sont-ils corrects ?

4. Les réglages de latitude et de longitude du télescope sont-ils corrects ?

5. Le calage UTC du télescope est-il correct ?

6. Les axes d'AD et de Déc du télescope sont-ils bien verrouillés ?

7. Le réglage d'inverseur N / S de télescope (lorsque applicable) est-il correctement effectué pour votre hémisphère ?

8. Le câble entre le télescope et l'ordinateur est-il en bon état ?

Si vous pensez que tous les réglages sont corrects, mais que le télescope continue ) bouger n'importe comment ou pas du tout, veuillez envoyer un rapport à kstars-devel@kde.org