# Controle de Dispositivo Astronômico com o INDI

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

O protocolo INDI suporta uma grande variedade de instrumentos astronômicos como câmeras CCD e focadores. Atualmente, o KStars suporta os seguintes dispositivos:

## Telescópios Suportados

Telescópio | Driver de dispositivo | Versão
--- | --- | ---
LX200 8"-12" Classic | LX200 Classic | 0.5
Telescópios baseados no Autostar | Autostar LX200 | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.5
LX200 Classic 16" | LX00 16" | 0.5
NexStar GPS, CGE, AS-GT | Celestron GPS | 0.5
New 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

## Focadores Suportados

Focador | Driver de dispositivo | Versão
--- | --- | ---
Meade LX200GPS Microfocuser | LX200 GPS | 0.1
Meade 1206 Primary Mirror Focuser | LX200 Genérico | 0.1
Séries JMI NGF | LX200 Genérico | 0.1
JMI MOTOFOCUS | LX200 Genérico | 0.1

## Conexão do focador

O focador somente deve ser conectado à porta do focador no LX200 GPS, Autostar, ou telescópios Classic.

## CCDs Suportados

CCD | Driver de dispositivo | Versão
--- | --- | ---
Finger Lakes Instruments CCDs | fliccd | 0.1

## Webcams Suportadas

Webcam | Driver de 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 controlas dispositivos remotos ou locais indiferentemente através da arquitetura cliente/servidor do INDI. Dispositivos INDI podem ser executados em três diferentes modos:

1. Local: O modo local é o mais comum sendo usado para controlar um dispositivo local (&ie; um dispositivo conectado a sua máquina).

2. Servidor: O modo servidor estabelece um servidor INDI para um dispositivo específico e espera por conexões a partir de clientes remotos. Você não pode operar dispositivos servidor, você pode somente inciá-los e desligá-los.

3. Cliente: O modo cliente é usado para conectar à servidores remotos INDI executando dispositivos INDI. Você pode controlar dispositivos remots da mesma maneira que controla dispositivos locais.

Você pode executar um dispositvo local, estabelecer servidores INDI, e conectar à clientes remotos a partir do Gerenciador do Dispositivo no menu Dispositivos.

Aqui está uma captura de tela da janela do Gerenciador de Dispositivo:

Executando drivers de dispositivo
Iniciar drivers de dispositivo

Você pode executar dispositivos navegando na árvore de dispositivos, selecionando um dispositivo específico, e então clicando no botão Executar Serviço. Você pode selecionar o modo de operação, seja local ou servidor como definido acima.

Para controlar dispositivos remotos, veja a seção controle de dispositivos remotos.

## Configuração de Teslescópio

A maioria dos telescópios são equipados com a interface RS232 para controle remoto. Conecte o plugue RS232 em seu telescópio à porta Serial/USB do seu computador. Tradicionalmente, o RS232 se conecta à porta serial do seu computador, mas uma vez que muitos dos novos laptops abandonaram a porta serial em favor das portas USB/FireWire, você pode precisar obter um adaptador Serial para USB para usar com novos laptops.

Após conectar seu telescópio à porta Serial/USB, ligue seu telescópio. É altamente recomendável que você baixe e instale o último firmware para o controlador do seu telescópio.

O telescópio precisa ser alinhado antes de poder ser usado corretamente. Alinhe seu telescópio (alinhamento de uma ou duas estrelas) como ilustrado no manual do seu telescópio.

O &kstars; precisa verificar as configurações de hora e localização antes de conectar-se ao telescópio. Isto garante o rastreamento apropriado e sincronização entre o telescópio e o &kstars;. Os passos a seguir habilitarão que você conecte-se a um dispositivo que está conectado ao seu computador. Para conectar e controlar dispositivos remotos, por favor acesse a seção controle de dispositivo remoto.

Você pode usar o Assistente de Configuração de Telescópio e ele verificará todas as informações necessárias no processo. Ele pode automaticamente procurar nas portas por telescópios conectados. Você pode executar o assistente selecionando o Assistente de Configuração de Telescópio a partir do menu Dispositivos.

