# 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 focalizadores. Para uma lista atualizada dos dispositivos suportados, por favor visite a página de dispositivos suportados do INDI.

## Configuração do INDI

O &kstars; pode controlar 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 iniciá-los e desligá-los.

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

Você pode executar um dispositivo local, estabelecer servidores INDI, e conectar à clientes remotos a partir do Gerenciador de 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 o dispositivo específico, e então clicando no botão Executar serviço. Você pode selecionar o modo de operação, tanto local como servidor como definido acima. O número da porta é gerado aleatoriamente dentro do intervalo de 7624 a 10.000. Para especificar uma porta, clique na coluna porta próxima do controlador desejado. O &kstars; permite que vários controladores rodem em um servidor INDI, e mesmo em uma porta. Selecione vários controladores e então pressione o botão Executar serviço.

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

## Configuração de telescó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 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 Definir localização geográfica selecionando 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;,. 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. Clique no botão Executar serviço.

6. Clique em Fechar para deixar 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 gráficas 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.

   - Visualizações de propriedade nas abas Controle principal e Opções: 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.

   - Visualizador de registro: Dispositivos relatam seu estado e comando reconhecidos enviando mensagens INDI. Cada dispositivo possui seu próprio visualizador de registro. 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 do menu Dispositivos.

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!

### AVISO

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

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á automaticamente exibida no visualizador FITS do &kstars;.

## Configurar INDI

A página INDI permite a você modificar as opções específicas do lado cliente do INDI. A janela é dividida em diversas categorias principais: geral, atualizações automáticas do dispositivo, tela, atualizar fonte, roda de filtro e porta do servidor:

- Geral

  - `Diretório FITS padrão:` Especifica o diretório onde todas as imagens FITS capturadas serão salvas. Se nenhum diretório for especificado, as imagens serão salvas no $HOME.

  - `Porta do telescópio:` A porta padrão do telescópio. Quando você conecta a um serviço de telescópio local ou remoto, o &kstars; irá automaticamente preencher a porta do dispositivo telescópio com a porta padrão especificada.

  - `Porta de vídeo:` A porta de vídeo padrão. Quando você conecta a um serviço de vídeo local ou remoto, o &kstars; irá automaticamente preencher a porta do dispositivo webcam com a porta padrão especificada.

- Atualizações automáticas de dispositivo

  - `Tempo:` Atualiza a data e hora do telescópio, se suportado, durante a conexão.

  - `Localização geográfica:` Atualiza a informação de localização geográfica do telescópio (longitude e latitude atual), se suportado, durante a conexão.

- Tela

  - `Mira do dispositivo:` Quando marcado, o &kstars; exibe a mira do telescópio no mapa do céu. A mira é exibida sobre uma conexão com sucesso ao telescópio e sua localização é atualizada periodicamente. O nome do telescópio é exibido próximo à mira. O &kstars; exibe uma mira para cada telescópio conectado. Para alterar a cor da mira do telescópio, abra a janela Configurar o &kstars;. Selecione a aba Cores e então altere a cor do item Indicador de mira para a cor desejada.

  - `Mensagens INDI na barra de status:` Se marcado, o &kstars; exibe mensagens de status do INDI na barra de status do &kstars;.

  - `Mostra FITS automaticamente ao capturar:` Quando marcado, o &kstars; irá exibir o FITS capturado na ferramenta Visualizador FITS do &kstars;.

- Atualizar fonte: sincroniza o &kstars; de acordo com as configurações de hora e localização do computador ou do dispositivo.

- Roda de filtros: atribui códigos de cores para os slots da roda de filtros (por ex.: Slot #0 vermelho, Slot #1 azul.. etc). Você pode atribui códigos de cores para até 10 slots do filtro (0 a 9). Para atribuir um código de cor, selecione o número do slot da caixa de combinação suspensa e digite o código de cor correspondente no campo de edição. Repita o procedimento para todos os slots desejados e então pressione OK.

- Porta do servidor: Especifica o intervalo de portas que o Servidor INDI irá se conectar ao iniciar novos dispositivos.

## 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 interface gráfica por botões e caixas de opção).

- Propriedade de luz (representada na interface gráfica 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 da página INDI da janela de configurações.

## 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 infraestrutura 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` [opções] [`driver` ...]

Opções:

-l d : log das mensagens do driver para d/YYYY-MM-DD.islog

-m m : matar o cliente se obter mais que estes MB, padrão 10

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

-f caminho : Caminho da FIFO para início e parada dinâmicos dos controladores.

-v : exibir eventos chave, sem tráfego

-vv : -v + conteúdo da mensagem chave

-vvv : -vv + xml completo

driver : executável ou dispositivo@maquina[:porta]

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 Gerenciador de dispositivos 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, Instrument-Neutral-Distributed-Interface (Interface Distribuída Neutra de Instrumento) desenvolvido por Elwood C. Downey do Instituto ClearSky. O &kstars; emprega drivers de dispositivo que são compatíveis 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 interface gráfica 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 focalizadores e ampliar 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

Quais operações o &kstars; fornece para controlar o telescópio?

Isto depende do telescópio em particular que você está usando, mas as três operações mínimas são `Rotação`, `Rastrear` e `Sincronizar`, que você pode usá-las diretamente do mapa do céu. Seu telescópio deve estar alinhado para estas operações serem executadas corretamente. Alguns telescópios oferecem mais operações como gerenciamento de sites, modos de rotação, foco, parking e mais. Você pode acessar os recursos estendidos do telescópio no painel de controle do INDI no menu de dispositivos.

Qual é a diferença entre `Rotação`, `Rastrear` e `Sincronizar` exatamente?

O comando `Rotação` ordena o telescópio a mover-se para um destino em particular e uma vez que o telescópio atinge o destino, o telescópio continua rastreando este destino numa taxa sidereal (por ex.: a taxa a qual a estrela se move pelo céu). Este trabalho funciona bem para estrelas, objetos Messier e sobre tudo fora de nosso sistema solar. Mas os objetos do sistema solar viajam através do céu, então o telescópio deve `Rastrear` os objetos conforme estes movem.

No entanto, você precisa emitir um comando de rastreio se quiser rastrear um objeto com movimento não sideral. Por outro lado, `Sincronizar` é usado para sincronizar as coordenadas internas do telescópio com aquelas do objeto que você selecionou.

Posso controlar meu telescópio remotamente?

Sim. Você pode iniciar um servidor INDI na máquina conectada ao seu telescópio e o servidor irá escutar as requisições dos clientes &kstars;. Uma vez que você estiver conectado, você pode controlar o seu telescópio diretamente do mapa celeste. Este procedimento está descrido em detalhes na seção controle de dispositivo remoto.

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 do telescópio 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. Você pode usar o menu do clique direito para centralizar e rastrear a cruz do telescópio no mapa celeste.

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

Este comportamento é 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 indi-devel@lists.sourceforge.net