# Contrôle de matériel astronomique 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
Télescopes gérés par Autostar | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.5
LX200 Classic 16" | LX00 16" | 0.5
NexStar GPS, CGE, AS-GT | Celestron GPS | 0.5
New GT, NexStar 5i/8i | Celestron GPS | 0.5
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.

## CCD gérés

CCD | Pilote de matériel | Version
--- | --- | ---
Intruments CCD Finger Lakes | fliccd | 0.1

## Webcams gérées

Webcam | Pilote de matériel | Version
--- | --- | ---
N'importe quel périphérique compatible Video4Linux | v4ldriver | 0.1
Webcam Philips | v4lphilips | 0.1

## Réglage INDI

KStars peut contrôler des périphériques locaux et distants sans peine par l'architecture client/serveur INDI. Les périphériques INDI peuvent fonctionner dans trois différents modes.

1. Local : le mode local est le plus commun et sert à contrôler le matériel local (&cad; attaché à votre machine).

2. Serveur : le mode serveur établit un serveur INDI pour un matériel particulier et attend les connexions des clients distants. Vous ne pouvez pas opérer les périphériques serveurs, vous ne pouvez que les démarrer et les arrêter.

3. Client : le mode client sert à se connecter à des serveurs INDI faisant fonctionner des périphériques INDI. Vous pouvez contrôler des périphériques sans peine comme des périphériques locaux.

Vous pouvez lancer un périphérique local, établir des serveurs INDI et connecter à des clients distants depuis le Gestionnaire de périphériques dans le menu Périphériques.

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 pouvez lancer des périphériques en naviguant dans l'arborescence des périphériques, en choisissant un matériel spécifique, et en cliquant sur le bouton Lancer le service. Vous pouvez sélectionner le mode opératoire, soit local, soit en serveur comme défini ci-dessus.

Pour contrôler les périphériques distants, référez-vous à la section contrôle de périphérique distant.

## 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.

&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.

Vous pouvez utiliser cet assistant de configuration de télescope, et il vérifiera toutes les informations nécessaires au processus. Il peut balayer automatiquement les ports pour les télescopes attachés. Vous pouvez lancer l'assistant de configuration en sélectionnant Assistant de configuration de télescope dans le menu Périphériques.

D'une autre manière, vous pouvez connecter un télescope local en effectuant 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.

### Réglages fréquents

Vous n'avez pas besoin de déterminer l'emplacement géographique à chaque fois que vous connectez un télescope. N'ajustez que les réglages nécessaires.

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 INDI : le panneau offre à l'utilisateur toutes les fonctions gérées par un périphérique.

   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.

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.

## Configuration des CCD et Capture vidéo

Kstars gère les CCD Finger Lakes instruments et n'importe quel matériel compatible Video4Linux. Les fonctionnalités étendues des webcams Philips sont aussi gérées.

Vous pouvez lancer des périphériques CCD et de capture vidéo depuis le Gestionnaire de périphériques dans le menu Périphériques. Comme tous les périphériques INDI, certains des contrôles seront accessibles depuis la carte du ciel. Le périphérique peut être contrôlé pleinement depuis le Panneau de contrôle INDI.

Le format standard pour la capture d'images est FITS. Une fois qu'une image est capturée et téléchargée, elle sera affichée dans l'afficheur FITS de KStars. Pour capturer une séquence d'images, utilisez l'outil Capture d'une séquence d'images du menu Périphériques. Cet outil est inactif jusqu'à ce que vous établissiez une connexion à un périphérique d'image.

## 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

Supposons que nous voulions lancer un indiserver avec les pilotes INDI sur une machine distante, `machine_distante`, et les connecter à &kstars; qui fonctionne sur la machine locale.

Depuis la machine locale, connectez-vous sur la machine distante `machine_distante` en saisissant :

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

Ceci lie le `local_port` de la machien locale au `remote_port` du `remote_host`. Après connexion, exécutez inidiserver sur la machine distante :

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

De retour sur la machine locale, lancez &kstars;, puis ouvrez le Gestionnaire de périphériques et ajoutez un hôte sous l'onglet Client. L'hôte doit être localhost (habituellement 127.0.0.1) et le numéro de port doit être le `local_port` utilisé dans les étapes ci-dessus. Cliquez du bouton droit sur l'hôte et sélectionnez Connecter dans le menu contextuel. &kstars; se connectera au serveur INDI distant en sécurité. Les informations d'hôte seront enregistrées pour les sessions futures.

## 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.

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 que vous avez à la fois les droits en lecture et en écriture pour le port auquel vous essayez de vous connecter.

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

3. 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.

4. 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`

5. 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