# Controlo de Telescópios com o INDI

O KStars fornece uma interface para configurar e controlar os instrumentos astronómicos através do protocolo INDI.

O protocolo INDI suporta uma variedade de instrumentos astronómicos, como as câmaras CCD e os sistemas de foco. De momento, o KStars suporta os seguintes dispositivos:

## Telescópios Suportados

Telescópio | Controlador do dispositivo | Versão
--- | --- | ---
LX200 8"-12" Clássico | LX200 Clássico | 0.5
LX-90, LX50, ETX90 | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.2
LX200 Clássico 16" | LX00 16" | 0.2
Celestron GPS | Celestron GPS | 0.2
Celestron NexStar | Celestron GPS | 0.2
Astro-Physics AP | LX200 Genérico | 0.1
Astro-Electronic FS-2 | LX200 Genérico | 0.1
Losmandy Gemini | LX200 Genérico | 0.1
Controladores Mel Bartels | LX200 Genérico | 0.1

## Sistemas de Foco Suportados

Sistema | Controlador do dispositivo | Versão
--- | --- | ---
Meade LX200GPS Microfocuser | LX200 GPS | 0.1
Meade 1206 Primary Mirror Focuser | LX200 Genérico | 0.1
Série JMI NGF | LX200 Genérico | 0.1
JMI MOTOFOCUS | LX200 Genérico | 0.1

## Ligação do sistema de foco

Os sistemas de foco precisam de estar ligados ao porto do sistema apenas nos telescópios LX200 GPS, Autostar, ou Clássico.

O KStars poderá controlar os dispositivos locais e remotos transparentemente através da arquitectura cliente/servidor do INDI. A configuração local/servidor é usada para controlar um dispositivo local (i.e., um dispositivo ligado à sua máquina) e é também usado para estabelecer um servidor ao qual os clientes remotos se poderão ligar. Uma configuração cliente/remoto é usada para ligar um cliente às máquina remotas que estão a correr num servidor de INDI.

O controlo do seu telescópio com o KStars necessita de uns poucos passos simples. É vital completar cada passo, antes de passar para o próximo.

## Configuração do Telescópio

A maioria dos telescópios estão equipados com interfaces RS232 para o controlo remoto. Ligue a ficha RS232 no seu telescópio à porta Série/USB 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 USB/FireWire, você poderá ter de optar um adaptador de série para USB para poder usar nos novos portáteis.

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

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.

## Configuração de INDI do KStars

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 dispostivos remotos, por favor veja a secção controlo de dispositivos remotos.

Para se ligar a um telescópio, por favor efectue os seguintes passos:

1. Configure a sua localização geográfica. Abra a janela Localização Geográfica seleccionando a opção Localização Geográfica... do menu Configuração ou se carregar no ícone do Globo da barra de ferramentas ou ainda se carregar em &Ctrl;g.

2. Configure a sua data e hora locais. Você poderá mudar para qualquer data e hora se seleccionar a opção Acertar o Relógio... no menu Tempo ou carregando no ícone tempo da barra de ferramentas. A janela Acertar o Relógio usa um item gráfico de Extracção de Datas do &kde;, em conjunto com três opções para definir as horas, minutos e segundos. Se você precisar de repor o relógio de volta na hora actual, basta seleccionar a opção Acertar a Hora para Agora no menu Tempo.

3. Carregue no menu Dispositivos e seleccione o Gestor de Dispositivos.

4. Na coluna Dispositivo, seleccione o modelo do seu telescópio.

5. Carregue com o botão direito no dispositivo e seleccione a opção Executar Serviço.

6. Carregue em Ok para fechar a Janela de Gestão dos Dispositivos.

Aqui está uma imagem da janela do Gestor de Dispositivos:

Correr os controladores de dispositivos
Iniciar os controladores de dispositivos

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

### Controlar o seu telescópio

1. Controlo do Mapa do Céu: Para cada dispositivo que você execute no Gestor de Dispositivos, aparecerá um menu de contexto para cada item correspondente que lhe permite controlar as propriedades do dispositivo. Você poderá enviar comandos do tipo `Mover, Sincronizar,` e `Seguir` directamente a partir do mapa do céu.

   Aqui está uma imagem do menu de contexto que aparece para um dispositivo LX200 Clássico activo:

   Controlar os dispositivos do mapa do céu

