# Controlo de Dispositivos Astronómicos 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
Telescópios baseados no Autostar | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.5
LX200 Clássico 16" | LX00 16" | 0.5
NexStar GPS, CGE, AS-GT | Celestron GPS | 0.5
Nova GT, NexStar 5i/8i | Celestron GPS | 0.5
Takahashi Temma | temma | 0.1
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.

## CCDs Suportados

CCD | Controlador do dispositivo | Versão
CCDs da Finger Lakes Instruments | fliccd | 0.1

## Webcam's Suportadas

Webcam | Controlador do dispositivo | Versão
Qualquer dispositivo compatível com o Video4Linux | v4ldriver | 0.1
Webcam da Philips | v4lphilips | 0.1

## Configuração do INDI

O KStars pode controlar os dispositivos locais e remotos transparentemente através da arquitectura cliente/servidor do INDI. Os dispositivos INDI podem ser corridos em três modos diferentes:

1. Local: O modo local é o mais comum e é usado para controlar um dispositivo local (&ie;, um dispositivo ligado à sua máquina).

2. 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.

3. Cliente: O modo cliente é usado para ligar aos servidores INDI remotos que estejam a correr dispositivos INDI. Você poderá controlar transparentemente os dispositivos como se fossem dispositivos locais.

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

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

Correr os controladores de dispositivos Iniciar os controladores de dispositivos

Você poderá correr os dispositivos se navegar na árvore de dispositivos, seleccionar um dispositivo específico e carregar depois no botão Executar Serviço. Você poderá seleccionar o modo de operação, sendo este local ou de servidor como é definido acima.

Para controlar os dispositivos remotos, veja a secção de controlo de dispositivos remotos.

## 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.

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 controlo de dispositivos remotos.

Você poderá usar o Assistente de Configuração do Telescópio para que verifique toda a informação necessária no processo. Ele poderá pesquisar os portos à procura de telescópios ligados. Você poderá correr o assistente se seleccionar o Assistente de Configuração do Telescópio no menu Dispositivos.

Am alternativa, 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.

### Configurações Frequentes

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.

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 suportadas por um dispositivo.

   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.

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.

## Configuração da Captura de Vídeo e do CCD

O KStars suporta os CCDs da Finger Lakes e qualquer dispositivo compatível com o Video4Linux. As funcionalidades extendidas das Webcam's da Philips são também suportadas.

Você poderá correr os dispositivos CCD e de Captura de Vídeo no Gestor de Dispositivos no menu Dispositivos. 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 Painel de Controlo do INDI.

O formato normal para a captura de imagens é o FITS. Logo que uma imagem tenha sido capturada e transferida, ela será mostrada no Visualizador de FITS do KStars. Para capturar uma sequência de imagens, use a ferramenta para Capturar uma Sequência de Imagens no menu Dispositivos. Esta ferramenta está inactiva até que você estabeleça uma ligação ao dispositivo de imagem.

## Conceitos do INDI

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 dispositivos poderão conter uma ou mais propriedades. Cada propriedade poderá conter um ou mais elementos. Existem quatro tipos de propriedades do INDI:

- Propriedade textual.

- Propriedade numérica.

- Propriedade de opção (Representada na GUI por botões e opções de selecção).

- Propriedade de luz (Representada na GUI por LEDs coloridos).

Por exemplo, todos os dispositivos INDI partilham a propriedade da opção-padrão CONNECTION. A propriedade CONNECTION tem dois elementos: as opções CONNECT e DISCONNECT. O KStars processa a descrição genérica em XML das propriedades e constrói uma representação gráfica adequada para a interacção directa com o utilizador.

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:

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

- 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` [opçõ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

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

Na máquina local, ligue-se à máquina remota, a `maquina_remota`, escrevendo:

$ `ssh` -L `porto_local`:`maquina_remota`:`porto_remoto`

Isto associa o `porto_local` da máquina local ao `porto_remoto` da `maquina_remota`. Depois de se ligar, corra o 'indiserver' na máquina remota:

$ `indiserver` -p `porto_remoto` [`controlador`...]

De volta à máquina local, inicie o &kstars;, abrindo então o Gestor de Dispositivos e adicionando uma máquina na página Cliente. A máquina deverá ser a `maquina_local` (normalmente igual a 127.0.0.1) e o número de porto deverá ser o `porto` usado em todos os passos acima. Carregue com o botão direito na máquina e seleccione Ligar 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.

## 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.

Está planeado o suporte para mais dispositivos?

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 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 se tem tanto permissões de leitura como de escrita para o porto onde se está a tentar ligar.

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

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

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

5. 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