# 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. Pour une liste à jour des matériels pris en charge, veuillez consulter la page INDI des matériels gérés.

## 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 modes différents :

1. Local : le mode local est le plus commun et sert à contrôler le matériel local (c'est-à-dire 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 manipuler 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 menu Périphériques Gestionnaire de 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 démarrer des périphériques en naviguant dans l'arborescence, sélectionnez un périphérique spécifique, puis cliquez sur le bouton Démarrer le service. Vous pouvez sélectionner le mode de fonctionnement, soit local ou serveur tel que défini ci-dessus. Le numéro de port est généré de façon aléatoire entre la plage de 7624 à 10000. Pour spécifier un port, cliquez sur la colonne de port à côté du pilote de périphériques désiré. &kstars; permet aux pilotes de périphériques de faire fonctionner plusieurs pilotes sous un même serveur INDI, et donc un seul port. Sélectionnez plusieurs pilotes puis appuyez sur le bouton Démarrer le service.

Pour contrôler les périphériques distants, veuillez vous référer à 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 ou 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 de type USB et 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 ou USB, allumez votre télescope. Il est hautement recommandé de télécharger et installer 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 de position avant de se connecter au télescope. Cela 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 l'assistant de configuration du 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 Périphériques Assistant de configuration de télescope.

D'une autre manière, vous pouvez connecter un télescope local en effectuant les étapes suivantes :

1. Déterminez votre position géographique. Ouvrez la fenêtre Configuration Position géographique… ou en actionnant l'icône représentant un Globe dans la barre d'outils, ou en saisissant &Ctrl;G.

2. Déterminez vos heure et date locales. Vous pouvez changer en n'importe quelle heure ou date en sélectionnant Heure Définir l'heure… ou en actionnant l'icône Heure dans la barre d'outils. La fenêtre Régler l'heure utilise un composant graphique de choix de date standard dans &kde;. Si vous avez besoin de remettre l'horloge à l'heure actuelle, actionnez simplement Heure Régler l'heure à maintenant.

3. Cliquez sur le menu Périphériques Gestionnaire de périphériques….

4. Sous la colonne Périphérique, sélectionnez votre modèle de télescope.

5. Cliquez sur le bouton Lancer le service.

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

### Réglages fréquents

Vous n'avez pas besoin de déterminer la position 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 `Pivoter`, `Synchroniser` et `Suivre` 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. Tableau de bord INDI : ce tableau de bord 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 dans les onglets Contrôle principal et Options : 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 du point de vue sémantique 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. 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é.

   Tableau de bord 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 Tableau de bord 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 Tableau de bord INDI.

Par défaut, &kstars; essayera de se connecter au port `/dev/ttyS0`. Pour changer le port de connexion, sélectionnez Outils Périphériques Tableau de bord INDI et changez le port sous l'onglet de votre périphérique.

&kstars; met à jour automatiquement la longitude, la latitude et l'heure fondés sur les réglages actuels de &kstars;. Vous pouvez les activer/désactiver en utilisant la page INDI dans le menu Configuration Configurer &kstars;. Dans la page INDI, vous pouvez indiquez à &kstars; d'afficher ou non les messages d'INDI dans la barre d'état. Par défaut, les numéros de port du serveur INDI se trouve dans la plage 7624 à 9000, mais vous pouvez facilement modifier cette plage en utilisant les boîtes de texte De et À de la section Port du serveur.

Si &kstars; réussit à communiquer avec le télescope, il retrouvera l'AD et la DEC courantes depuis le télescope et affichera une croix sur la carte du ciel, indiquant la position du télescope. Vous pouvez masquer la croix qui indique la position depuis le menu Configuration Configurer &kstars;….

### 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 avec le bouton droit sur la carte du ciel et sélectionner `Synchroniser` du menu du télescope. Cette action demandera 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 acquisitions CCD et vidéo

Vous pouvez lancer les périphériques d'acquisition CCD et vidéo depuis le menu Périphériques Gestionnaire de 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 Tableau de bord INDI….

Le format standard pour la capture d'images est FITS. Une fois l'une image acquise et téléchargée, elle sera affichée dans l'afficheur FITS de &kstars;.

## Configurer INDI

La page d'INDI vous permet de modifier les options spécifiques du Côté client d'INDI. Pour y accéder, sélectionnez Configuration Configurer &kstars; de cette page. La fenêtre est divisée en plusieurs catégories principales : général, mises à jour des périphériques automatique, affichage, source de mise à jour, roue à filtres et port du serveur :

- Général

  - Serveur INDI : indiquez l'exécutable du serveur INDI installé sur votre système. Par défaut, &kstars; utilise /usr/bin/indiserver.

  - Dossier XML des pilotes INDI : spécifie le dossier &XML; sur votre système contenant les pilotes INDI. Par défaut &kstars; utilise le dossier /usr/share/indi.

  - Dossier FITS par défaut : spécifie le dossier où toutes les images FITS seront enregistrées. S'il n'y a pas de dossier spécifié, les images seront enregistrées dans `$HOME`.

- Synchronisation heure et position

  - &kstars; synchronise tous les périphériques : &kstars; est la source des réglages de l'heure et de la position. Tous les réglages d'heure et de position des périphériques INDI sont synchronisés avec les réglages de &kstars;.

  - La monture synchronise &kstars; : la télécommande de la monture est la source des réglages de l'heure et de la position. Les réglages de l'heure et de la position de &kstars; sont synchronisés avec les réglages de la télécommande de la monture.

  - Le GPS synchronise &kstars; : le pilote du GPS est la source des réglages d'heure et de position. Les réglages de l'heure et de la position de &kstars; sont synchronisés avec les réglages du GPS.

  - Heure : la date et l'heure de &kstars; est synchronisé automatiquement à partir de la source de synchronisation.

  - Position : la position de &kstars; est synchronisée automatiquement à partir de la source de synchronisation.

- Affichage

  - Réticule du télescope : lorsque cela est coché, &kstars; affiche le réticule du télescope sur la carte du ciel. La croix est affichée lors d'une connexion réussie au télescope, et sa position est actualisée périodiquement. Le nom du télescope est affiché à côté du réticule. &kstars; affiche un réticule pour chaque télescope connecté. Pour changer la couleur du réticule du télescope, ouvrez la fenêtre Configuration de &kstars;. Sélectionnez l'onglet Couleurs, et changez la couleur de l'élément Indicateur de cible dans la couleur désirée.

  - Fenêtre indépendante : rendre la fenêtre de l'afficheur FITS indépendante.

  - Notifications des messages : afficher les messages d'INDI comme des notifications du bureau plutôt que dans des boîtes de dialogue.

- Port du serveur

  - Spécifiez une plage de ports que le serveur INDI puisse utiliser lors du démarrage de nouveaux pilotes.

## Concepts INDI

Le concept clé principal dans INDI est que les périphériques ont la possibilité de se décrire eux-mêmes. Ceci s'accomplit en utilisant le &XML; pour décrire une hiérarchie générique qui peut représenter à la fois les périphériques canoniques et non canoniques. Dans INDI, tous les périphériques peuvent contenir une ou plusieurs propriétés. Toute propriété peut contenir un ou plusieurs éléments. Il y a quatre types de propriétés INDI :

- Propriétés de texte.

- Propriété de nombre.

- Propriété d'activation (représenté dans l'interface graphique par des boutons et des cases à cocher).

