<chapter id="indi">
<title
>Controlo de Dispositivos Astronómicos com o <acronym
>INDI</acronym
></title>
<indexterm
><primary
>Controlo do INDI</primary>
<secondary
>Introdução</secondary>
</indexterm>

<para
>KStars provides an interface to configure and control astronomical instruments via the <acronym
><link linkend="what-is-indi"
>INDI</link
></acronym
> protocol.</para>

<para
>The <acronym
>INDI</acronym
> protocol supports a variety of astronomical instruments such as CCD cameras and focusers. Currently, KStars supports the following devices:</para>

<table id="device-table" pgwide="1" frame="all">
<title
>Supported Telescopes</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Telescope</entry>
<entry
>Device driver</entry>
</row>
</thead>
<tbody>
<row>
<entry
>LX200 8"-12" Classic</entry>
<entry
>indi_lx200classic</entry>
</row>
<row>
<entry
>Autostar based telescopes</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
>Supported Focusers</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Focuser</entry>
<entry
>Device driver</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
>Supported CCDs</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>CCD</entry>
<entry
>Device driver</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
>Supported Filter Wheels</title>
  <tgroup cols="2" colsep="1" rowsep="1">
    <thead>
      <row>
	<entry
>Filter Wheel</entry>
	<entry
>Device driver</entry>
      </row>
    </thead>
    <tbody>
      <row>
	<entry
>FLI Filter Wheels</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
>Supported Webcams</title>
<tgroup cols="2" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Webcam</entry>
<entry
>Device driver</entry>
</row>
</thead>
<tbody>
<row>
<entry
>Any Video4Linux compatible device</entry>
<entry
>indi_v4l_generic</entry>
</row>
<row>
<entry
>Philips webcam</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
>Configuração do INDI</title>
<indexterm
><primary
>INDI</primary>
<secondary
>Configuração</secondary>
</indexterm>
<para
>KStars can control local and remote devices seamlessly via the <link linkend="what-is-indi"
>INDI</link
> server/client architecture. INDI devices may be run in three different modes:</para>

<orderedlist>
<listitem
><para
>Local: O modo local é o mais comum e é usado para controlar um dispositivo local (&ie;, um dispositivo ligado à sua máquina).</para
></listitem>
<listitem
><para
>Servidor: O modo servidor estabelece um servidor de INDI para um dado dispositivo e fica à espera de ligações dos clientes remotos. Você não poderá operar os dispositivos servidores, só os poderá iniciar e terminar.</para
></listitem>
<listitem
><para
>Cliente: O modo cliente é usado para ligar aos servidores INDI remotos que estejam a correr dispositivos INDI. Você poderá controlar de forma transparente os dispositivos como se fossem dispositivos locais.</para
></listitem>
</orderedlist>

<para
>Você poderá correr um dispositivo local, estabelecer servidores INDI e ligar-se a clientes remotos através do <guimenuitem
>Gestor de Dispositivos</guimenuitem
> no menu <guimenu
>Dispositivos</guimenu
>.</para>

<para
>Aqui está uma imagem da janela do <guilabel
>Gestor de Dispositivos</guilabel
>:</para>

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

<para
>You can run devices by browsing the device tree, selecting a specific device, and then clicking on the <guibutton
>Run Service button</guibutton
>. You can select the operation mode, either local or server as defined above.</para>

<para
>Para controlar os dispositivos remotos, veja a secção de <link linkend="indi-remote-control"
>controlo de dispositivos remotos</link
>.</para>
</sect1>

<sect1 id="indi-telescope-setup">
<title
>Configuração do Telescópio</title>
<indexterm
><primary
>INDI</primary>
<secondary
>Configuração</secondary>
</indexterm>

<para
>A maioria dos telescópios estão equipados com interfaces <hardware
>RS232</hardware
> para o controlo remoto. Ligue a ficha RS232 no seu telescópio à porta <hardware
>Série/USB</hardware
> do seu computador. Tradicionalmente, o RS232 liga-se à porta série do seu computador, mas dado que muitos portáteis abandonaram a porta série a favor das portas <hardware
>USB/FireWire</hardware
>, você poderá ter de optar um adaptador de série para USB para poder usar nos novos portáteis.</para>

<para
>Depois de ligar o seu telescópio à porta Série/USB, ligue o seu telescópio. É <emphasis
>altamente</emphasis
> recomendado que você obtenha e instale o último 'firmware' para o controlador do seu telescópio.</para>

<para
>O telescópio precisa de ser alinhado antes de poder ser usado convenientemente. Alinhe o seu telescópio (alinhamento de uma ou duas estrelas), tal como é indicado no manual do seu telescópio.</para>