2. Painel de Controlo do INDI: O painel oferece ao utilizador todas as funcionalidades que um dispositivo suporta para um maior controlo sobre o telescópio. As propriedades como a configuração da porta, a gestão do sítio e os controlos de movimento, entre outros, poderão ser manipulados a partir do painel de controlo do INDI.

   O painel está dividido em três secções principais:

   - Páginas do dispositivo: 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.

   - Janela de propriedades: As propriedades são o elemento-chave na arquitectura do INDI. Cada dispositivo define um conjunto de propriedades para comunicar com o cliente. A posição actual do telescópio é um exemplo de uma propriedade. As propriedades semanticamente semelhantes estão normalmente contidas em blocos ou grupos lógicos.

   - Visualizadores de registos: Os dispositivos comunicam o seu estado e os comandos de reconhecimento, enviando as mensagens do INDI. Cada dispositivo tem o seu próprio registo, e todos os dispositivos partilham um visualizador de registos genérico. Um dispositivo envia normalmente mensagens apenas para o seu controlador, mas um dispositivo poderá também enviar uma mensagem genérica, sempre que for apropriado.

   Painel de Controlo de INDI

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 Mapa do céu são automaticamente reflectidas no Painel de Controlo do INDI e vice-versa.

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

Por omissão, o KStars irá tentar ligar-se à porta `/dev/ttyS0`. Para mudar a porta de ligação, seleccione o Painel de Controlo do INDI no menu Dispositivos e mude a porta na página do seu dispositivo.

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 Configurar o INDI no menu Dispositivos.

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

### Sincronizar o seu telescópio

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 direito em Vega no mapa do céu e seleccionar `Sincronizar` 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.

É tudo! O seu telescópio está pronto para explorar os céus!

### ATENÇÃO

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

## Conceitos do INDI

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 ofereceidas diferem de dispositivo para dispositivo. Todavia, todas as propriedades partilham funcionalidades comuns que restringem a forma como são apresentados e usados:

- Permissão: Todas as propriedades podrã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.

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

  ### Código de cor do estado do INDI

  Estado | Cor | Descrição
  --- | --- | ---
  Inactivo | Cinzento | O dispositivo não está a efectuar nenhuma acção respeitante a esta propriedade
  Ok | Verde | A última operação efectuada neste propriedade foi bem-sucedida e está activa
  Ocupado | Amarelas | A propriedade está a efectuar uma acção
  Alerta | Red | A propriedades está numa condição crítica e precisa de atenção imediata

  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 Ocupadas. Quando o processo de movimentação tiver completado com sucesso, as propriedades ficarão assinaladas como Ok.

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

  - -156,40

  - -156:24:00

  - -156:24

- Tempo: O tempo-padrão para todas as comunicações relacionadas com o INDI é o Tempo Universal UTC indicado no formaot AAAA-MM-DDTHH:MM:SS em acordo com o ISO 8601. O &kstars; comunica a hora correcta em UTC com os controladores de dispositivos automaticamente. Você poderá activar/desactivar as actualizações de tempos automáticas com a janela Configurar o INDI no menu Dispositivos.

## Controlo de Dispositivos Remotos

O KStars fornece uma camada simples mas poderosa para controlar dispositivos remotos. Uma descrição mais detalhada da camada está descrita no artigo do INDI.

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

1. Servidor: Para preparar um dispositivo para ser controlado remotamente, siga os mesmos passos que para a configuração local/servidor. Quando você iniciar o serviço de um dispositivo no Gestor de Dispositivos, é mostrado um número de porto na coluna Porto de Espera. Para além do número de porto, você precisa do nome da máquina ou do endereço IP do seu servidor.

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

Cliente INDI

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

### Correr um servidor de INDI na linha de comandos

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.

Dado que o INDI é um componente de infra-estrutura independente, você poderá correr um servidor de INDI numa máquina sem o KStars. O INDI pode ser compilado em separado para correr em máquinas remotas. Para além disso, os controladores de dispositivos mandam as mensagens para o `stderr` e isso poderá ser útil numa situação de depuração. A sintaxe para o servidor de INDI é a seguinte:

$ `indiserver` [optções] [`controlador` ...]

Opções:

-p p : porto IP alternativo, por omissão é o 7624

-r n : máximo de tentativas de reinicialização, por omissão 2

