<chapter id="indi">
<title
>Contrôle de matériel astronomique avec <acronym
>INDI</acronym
></title>
<indexterm
><primary
>Contrôle INDI</primary>
<secondary
>Survol</secondary>
</indexterm>

<para
>&kstars; fournit une interface pour configurer et piloter les instruments astronomiques par le protocole <acronym
><link linkend="what-is-indi"
>INDI</link
></acronym
>. </para>

<para
>Le protocole <acronym
>INDI</acronym
> 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 <acronym
>INDI</acronym
> <ulink url="https://indilib.org/index.php?title=Devices"
> des matériels gérés</ulink
>.  </para>

<sect1 id="indi-kstars-setup">
<title
>Réglage INDI</title>
<indexterm
><primary
>INDI</primary>
<secondary
>Configuration</secondary>
</indexterm>
<para
>&kstars; peut contrôler des périphériques locaux et distants sans peine par l'architecture client/serveur <link linkend="what-is-indi"
>INDI</link
>. Les périphériques INDI peuvent fonctionner dans trois modes différents : </para>

<orderedlist>
<listitem
><para
><guilabel
>Local</guilabel
> : le mode local est le plus commun et sert à contrôler le matériel local (c'est-à-dire attaché à votre machine). </para
></listitem>

<listitem
><para
><guilabel
>Serveur</guilabel
> : 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. </para
></listitem>

<listitem
><para
><guilabel
>Client</guilabel
> : 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. </para
></listitem>
</orderedlist>

<para
>Vous pouvez lancer un périphérique local, établir des serveurs INDI et connecter à des clients distants depuis le menu <menuchoice
><guimenu
>Périphériques</guimenu
> <guimenuitem
>Gestionnaire de périphériques</guimenuitem
></menuchoice
>. </para>

<para
>Voici une capture d'écran de la fenêtre de <guilabel
>Gestionnaire de matériel</guilabel
> : </para>

<screenshot>
<screeninfo
>Lancer les pilotes de périphérique</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="devicemanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Démarrer les pilotes de périphériques</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>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 <guibutton
>Démarrer le service</guibutton
>. 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 <guibutton
>Démarrer le service</guibutton
>. </para>

<para
>Pour contrôler les périphériques distants, veuillez vous référer à la section <link linkend="indi-remote-control"
>contrôle de périphérique distant</link
>. </para>
</sect1>

<sect1 id="indi-telescope-setup">
<title
>Réglage du télescope</title>
<indexterm
><primary
>INDI</primary>
<secondary
>Configuration</secondary>
</indexterm>

<para
>La plupart des télescopes sont équipés d'une interface <hardware
>RS232</hardware
> pour la télécommande. Connectez la prise RS232 de votre télescope dans la prise <hardware
>série</hardware
> ou <hardware
>USB</hardware
> 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 <hardware
>USB</hardware
> et <hardware
>Firewire</hardware
>, vous pouvez avoir besoin de vous procurer un adaptateur USB pour utilisation avec les nouveaux portables. </para>

<para
>Après avoir connecté votre télescope au port <hardware
>Série</hardware
> ou <hardware
>USB</hardware
>, allumez votre télescope. Il est <emphasis
>hautement</emphasis
> recommandé de télécharger et installer le firmware (logiciel embarqué) le plus récent pour votre contrôleur de télescope. </para>

<para
>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. </para>

<para
>&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 <link linkend="indi-remote-control"
>Contrôle des périphériques distants</link
>. </para>

<para
>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 <menuchoice
><guimenu
>Périphériques</guimenu
> <guimenuitem
>Assistant de configuration de télescope</guimenuitem
></menuchoice
>. </para>

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

<orderedlist>
<listitem
><para
>Déterminez votre position géographique. Ouvrez la fenêtre <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Position géographique…</guimenuitem
></menuchoice
> ou en actionnant l'icône représentant un <guiicon
>Globe</guiicon
> dans la barre d'outils, ou en saisissant <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
>. </para>
</listitem>

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

<listitem>
<para
>cliquez sur le menu <menuchoice
><guimenu
>Périphériques</guimenu
> <guimenuitem
>Gestionnaire de périphériques…</guimenuitem
></menuchoice
> </para>
</listitem>

<listitem>
<para
>sous la colonne <guilabel
>Périphérique</guilabel
>, sélectionnez votre modèle de télescope. </para>
</listitem>

<listitem>
<para
>cliquez sur le bouton <guibutton
>Lancer le service</guibutton
>. </para>
</listitem>

<listitem>
<para
>cliquez sur le bouton <guibutton
>Fermer</guibutton
> pour fermer la boîte de dialogue du gestionnaire de matériel. </para>
</listitem>
</orderedlist>

<note id="geo-time-note">
<title
>Réglages fréquents</title>
<para
>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. </para
></note>

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

<orderedlist>
<title
>Contrôler votre télescope</title>
<listitem>
<para
><guilabel
>Contrôle de la carte du ciel</guilabel
> : pour chaque périphérique que vous lancez dans le <guilabel
>gestionnaire de périphériques</guilabel
>, 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 <command
>Pivoter</command
>, <command
>Synchroniser</command
> et <command
>Suivre</command
> directement depuis la carte du ciel. </para>

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

<screenshot>
<screeninfo
>Contrôle des périphériques depuis la carte du ciel</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="skymapdevice.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</listitem>

<listitem>
<para
><guilabel
>Panneau de contrôle INDI</guilabel
> : ce panneau de contrôle offre à l'utilisateur toutes les fonctions gérées par un périphérique. </para>

<para
>Le panneau est divisé en trois sections principales : </para>

<itemizedlist>
<listitem>
<para
><guilabel
>Onglets des périphériques</guilabel
> : 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. </para>
</listitem>

<listitem>
<para
>Affichage des propriétés dans les onglets <guilabel
>Contrôle principal</guilabel
> et <guilabel
>Options</guilabel
> : 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. </para>
</listitem>

<listitem>
<para
><guilabel
>Afficheur de journaux</guilabel
> : 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é. </para>
</listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Panneau de contrôle INDI</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="indicontrolpanel.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</listitem>
</orderedlist>

<para
>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 <guilabel
>Carte du ciel</guilabel
> sont reflétés automatiquement dans le <guilabel
>Panneau de contrôle INDI</guilabel
> et vice versa. </para>

<para
>Pour connecter votre télescope, vous pouvez soit sélectionner <guimenuitem
>Connecter</guimenuitem
> du menu contextuel des périphériques, soit actionner <guibutton
>Connecter</guibutton
> sous votre onglet de périphérique dans le <guilabel
>Panneau de contrôle INDI</guilabel
>. </para>

<important
><para
>Par défaut, &kstars; essayera de se connecter au port <constant
>/dev/ttyS0</constant
>. Pour changer le port de connexion, sélectionnez <menuchoice
><guimenu
>Outils</guimenu
> <guisubmenu
>Périphériques</guisubmenu
> <guimenuitem
>Panneau de contrôle INDI</guimenuitem
></menuchoice
> et changez le port sous l'onglet de votre périphérique. </para
></important>

<para
>&kstars; met à jour automatiquement la longitude, la latitude et l'heure basés sur les réglages actuels de &kstars;. Vous pouvez les activer/désactiver en utilisant la page <guilabel
>INDI</guilabel
> dans le menu <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer &kstars;</guimenuitem
></menuchoice
>. Dans la page <guilabel
>INDI</guilabel
>, 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 <guilabel
>De</guilabel
> et <guilabel
>À</guilabel
> de la section <guilabel
>Port du serveur</guilabel
>. </para>

<para
>Si &kstars; réussit à communiquer avec le télescope, il retrouvera l'<abbrev
>AD</abbrev
> et la <abbrev
>DEC</abbrev
> 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 <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer &kstars;…</guimenuitem
></menuchoice
>. </para>

<note id="indi-sync">
<title
>Synchronisation de votre télescope</title>
<para
>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 <mousebutton
>droit</mousebutton
> sur la carte du ciel et sélectionner <command
>Synchroniser</command
> 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. </para>
</note>

<para
>Voilà ! Votre télescope est prêt à explorer les cieux ! </para>

<warning>
<title
>AVERTISSEMENT</title>
<para
>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. </para>
</warning>
</sect1>

<sect1 id="indi-other-setup">
<title
>Configuration des acquisitions CCD et vidéo</title>
<indexterm
><primary
>Contrôle des CCD Vidéo</primary>
<secondary
>Configuration</secondary>
</indexterm>

<para
>Vous pouvez lancer les périphériques d'acquisition CCD et vidéo depuis le menu <menuchoice
><guimenu
>Périphériques</guimenu
> <guimenuitem
>Gestionnaire de périphériques</guimenuitem
></menuchoice
>. 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 <guimenuitem
>Panneau de contrôle INDI…</guimenuitem
>. </para>

<para
>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 <link linkend="tool-fitsviewer"
>l'afficheur FITS</link
> de &kstars;. </para>
</sect1>

<sect1 id="indi-configure">
<title
>Configurer INDI</title>
<indexterm
><primary
>Configurer</primary>
<secondary
>INDI</secondary>
</indexterm>

<para
>La page d'<guilabel
>INDI</guilabel
> vous permet de modifier les options spécifiques du <emphasis
>Côté client</emphasis
> d'INDI. Pour y accéder, sélectionnez <menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer &kstars;</guimenuitem
></menuchoice
> 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 :  </para>

<itemizedlist>
  <listitem
><para
><guilabel
>Général</guilabel
></para>
    <itemizedlist>
      <listitem
><para
><guilabel
>Serveur INDI</guilabel
> : indiquez l'exécutable du serveur INDI installé sur votre système. Par défaut, &kstars; utilise <quote
>/usr/bin/indiserver</quote
>.</para
></listitem>
      <listitem
><para
><guilabel
>Répertoire XML des pilotes INDI</guilabel
> : spécifie le répertoire &XML; sur votre système contenant les pilotes INDI. Par défaut &kstars; utilise le répertoire <quote
>/usr/share/indi</quote
>. </para
></listitem>
      <listitem
><para
><guilabel
>Répertoire FITS par défaut : </guilabel
> spécifie le dossier où toutes les images FITS seront enregistrées. S'il n'y a pas de répertoire spécifié, les images seront enregistrées dans <varname
>$HOME</varname
>.</para
></listitem>
    <!-- Telescope port & Video port:
      <listitem
><para
><option
>Telescope port:</option
> The default telescope port. When you connect to a local or remote telescope service, &kstars; will automatically fill the telescope's device port with the specified default port.</para
></listitem>
      <listitem
><para
><option
>Video port:</option
> The default video port. When you connect to a local or remote video service, &kstars; will automatically fill the webcam's device port with the specified default port.</para
></listitem
>	
    -->
    </itemizedlist>
  </listitem>
  <listitem
><para
><guilabel
>Synchronisation heure et position</guilabel
></para>
    <itemizedlist>
      <listitem
><para
><guilabel
>&kstars; synchronise tous les périphériques</guilabel
> : &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;.</para
></listitem>
      <listitem
><para
><guilabel
>La monture synchronise &kstars;</guilabel
> : 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.</para
></listitem>
      <listitem
><para
><guilabel
>Le GPS synchronise &kstars;</guilabel
> : 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.</para
></listitem>
      <listitem
><para
><guilabel
>Heure</guilabel
> : la date et l'heure de &kstars; est synchronisé automatiquement à partir de la source de synchronisation.</para
></listitem>
      <listitem
><para
><guilabel
>Position</guilabel
> : la position de &kstars; est synchronisée automatiquement à partir de la source de synchronisation.</para
></listitem>
    </itemizedlist>
  </listitem>
  <listitem
><para
><guilabel
>Affichage</guilabel
></para>
    <itemizedlist>
      <listitem
><para
><guilabel
>Réticule du télescope</guilabel
> : 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 <link linkend="viewops"
>Configuration de &kstars;</link
>. Sélectionnez l'onglet <guilabel
>Couleurs</guilabel
>, et changez la couleur de l'élément <guimenuitem
>Indicateur de cible</guimenuitem
> dans la couleur désirée.</para
></listitem>
      <listitem
><para
><guilabel
>Fenêtre indépendante</guilabel
> : rendre la fenêtre de l'<guilabel
>afficheur FITS</guilabel
> indépendante.</para
></listitem>
      <listitem
><para
><guilabel
>Notifications des messages</guilabel
> : montrer les messages d'INDI comme des notifications du bureau plutôt que dans des boîtes de dialogue.</para
></listitem>
    </itemizedlist>
  </listitem>
<!--
  <listitem
><para
>Update Source: Synchronize &kstars; according to either the
    computer or device time and location settings.</para>
  </listitem>
  <listitem
><para
>Filter Wheel: Assign color codes to the filter wheel slots (&eg; Slot #0 Red, Slot #1 Blue, &etc;) You can assign color codes for up to 10 filter slots (0 to 9). To assign a color code, select a slot number from the drop down combo box, and then type the corresponding color code in the edit field. Repeat the process for all desired slots and then press OK.</para>
  </listitem>
-->
  <listitem
><para
><guilabel
>Port du serveur</guilabel
></para>
    <itemizedlist>
      <listitem
><para
>Spécifiez une plage de ports que le serveur INDI puisse utiliser lors du démarrage de nouveaux pilotes.</para
></listitem>
    </itemizedlist>
  </listitem>
</itemizedlist>

</sect1>

<sect1 id="indi-concepts">
<title
>Concepts INDI</title>
<indexterm
><primary
>Contrôle de télescope</primary>
<secondary
>Concepts</secondary>
</indexterm>

<para
>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 <emphasis
>périphériques</emphasis
> peuvent contenir une ou plusieurs <emphasis
>propriétés</emphasis
>. Toute <emphasis
>propriété</emphasis
> peut contenir un ou plusieurs <emphasis
>éléments</emphasis
>. Il y a quatre types de propriétés INDI : </para>
<itemizedlist>
<listitem
><para
>Propriétés de texte.</para
></listitem>
<listitem
><para
>Propriété de nombre.</para
></listitem>
<listitem
><para
>Propriété d'activation (représenté dans l'interface graphique par des boutons et des cases à cocher).</para
></listitem>
<listitem
><para
>Propriétés de lumière (représenté dans l'interface graphique par des LED colorées).</para
></listitem>
</itemizedlist>

<para
>Par exemple, tous les périphériques INDI partagent la <emphasis
>propriété</emphasis
> 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. </para>

<para
>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. </para>

<itemizedlist>
<listitem>
<para
>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. </para>
</listitem>
<listitem>
<para
>É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é : </para>
<table frame="top"
><title
>Code de couleur d'état INDI</title>
<tgroup cols="3" colsep="1" rowsep="1">
<thead>
<row>
<entry
>État</entry>
<entry
>Couleur</entry>
<entry
>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry
>En attente</entry>
<entry
>Gris</entry>
<entry
>Le périphérique ne réalise pas d'action respectant cette propriété</entry>
</row>
<row>
<entry
>Ok</entry>
<entry
>Vert</entry>
<entry
>La dernière opération effectuée sur cette propriété a réussi et est active.</entry>
</row>
<row>
<entry
>Occupé</entry>
<entry
>Jaune</entry>
<entry
>La propriété effectue une action</entry>
</row>
<row>
<entry
>Alerte</entry>
<entry
>Rouge</entry>
<entry
>La propriété est dans un état critique et a besoin d'une attention immédiate</entry>
	</row>
	</tbody>
</tgroup>
</table>

<para
>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 <guilabel
>Occupé</guilabel
>. Quand le processus de déplacement oblique est terminé avec succès, les propriétés seront signalées comme <guilabel
>Ok</guilabel
>. </para>
</listitem>
<listitem>
<para
>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 : </para>
<itemizedlist>
<listitem
><para
>-156,40</para
></listitem>
<listitem
><para
>-156:24:00</para
></listitem>
<listitem
><para
>-156:24</para
></listitem>
</itemizedlist>
</listitem>
<listitem>
<para
>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 <guilabel
>INDI</guilabel
> de la boîte de dialogue de configuration. </para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="indi-remote-control">
<title
>Contrôle de périphériques à distance</title>
<indexterm
><primary
>Contrôle de télescope</primary>
<secondary
>Périphériques distants</secondary>
</indexterm>

<para
>&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 <ulink url="https://www.clearskyinstitute.com/INDI/INDI.pdf"
>l'article</ulink
> sur INDI. </para>

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

<orderedlist>
<listitem>
<para
><guilabel
>Serveur</guilabel
> : pour préparer un matériel pour le contrôle distant, suivez les mêmes étapes que dans le réglage <link linkend="indi-kstars-setup"
>local/serveur</link
>. Lorsque vous lancez un service de matériel dans le <guilabel
>gestionnaire de périphériques</guilabel
>, un numéro de port s'affiche sous la colonne <guilabel
>Port d'écoute</guilabel
>. En plus du numéro de port, vous avez aussi besoin du nom d'hôte ou adresse IP de votre serveur. </para>

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

<screenshot>
<screeninfo
>Client INDI</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="indiclient.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>Après que vous aurez ajouté un hôte, cliquez avec le bouton droit sur l'hôte à <guimenuitem
>connecter</guimenuitem
> ou <guimenuitem
>déconnecter</guimenuitem
>. Si une connexion est établie, vous pouvez contrôler le télescope depuis la <guilabel
>Carte du ciel</guilabel
> ou le <guilabel
>panneau de contrôle INDI</guilabel
> exactement comme décrit dans la section <link linkend="indi-kstars-setup"
>local/serveur</link
>. C'est aussi facile que ça. </para>

<sect2 id="indi-commandline">
<title
>Lancement d'un serveur INDI depuis la ligne de commande</title>
<para
>Comme &kstars; vous permet de déployer un serveur INDI, vous pouvez lancer un serveur INDI depuis la ligne de commande. </para>

<para
>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 écrivent dans un journal les messages dans <constant
>stderr</constant
>. Cela peut être utile pour les situations de recherche d'erreur. La syntaxe pour le serveur INDI est la suivante : </para>

<para
>$ <command
>indiserver</command
> [options] driver [<filename
>driver</filename
>…] </para>

<para
><screen
>Options:
 -l d     : Log driver messages to &lt;d&gt;/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]
</screen
></para>

<para
>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 : </para>

<para
>$ <command
>indiserver</command
> -p 8000 <filename
>LX200GPS</filename
></para>
</sect2>

<sect2 id="indi-secure-remote">
<title
>Sécurisation des opérations distantes</title>

<para
>Supposons que nous voulions lancer un indiserver avec les pilotes INDI sur une machine distante, <constant
>machine-distante</constant
>, et les connecter à &kstars; qui fonctionne sur la machine locale. </para>

<para
>Depuis la machine locale, connectez-vous sur la machine distante <constant
>machine-distante</constant
> en saisissant : </para>

<para
>$ <command
>ssh</command
> -L <varname
>local-port</varname
> : <constant
>remote-host</constant
> : <varname
>remote-port</varname
></para>

<para
>Ceci lie le <varname
>local-port</varname
> de la machine locale au <varname
>remote-port</varname
> du <constant
>remote-host</constant
>. Après connexion, exécutez indiserver sur la machine distante : </para>

<para
>$ <command
>indiserver</command
> -p <varname
>remote-port</varname
> [<filename
>driver</filename
>…]</para>

<para
>De retour sur la machine locale, lancez &kstars;, puis ouvrez le <guimenuitem
>Gestionnaire de périphériques</guimenuitem
> et ajoutez un hôte sous l'onglet <guilabel
>Client</guilabel
>. L'hôte doit être localhost (habituellement 127.0.0.1) et le numéro de port doit être le <varname
>local-port</varname
> utilisé dans les étapes ci-dessus. Cliquez avec le bouton <mousebutton
>droit</mousebutton
> sur l'hôte et sélectionnez <guimenuitem
>Connecter</guimenuitem
> 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.</para>
</sect2>
</sect1>

<sect1 id="indi-faq">
<title
>Foire aux questions d'INDI</title>
<indexterm
><primary
>Contrôle de télescope</primary>
<secondary
>&FAQ;</secondary>
</indexterm>

<qandaset defaultlabel="qanda">
<qandaentry>
<question id="what-is-indi">
<para
>Qu'est qu'INDI ?</para>
</question>
<answer>
<para
><acronym
>INDI</acronym
> est le protocole de contrôle <ulink url="http://indi.sourceforge.net"
>Instrument-Neutral-Distributed-Interface</ulink
> développé par <author
><firstname
>Elwood</firstname
><surname
>C. Downey</surname
></author
> du <ulink url="http://www.clearskyinstitute.com/"
>ClearSky Institute</ulink
>. &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. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Comptez-vous gérer plus de périphériques ? </para>
</question>
<answer>
<para
>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 à <email
>indi-devel@lists.sourceforge.net</email
> </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Quelles opérations &kstars; fournit-il pour contrôler le télescope ? </para>
</question>
<answer>
<para
>Cela dépend du télescope que vous utilisez, mais les trois opérations minimales sont : <command
>Pivoter</command
>, <command
>Suivre</command
> et <command
>Synchroniser</command
>, 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 <menuchoice
><guimenu
>Outils</guimenu
> <guisubmenu
>Périphériques</guisubmenu
> <guimenuitem
>Panneau de contrôle INDI…</guimenuitem
></menuchoice
>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Quelle est exactement la différence entre <command
>Pivoter</command
>, <command
>Suivre</command
> et <command
>Synchroniser</command
> ? </para>
</question>
<answer>
<para
>La commande <command
>Pivoter</command
> 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 <emphasis
>sidérale</emphasis
> (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 <command
>Suivre</command
> les objets comme ils bougent. </para>
<para
>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, <command
>Synchroniser</command
> sert à synchroniser les coordonnées internes du télescope avec un objet que vous sélectionnez. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Puis-je contrôler mon télescope à distance ? </para>
</question>
<answer>
<para
>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 <link linkend="indi-remote-control"
>Contrôle de périphérique distant</link
>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Lorsque j'essaye de <guibutton
>connecter</guibutton
>, &kstars; rapporte que le télescope n'est pas connecté au port série/USB. Que puis-je faire ? </para>
</question>
<answer>
<para
>Ce message est déclenché lorsque &kstars; ne peut pas communiquer avec le télescope. Voici quelques manipulations que vous pouvez effectuer :</para>

   <orderedlist>
   <listitem>
<para
>vérifiez que vous avez à la fois les droits en lecture et en écriture pour le port auquel vous essayez de vous connecter.</para>
   </listitem>
   <listitem>
<para
>vérifiez la connexion du câble et assurez-vous qu'il est en bon état et testez-le avec d'autres applications.</para>
   </listitem>
   <listitem>
<para
>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.</para>
   </listitem>
   <listitem>
<para
>Sélectionner le menu <menuchoice
><guimenu
>Outils</guimenu
> <guisubmenu
>Périphériques</guisubmenu
> <guimenuitem
>Panneau de contrôle INDI…</guimenuitem
></menuchoice
>. Le périphérique par défaut est <constant
>/dev/ttyS0</constant
>.</para>
   </listitem>
   <listitem>
   <para
>Redémarrez &kstars; et réessayez.</para>
   </listitem>
   </orderedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>&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 ?</para>
</question>
<answer>
<para
>&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 <link linkend="indi-sync"
>synchroniser</link
> 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. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Le télescope se déplace d'une manière erratique ou pas du tout. Que puis-je faire ?</para>
</question>
<answer>
<para
>Ce comportement est la plupart du temps dû à des réglages incorrects. Veuillez vérifier la liste suivante :</para>
<orderedlist>
<listitem>
<para
>Le télescope est-il aligné ?</para>
</listitem>
<listitem>
<para
>Le mode d'alignement du télescope est-il correct ? Utilisez le <guilabel
>panneau de contrôle INDI</guilabel
> pour le vérifier et changez ces réglages (<constant
>Alt/Az, Polar, Land</constant
>). </para>
</listitem>
<listitem>
<para
>Les réglages d'heure et date du télescope sont-ils corrects ?</para>
</listitem>
<listitem>
<para
>Les réglages de latitude et de longitude du télescope sont-ils corrects ?</para>
</listitem>
<listitem>
<para
>Le calage UTC du télescope est-il correct ?</para>
</listitem>
<listitem>
<para
>Les axes d'AD et de DEC du télescope sont-ils bien verrouillés ?</para>
</listitem>
<listitem>
<para
>Le réglage d'inverseur N/S de télescope (lorsque applicable) est-il correctement effectué pour votre hémisphère ?</para>
</listitem>
<listitem>
<para
>Le câble entre le télescope et l'ordinateur est-il en bon état ?</para>
</listitem>
</orderedlist>

<para
>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 à <email
>indi-devel@lists.sourceforge.net</email
>. </para>
</answer>
</qandaentry>
</qandaset>
</sect1>
</chapter>

