<chapter id="indi">
<title
>Control de dispositivos astronómicos con <acronym
>INDI</acronym
></title>
<indexterm
><primary
>Control INDI</primary>
<secondary
>Introducción</secondary>
</indexterm>

<para
>KStars proporciona una interfaz para configurar y controlar instrumentos astronómicos mediante el protocolo <acronym
><link linkend="what-is-indi"
>INDI</link
></acronym
>.</para>

<para
>El protocolo <acronym
>INDI</acronym
> funciona con diversos instrumentos astronómicos, como cámaras CCD y enfocadores. En la actualidad, KStars permite trabajar con los siguientes dispositivos:</para>

<table id="device-table" pgwide="1" frame="all">
<title
>Telescopios permitidos</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Telescopio</entry>
<entry
>Controlador de dispositivo</entry>
</row>
</thead>
<tbody>
<row>
<entry
>LX200 8"-12" Classic</entry>
<entry
>indi_lx200classic</entry>
</row>
<row>
<entry
>Telescopios basados en Autostar</entry>
<entry
>indi_lx200autostar</entry>
</row>
<row>
<entry
>LX200 GPS 8"-16"</entry>
<entry
>indi_lx200gps</entry>
</row>
<row>
<entry
>LX200 Classic 16"</entry>
<entry
>indi_lx200_16</entry>
</row>
<row>
<entry
>NexStar GPS, CGE, AS-GT</entry>
<entry
>indi_celestrongps</entry>
</row>
<row>
<entry
>New GT, NexStar 5i/8i</entry>
<entry
>indi_celestrongps</entry>
</row>
<row>
<entry
>Takahashi Temma</entry>
<entry
>indi_temma</entry>
</row>
<row>
<entry
>Astro-Electronic FS-2</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>Argo Navis</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>Losmandy Gemini</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>Mel Bartels Controllers</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>Sky Commander</entry>
<entry
>indi_skycommander</entry>
</row>
<row>
<entry
>Intelliscope/SkyWizard</entry>
<entry
>indi_intelliscope</entry>
</row>
<row>
<entry
>Orion Atlas</entry>
<entry
>indi_orion_atlas</entry>
</row>
</tbody>
</tgroup>
</table>
<table id="focuser-table" pgwide="1" frame="all">
<title
>Enfocadores permitidos</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Enfocador</entry>
<entry
>Controlador de dispositivo</entry>
</row>
</thead>
<tbody>
<row>
<entry
>Meade LX200GPS Microfocuser</entry>
<entry
>indi_lx200gps</entry>
</row>
<row>
<entry
>Meade 1206 Primary Mirror Focuser</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>JMI NGF Series</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>JMI MOTOFOCUS</entry>
<entry
>indi_lx200basic</entry>
</row>
<row>
<entry
>FLI Precision Focuser</entry>
<entry
>indi_fli_pdf</entry>
</row>
<row>
<entry
>RoboFocus</entry>
<entry
>indi_robofocus</entry>
</row>
</tbody>
</tgroup>
</table>

<table id="ccd-table" pgwide="1" frame="all">
<title
>CCD permitidas</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>CCD</entry>
<entry
>Controlador de dispositivo</entry>
</row>
</thead>
<tbody>
<row>
<entry
>Finger Lakes Instruments CCDs</entry>
<entry
>indi_fli_ccd</entry>
</row>
<row>
<entry
>Santa Barbara Instrument CCDs</entry>
<entry
>indi_sbig_ccd</entry>
</row>
<row>
<entry
>Apogee CCDs</entry>
<entry
>indi_apogee_alta</entry>
</row>
</tbody>
</tgroup>
</table>

<table id="filter-table" pgwide="1" frame="all">
  <title
>Ruedas portafiltros permitidas</title>
  <tgroup cols="2" colsep="1" rowsep="1">
    <thead>
      <row>
	<entry
>Rueda portafiltros</entry>
	<entry
>Controlador de dispositivo</entry>
      </row>
    </thead>
    <tbody>
      <row>
	<entry
>Ruedas portafiltros FLI</entry>
	<entry
>indi_fli_wheel</entry>
      </row>
      <row>
	<entry
>True Technology Wheel</entry>
	<entry
>indi_trutech_wheel</entry>
      </row>

    </tbody>
  </tgroup>
  </table>
  
<table id="video-table" pgwide="1" frame="all">
<title
>Webcams permitidas</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Webcam</entry>
<entry
>Controlador de dispositivo</entry>
</row>
</thead>
<tbody>
<row>
<entry
>Cualquier dispositivo compatible con Video4Linux</entry>
<entry
>indi_v4l_generic</entry>
</row>
<row>
<entry
>Webcam Philips</entry>
<entry
>indi_v4l_philips</entry>
</row>
<row>
<entry
>Meade Lunar Planetary Imager</entry>
<entry
>indi_meade_lpi</entry>
</row>
<row>
<entry
>SBIG STV</entry>
<entry
>indi_sbig_stv</entry>
</row>
</tbody>
</tgroup>
</table>

<sect1 id="indi-kstars-setup">
<title
>Configuración de INDI</title>
<indexterm
><primary
>INDI</primary>
<secondary
>Configuración</secondary>
</indexterm>
<para
>KStars puede controlar dispositivos locales y remotos de forma independiente mediante la arquitectura servidor/cliente <link linkend="what-is-indi"
>INDI</link
>. Los dispositivos INDI pueden funcionar en tres modos distintos:</para>