<para
>O &kstars; precisa de verificar a configuração da hora e da localização antes de se ligar ao telescópio. Isto garante um seguimento correcto e uma sincronização entre o telescópio e o &kstars;. Os passos seguintes permitir-lhe-ão ligar-se a um dispositivo que está ligado ao seu computador. Para se ligar e controlar os dispositivos remotos, por favor veja a secção <link linkend="indi-remote-control"
>controlo de dispositivos remotos</link
>.</para>

<para
>You can use the Telescope Setup Wizard and it will verify all the required information in the process. It can automatically scan ports for attached telescopes. You can run the wizard by selecting <guimenuitem
>Telescope Setup Wizard</guimenuitem
> from the <guimenu
>Devices</guimenu
> menu.</para>

<para
>Am alternativa, para se ligar a um telescópio, por favor efectue os seguintes passos:</para>

<orderedlist>
<listitem
><para
>Set your geographical location. Open the <guilabel
>Geographic...</guilabel
> window by selecting <guimenuitem
>Set Geographic Location...</guimenuitem
> from the <guimenu
>Settings</guimenu
> menu, or by pressing the <guiicon
>Globe</guiicon
> icon in the toolbar, or by pressing <keycombo action="simul"
>&Ctrl;<keycap
>g</keycap
></keycombo
>.</para>
</listitem>
<listitem
><para
>Set your local time and date. You can change to any time or date by selecting <guimenuitem
>Set Time...</guimenuitem
> from the <guimenu
>Time</guimenu
> menu, or by pressing the <guiicon
>time</guiicon
> icon in the toolbar. The <guilabel
>Set Time</guilabel
> window uses a standard &kde; Date Picker widget, coupled with three spinboxes for setting the hours, minutes and seconds. If you ever need to reset the clock back to the current time, just select <guimenuitem
>Set Time to Now</guimenuitem
> from the <guimenu
>Time</guimenu
> menu.</para>
</listitem>
<listitem>
<para
>Carregue no menu <guimenu
>Dispositivos</guimenu
> e seleccione o <guimenuitem
>Gestor de Dispositivos</guimenuitem
>.</para>
</listitem>
<listitem>
<para
>Na coluna <guilabel
>Dispositivo</guilabel
>, seleccione o modelo do seu telescópio.</para>
</listitem>
<listitem>
<para
><mousebutton
>Right</mousebutton
>-click on the device and select <guilabel
>Run Service</guilabel
>.</para>
</listitem>
<listitem>
<para
>Click <guibutton
>Ok</guibutton
> to close the Device Manager Dialog.</para>
</listitem>
</orderedlist>

<note id="geo-time-note">
<title
>Configurações Frequentes</title>
<para
>Você não precisa de configurar a localização geográfica e a hora, sempre que se liga a um telescópio. Ajuste apenas as opções quando for necessário.</para
></note>

<para
>Você está agora pronto para usar as funcionalidades dos dispositivos; o &kstars; fornece convenientemente duas interfaces gráficas para controlar os telescópios:</para>

<orderedlist>
<title
>Controlar o seu telescópio</title>
<listitem>
<para
><guilabel
>Controlo do Mapa do Céu</guilabel
>: Para cada dispositivo que você execute no <guilabel
>Gestor de Dispositivos</guilabel
>, aparecerá um menu de contexto para cada item correspondente que lhe permite controlar as propriedades do dispositivo. Você poderá enviar comandos do tipo <command
>Mover, Sincronizar,</command
> e <command
>Seguir</command
> directamente a partir do mapa do céu. </para>
<para
>Aqui está uma imagem do menu de contexto que aparece para um dispositivo LX200 Clássico activo:</para>
<screenshot>
<screeninfo
>Controlar os dispositivos do mapa do céu</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="skymapdevice.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</listitem>

<listitem>
<para
><guilabel
>Painel de Controlo do INDI</guilabel
>: O painel oferece ao utilizador todas as funcionalidades suportadas por um dispositivo. </para>

<para
>O painel está dividido em três secções principais:</para>
<itemizedlist>
<listitem>
<para
><guilabel
>Páginas do dispositivo</guilabel
>: Cada dispositivo adicional activo ocupa uma página no painel do INDI. Os vários dispositivos podem ser executados em simultâneo sem afectar a operação dos outros dispositivos. </para>
</listitem>
<listitem>
<para
><guilabel
>Property view</guilabel
>: Properties are the key element in INDI architecture. Each device defines a set of properties to communicate with the client. The current position of the telescope is an example of a property. Semantically similar properties are usually contained in logical blocks or groupings. </para>
</listitem>
<listitem>
<para
><guilabel
>Log viewers</guilabel
>: Devices report their status and acknowledge commands by sending INDI messages. Each device has its own log view, and all devices share one generic log viewer. A device usually sends messages to its device driver only, but a device is permitted to send a generic message when appropriate. </para>
</listitem>
</itemizedlist>
<screenshot>
<screeninfo
>Painel de Controlo de INDI</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="indicontrolpanel.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</listitem>
</orderedlist>