Alternativamente, você pode conectar a um telescópio local executando os seguintes passos:

1. Configure sua localização geográfica. Abra a janela Configurar Localização Geográfica selecionando o Configurar Localização Geográfica... a partir do menu Configurações ou pressionando o ícone em forma de Globo na barra de ferramentas, ou ainda pressionando &Ctrl;g.

2. Configure sua hora local e data. Você pode mudar para qualquer hora ou data selecionando o Configurar Hora... a partir do menu Hora, ou pressionando o ícone hora na barra de ferramentas. A janela Configurar Hora usa o widget padrão para selecionar Data do &kde;, acoplado com três caixas de numeração para configurar as horas, minutos e segundos. Se você precisar reiniciar o relógio para a hora atual, simplesmente selecione Configurar Hora para Agora a partir do menu Hora.

3. Clique no menu Dispositivos e selecione o Gerenciador de Dispositivos.

4. Sob a coluna Dispositivo, selecione o modelo do seu telescópio.

5. Dê um clique-direito no dispositivo e selecione Executar Serviço.

6. Clique em Ok para fechar o Diálogo do Gerenciador de Dispositivo.

### Configurações Frequentes

Você não precisa configurar a localização geográfica e hora toda vez que você conecta ao seu telescópio. Somente ajuste as configurações se precisar.

Você está agora pronto para usar os recursos do dispositivo. O &kstars; convenientemente fornece duas interfaces GUI intercambiáveis para controlar os telescópios:

### Controlando seu telescópio

1. Controle de mapa Celeste: Para cada dispositivo que você executa no Gerenciador de Dispositivo, uma entrada correspondente mostrará um menu de contexto que permite controlar as propriedades do dispositivo. Você pode enviar comandos como `Rotacionar, Sincronizar,` e `Rastrear` diretamente a partir do mapa celeste.

   Aqui está uma captura de tela do menu de contexto com um dispositivo LX200 Classic ativo:

   Controlando dispositivos a partir do mapa celeste

2. Painel de Controle INDI: O painel oferece ao usuário todos os recursos suportados por um dispositivo.

   O painel é dividido em três seções principais:

   - Aba de dispositivo: Cada dispositivo ativo adicional ocupa uma aba no painel INDI. Dispositivos múltiplos pode ser executados simultaneamente sem afetar a operação de outros dispositivos.

   - Visão propriedade: Propriedades são os elementos chave na arquitetura INDI. Cada dispositivo define um conjunto de propriedades para comunicar-se com o cliente. A posição atual do telescópio é um exemplo de uma propriedade. Propriedades semanticamente similares são normalmente reunidas em blocos ou grupos lógicos.

   - Visualizadores de registro: Dispositivos relatam seu estado e comando reconhecidos enviando mensagens INDI. Cada dispositivo possui seu próprio visualizador de registro, e todos os dispositivos compartilham um visualizador de registro genérico. Um dispositivo normalmente envia mensagens para seu driver de dispositivo somente, mas a um dispositivo é permitido enviar uma mensagem genérica quando apropriado.

   Painel de Controle INDI

Você não está restrito a usar uma interface ou outra uma vez que elas podem ser usadas simultaneamente. Ações a partir do Mapa celeste são automaticamente refletidas no Painel de Controle INDI e vice-versa.

Para conectar ao seu telescópio, você pode tanto selecionar Conectar a partir do menu de contexto ou, alternativamente, pressionar o Conectar sob a aba de dispositivo no Painel de Controle INDI.

Por padrão, o KStars tentará conectar à porta `/dev/ttyS0`. Para mudar a porta de conexão, selecione no Painel de Controle INDI o menu Dispositivos e mude a porta na aba do seu dispositivo.

O &kstars; automaticamente atualiza a longitude, latitude e hora do telescópio baseado nas configurações atuais do &kstars;. Você pode habilitar/desabilitar esta atualização a partir do diálogo Configurar INDI.