<orderedlist>
<listitem
><para
>Local: el modo local es el más común y se utiliza para controlar dispositivos locales (&ie; un dispositivo conectado a su máquina).</para
></listitem>
<listitem
><para
>Servidor: el modo servidor proporciona un servidor INDI para un dispositivo particular y espera conexiones provenientes de clientes remotos. No es posible operar dispositivos servidores; sólo podrá iniciarlos y detenerlos.</para
></listitem>
<listitem
><para
>Cliente: el modo cliente se usa para conectar a servidores INDI remotos que están ejecutando dispositivos INDI. No es posible controlar independientemente dispositivos remotos como si se tratara de dispositivos locales.</para
></listitem>
</orderedlist>

<para
>Puede ejecutar un dispositivo local, proporcionar servidores INDI y conectar con clientes remotos desde el <guimenuitem
>Gestor de dispositivos</guimenuitem
> en el menú <guimenu
>Dispositivos</guimenu
>.</para>

<para
>A continuación se muestra una captura de la ventana del <guilabel
>Gestor de dispositivos</guilabel
>:</para>

<screenshot>
<screeninfo
>Ejecución de controladores de dispositivos</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="devicemanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Iniciar controladores de dispositivos</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Puede iniciar dispositivos examinando el árbol de dispositivos, seleccionando un dispositivo y pulsando a continuación el botón <guibutton
>Ejecutar servicio</guibutton
>. Puede seleccionar el modo de operación, que puede ser local o servidor, tal y como se definió anteriormente.</para>

<para
>Para controlar dispositivos remotos, consulte la sección <link linkend="indi-remote-control"
>control de dispositivos remotos</link
>.</para>
</sect1>

<sect1 id="indi-telescope-setup">
<title
>Configuración del telescopio</title>
<indexterm
><primary
>INDI</primary>
<secondary
>Configuración</secondary>
</indexterm>

<para
>La mayor parte de los telescopios están equipados con una interfaz <hardware
>RS232</hardware
> para ser controlados a distancia. Conecte la clavija RS232 de su telescopio a un puerto <hardware
>serie/USB</hardware
> de su equipo. Tradicionalmente, la clavija RS232 se conectaba a un puerto serie de su equipo, pero como muchos nuevos portátiles abandonaron el puerto serie en beneficio de los puertos <hardware
>USB/FireWire</hardware
>, tal vez necesite obtener un adaptador serie a USB para poder usarlo con los nuevos portátiles.</para>

<para
>Tras conectar su telescopio al puerto serie/USB, encienda el telescopio. Se le recomienda <emphasis
>encarecidamente</emphasis
> que descargue e instale el último firmware para el controlador de su telescopio.</para>

<para
>El telescopio necesita estar alineado antes de poder usarlo correctamente. Alinee el telescopio (alineación con una o dos estrellas) siguiendo el modo descrito en su manual.</para>

<para
>&kstars; necesita verificar las preferencias de hora y posición antes de conectar con el telescopio. Esto asegura un correcto seguimiento y la sincronización entre el telescopio y &kstars;. Los siguientes pasos le permitirán conectar con un dispositivo controlado por su equipo. Para conectar y controlar dispositivos remotos, consulte la sección <link linkend="indi-remote-control"
>control de dispositivos remotos</link
>.</para>

<para
>Puede usar el asistente de configuración del telescopio para verificar toda la información necesaria para este proceso. Este asistente buscará telescopios conectados a cualquier puerto. Puede lanzar el asistente seleccionando <guimenuitem
>Asistente de configuración del telescopio</guimenuitem
> en el menú <guimenu
>Dispositivos</guimenu
>.</para>

<para
>De forma alternativa, puede conectar con un telescopio local realizando los siguientes pasos:</para>

<orderedlist>
<listitem
><para
>Fije su posición geográfica. Abra la ventana <guilabel
>Geográfica...</guilabel
> seleccionando <guimenuitem
>Configurar posición geográfica...</guimenuitem
> en el menú <guimenu
>Preferencias</guimenu
> o pulsando el icono del <guiicon
>globo</guiicon
> que hay en la barra de herramientas; también puede pulsar <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
>.</para>
</listitem>
<listitem
><para
>Fije su fecha y hora local. Puede cambiar a cualquier fecha u hora seleccionando <guimenuitem
>Establecer tiempo...</guimenuitem
> en el menú <guimenu
>Tiempo</guimenu
> o pulsando el botón <guiicon
>Tiempo</guiicon
> que hay en la barra de herramientas. La ventana <guilabel
>Establecer la fecha y la hora</guilabel
> usa un selector de fechas estándar de &kde; junto a tres campos incrementales para fijar las horas, minutos y segundos. Si alguna vez necesita restablecer el tiempo a la hora actual, seleccione <guimenuitem
>Establecer tiempo a ahora</guimenuitem
> en el menú <guimenu
>Tiempo</guimenu
>.</para>
</listitem>
<listitem>
<para
>Pulse sobre el menú <guimenu
>Dispositivos</guimenu
> y seleccione el <guimenuitem
>Gestor de dispositivos</guimenuitem
>.</para>
</listitem>
<listitem>
<para
>Seleccione su modelo de telescopio en la columna <guilabel
>Dispositivo</guilabel
>.</para>
</listitem>
<listitem>
<para
>Haga clic con el botón <mousebutton
>derecho</mousebutton
> del ratón en el dispositivo y seleccione <guilabel
>Ejecutar servicio</guilabel
>.</para>
</listitem>
<listitem>
<para
>Pulse <guibutton
>Aceptar</guibutton
> para cerrar el diálogo del gestor de dispositivos.</para>
</listitem>
</orderedlist>