<para
>Você não está restrito a usar apenas uma interface sobre outra, dado que ambas podem ser usadas em simultâneo. As acções do <guilabel
>Mapa do céu</guilabel
> são automaticamente reflectidas no <guilabel
>Painel de Controlo do INDI</guilabel
> e vice-versa.</para>

<para
>Para se ligar ao seu telescópio, você poderá então seleccionar <guimenuitem
>Ligar</guimenuitem
> no menu de contexto do seu dispositivo ou, em alternativa, poderá carregar em <guibutton
>Ligar</guibutton
> na página do seu dispositivo no <guilabel
>Painel de Controlo de INDI</guilabel
>.</para>

<important
><para
>By default, KStars will try to connect to the <constant
>/dev/ttyS0</constant
> port. To change the connection port, select <guilabel
>INDI Control Panel</guilabel
> from the <guimenu
>Devices</guimenu
> menu and change the port under your device tab.</para
></important>

<para
>O &kstars; actualiza automaticamente a longitude, latitude e a hora do telescópio., com base na configuração actual do &kstars;. Você poderá activar/desactivar essas actualizações na janela <guimenuitem
>Configurar o INDI</guimenuitem
> no menu <guimenu
>Dispositivos</guimenu
>. </para>

<para
>Se o &kstars; comunicar de forma bem-sucedida com o telescópio, ele irá tentar obter a <abbrev
>AR</abbrev
> e a <abbrev
>DEC</abbrev
> actual do telescópio e irá mostrar uma mira no mapa do céu, indicando a posição do telescópio.</para>

<note id="indi-sync">
<title
>Sincronizar o seu telescópio</title>
<para
>Se você alinhou o seu telescópio e a última estrela de alinhamento foi, por exemplo, Vega, então a mira deverá estar centrada à volta de Vega. Se a mira estiver fora do alvo, então você poderá carregar com o botão <mousebutton
>direito</mousebutton
> em Vega no mapa do céu e seleccionar <command
>Sincronizar</command
> no menu do seu telescópio. Esta acção irá indicar ao telescópio para sincronizar as suas coordenadas internas de modo a corresponderem às de Vega, ficando agora o alvo do telescópio centrado em Vega. </para>
</note>

<para
>É tudo: o seu telescópio está pronto para explorar os céus!</para>

<warning>
<title
>ATENÇÃO</title>
<para
>Nunca use o telescópio para olhar para o Sol. Se olhar para o sol poderá causar danos irreversíveis aos seus olhos, assim como ao seu equipamento.</para>
</warning>
</sect1>

<sect1 id="indi-other-setup">
<title
>Configuração da Captura de Vídeo e do CCD</title>
<indexterm
><primary
>Controlo do Vídeo CCD</primary>
<secondary
>Configuração</secondary>
</indexterm>

<para
>KStars supports the following imaging devices:</para>
<itemizedlist>
  <listitem
><para
>Finger Lakes instruments CCDs</para
></listitem>
  <listitem
><para
>SBIG CCDs: In order to use SBIG CCDs, you must download and install the Universal SBIG Driver library from <ulink url="http://indi.sourceforge.net"
>INDI</ulink
> website.</para
></listitem>
  <listitem
><para
>Apogee CCDs: Only USB versions are supported. You must have libusb installed.</para
></listitem>
  <listitem
><para
><ulink url="http://www.exploits.org/v4l/"
>Video4Linux</ulink
> compatible devices. Philips webcam extended features are supported as well.</para
></listitem>
</itemizedlist>

<para
>Você poderá correr os dispositivos CCD e de Captura de Vídeo no <guimenuitem
>Gestor de Dispositivos</guimenuitem
> no menu <guimenu
>Dispositivos</guimenu
>. Como todos os dispositivos INDI, alguns dos controlos do dispositivo ficarão acessíveis no mapa do céu. O dispositivo poderá ser controlado por completo no <guimenuitem
>Painel de Controlo do INDI</guimenuitem
>.</para>

<para
>The standard format for image capture is FITS. Once an image is captured and downloaded, it will be automatically displayed in the KStars <link linkend="tool-fitsviewer"
>FITS Viewer</link
>. To capture a sequence of images, use the <guimenuitem
>Capture Image Sequence</guimenuitem
> tool from the <guimenu
>Devices</guimenu
> menu. This tool is inactive until you establish a connection to an image device.</para>