Se o &kstars; se comunicar com sucesso com o telescópio, ele obterá o RA e DEC atuais do telescópio e exibirá uma cruz no mapa celeste indicando a posição do telescópio.

### Sincronizando seu telescópio

Se você alinhou seu telescópio e o última estrela alinhada foi, por exemplo, Vega, então a cruz deve estar centrada próximo a Vega. Se a cruz estiver fora do alvo, então você pode dar um clique-direito em Vega no mapa estelar e selecionar `Sincronizar` a partir do menu do seu telescópio. Esta ação instruirá o telescópio a sincronizar suas coordenadas internas para corresponder com as de Vega, e a cruz do telescópio deve agora estar centrada próximo à Vega.

É isto: seu telescópio está pronto para explorar o universo.

### ALERTA

Nunca usa o telescópio para olhar o sol. Olhar diretamente o sol pode causar um dano irreversível aos seus olhos, bem como ao seu equipamento.

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

O KStars suporta instrumentos CCDs Finger Lakes e qualquer dispositivo compatível com o Video4Linux. Webcams Philips com recursos extendidos são também suportadas.

Você pode executar dispositivos de Captura de Vídeo e CCD a partir do Gerenciador de Dispositivos no menu Dispositivos. Como todos os dispositivos INDI, alguns controles do dispositivo serão acessíveis a partir do mapa celeste. O dispositivo pode ser controlado totalmente a partir do Painel de Controle INDI.

O formato padrão para captura de imagem é o FITS. Uma vez que uma imagem seja capturada e baixada, ela será exibida no Visualizador FITS do KStars. Para capturar uma sequência de imagens, use a ferramentas Capturar Sequência de Imagens a partir do menu Dispositivos. Esta ferramenta fica inativa até você estabelecer uma conexão com um dispositivo de imagem.

## Conceitos do INDI

O conceito chave no INDI é que os dispositivos possuem a habilidade de descreverem-se a si mesmos. Isto é conseguido usando o XML para descrever uma hierarquia genérica que pode representar tanto dispositivos canônicos como não canônicos. No INDI, todos os dispositivos podem conter uma ou mais propriedades. Qualquer propriedade pode conter um ou mais elementos. Existem quatro tipos de propriedades INDI:

- Propriedade textual.

- Propriedade numérica.

- Propriedade de opção/ação (Representadas na GUI por botões e caixas de opção).

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

Por exemplo, todos os dispositivos INDI compartilhas a propriedade de opção/ação padrão CONNECTION. A propriedade CONNECTION possui dois elementos: as chaves CONNECT e DISCONNECT. O KStars analisa a descrição XML genérica das propriedades e constrói uma representação de interface gráfica adequada para interação humana direta.

O painel de controle INDI oferece muitas propriedades do dispositivo não acessíveis a partir do mapa celeste. As propriedades oferecidas diferem de um dispositivo para outro. No entanto, todas as propriedades compartilham recursos que indicam como eles são exibidos e usados:

- Permissão: Todas as propriedades podem estar habilitadas tanto para leitura-somente, como para escrita-somente, ou ainda para leitura e escrita. Um exemplo de uma propriedade de leitura e escrita é a Acensão Direta (do inglês, RA) do telescópio. Você pode inserir uma nova Acensão Direta e o telescópio, baseado nas configurações atuais, rotacionará e sincronizará para a nova entrada. Além disso, quando o telescópio rotaciona, sua Acensão Direta é atualizada e enviada para o cliente.

- Estado: Prefixado para cada propriedade é um indicador de estado (LED redondo). Cada propriedade possui um estado e um código de cor associado:

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

  Estado | Cor | Descrição
  --- | --- | ---
  Disponível | Cinza | O dispositivo não está executando nenhuma ação relacionada a esta propriedade
  Ok | Verde | A última operação realizada nesta propriedade foi bem sucedida e ativa
  Ocupado | Amarelo | A propriedade está executando um ação
  Alerta | Vermelho | A propriedade está em uma condição crítica e precisa de atenção imediata

  O driver do dispositivo atualiza o estado da propriedade em tempo real quando necessário. Por exemplo, se o telescópio está no processo de rotação para um alvo, então as propriedades RA/DEC serão assinaladas como Ocupada. Quando o processo de rotação estiver completado com sucesso, as propriedades serão assinaladas como Ok.