-v : mais descritivo no 'stderr'

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:

$ `indiserver` -p 8000 `lx200gps`

### Operação Remota Segura

Suppose we want to run an indiserver with INDI drivers on a remote host, `remote_host`, and connect them to &kstars; running on the local machine.

From the local machine log onto the remote host, `remote_host`, by typing:

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

This binds the `local_port` on the local machine to the `remote_port` on the `remote_host`. After logging in, run indiserver on the remote host:

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

Back on the local machine, start &kstars; then open the Device Manager and add a host under the Client tab. The host should be the local host (usually 127.0.0.1) and the port number should be the `local_port` used in the steps above. Right-click on the host and select Connect from the popup menu. &kstars; will connect to the remote INDI server securely. The host information will be saved for future sessions.

## Perguntas Mais Frequentes do INDI

O Que é o INDI?

O INDI é o protocolo de controlo da Instrument-Neutral-Distributed-Interface que foi desenvolvido por Elwood C. Downey do ClearSky Institute. O &kstars; usa controladores de dispositivos que sejam compatíveis com o protocolo INDI. O INDI tem muitas vantagens, incluindo uma separação lógica entre os controladores de dispositivos e os controladores de 'software'. Os cliente que usam os controladores de dispositivos (como o &kstars;) não sabem nada sobre as capacidades do dispositivo. Na altura da execução, o &kstars; comunica com os controladores de dispositivos e cria uma interface completamente dinâmica com base nos serviços fornecidos pelo dispositivo. Como tal, poderão ser criados ou actualizados novos controladores para que o KStars tire partido completo deles sem alterar nada do lado do cliente.

Quais os dispositivos que o KStars suporta?

De momento, o &kstars; suporta o LX200 Clássico, LX200 Autostar, LX200 GPS, LX200 16" e o Celestron GPS.

Está planeado o suporte para mais dispositivos?

Sim. Planeamos suportar as câmaras CCD e sistemas de foco mais importantes e extender o supore para mais telescópios. Se você gostar que o INDI suporte um dispositivo em particular, envie por favor um e-mail para indi-devel@lists.sourceforge.net

Não tenho nenhuma porta série, como é que poderei ligar-me ao telescópio?

Muitos dos portáteis mais modernos não têm nenhuma porta série. Você irá precisar de um adaptador de Série para USB que seja suportado no Linux. Por exemplo, o adaptador de Série-USB USA-19QW da Keyspan é bem suportado no Linux e foi testado com o &kstars;. Você precisa de ver a documentação do seu adaptador para descobrir as portas que fornecem (e.g., a `/dev/ttyUSB0 .... /dev/ttyUSB9`).

Quando me tento Ligar, o &kstars; diz que o telescópio não está ligado à porta série/USB. O que é que posso fazer?

Esta mensagem é desencadeada quando o &kstars; não consegue comunicar com o telescópio. Aqui estão algumas coisas que você pode fazer:

1. Verifique a ligação do cabo, certifique-se que está em boas condições e teste-a com outras aplicações.

2. Verifique a alimentação do seu telescópio, certifique-se que este está ligado e que tem alimentação suficiente.

3. Configure a porta correcta no Painel de Controlo do INDI no menu Dispositivos. A porta por omissão é a `/dev/ttyS0`

4. Reinicie o &kstars; e tente de novo.

O &kstars; diz que o telescópio está ligado e pronto, mas não consigo encontrar a mira do telescópio; onde é que está?

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 Sincronizar o seu telescópio com o seu alvo actual.

O telescópio está-se a mover de forma errada ou não se mexe de todo. O que posso fazer?

Este comportamento deve-se em grande parte a configurações incorrectas; por favor verifique a seguinte lista:

1. O telescópio está alinhado?

2. O modo de alinhamento do telescópio está correcto? Use o Painel de Controlo do INDI para validar e alterar estas configurações (`Alt/Az,Polar, Land`).

3. A configuração da data e hora do telescópio está correcta?

4. A configuração da latitude e da longitude está correcta?

5. O deslocamento de UTC do telescópio está correcto?

6. Os eixos de AR e DEC do telescópio estão firmemente fixos?

7. A opção de N/S do telescópio (quando se aplicar) está feita correctamente para o seu hemisfério?

8. O cabo entre o telescópio e o computador está em boas condições?

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 kstars-devel@kde.org