<important>
<para
>The fli and apogee drivers requires root privileges in order to operate properly. Note that running the driver as root is considered a security risk.</para>
</important>
</sect1>

<sect1 id="indi-capture">
<title
>Capturar a Sequência de Imagens</title>
<indexterm
><primary
>Captura</primary>
<secondary
>Imagem</secondary>
</indexterm>

<para
>A ferramenta para Capturar uma Sequência de Imagens pode ser usada para adquirir imagens de máquinas fotográficas, câmaras e CCDs nos modos interactivo e em lote. Para além disso, poderá escolher qual o filtro, se necessário, deseja usar com as suas imagens. A ferramenta de captura fica desactivada até que estabeleça uma ligação a um dispositivo de imagem.</para
> 

<screenshot>
<screeninfo
>Capturar uma Sequência de Imagens</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="indicapture.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>A imagem acima representa uma sessão de captura simples. A ferramenta oferece as seguintes opções:</para>
<itemizedlist>
  <listitem
><para
>Câmara/CCD</para>
     <itemizedlist>
         <listitem
><para
><option
>Dispositivo:</option
> O dispositivo de imagem desejado.</para
></listitem>
         <listitem
><para
><option
>Prefixo:</option
> O prefixo da imagem que será antecedido no nome de cada ficheiro de imagem capturada.</para
></listitem>
         <listitem
><para
><option
>Exposição:</option
> O número de segundos da exposição de cada imagem.</para
></listitem>
         <listitem
><para
><option
>Quantidade:</option
> O número de imagens a adquirir.</para
></listitem>
         <listitem
><para
><option
>Atraso:</option
> O atraso em segundos entre imagens consecutivas.</para
></listitem>
         <listitem
><para
><option
>Tempo ISO 8601:</option
> Adiciona uma hora no formato ISO 8601 ao nome do ficheiro. (p.ex. imagem_01_20050427T09:48:05).</para
></listitem>
     </itemizedlist>
    </listitem>
   <listitem
><para
>Filtro</para>
      <itemizedlist>
          <listitem
><para
><option
>Dispositivo:</option
> O dispositivo do filtro desejado.</para
></listitem>
          <listitem