- Contexto: Propriedades numéricas pode aceitar e processar números em dois formatos: decimal e sexagesimal. O formato sexagesimal é conveniente para expressar hora ou coordenadas equatoriais/geográficas. Você pode usar qualquer formato de acordo com sua conveniência. Por exemplo, todos os seguintes números são iguais:

  - -156,40

  - -156:24:00

  - -156:24

- Hora: A hora padrão para todos as comunicações relacionadas com o INDI é a Hora Universal UTC especificada como AAAA-MM-DDTHH:MM:SS de acordo com a ISO 8601. O &kstars; comunica a hora correta UTC com os drivers do dispositivo automaticamente. Você pode habilitar/desabilitar atualizações de hora a partir do diálogo Configurar INDI sob o menu Dispositivos.

## Controle de Dispositivo Remoto

O KStars fornece uma camada simples e poderosa para controle de dispositivo remoto. Uma descrição detalhada da camada é descrita na folha técnica do INDI.

Você precisa configurar tanto a máquina servidora como a cliente para controle remoto:

1. Servidor: Para preparar um dispositivo para controle remoto, siga os seguintes passos na configuração local/servidor. Ao iniciar um serviço de dispositivo no Gerenciador de Dispositivo, um número de porta é exibido na coluna Ouvir porta. Além do número da porta, você também precisará do nome de máquina ou endereço IP do seu servidor.

2. Cliente: Selecione o Gerenciador de Dispositivo a partir do menu Dispositivo e clique na aba Cliente. Você pode adicionar, modificar ou excluir máquinas na aba Cliente. Adicione uma máquina clicando no botão Adicionar. Insira o nome de máquina/endereço IP do servidor no campo Máquina, e insira o número da porta obtido da máquina servidora no passo 1.

Cliente INDI

Após você adicionar uma máquina, dê um clique direito na máquina para Conectar ou Desconectar. Se uma conexão for estabelecida, você pode controlar o telescópio a partir do Mapa celeste ou do Painel de Controle INDI exatamente como descrito na seção local/servidor. Isto é muito fácil!

### Executando um servidor INDI a partir da linha de comando

Apesar do &kstars; permitir que você facilmente estabeleça um servidor INDI, você pode lançar um servidor INDI a partir da linha de comando.

Uma vez que o INDI é um componente de backend independente, você pode rodar um servidor INDI em uma máquina sem o KStars. O INDI pode ser compilado separadamente para ser executado em máquinas remotas. Além do mais, drivers de dispositivo registram mensagens para o `stderr` e que podem ser úteis na depuração de uma situação. A sintaxe para um servidor INDI é a seguinte:

$ `indiserver` [options] [`driver` ...]

Opções:

-p p : alterna porta IP, padrão é 7624

-r n : máximas tentativas de reinicialização , padrão é 2

-v : mensagens de erro mais elucidativas para o stderr

Por exemplo, se você deseja iniciar um servidor INDI rodando um driver LX200 GPS e recebendo conexões na porta 8000, você deve executar o seguinte comando:

$ `indiserver` -p 8000 `lx200gps`

### Operação Remota Segura

Suponhamos que nós desejemos executar um servidor indi com drivers INDI em uma máquina remota, `maquina_remota`, e conectá-lo ao &kstars; executado em uma máquina local.

A partir da máquina local registrar a máquina remota, `maquina_remota`, digitando:

$ `ssh` -L `porta_local`:`maquina_remota`:`porta_remota`

Isto conecta a `porta_local` na máquina local à `porta_remota` na `maquina_remota`. Após o login, executar o servidor indi na máquina remota:

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