<note id="geo-time-note">
<title
>Preferencias frecuentes</title>
<para
>No necesita establecer la posición geográfica y la hora cada vez que conecte un telescopio. Ajuste únicamente las preferencias que necesite.</para
></note>

<para
>Ahora está preparado para usar las funciones del dispositivo. &kstars; proporciona dos interfaces de usuario intercambiables para controlar telescopios:</para>

<orderedlist>
<title
>Control del telescopio</title>
<listitem>
<para
><guilabel
>Control del mapa del cielo</guilabel
>: Para cada dispositivo que ejecute en el <guilabel
>Gestor de dispositivos</guilabel
> se mostrará una entrada correspondiente en el menú emergente que le permitirá controlar las propiedades del dispositivo. Puede lanzar órdenes como <command
>Slew, Sync</command
> y <command
>Track</command
> directamente desde el mapa del cielo. </para>
<para
>Esta es una captura del menú emergente con un dispositivo LX200 Classic activo:</para>
<screenshot>
<screeninfo
>Control de dispositivos desde el mapa del cielo</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="skymapdevice.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</listitem>

<listitem>
<para
><guilabel
>Panel de control INDI</guilabel
>: este panel proporciona al usuario todas las funciones permitidas por un dispositivo. </para>

<para
>El panel está dividido en tres secciones principales:</para>
<itemizedlist>
<listitem>
<para
><guilabel
>Pestañas del dispositivo</guilabel
>: cada dispositivo activo adicional ocupa una pestaña en el panel INDI. Se pueden ejecutar múltiples dispositivos de forma simultánea sin afectar la operación del resto de dispositivos. </para>
</listitem>
<listitem>
<para
><guilabel
>Vista de propiedades</guilabel
>: Las propiedades son los elementos clave en la arquitectura INDI. Cada dispositivo define una serie de propiedades para comunicarse con el cliente. La posición actual del telescopio es un ejemplo de propiedad. Las propiedades semánticamente similares están contenidas normalmente en bloques lógicos o agrupaciones. </para>
</listitem>
<listitem>
<para
><guilabel
>Visores de registros</guilabel
>: Los dispositivos informan de su estado y de las órdenes reconocidas enviando mensajes INDI. Cada dispositivo posee su propio visor de registro, y todos los dispositivos comparten un visor de registro general. Normalmente, un dispositivo envía mensajes únicamente a su propio controlador de dispositivo, aunque también se le permite enviar un mensaje general cuando resulta conveniente. </para>
</listitem>
</itemizedlist>
<screenshot>
<screeninfo
>Panel de control INDI</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="indicontrolpanel.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</listitem>
</orderedlist>

<para
>No está limitado a usar una interfaz en lugar de otra, ya que es posible usar ambas simultáneamente. Las acciones del <guilabel
>mapa del cielo</guilabel
> se reflejan automáticamente en el <guilabel
>Panel de control de INDI</guilabel
> y viceversa.</para>

<para
>Para conectar su telescopio puede seleccionar <guimenuitem
>Conectar</guimenuitem
> en el menú emergente de su dispositivo, o bien pulsar el botón <guibutton
>Conectar</guibutton
> que encontrará en la pestaña de su dispositivo en el <guilabel
>Panel de control de INDI</guilabel
>.</para>

<important
><para
>De forma predeterminada, KStars intentará conectar con el puerto <constant
>/dev/ttyS0</constant
>. Para cambiar el puerto de conexión, seleccione <guilabel
>Panel de control INDI</guilabel
> en el menú <guimenu
>Dispositivos</guimenu
> y cambie el puerto en la pestaña del correspondiente dispositivo.</para
></important>

<para
>&kstars; actualiza automáticamente la longitud, latitud y hora de su telescopio según las preferencias actuales de &kstars;. Puede activar o desactivar estas actualizaciones en el diálogo <guimenuitem
>Configurar INDI</guimenuitem
> del menú <guimenu
>Dispositivos</guimenu
>. </para>

<para
>Si &kstars; consigue comunicarse con éxito con el telescopio, obtendrá la <abbrev
>AR</abbrev
> y la <abbrev
>DEC</abbrev
> del mismo y mostrará una cruceta en el mapa del cielo para indicar la posición del telescopio.</para>

<note id="indi-sync">
<title
>Sincronización del telescopio</title>
<para
>Si ya alineó su telescopio y la última estrella usada para la alineación fue, por ejemplo, Vega, la cruceta debería estar centrada en Vega. Si la cruceta está fuera del objetivo, puede pulsar sobre Vega en el mapa con el botón <mousebutton
>derecho</mousebutton
> del ratón y seleccionar <command
>Sync</command
> en el menú de su telescopio. Esta acción indicará al telescopio que sincronice sus coordenadas internas para que coincidan con las de Vega, con lo que la cruceta del telescopio debería aparecer ahora centrada en Vega. </para>
</note>

<para
>Ya está: su telescopio está preparado para explorar los cielos.</para>

<warning>
<title
>ADVERTENCIA</title>
<para
>Nunca use el telescopio para mirar al Sol. Mirar al Sol puede causar daños irreversibles en sus ojos y en su equipo.</para>
</warning>
</sect1>