><para
><option
>Filter:</option
> The desired filter slot. You can assign color values to slot numbers using the <link linkend="indi-configure"
>Configure INDI</link
> window (e.g. Slot #1 = Red, Slot #2 = Blue..etc).</para
></listitem
>          
       </itemizedlist>
   </listitem>
</itemizedlist>

<para
>After you fill in the desired options, you can begin the capture procedure by pressing the <guibutton
>Start</guibutton
> button. You may cancel at any time using the <guibutton
>Stop</guibutton
> button. All captured images will be saved to the default FITS directory which can be specified in the <link linkend="indi-configure"
>Configure INDI</link
> window.</para>

<para
>Se tiver requisitos e condições de captura mais complexos para cumprir, recomenda-se que crie um programa que vá de encontro às suas necessidades com a ferramenta de <link linkend="tool-scriptbuilder"
>Construção de 'Scripts'</link
> no menu <guimenu
>Ferramentas</guimenu
>.</para>
</sect1>

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

<para
>The Configure INDI window allows you to modify <emphasis
>Client side</emphasis
> INDI specific options. The window is divided into four main categories: General, Automatic device updates, Display, and Filter Wheel:</para>

 <itemizedlist>
   <listitem
><para
>Geral</para>
      <itemizedlist>
         <listitem
><para
><option
>Directoria do FITS por omissão:</option
> Indique a pasta onde todas as imagens capturadas pelo FITS serão gravadas. Se não for indicada qualquer pasta, as imagens serão gravadas na $HOME.</para
></listitem>
         <listitem
><para
><option
>Automatic Display of FITS upon capture:</option
> When checked, KStars will display captured FITS in KStars <link linkend="tool-fitsviewer"
>FITS Viewer</link
> tool. If you use the <link linkend="indi-capture"
>Capture Image Sequence</link
> tool, all captured images will be saved to disk regardless of this option.</para
></listitem>
         <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
>Actualizações automáticas dos dispositivos</para>
    <itemizedlist>
       <listitem
><para
><option
>Hora:</option
> Actualiza a data e hora do telescópio, se for suportado, aquando da ligação.</para
></listitem>
       <listitem
><para
><option
>Localização geográfica:</option
> Actualiza a informação da localização geográfica (a latitude e longitude actuais), se for suportado, aquando da ligação.</para
></listitem>
    </itemizedlist>
   </listitem>
   <listitem
><para
>Visualização</para>
    <itemizedlist>
     <listitem
><para
><option
>Device target crosshair:</option
> When checked, KStars displays the telescope's target crosshair on the sky map. The crosshair is displayed upon a successful connection to the telescope and its location is updated periodically. The telescope's name is displayed next to the crosshair. KStars displays one crosshair per each connected telescope. To change the color of the telescope's crosshair, open the <link linkend="viewops"
>Configure KStars</link
> window. Select the <guilabel
>Colors</guilabel
> tab, and then change the color of the <emphasis
>Target Indicator</emphasis
> item to the desired color.</para
></listitem>
     <listitem
><para
><option
>INDI messages in status bar:</option
> When checked, KStars displays INDI status messages in the KStars status bar.</para
></listitem>
    </itemizedlist>
   </listitem>
  <listitem
><para
>Roda do Filtro: Atribui códigos de cores às posições da roda do filtro (p.ex., Posição #0 Vermelho, Posição #1 Azul..etc). Poderá atribuir códigos de cores até 10 posições de filtragem (0 a 9). Para atribuir um código de cor, seleccione um número de posição na lista respectiva e escreva depois o código de cor correspondente no campo de texto. Repita o processo para todas as posições desejadas e carregue depois em OK.</para>
  </listitem>
  </itemizedlist>

</sect1>

<sect1 id="indi-concepts">
<title
>Conceitos do INDI</title>
<indexterm
><primary
>Controlo de Telescópio</primary>
<secondary
>Conceitos</secondary>
</indexterm>

<para
>O conceito-chave principal no INDI é que os dispositivos têm a capacidade de se descreverem a si próprios. Isto é obtido através do uso de XML para descrever uma hierarquia genérica que possa representar tanto os dispositivos canónicos como os não-canónicos. No INDI, todos os <emphasis
>dispositivos</emphasis
> poderão conter uma ou mais <emphasis
>propriedades</emphasis
>. Cada <emphasis
>propriedade</emphasis
> poderá conter um ou mais <emphasis
>elementos</emphasis
>. Existem quatro tipos de propriedades do INDI:</para>
<itemizedlist>
<listitem
><para
>Propriedade textual.</para
></listitem>
<listitem
><para
>Propriedade numérica.</para
></listitem>
<listitem
><para
>Propriedade de opção (Representada na GUI por botões e opções de selecção).</para
></listitem>
<listitem
><para
>Propriedade de luz (Representada na GUI por LEDs coloridos).</para
></listitem>
</itemizedlist>

<para
>For example, all INDI devices share the CONNECTION standard switch <emphasis
>property</emphasis
>. The CONNECTION property has two elements: CONNECT and DISCONNECT switches. KStars parses the generic XML description of properties and builds a GUI representation suitable for direct human interaction.</para>

<para
>O painel de controlo do INDI oferece várias propriedades do dispositivo que não estão acessíveis no mapa do céu. As propriedades oferecidas diferem de dispositivo para dispositivo. Todavia, todas as propriedades partilham funcionalidades comuns que restringem a forma como são apresentados e usados:</para>

<itemizedlist>
<listitem>
<para
>Permissão: Todas as propriedades poderão ser apenas para leitura, apenas para escrita ou com permissões de escrita e leitura em simultâneo. Um exemplo de uma propriedade de leitura/escrita é a Ascenção Recta do telescópio. Você poderá indicar uma nova Ascenção Recta para que o telescópio, baseado na configuração actual, irá então mover ou sincronizar-se com os novos dados. Para além disso, quando o telescópio se mover, a sua Ascenção Recta fica actualizada e é enviada de volta para o cliente.</para>
</listitem>
<listitem>
<para
>Estado: Antes de cada propriedades existe um indicador de estado (um LED redondo). Cada propriedades tem um estado e um código de cores associados:State: Prefixed to each property is a state indicator (round LED). Each property has a state and an associated color code:</para>
<table frame="top"
><title
>Código de cor do estado do INDI</title>
<tgroup cols="3" colsep="1" rowsep="1">
<thead>
<row>
<entry
>Estado</entry>
<entry
>Cor</entry>
<entry
>Descrição</entry>
</row>
</thead>
<tbody>
<row>
<entry
>Inactivo</entry>
<entry
>Cinzento</entry>
<entry
>O dispositivo não está a efectuar nenhuma acção respeitante a esta propriedade</entry>
</row>
<row>
<entry
>Ok</entry>
<entry
>Verde</entry>
<entry
>A última operação efectuada neste propriedade foi bem-sucedida e está activa</entry>
</row>
<row>
<entry
>Ocupado</entry>
<entry
>Amarelas</entry>
<entry
>A propriedade está a efectuar uma acção</entry>
</row>
<row>
<entry
>Alerta</entry>
<entry
>Red</entry>
<entry
>A propriedades está numa condição crítica e precisa de atenção imediata</entry>
	</row>
	</tbody>
</tgroup>
</table>

<para
>O controlador do dispositivo actualiza o estado da propriedade em tempo-real quando for necessário. Por exemplo, se o telescópio estiver no processo de se mover para um dado alvo, então as propriedades de AR/DEC ficarão marcadas como <guilabel
>Ocupadas</guilabel
>. Quando o processo de movimentação tiver completado com sucesso, as propriedades ficarão assinaladas como <guilabel
>Ok</guilabel
>.</para>
</listitem>
<listitem>
<para
>Contexto: As propriedades numéricas podem aceitar e processar os números em dois formatos: decimal e sexagesimal. O formato sexagesimal é conveniente quando expressa a hora ou as coordenadas equatoriais/geográficas. Você poderá usar qualquer formato conveniente para si. Por exemplo, todos os números seguintes são iguais:</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
>Time: The standard time for all INDI-related communications is Universal Time UTC specified as YYYY-MM-DDTHH:MM:SS in accord with ISO 8601. &kstars; communicates the correct UTC time with device drivers automatically. You can enable/disable automatic time updates from the <guimenuitem
>Configure INDI</guimenuitem
> dialog under the <guimenu
>Devices</guimenu
> menu. </para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="indi-remote-control">
<title
>Controlo de Dispositivos Remotos</title>
<indexterm
><primary
>Controlo de Telescópio</primary>
<secondary
>Dispositivos Remotos</secondary>
</indexterm>

<para
>KStars provides a simple yet powerful layer for remote device control. A detailed description of the layer is described in the INDI <ulink url="http://www.clearskyinstitute.com/INDI/INDI.pdf"
>white paper</ulink
>.</para>

<para
>Você precisa de configurar tanto as máquinas servidoras como as clientes para o controlo remoto:</para>

<orderedlist>
<listitem>
<para
>Servidor: Para preparar um dispositivo para ser controlado remotamente, siga os mesmos passos que para a configuração <link linkend="indi-kstars-setup"
>local/servidor</link
>. Quando você iniciar o serviço de um dispositivo no <guimenu
>Gestor de Dispositivos</guimenu
>, é mostrado um número de porto na coluna <guilabel
>Porto de Espera</guilabel
>. Para além do número de porto, você precisa do nome da máquina ou do endereço IP do seu servidor. </para>

</listitem>
<listitem>
<para
>Cliente: Seleccione o <guimenuitem
>Gestor de Dispositivos</guimenuitem
> no menu <guimenu
>Dispositivo</guimenu
> e carregue na página <guilabel
>Cliente</guilabel
>. Você poderá adicionar, modificar ou remover máquinas na página <guilabel
>Cliente</guilabel
>. Adicione uma máquina, carregando no botão <guibutton
>Adicionar</guibutton
>. Indique o nome da máquina/endereço IP do servidor no campo <guilabel
>Máquina</guilabel
> e indique o número do porto que obteve na máquina <emphasis
>servidora</emphasis
> no passo 1. </para>
</listitem>
</orderedlist>

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

<para
>Depois de adicionar uma máquina, carregue com o botão direito na máquina para se <guimenuitem
>Ligar</guimenuitem
> ou <guimenuitem
>Desligar</guimenuitem
>. Se estiver estabelecida uma ligação, você poderá controlar o telescópio no <guilabel
>Mapa do céu</guilabel
> ou no <guilabel
>Painel de Controlo do INDI</guilabel
>, tal como está descrito na secção <link linkend="indi-kstars-setup"
>local/servidor</link
>. É tão simples quanto isto. </para>

<sect2 id="indi-commandline">
<title
>Correr um servidor de INDI na linha de comandos</title>
<para
>Embora o &kstars; lhe permita instalar com facilidade um servidor de INDI, você poderá instalar facilmente um servidor de INDI; você poderá lançar um servidor de INDI a partir da linha de comandos. </para>

<para
>Since INDI is an independent backend component, you can run an INDI server on a host without KStars. INDI can be compiled separately to run on remote hosts. Furthermore, device drivers log messages to <constant
>stderr</constant
> and that can be helpful in a debugging situation. The syntax for INDI server is as following:</para>

<para
>$ <command
>indiserver</command
> [opções] [<filename
>controlador</filename
> ...]</para>

<para
>Opções:</para>
<para
>-l d : regista as mensagens do controlador para d/AAAA-MM-DD.islog</para>
<para
>-m m : matar o cliente se deixar para trás mais de 'm' MB; por omissão 10</para>
<para
>-p p : porto IP alternativo, por omissão é o 7624</para>
<para
>-v : mostrar os eventos-chave, sem tráfego</para>
<para
>-vv : -v + conteúdo das mensagens-chave</para>
<para
>-vvv : -vv + XML completo</para>
<para
>controlador : executável ou dispositivo@máquina[:porto]</para>

<para
>Por exemplo, se você quiser iniciar um servidor de INDI a correr um controlador de um LX200 GPS e quiser atender as ligações no porto 8000, você iria executar o seguinte comando:</para>

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

<sect2 id="indi-secure-remote">
<title
>Operação Remota Segura</title>

<para
>Suponha que deseja executar o 'indiserver' e os seus clientes numa máquina remota, a <constant
>maquina_remota</constant
>, e ligá-los ao &kstars; que está a correr na máquina local.</para>

<para
>Na máquina local, ligue-se à máquina remota, a <constant
>maquina_remota</constant
>, escrevendo:</para>

<para
>$ <command
>ssh</command
> -L <varname
>porto_local</varname
>:<constant
>maquina_remota</constant
>:<varname
>porto_remoto</varname
></para>

<para
>Isto associa o <varname
>porto_local</varname
> da máquina local ao <varname
>porto_remoto</varname
> da <constant
>maquina_remota</constant
>. Depois de se ligar, corra o 'indiserver' na máquina remota:</para>

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

<para
>De volta à máquina local, inicie o &kstars;, abrindo então o <guimenuitem
>Gestor de Dispositivos</guimenuitem
> e adicionando uma máquina na página <guilabel
>Cliente</guilabel
>. A máquina deverá ser a <constant
>maquina_local</constant
> (normalmente igual a 127.0.0.1) e o número de porto deverá ser o <varname
>porto</varname
> usado em todos os passos acima. Carregue com o botão <mousebutton
>direito</mousebutton
> na máquina e seleccione <guimenuitem
>Ligar</guimenuitem
> no menu de contexto. O &kstars; ligar-se-á ao servidor de INDI remoto com segurança. A informação da máquina será guardada para as sessões futuras.</para>
</sect2>
</sect1>

<sect1 id="indi-faq">
<title
>Perguntas Mais Frequentes do INDI</title>
<indexterm
><primary
>Controlo de Telescópio</primary>
<secondary
><acronym
>FAQ</acronym
></secondary>
</indexterm>

<qandaset defaultlabel="qanda">
<qandaentry>
<question id="what-is-indi">
<para
>O Que é o INDI?</para>
</question>
<answer>
<para
><acronym
>INDI</acronym
> is the <ulink url="http://indi.sourceforge.net"
> Instrument-Neutral-Distributed-Interface</ulink
> control protocol developed by <author
><firstname
>Elwood</firstname
><surname
>C. Downey</surname
></author
> of <ulink url="http://www.clearskyinstitute.com/"
>ClearSky Institute</ulink
>. &kstars; employs device drivers that are compatible with the INDI protocol. INDI has many advantages including loose coupling between hardware devices and software drivers. Clients that use the device drivers (like &kstars;) are completely unaware of the device capabilities. In run time, &kstars; communicates with the device drivers and builds a completely dynamical GUI based on services provided by the device. Therefore, new device drivers can be written or updated and KStars can take full advantage of them without any changes on the client side.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Está planeado o suporte para mais dispositivos? </para>
</question>
<answer>
<para
>Sim. Planeamos suportar as câmaras CCD e sistemas de foco mais importantes e extender o suporte para mais telescópios. Se você gostar que o INDI suporte um dispositivo em particular, envie por favor um e-mail para <email
>indi-devel@lists.sourceforge.net</email
> </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>What operations does KStars provide to control the telescope? </para>
</question>
<answer>
<para
>Depende do telescópio em particular que está a usar, mas as três operações Mínimas são o <command
>Movimentar</command
>, <command
>Seguir</command
> e <command
>Sincronizar</command
>, que poderá emitir directamente a partir do mapa do céu. O seu telescópio deverá estar alinhado para estas operações funcionarem correctamente. Alguns telescópios oferecem-lhe mais operações, como a gestão de locais, os modos de movimentação, focagens e posições de repouso, entre outras. Poderá aceder às funcionalidades extendidas dos telescópios no Painel de Controlo do INDI no menu Dispositivos. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Qual é a diferença entre <command
>Movimentar</command
>, <command
>Seguir</command
> e <command
>Sincronizar</command
> ao certo? </para>
</question>
<answer>
<para
>O comando <command
>Movimentar</command
> indica ao telescópio para se posicionar num dado alvo em particular e, logo que o telescópio atinja o seu alvo, o telescópio começa a seguir esse alvo numa taxa <emphasis
>sideral</emphasis
> (i.e., a taxa com que as estrelas se movem pelo céu). Isto funciona bem para as estrelas, objectos Messier e quase tudo o que esteja fora do nosso sistema solar. Contudo, os objectos do sistema solar viajam de forma diferente pelo céu, como tal, o telescópio deverá <command
>Seguir</command
> os objectos à medida que se movem. </para>
<para
>Como tal, terá de emitir um comando de seguimento, se quiser seguir um objecto com um movimento não-sideral. Por outro lado, o <command
>Sincronizar</command
> é usado para acertar as coordenadas internas do telescópio com as do objecto que seleccionar. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Posso controlar o meu telescópio remotamente? </para>
</question>
<answer>
<para
>Sim. Poderá iniciar um servidor de INDI na máquina que está ligado ao seu telescópio, para que o servidor atenda os pedidos dos clientes do &kstars;. Logo que esteja ligado, poderá controlar directamente o seu telescópio a partir do mapa do céu. Este procedimento está descrito em detalhe na secção <link linkend="indi-remote-control"
>Controlo de dispositivos remotos</link
>. </para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Quando me tento <guibutton
>Ligar</guibutton
>, o &kstars; diz que o telescópio não está ligado à porta série/USB. O que é que posso fazer? </para>
</question>
<answer>
<para
>Esta mensagem é desencadeada quando o &kstars; não consegue comunicar com o telescópio. Aqui estão algumas coisas que você pode fazer:</para>

   <orderedlist>
   <listitem>
<para
>Verifique se tem tanto permissões de leitura como de escrita para o porto onde se está a tentar ligar.</para>
   </listitem>
   <listitem>
<para
>Verifique a ligação do cabo, certifique-se que está em boas condições e teste-a com outras aplicações.</para>
   </listitem>
   <listitem>
<para
>Verifique a alimentação do seu telescópio, certifique-se que este está ligado e que tem alimentação suficiente.</para>
   </listitem>
   <listitem>
<para
>Configure a porta correcta no <guilabel
>Painel de Controlo do INDI</guilabel
> no menu <guimenu
>Dispositivos</guimenu
>. A porta por omissão é a <constant
>/dev/ttyS0</constant
></para>
   </listitem>
   <listitem>
   <para
>Reinicie o &kstars; e tente de novo.</para>
   </listitem>
   </orderedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>O &kstars; diz que o telescópio está ligado e pronto, mas não consigo encontrar a mira do telescópio; onde é que está?</para>
</question>
<answer>
<para
>O &kstars; devolve as coordenadas AR e DEC do telescópio logo que se liga. Se o seu alinhamento foi feito correctamente, então você deverá ver a mira no seu alvo no Mapa do Céu. Contudo, as coordenadas de AR e DEC fornecidas pelo telescópio poderão estar incorrectas (até mesmo abaixo do horizonte) e você poderá precisar de <link linkend="indi-sync"
>Sincronizar</link
> o seu telescópio com o seu alvo actual. Poderá usar o menu do botão direito para se centrar e seguir a mira do telescópio no mapa celeste.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>O telescópio está-se a mover de forma errada ou não se mexe de todo. O que posso fazer?</para>
</question>
<answer>
<para
>Este comportamento deve-se em grande parte a configurações incorrectas; por favor verifique a seguinte lista:</para>
<orderedlist>
<listitem>
<para
>O telescópio está alinhado?</para>
</listitem>
<listitem>
<para
>O modo de alinhamento do telescópio está correcto? Use o <guilabel
>Painel de Controlo do INDI</guilabel
> para validar e alterar estas configurações (<constant
>Alt/Az,Polar, Land</constant
>).</para>
</listitem>
<listitem>
<para
>A configuração da data e hora do telescópio está correcta?</para>
</listitem>
<listitem>
<para
>A configuração da latitude e da longitude está correcta?</para>
</listitem>
<listitem>
<para
>O deslocamento de UTC do telescópio está correcto?</para>
</listitem>
<listitem>
<para
>Os eixos de AR e DEC do telescópio estão firmemente fixos?</para>
</listitem>
<listitem>
<para
>A opção de N/S do telescópio (quando se aplicar) está feita correctamente para o seu hemisfério?</para>
</listitem>
<listitem>
<para
>O cabo entre o telescópio e o computador está em boas condições?</para>
</listitem>
</orderedlist>

<para
>Se você pensa que todas as configurações estão correctas mas o telescópio ainda se continua a mover de forma errada ou não se move de todo, por favor envie um relatório de erro para <email
>indi-devel@lists.sourceforge.net</email
></para>
</answer>
</qandaentry>
</qandaset>
</sect1>
</chapter>