- Propriétés de lumière (représenté dans l'interface graphique par des LED colorées).

Par exemple, tous les périphériques INDI partagent la propriété interrupteur standard CONNECTION. La propriété CONNECTION possède deux éléments : les interrupteurs CONNECT et DISCONNECT. &kstars; analyse la description générique &XML; des propriétés et construit une représentation graphique adaptée à l'interaction humaine directe.

Le tableau de bord 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, alors les propriétés d'AD et de DEC 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 la norme 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 la page INDI de la boîte de dialogue de configuration.

## 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étaillée 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 d'écoute. 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 menu Périphériques gestionnaire de 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 ou une 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 avec le 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 tableau de bord 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 moteur 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 écrivent dans un journal les messages dans `stderr`. Cela peut être utile pour les situations de recherche d'erreur. La syntaxe pour le serveur INDI est la suivante :

$ `indiserver` [options] driver [`driver`…]

    Options:
     -l d     : Log driver messages to <d>/YYYY-MM-DD.islog
     -m m     : Kill client if gets more than this many MB behind, default 128.
     -d m     : Drop streaming blobs if client gets more than this many MB behind, default 5. 0 to disable.
     -p p     : Alternate IP port, default 7624.
     -r r     : Maximum driver restarts on error, default 10.
     -f path  : Path to fifo for dynamic startup and shutdown of drivers.
     -v       : Show key events, no traffic.
     -vv      : -v + key message content.
     -vvv     : -vv + complete xml.
     driver   : Executable or [device]@host[:port]

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 machine locale au `remote-port` du `remote-host`. Après connexion, exécutez indiserver 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 avec le 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 qu'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 utilisant 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 courrier électronique à indi-devel@lists.sourceforge.net

Quelles opérations &kstars; fournit-il pour contrôler le télescope ?

Cela dépend du télescope que vous utilisez, mais les trois opérations minimales sont : `Pivoter`, `Suivre` et `Synchroniser`, que vous pouvez utiliser directement depuis la carte du ciel. Votre télescope doit être mis en station pour que ces opérations fonctionnent correctement. Certains télescopes fournissent davantage d'opérations comme la gestion des sites, les modes de pivotage, la mise au point, le stationnement, et plus encore. Vous pouvez accéder aux caractéristiques étendues des télescopes depuis le menu Outils Périphériques Tableau de bord INDI….

Quelle est exactement la différence entre `Pivoter`, `Suivre` et `Synchroniser` ?

La commande `Pivoter` ordonne au télescope de se déplacer vers une cible particulière, et, une fois que le télescope a atteint sa cible, le télescope continue à suivre la cible à une vitesse sidérale (c'est-à-dire la vitesse à laquelle l'objet se déplace dans le ciel). Ceci fonctionne bien pour les étoiles, les objets Messier, et à peu près tout hors du système solaire. Mais les objets du système solaire voyagent différemment à travers le ciel, et le télescope doit `Suivre` les objets comme ils bougent.

Pour cela, vous avez besoin d'effectuer une commande de suivi, si vous voulez suivre un objet avec un mouvement non sidéral. D'une autre manière, `Synchroniser` sert à synchroniser les coordonnées internes du télescope avec un objet que vous sélectionnez.

Puis-je contrôler mon télescope à distance ?

Oui. Vous pouvez démarrer un serveur INDI sur la machine connectée à votre télescope, et le serveur écoutera les requêtes des clients &kstars;. Une fois que vous aurez connecté, vous pouvez contrôler votre télescope directement depuis la carte du ciel. Cette procédure est décrite en détail dans la section Contrôle de périphérique distant.

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 manipulations que vous pouvez effectuer :

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 et assurez-vous qu'il est en bon état et testez-le avec d'autres applications.

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

4. Sélectionner le menu Outils Périphériques Tableau de bord INDI…. Le périphérique 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 DEC du télescope en connexion. Si votre alignement a été effectué correctement, vous pouvez voir la croix près de votre cible dans la carte du ciel. Cependant, les coordonnées AD et DEC 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. Vous pouvez utiliser le menu contextuel pour centrer et suivre la croix du télescope dans la carte du ciel.

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 Tableau de bord 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 DEC 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 de bogue à indi-devel@lists.sourceforge.net.