<sect1 id="indi-other-setup">
<title
>Configuración de CCD y de captura de vídeo</title>
<indexterm
><primary
>Control de vídeo CCD</primary>
<secondary
>Configuración</secondary>
</indexterm>

<para
>Los siguientes dispositivos de imagen funcionan con KStars:</para>
<itemizedlist>
  <listitem
><para
>Finger Lakes instruments CCDs</para
></listitem>
  <listitem
><para
>CCD SBIG: Para poder usar una CCD SBIG debe descargar e instalar la biblioteca del controlador SBIG universal disponible en el sitio web de <ulink url="http://indi.sourceforge.net"
>INDI</ulink
>.</para
></listitem>
  <listitem
><para
>CCD Apogee: Solo se admiten las versiones USB. Debe tener instalado «libusb».</para
></listitem>
  <listitem
><para
>Dispositivos compatibles con <ulink url="http://www.exploits.org/v4l/"
>Video4Linux</ulink
>. También se permiten las funciones extendidas de la webcam Philips.</para
></listitem>
</itemizedlist>

<para
>Puede ejecutar dispositivos CCD y de captura de vídeo desde <guimenuitem
>Gestor de dispositivos</guimenuitem
>, en el menú <guimenu
>Dispositivos</guimenu
>. Al igual que todos los dispositivos INDI, podrá acceder a algunos de los controles de los dispositivos desde el mapa del cielo. El dispositivo se puede controlar totalmente desde el <guimenuitem
>Panel de control INDI</guimenuitem
>.</para>

<para
>FITS es el formato estándar de las capturas de imagen. Una vez que se ha capturado y descargado una imagen, esta será mostrada automáticamente por el <link linkend="tool-fitsviewer"
>visor FITS</link
> de KStars. Para capturar una secuencia de imágenes, utilice la herramienta <guimenuitem
>Capturar secuencia de imágenes</guimenuitem
> en el menú <guimenu
>Dispositivos</guimenu
>. Esta herramienta estará inactiva hasta que realice una conexión con un dispositivo de obtención de imágenes.</para>

<important>
<para
>Los controladores «fli» y «apogee» necesitan permisos de usuario «root» para funcionar correctamente. Tenga en cuenta que ejecutar un controlador como usuario «root» se considera un riesgo para la seguridad de su sistema.</para>
</important>
</sect1>

<sect1 id="indi-capture">
<title
>Capturar secuencias de imágenes</title>
<indexterm
><primary
>Capturar</primary>
<secondary
>Imagen</secondary>
</indexterm>

<para
>La herramienta para capturar secuencias de imágenes se puede utilizar para obtener imágenes de cámaras y CCD en modo interactivo o por lotes. Además, puede seleccionar qué filtro, si existe alguno, desea usar para capturar las imágenes. La herramienta de captura estará desactivada hasta que establezca una conexión con un dispositivo de captura.</para
> 

<screenshot>
<screeninfo
>Capturar secuencia de imágenes</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="indicapture.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>La instantánea anterior ilustra un ejemplo de sesión de captura. La herramienta proporciona las siguientes opciones:</para>
<itemizedlist>
  <listitem
><para
>Cámara/CCD</para>
     <itemizedlist>
         <listitem
><para
><option
>Dispositivo:</option
> El dispositivo de imagen deseado.</para
></listitem>
         <listitem
><para
><option
>Prefijo:</option
> El prefijo por el que comenzará cada nombre de archivo de la imagen capturada.</para
></listitem>
         <listitem
><para
><option
>Exposición:</option
> El número de segundos de exposición de cada captura.</para
></listitem>
         <listitem
><para
><option
>Contador:</option
> El número de imágenes a capturar.</para
></listitem>
         <listitem
><para
><option
>Demora:</option
> El intervalo de demora en segundos entre imágenes consecutivas.</para
></listitem>
         <listitem
><para
><option
>Marca de tiempo ISO 8601</option
>: Añade marcas de tiempo ISO 8601 a los nombres de archivos (p. ej., «image_01_20050427T09:48:05).</para
></listitem>
     </itemizedlist>
    </listitem>
   <listitem
><para
>Filtro</para>
      <itemizedlist>
          <listitem
><para
><option
>Dispositivo:</option
> El dispositivo de filtro deseado.</para
></listitem>
          <listitem