De volta a máquina local, inicie o &kstars; e então abra o Gerencionador de Dispositivo e adicione uma máquina na aba Cliente. A máquina deve ser a máquina local (normalmente 127.0.0.1) e o número da porta deve ser a `porta_local` usada nos passos anteriores. Dê um clique-direito na máquina e selecione Conectar a partir do menu de contexto. O &kstars; conectará ao servidor INDI de maneira segura. As informações da máquina serão salvas para sessões futuras.

## Perguntas Frequentes sobre o INDI

O que é o INDI?

O INDI é o protocolo de controle denominado, do inglês, Interface Distribuída Neutra de Instrumento desenvolvido por Elwood C. Downey do Instituto ClearSky. O &kstars; emprega drivers de dispositivo que são compatíevis com o protocolo INDI. O INDI possui muitas vantagens incluindo a perda do acoplamento entre dispositivos de hardware e drivers de software. Clientes que usam os drivers de dispositivos (como o &kstars;) são completamente inconscientes das capacidades do dispositivo. No momento da execução, o &kstars; se comunica com os drivers de dispositivo e constrói uma GUI completamente dinâmica baseada nos servições fornecidos pelo dispositivo. Logo, novos drivers de dispositivo podem ser escritos e atualizados e o KStars pode obter todas as vantagens que ele oferece sem precisar de nenhuma mudança no lado cliente.

Vocês planejam suportar mais dispositivos?

Sim. Nós planejamos suportar a maioria das câmeras CCD e focadores e extender o suporte para mais telescópios. Se você gostaria que o INDI suportasse um dispositivo em particular, por favor envie uma mensagem eletrônica para indi-devel@lists.sourceforge.net

Eu não possuo uma porta serial. Como eu posso conectar o telescópio?

Muitos laptops modernos não possuem uma porta serial. Você precisará de uma adaptador Serial Para USB que seja suportado pelo Linux. Por exemplo, o adaptador Serial Para USB USA-19QW da Keyspan é bem suportado pelo Linux e foi testado com o &kstars;. Você precisa verificar na documentação do seu adaptador que portas eles fornecem (por exemplo, `/dev/ttyUSB0 ... /dev/ttyUSB9`).

Quando eu tento Conectar, o &kstars; relata que o telescópio não está conectado com a porta serial/USB. O que eu posso fazer?

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

1. Verifique se você tem tanto permissão de leitura como de escrita para a porta que você está tentando conectar-se.

2. Verificar a conexão do cabo, certificando-se de que ela está em boas condições e testá-la com outros aplicativos.

3. Verificar a energia do telescópio, certificando-se de que ele esteja ligado e que esteja recebendo energia suficiente.

4. Configurar a porta correta no Painel de Controle INDI do menu Dispositivos. A porta padrão é `/dev/ttyS0`

5. Reiniciar o &kstars; e tentar novamente.

O &kstars; relata que o telescópio está on-line e pronto, mas eu não consigo encontrar a cruz do telescópio. O que é isto?

O &kstars; obtém as coordenadas RA e DEC a partir da conexão. Se seu alinhamento foi realizado corretamente, então você deve ver a cruz próxima ao seu alvo no Mapa Celeste. No entanto as coordenadas RA e DEC fornecidas pelo telescópio podem estar incorretas (mesmo abaixo do horizonte) e você precisará sincronizar seu telescópio para seu alvo atual.

O telescópio está se movendo erraticamente ou não realiza nenhum movimento. O que eu posso fazer?

Este comportamente é normalmente resultado de configurações incorretas. Por favor verifique a seguinte lista de checagem:

1. O telescópio está alinhado?

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

3. As configurações de data e hora do telescópio estão corretas?

4. As configurações de latitude e longitude do telescópio estão corretas?

5. O desvio UTC do telescópio está correto?

6. Os eixos RA e DEC do telescópio estão travados firmemente?

7. A configuração de troca N/S do telescópio (quando aplicável) está correta para o seu hemisfério?

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

Se você acha que todas as configurações estão corretas mas o telescópio ainda continua a mover-se erraticamente ou a não mover-se, então por favor envie um relatório para o kstars-devel@kde.org