><para
><option
>Filtro:</option
> La ranura del filtro deseada. Puede asignar valores de color a los números de ranura desde la ventana <link linkend="indi-configure"
>Configurar INDI</link
> (por ejemplo, ranura #1 = rojo, ranura #2 = azul, etc.).</para
></listitem
>          
       </itemizedlist>
   </listitem>
</itemizedlist>

<para
>Tras rellenar las opciones deseadas podrá comenzar el proceso de captura pulsando el botón <guibutton
>Iniciar</guibutton
>. Puede cancelar en cualquier momento con el botón <guibutton
>Detener</guibutton
>. Todas las imágenes capturadas se guardarán en la carpeta por omisión de FITS, que se puede especificar en la ventana <link linkend="indi-configure"
>Configurar INDI</link
>.</para>

<para
>Si necesita cumplir otros requisitos y condiciones más complejas para realizar la captura se le recomienda que cree un guión para satisfacer sus necesidades usando la herramienta <link linkend="tool-scriptbuilder"
>Constructor de guiones</link
> en el menú <guimenu
>Herramientas</guimenu
>.</para>
</sect1>

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

<para
>La ventana de configuración INDI le permite modificar opciones específicas de INDI en la <emphasis
>parte cliente</emphasis
>. La ventana se divide en cuatro categorías principales: «General», «Actualizaciones automáticas del dispositivo», «Pantalla» y «Rueda de filtros»:</para>

 <itemizedlist>
   <listitem
><para
>General</para>
      <itemizedlist>
         <listitem
><para
><option
>Carpeta FITS por omisión:</option
> Especifica la carpeta donde se guardarán las imágenes FITS capturadas. Si no se especifica ninguna, las imágenes se guardarán en $HOME.</para
></listitem>
         <listitem
><para
><option
>Mostrar FITS automáticamente tras capturar:</option
> Si está marcado, KStars mostrará la imagen FITS capturada en la herramienta <link linkend="tool-fitsviewer"
>visor FITS</link
>. Si usa la herramienta <link linkend="indi-capture"
>capturar secuencia de imágenes</link
>, todas las imágenes capturadas se guardarán en disco independientemente de esta opción.</para
></listitem>
         <listitem
><para
><option
>Puerto del telescopio:</option
> El puerto por omisión del telescopio. Cuando conecte con un servicio de telescopio local o remoto, KStars rellenará de forma automática el puerto de dispositivo del telescopio con el puerto por omisión especificado.</para
></listitem>
         <listitem
><para
><option
>Puerto de vídeo:</option
> El puerto de vídeo por omisión. Cuando conecte con un servicio de vídeo local o remoto, KStars rellenará de forma automática el puerto de dispositivo de la webcam con el puerto por omisión especificado.</para
></listitem>
      </itemizedlist>
   </listitem>
   <listitem
><para
>Actualizaciones automáticas del dispositivo</para>
    <itemizedlist>
       <listitem
><para
><option
>Tiempo:</option
> Actualiza la fecha y hora del telescopio, si está permitido, tras la conexión.</para
></listitem>
       <listitem
><para
><option
>Posición geográfica:</option
> Actualiza la información sobre la posición geográfica del telescopio (la longitud y latitud actuales), si está permitido, tras la conexión.</para
></listitem>
    </itemizedlist>
   </listitem>
   <listitem
><para
>Pantalla</para>
    <itemizedlist>
     <listitem
><para
><option
>Cruceta del dispositivo de destino:</option
> Cuando está marcada, KStars muestra la cruceta del objetivo del telescopio en el mapa del cielo. La cruceta se muestra tras una conexión exitosa con el telescopio, y su posición se actualiza periódicamente. El nombre del telescopio se muestra junto a la cruceta. KStars muestra una cruceta por cada telescopio conectado. Para cambiar el color de la cruceta del telescopio, abra la ventana <link linkend="viewops"
>Configurar KStars</link
>. Seleccione la sección <guilabel
>Colores</guilabel
> y cambie a continuación el color del elemento <emphasis
>indicador de objetivo</emphasis
>.</para
></listitem>
     <listitem
><para
><option
>Mensajes de INDI en la barra de estado:</option
> Cuando está marcado, KStars muestra mensajes de estado INDI en la barra de estado de KStars.</para
></listitem>
    </itemizedlist>
   </listitem>
  <listitem
><para
>Rueda de filtros: Asigna códigos de color a las ranuras de la rueda de filtros (por ejemplo, ranura #0 a rojo, ranura #1 a azul, etc.). Puede asignar códigos de color hasta a 10 ranuras de filtros (desde la 0 hasta la 9). Para asignar un código de color, seleccione un número de ranura en la lista desplegable y luego introduzca el correspondiente código de color en el campo de edición. Repita el proceso para todas las ranuras necesarias y luego pulse «Aceptar».</para>
  </listitem>
  </itemizedlist>

</sect1>

<sect1 id="indi-concepts">
<title
>Conceptos INDI</title>
<indexterm
><primary
>Control del telescopio</primary>
<secondary
>Conceptos</secondary>
</indexterm>

<para
>El concepto clave principal de INDI es que los dispositivos tienen la capacidad de describirse a sí mismos. Esto se consigue usando XML para describir una jerarquía general que puede representar dispositivos tanto canónicos como no canónicos. En INDI, todos los <emphasis
>dispositivos</emphasis
> pueden contener una o más <emphasis
>propiedades</emphasis
>. Una <emphasis
>propiedad</emphasis
> puede contener uno o más <emphasis
>elementos</emphasis
>. Existen cuatro tipos de propiedades INDI:</para>
<itemizedlist>
<listitem
><para
>Propiedad de texto.</para
></listitem>
<listitem
><para
>Propiedad numérica.</para
></listitem>
<listitem
><para
>Propiedad conmutable (representada en la interfaz mediante botones y casillas).</para
></listitem>
<listitem
><para
>Propiedad luminosa (representada en la interfaz mediante LED de colores).</para
></listitem>
</itemizedlist>

<para
>Por ejemplo, todos los dispositivos INDI comparten la <emphasis
>propiedad</emphasis
> conmutable estándar «CONNECTION». Esta propiedad tiene dos elementos: los conmutadores «CONNECT» y «DISCONNECT». KStars analiza la descripción XML general de las propiedades y construye una representación de una interfaz gráfica de usuario apropiada para la interacción humana directa.</para>

<para
>El panel de control INDI ofrece muchas propiedades de dispositivo a las que no se puede acceder desde el mapa del cielo. Las propiedades que se ofrecen difieren de un dispositivo a otro. No obstante, todas las propiedades comparten características comunes que limitan la forma en que se muestran y cómo se usan:</para>

<itemizedlist>
<listitem>
<para
>Permisos: Todas las propiedades pueden ser de solo lectura, de solo escritura y con permiso de lectura y escritura. Un ejemplo de una propiedad de lectura y escritura es la ascensión recta del telescopio. Puede introducir una nueva ascensión recta y el telescopio, basado en las preferencias actuales, se desplazará o se sincronizará al nuevo dato introducido. Aún más, cuando el telescopio se desplaza, su ascensión recta se actualiza y se envía de vuelta al cliente.</para>
</listitem>
<listitem>
<para
>Estado: Existe un indicador de estado (LED redondo) prefijado para cada propiedad. Cada propiedad posee un estado y un código de color asociado:</para>
<table frame="top"
><title
>Código de colores de estado INDI</title>
<tgroup cols="3" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Estado</entry>
<entry
>Color</entry>
<entry
>Descripción</entry>
</row>
</thead>
<tbody>
<row>
<entry
>Inactivo</entry>
<entry
>Gris</entry>
<entry
>El dispositivo no está realizando ninguna acción con respecto a esta propiedad</entry>
</row>
<row>
<entry
>Ok</entry>
<entry
>Verde</entry>
<entry
>La última operación realizada sobre esta propiedad se realizó con éxito y sigue activa</entry>
</row>
<row>
<entry
>Ocupado</entry>
<entry
>Amarillo</entry>
<entry
>La propiedad está realizando una acción</entry>
</row>
<row>
<entry
>Alerta</entry>
<entry
>Rojo</entry>
<entry
>La propiedad está en condición crítica y necesita atención inmediata</entry>
	</row>
	</tbody>
</tgroup>
</table>

<para
>El controlador del dispositivo actualiza el estado de la propiedad en tiempo real cuando es necesario. Por ejemplo, si el telescopio se está desplazando a un objetivo, las propiedades RA/DEC recibirán la señal <guilabel
>Ocupado</guilabel
>. Cuando el desplazamiento se haya completado con éxito, las propiedades recibirán la señal <guilabel
>Ok</guilabel
>.</para>
</listitem>
<listitem>
<para
>Contexto: Las propiedades numéricas pueden aceptar y procesar números en dos formatos: decimal y sexagesimal. El formato sexagesimal resulta conveniente cuando se expresan horas o coordenadas ecuatoriales o geográficas. Puede usar el formato que más le convenga. Por ejemplo, todos los números siguientes son idénticos:</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
>Hora: La hora estándar que se usa para todas las comunicaciones relacionadas con INDI es la Hora Universal UTC, especificada como AAAA-MM-DDTHH:MM:SS, según la ISO 8601. &kstars; comunica la hora UTC correcta a los controladores de dispositivo automáticamente. Puede activar o desactivar las actualizaciones de hora automáticas en el diálogo <guimenuitem
>Configurar INDI</guimenuitem
> en el menú <guimenu
>Dispositivos</guimenu
>. </para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="indi-remote-control">
<title
>Control de dispositivo remoto</title>
<indexterm
><primary
>Control del telescopio</primary>
<secondary
>Dispositivos remotos</secondary>
</indexterm>

<para
>KStars proporciona una capa simple, aunque potente, para controlar dispositivos remotos. Una descripción detallada de esta capa se describe en el <ulink url="http://www.clearskyinstitute.com/INDI/INDI.pdf"
>libro blanco</ulink
> de INDI.</para>

<para
>Necesita configurar tanto la máquina servidora como la cliente para el control remoto:</para>

<orderedlist>
<listitem>
<para
>Servidor: Para preparar un dispositivo para control remoto, siga los mismos pasos que en la configuración <link linkend="indi-kstars-setup"
>local/servidor</link
>. Cuando inicie un servicio para un dispositivo en el <guimenu
>Gestor de dispositivos</guimenu
>, se mostrará un número de puerto en la columna <guilabel
>Puerto a la escucha</guilabel
>. Además de este número de puerto, también necesita el nombre de máquina o la dirección IP de su servidor. </para>

</listitem>
<listitem>
<para
>Cliente: Seleccione el <guimenuitem
>Gestor de dispositivos</guimenuitem
> en el menú <guimenu
>Dispositivo</guimenu
> y pulse sobre la pestaña <guilabel
>Cliente</guilabel
>. Puede añadir, modificar o borrar máquinas en la pestaña <guilabel
>Cliente</guilabel
>. Añada una máquina pulsando el botón <guibutton
>Añadir</guibutton
>. Introduzca el nombre de máquina o la dirección IP del servidor en el campo <guilabel
>Servidor</guilabel
>, e introduzca el número de puerto de la máquina <emphasis
>servidora</emphasis
> obtenido en el paso 1. </para>
</listitem>
</orderedlist>

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

<para
>Tras añadir un servidor, pulse sobre él con el botón derecho del ratón para <guimenuitem
>Conectar</guimenuitem
> o <guimenuitem
>Desconectar</guimenuitem
>. Si se ha establecido una conexión, puede controlar el telescopio desde el <guilabel
>mapa del cielo</guilabel
> o desde el <guilabel
>Panel de control INDI</guilabel
> exactamente como se describe en la sección <link linkend="indi-kstars-setup"
>local/servidor</link
>. Es tan sencillo como eso. </para>

<sect2 id="indi-commandline">
<title
>Ejecución de un servidor INDI desde la consola</title>
<para
>Aunque &kstars; le permite establecer fácilmente un servidor INDI, también puede lanzar un servidor INDI desde la línea de órdenes. </para>

<para
>Debido a que INDI es un componente de motor independiente, es posible ejecutar un servidor INDI en un servidor sin KStars. Se puede compilar INDI por separado para ser ejecutado en máquinas remotas. Además, los controladores de dispositivo envían mensajes a <constant
>stderr</constant
>, algo que puede resultar útil en una situación de depuración. La sintaxis para lanzar un servidor INDI es la siguiente:</para>

<para
>$ <command
>indiserver</command
> [opciones] [<filename
>controlador</filename
> ...]</para>

<para
>Opciones:</para>
<para
>-l d : registrar los mensajes del controlador en d/YYYY-MM-DD.islog</para>
<para
>-m m : cerrar el cliente si genera más de estos MB (10 por omisión)</para>
<para
>-p p : puerto IP alternativo (7624 por omisión)</para>
<para
>-v : mostrar eventos clave, no tráfico</para>
<para
>-vv : -v + contenido de los mensajes clave</para>
<para
>-vvv : -vv + xml completo</para>
<para
>driver : ejecutable o dispositivo@máquina[:puerto]</para>

<para
>Por ejemplo, si desea iniciar un servidor INDI para ejecutar un controlador LX200 GPS y escuchar conexiones en el puerto 8000, tendría que ejecutar la siguiente orden:</para>

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

<sect2 id="indi-secure-remote">
<title
>Operación remota segura</title>

<para
>Suponga que queremos ejecutar un servidor INDI con controladores INDI en una máquina remota, <constant
>remote_host</constant
>, y conectarlo con &kstars;, que está ejecutándose en la máquina local.</para>

<para
>Iniciaremos la sesión en la máquina remota, <constant
>remote_host</constant
>, desde la máquina local escribiendo:</para>

<para
>$ <command
>ssh</command
> -L <varname
>puerto_local</varname
>:<constant
>remote_host</constant
>:<varname
>puerto_remoto</varname
></para>

<para
>Esto enlaza el <varname
>puerto_local</varname
> de la máquina local al <varname
>puerto_remoto</varname
> del <constant
>remote_host</constant
>. Tras iniciar la sesión, ejecute el servidor INDI en la máquina remota:</para>

<para
>$ <command
>indiserver</command
> -p <varname
>puerto_remoto</varname
> [<filename
>controlador</filename
>...]</para>

<para
>De nuevo en la máquina local, inicie &kstars;, abra el <guimenuitem
>Gestor de dispositivos</guimenuitem
> y añada una máquina en la pestaña <guilabel
>Cliente</guilabel
>. La máquina debe ser el servidor local (normalmente 127.0.0.1) y el número de puerto debería ser el <varname
>puerto_local</varname
> usado en los pasos anteriores. Pulse con el botón <mousebutton
>derecho</mousebutton
> del ratón en la máquina añadida y seleccione <guimenuitem
>Conectar</guimenuitem
> en el menú emergente. &kstars; conectará con el servidor INDI remoto de forma segura. La información del servidor se guardará para futuras sesiones.</para>
</sect2>
</sect1>

<sect1 id="indi-faq">
<title
>Preguntas frecuentes sobre INDI</title>
<indexterm
><primary
>Control del telescopio</primary>
<secondary
><acronym
>FAQ</acronym
></secondary>
</indexterm>

<qandaset defaultlabel="qanda">
<qandaentry>
<question id="what-is-indi">
<para
>¿Qué es INDI?</para>
</question>
<answer>
<para
><acronym
>INDI</acronym
> es el protocolo de control <ulink url="http://indi.sourceforge.net"
>Instrument Neutral Distributed Interface</ulink
> desarrollado por <author
><firstname
>Elwood</firstname
> <surname
>C. Downey</surname
></author
> del <ulink url="http://www.clearskyinstitute.com/"
>ClearSky Institute</ulink
>. &kstars; emplea controladores de dispositivos que son compatibles con el protocolo INDI. INDI tiene muchas ventajas, como un perfecto entendimiento entre dispositivos de hardware y controladores de software. Los clientes que usan los controladores de dispositivos (como &kstars;) no necesitan saber absolutamente nada sobre las capacidades de los dispositivos. &kstars; se comunica con los controladores de dispositivos durante su ejecución y construye una interfaz completamente dinámica basada en los servicios que proporciona el dispositivo. Por tanto, se pueden escribir nuevos controladores de dispositivos o actualizar los existentes y KStars puede aprovecharlos sin realizar ningún cambio en la parte cliente.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Está previsto que funcionen más dispositivos? </para>
</question>
<answer>
<para
>Sí. Planeamos implementar las principales cámaras CCD y enfocadores, e incorporar más telescopios. Si le gustaría que INDI funcionara con un dispositivo particular, envíenos un email a <email
>indi-devel@lists.sourceforge.net</email
>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Qué operaciones proporciona KStars para controlar el telescopio? </para>
</question>
<answer>
<para
>Depende del telescopio particular que esté usando, pero las tres operaciones mínimas son <command
>Slew</command
>, <command
>Track</command
> y <command
>Sync</command
>, que puede lanzar directamente desde el mapa del cielo. Su telescopio debe estar alineado para que estas operaciones se realicen correctamente. Algunos telescopios le ofrecerán más operaciones, como gestión del sitio, modos de desplazamiento, enfoques, aparcado y demás. Puede acceder a las características extendidas del telescopio desde el «Panel de control INDI» en el menú «Dispositivo». </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Qué diferencia hay exactamente entre <command
>Slew</command
>, <command
>Track</command
> y <command
>Sync</command
>? </para>
</question>
<answer>
<para
>La orden <command
>Slew</command
> hace que el telescopio se desplace a un objetivo particular y, una vez en él, mantenga el seguimiento de dicho objetivo a un ritmo <emphasis
>sideral</emphasis
> (es decir, el ritmo al que las estrellas se mueven en el cielo). Esto funciona bien con estrellas, objetos Messier y con cualquier cosa que esté fuera de nuestro Sistema Solar). Pero los objetos del Sistema Solar viajan de un modo diferente a través del cielo, por lo que usamos la orden <command
>Track</command
> con ellos para seguir su movimiento. </para>
<para
>Por lo tanto, necesita emitir una orden «track» si desea seguir un objeto que tenga un movimiento no sideral. Por el contrario, la orden <command
>Sync</command
> se usa para sincronizar las coordenadas internas del telescopio con las de un objeto que haya seleccionado usted. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>¿Puedo controlar mi telescopio de forma remota? </para>
</question>
<answer>
<para
>Sí. Puede iniciar un servidor INDI en la máquina conectada a su telescopio y el servidor escuchará las peticiones de los clientes de &kstars;. Una vez conectado, podrá controlar su telescopio directamente desde el mapa del cielo. Este procedimiento se describe con detalle en la sección <link linkend="indi-remote-control"
>Control de dispositivos remotos</link
>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Cuando intento <guibutton
>Conectar</guibutton
>, &kstars; informa que el telescopio no está conectado al puerto serie/USB. ¿Qué puedo hacer? </para>
</question>
<answer>
<para
>Este mensaje se muestra cuando &kstars; no puede comunicarse con el telescopio. Estas son algunas cosas que puede hacer:</para>

   <orderedlist>
   <listitem>
<para
>Compruebe que tiene permisos de lectura y escritura en el puerto al que intenta conectarse.</para>
   </listitem>
   <listitem>
<para
>Compruebe el cable de conexión, asegúrese de que está en buen estado y pruébelo con otras aplicaciones.</para>
   </listitem>
   <listitem>
<para
>Compruebe que su telescopio está enchufado, que la fuente de alimentación está encendida y que el telescopio está recibiendo suficiente energía.</para>
   </listitem>
   <listitem>
<para
>Indique el puerto correcto en el <guilabel
>Panel de control INDI</guilabel
> del menú <guimenu
>Dispositivos</guimenu
>. El dispositivo por omisión es <constant
>/dev/ttyS0</constant
></para>
   </listitem>
   <listitem>
   <para
>Reinicie &kstars; y pruebe de nuevo.</para>
   </listitem>
   </orderedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>&kstars; informa que el telescopio está encendido y preparado, pero no puedo encontrar la cruceta del telescopio. ¿Dónde está?</para>
</question>
<answer>
<para
>&kstars; obtiene las coordenadas AR y Dec tras la conexión. Si se realizó la alineación correctamente, debería ver la cruceta sobre el objetivo en el mapa del cielo. No obstante, las coordenadas AR y Dec proporcionadas por el telescopio pueden ser incorrectas (e incluso por debajo del horizonte), por lo que necesitará <link linkend="indi-sync"
>sincronizar</link
> su telescopio con su objetivo actual. Puede usar el menú del botón derecho del ratón para centrar y seguir la cruceta del telescopio en el mapa del cielo.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>El telescopio se mueve de forma errática o no se mueve en absoluto. ¿Qué puedo hacer?</para>
</question>
<answer>
<para
>Este comportamiento se debe principalmente a preferencias incorrectas. Compruebe la siguiente lista de verificaciones:</para>
<orderedlist>
<listitem>
<para
>¿Está el telescopio alineado?</para>
</listitem>
<listitem>
<para
>¿Es correcto el modo de alineación del telescopio? Utilice el <guilabel
>Panel de control INDI</guilabel
> para comprobar y cambiar estas preferencias (<constant
>Alt/Az, Polar, Land</constant
>).</para>
</listitem>
<listitem>
<para
>¿Ha establecido correctamente la fecha y hora del telescopio?</para>
</listitem>
<listitem>
<para
>¿Ha establecido correctamente la longitud y latitud del telescopio?</para>
</listitem>
<listitem>
<para
>¿Es correcto el desplazamiento UTC del telescopio?</para>
</listitem>
<listitem>
<para
>¿Están firmemente asegurados los ejes AR y DEC del telescopio?</para>
</listitem>
<listitem>
<para
>¿Está bien posicionado el conmutador N/S de su telescopio (cuando sea de aplicación) para el hemisferio en el que se encuentra?</para>
</listitem>
<listitem>
<para
>¿Está en buen estado el cable de conexión del telescopio a su equipo?</para>
</listitem>
</orderedlist>

<para
>Si cree que todas sus preferencias son correctas y el telescopio continúa moviéndose erráticamente o no se mueve en absoluto, envíe un informe a <email
>indi-devel@lists.sourceforge.net</email
>.</para>
</answer>
</qandaentry>
</qandaset>
</sect1>
</chapter>

