# Controllo di periferiche astronomiche con INDI

KStars fornisce un'interfaccia per configurare e controllare strumenti astronomici tramite il protocollo INDI.

Il protocollo INDI supporta una vasta gamma di strumenti astronomici, quali camere CCD e focheggiatori. Attualmente KStars supporta i seguenti dispositivi:

## Telescopi supportati

Telescopio | Driver | Versione
--- | --- | ---
LX200 8"-12" Classico | LX200 Classico | 0.5
Telescopi basati su Autostar | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.5
LX200 Classico 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 Generico | 0.1
Astro-Electronic FS-2 | LX200 Generico | 0.1
Losmandy Gemini | LX200 Generico | 0.1
Controller Mel Bartels | LX200 Generico | 0.1

## Focheggiatori supportati

Focheggiatore | Driver | Versione
--- | --- | ---
Microfocheggiatore Meade LX200GPS | LX200 GPS | 0.1
Focheggiatore specchio primario Meade 1206 | LX200 Generico | 0.1
Serie JMI NGF | LX200 Generico | 0.1
JMI MOTOFOCUS | LX200 Generico | 0.1

## Connessione focheggiatore

I focheggiatori vanno connessi alla porta apposita soltanto nei telescopi LX200 GPS, Autostar o classico.

## CCD supportati

CCD | Driver | Versione
--- | --- | ---
CCD Finger Lakes Instruments | fliccd | 0.1

## Webcam supportate

Webcam | Driver | Versione
--- | --- | ---
Qualsiasi periferica compatibile Video4Linux | v4ldriver | 0.1
Webcam Philips | v4lphilips | 0.1

## Configurazione INDI

KStars può controllare indifferentemente periferiche locali e remote tramite l'architettura client/server INDI. Le periferiche INDI possono funzionare in tre modalità differenti:

1. Locale: la modalità locale è la più comune, ed è utilizzata per controllare periferiche locali (cioè direttamente collegate al tuo computer).

2. Server: questa modalità avvia un server INDI per una certa periferica e attende connessioni da client remoti. Non puoi gestire periferiche server, puoi soltanto accenderle e spegnerle.

3. Client: la modalità client è utilizzata per connettersi a server INDI remoti collegati a periferiche INDI. Puoi controllare le periferiche remote come se fossro in locale.

Puoi gestire periferiche locali, avviare un server INDI e connetterti a client remoti tramite il Gestore periferiche nel menu Periferiche.

Ecco un'immagine della finestra del Gestore periferiche:

Driver di periferica in esecuzione
Avvia driver di periferica

Puoi gestire periferiche scorrendone l'albero, selezionandone una e facendo clic sul pulsante Avvia servizio. Puoi selezionare la modalità di operazione, locale o server, come descritto in precedenza.

Per controllare periferiche remote, fai riferimento alla sezione Controllo periferiche remote

## Impostazione telescopio

La maggior parte dei telescopi sono equipaggiati con un'interfaccia RS232 per il controllo remoto. Connetti il jack RS232 sul tuo telescopio alla porta seriale/USB del tuo computer. Tradizionalmente la RS232 si connette alla porta seriale; tuttavia, dato che molti nuovi portatili hanno rinunciato alla seriale in favore di porte USB/FireWire, potrebbe essere necessario ottenere un adattatore da seriale a USB.

Dopo aver connesso il telescopio alla porta seriale/USB, accendilo. È vivamente consigliato scaricare e installare il firmware più recente per il controller del telescopio.

Il telescopio dev'essere allineato prima di poterlo utilizzare correttamente. Esegui questa operazione (allineamento a una o due stelle) come illustrato nel manuale del telescopio.

&kstars; deve verificare le impostazioni di data e ora e della località prima di connettersi al telescopio. Ciò assicura un corretto inseguimento e sincronizzazione tra il telescopio e &kstars;. I passi seguenti ti permetteranno di connetterti a una periferica direttamente collegata al tuo computer. Per la connessione e il controllo di periferiche remote, vedi la sezione controllo periferiche remote.

Puoi utilizzare la procedura guidata di configurazione del telescopio, la quale verificherà tutte le informazioni richieste. È in grado di controllare automaticamente le porte e rilevare telescopi connessi. Puoi avviare la procedura selezionando Configurazione telescopio... dal menu Periferiche

In alternativa, puoi connetterti a un telescopio locale seguendo i passi descritti di seguito:

1. Imposta la tua località geografica. Apri la finestra Imposta località geografica selezionando Imposta località geografica... dal menu Impostazioni, o premendo l'icona globo sulla barra degli strumenti, o ancora premendo &Ctrl;g.

2. Imposta la data e l'ora locali. Puoi passare a un'ora e data qualsiasi selezionando Imposta data/ora... dal menu Tempo, o premendo l'icona tempo nella barra degli strumenti. La finestra Imposta data/ora fa uso di un elemento grafico standard di &kde; per la selezione della data, insieme a tre caselle per impostare ore, minuti e secondi. Nel caso tu debba riportare l'orologio all'ora corrente, basta selezionare Usa ora corrente dal menu Tempo.

3. Fai clic sul menu Periferiche e seleziona Gestore periferiche....

4. Sotto la colonna Periferica, seleziona il modello del tuo telescopio.

5. Fai clic col pulsante destro del mouse sulla periferica e seleziona Avvia servizio.

6. Fai clic su Ok per chiudere la finestra del Gestore periferiche.

### Impostazioni frequenti

Non devi impostare l'ora e la località geografica ogni volta che ti connetti a un telescopio. È sufficiente regolare le impostazioni secondo le necessità.

Ora sei pronto per utilizzare le funzioni della periferica. &kstars; mette a disposizione due interfacce grafiche intercambiabili per il controllo dei telescopi:

### Controllare il telescopio

1. Controllo dalla mappa celeste: per ogni periferica in esecuzione nel Gestore periferiche apparirà una voce corrispondente nel menu a comparsa, tramite la quale potrai controllare le proprietà della periferica. Puoi dare comandi quali `Slew, Sync,` e `Track` direttamente dalla mappa celeste.

   Ecco un'immagine del menu a comparsa con una periferica "LX200 classico" attivata:

   Controllare la periferica dalla mappa del cielo

2. Pannello di controllo INDI: il pannello offre all'utente tutte le funzioni supportate da una periferica.

   Il pannello è diviso in tre settori principali:

   - Linguette periferiche: ogni periferica aggiuntiva corrisponde a una linguetta nel pannello INDI. È possibile avere molteplici periferiche in attività contemporanea senza interferenze reciproche.

   - Vista proprietà: le proprietà sono l'elemento chiave dell'architettura INDI. Ogni periferica definisce un insieme di proprietà per comunicare con il client. La posizione corrente verso cui punta il telescopio è un esempio di proprietà. Proprietà dal significato simile sono solitamente contenute in blocchi logici o gruppi.

   - Visori log: le periferiche riportano il loro stato e rispondono ai comandi inviando messaggi INDI. Ogni periferica ha il proprio visore di log, e tutte condividono un visore di log generico. Solitamente una periferica invia messaggi solo al proprio driver, ma ha il permesso di inviare un messaggio generico quando opportuno.

   Pannello di controllo INDI

Non devi scegliere quale interfaccia utilizzare, dato che si possono usare entrambe simultaneamente. Le azioni eseguite all'interno della Mappa celeste si riflettono automaticamente nel Pannello di controllo INDI, e viceversa.

Per connetterti al tuo telescopio puoi selezionare Connetti dal menu a comparsa della periferica, oppure puoi premere Connetti nella scheda della periferica dal Pannello di controllo INDI.

La porta predefinita a cui KStars tenta di connettersi è `/dev/ttyS0`. Per modificare la porta di connessione, seleziona Pannello di controllo INDI dal menu Periferiche e cambia il valore nella scheda della periferica.

&kstars; aggiorna automaticamente l'ora, la longitudine e la latitudine del telescopio in base alle impostazioni correnti. Puoi abilitare o disabilitare questo aggiornamento dalla finestra di dialogo Configura INDI... nel menu Periferiche.

Se &kstars; riesce a comunicare correttamente con il telescopio, ne otterrà le coordinate AR e DEC correnti e visualizzerà un mirino sulla mappa del cielo in corrispondenza di quella posizione.

### Sincronizzare il telescopio

Se hai allineato il telescopio e l'ultima stella utilizzata era, per esempio, Vega, allora il mirino dovrebbe essere centrato proprio su Vega. Se invece si trova altrove, puoi fare clic su Vega col pulsante destro del mouse e selezionare `Sync` dal menu del telescopio. L'effetto sarà di ordinare al telescopio di sincronizzare le sue coordinate interne con quelle di Vega, dopodiché il mirino dovrebbe essere centrato su questa stella.

Ecco fatto: il tuo telescopio è pronto per esplorare il firmamento.

### ATTENZIONE

Mai usare il telescopio per osservare il Sole. Puntare il Sole può causare danni irreparabili agli occhi e alla strumentazione.

## Configurazione CCD e cattura video

KStars supporta i CCD Finger Lakes Instrumentation e qualsiasi periferica compatibile Video4Linux. Sono supportate anche le funzionalità estese delle webcam Philips.

Puoi gestire CCD e dispositivi per la cattura video dal Gestore periferiche nel menu Periferiche. Come accade per tutte le periferiche INDI, sarà possibile un controllo parziale dalla mappa celeste. La periferica può essere controllata in ogni suo aspetto dal Pannello di controllo INDI.

Il formato standard per la cattura di immagini è il FITS. Una volta catturata e scaricata un'immagine, sarà visualizzata dal visore FITS di KStars. Per catturare una sequenza di immagini, utilizza la voce Cattura sequenza immagini... dal menu Periferiche. Questa voce rimane inattiva fino a quando viene stabilita una connessione a una periferica adatta.

## Concetti di INDI

Il concetto chiave in INDI è che le periferiche sono in grado di descriversi. Ciò si ottiene utilizzando XML per creare una gerarchia generica che rappresenti periferiche canoniche e non canoniche. In INDI, tutte le periferiche possono contenere una o più proprietà. Ogni proprietà può contenere uno o più elementi. Ci sono quattro tipi di proprietà INDI:

- Proprietà testo.

- Proprietà numerica.

- Proprietà interruttore (rappresentata nell'interfaccia grafica sotto forma di pulsanti e caselle).

- Proprietà luce (rappresentata nell'interfaccia grafica da LED colorati).

Per esempio, tutte le periferiche INDI condividono la proprietà interruttore standard CONNECTION. La proprietà CONNECTION ha due elementi, CONNECT e DISCONNECT. KStars interpreta la descrizione XML generica delle proprietà e crea un'interfaccia grafica che permetta all'utente di interagire.

Il pannello di controllo INDI presenta molte proprietà delle periferiche non accessibili dalla mappa celeste. Le proprietà mostrate differiscono a seconda del tipo di periferica. In ogni caso, tutte le proprietà condividono alcune caratteristiche, che determinano il modo in cui sono visualizzate e utilizzate:

- Permessi: tutte le proprietà possono essere abilitate alla sola lettura, alla sola scrittura, oppure sia alla lettura che alla scrittura. Un esempio di proprietà a lettura e scrittura è l'ascensione retta del telescopio. Puoi inserire una nuova ascensione retta e il telescopio, in base alle impostazioni correnti, si muoverà verso la nuova posizione o sincronizzerà le sue coordinate interne. Inoltre, mentre il telescopio si muove, la sua ascensione retta viene aggiornata, e il valore inviato al client.

- Stato: davanti ad ogni proprietà c'è un indicatore di stato (un LED rotondo). Ogni proprietà ha uno stato e un codice colore associato:

  ### Codice colori stato INDI

  Stato | Colore | Descrizione
  --- | --- | ---
  Inattivo | Grigio | La periferica non sta eseguendo alcuna azione relativa a questa proprietà
  Ok | Verde | L'ultima operazione eseguita su questa proprietà si è conclusa con successo
  Occupato | Giallo | La proprietà sta eseguendo un'azione
  Attenzione | Rosso | La proprietà è in condizioni critiche ed esige la tua attenzione immediata

  Il driver di periferica aggiorna lo stato delle proprietà in tempo reale quando necessario. Per esempio, se il telescopio si sta muovendo verso una posizione, allora le proprietà AR/DEC saranno indicate con Occupato. Quando il movimento viene completato correttamente, le proprietà saranno segnalate come Ok.

- Contesto: le proprietà numeriche possono accettare ed elaborare numeri in due formati, decimale e sessagesimale. Il formato sessagesimale è conveniente per esprimere l'ora o le coordinate equatoriali/geografiche. Puoi utilizzare un formato qualsiasi a tuo piacere. Per esempio, tutti i numeri seguenti sono uguali:

  - -156.40

  - -156:24:00

  - -156:24

- Tempo: il tempo standard per tutte le comunicazioni relative a INDI è il Tempo Universale UTC specificato come AAAA-MM-GGTHH:MM:SS secondo lo standard ISO 8601. &kstars; invia automaticamente il tempo UTC corretto ai driver di periferica. Puoi abilitare/disabilitare gli aggiornamenti automatici dell'ora dalla finestra di dialogo Configura INDI nel menu Periferiche.

## Controllo periferiche remote

KStars fornisce un layer semplice ma potente per il controllo di periferiche remote. Una descrizione dettagliata del layer è disponibile nel libro bianco INDI.

Devi configurare sia la macchina server che quella client per il controllo remoto:

1. Server: per preparare una periferica al controllo remoto, segui gli stessi passi descritti nella configurazione locale/server. Quando avvii un servizio di periferica nel Gestore periferiche, viene visualizzato un numero di porta nella colonna Porta di ascolto. Oltre al numero di porta servono il nome host o l'indirizzo IP del server.

2. Client: seleziona Gestore periferiche dal menu Periferiche e fai clic sulla linguetta Client. Nella scheda corrispondente puoi aggiungere, modificare o cancellare host. Aggiungi un host facendo clic sul pulsante Aggiungi.... Inserisci il nome host/indirizzo IP del server nella casella Host, e il numero di porta ottenuto dalla macchina server nel passo precedente.

Client INDI

Dopo aver aggiunto un host, fai clic su di esso per Connetterti o Disconnetterti. Se viene stabilita una connessione, puoi controllare il telescopio dalla mappa celeste o dal Pannello di controllo INDI esattamente come descritto nella sezione locale/server. È davvero così facile come sembra.

### Eseguire un server INDI dalla riga di comando

Sebbene &kstars; ti permetta di allestire con facilità un server INDI, puoi anche lanciarlo dalla riga di comando.

Dato che INDI è un componente indipendente del backend, puoi avere un server INDI in esecuzione su un host senza KStars. INDI può essere compilato separatamente per l'esecuzione su host remoti. Inoltre, i driver di periferica inviano messaggi di log a `stderr`, il che può essere d'aiuto per il debug. La sintassi per un server INDI è la seguente:

$ `indiserver` [opzioni] [`driver` ...]

Opzioni:

-p p : porta IP alternativa, predefinita 7624

-r n : max tentativi riavvio, predefinito 2

-v : più informazioni a stderr

Per esempio, se vuoi avviare un server INDI che esegua un driver LX200 GPS e resti in ascolto sulla porta 8000, devi digitare il comando seguente:

$ `indiserver` -p 8000 `lx200gps`

### Operazioni remote sicure

Supponi che vogliamo lanciare un indiserver con driver INDI su una macchina remota, `macchina_remota`, e connetterli a &kstars; in esecuzione sulla macchina locale.

Dalla macchina locale collegati a quella remota, `macchina_remota`, digitando:

$ `ssh` -L `porta_locale`:`host_remoto`:`porta_remota`

Questo comando lega `porta_locale` sulla macchina locale a `porta_remota` su `host_remoto`. Dopo aver fatto login, avvia indiserver sull'host remoto:

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

Sulla macchina locale avvia &kstars;, quindi apri il Gestore periferiche e aggiungi un host nella scheda Client. L'host dovrebbe essere quello locale (di solito 127.0.0.1) e il numero di porta dovrebbe essere la `porta_locale` usata nei passi precedenti. Fai clic col pulsante destro del mouse sull'host e seleziona Connetti dal menu a comparsa. &kstars; si connetterà in modalità sicura al server INDI remoto. Le informazioni sull'host saranno memorizzate per le sessioni successive.

## Domande frequenti su INDI

Che cos'è INDI?

INDI è il protocollo di controllo dell'Instrument-Neutral-Distributed-Interface sviluppato da Elwood C. Downey del ClearSky Institute. &kstars; utilizza driver di periferica compatibili con il protocollo INDI. INDI ha molti vantaggi, compreso l'accoppiamento flessibile tra periferiche hardware e driver software. I client che utilizzano i driver (come &kstars;) non sanno nulla delle funzioni della periferica. Durante l'esecuzione, &kstars; comunica con i driver e produce un'interfaccia grafica dinamica in base ai servizi forniti dalla periferica. Ne consegue che, dopo l'introduzione di un nuovo driver o l'aggiornamento di uno esistente, KStars può sfruttare immediatamente le migliorie senza bisogno di cambiamenti dal lato client.

Avete in programma di supportare altre periferiche?

Sì, abbiamo in programma di supportare i principali dispositivi CCD e focheggiatori, e di estendere il supporto a un maggior numero di telescopi. Se vuoi che INDI supporti una periferica in particolare, invia un messaggio a indi-devel@lists.sourceforge.net.

Non ho una porta seriale, come faccio a connettermi al telescopio?

Molti portatili moderni non hanno una porta seriale. Sarà necessario un adattatore da seriale a USB che sia supportato sotto Linux. Per esempio, l'adattatore USA-19QW di Keyspan è ben supportato da Linux ed è stato provato con &kstars;. Fai riferimento alla documentazione dell'adattatore per sapere quali porte sono fornite (per esempio `/dev/ttyUSB0 ... /dev/ttyUSB9`).

Quando faccio clic su Connetti, &kstars; risponde che il telescopio non è connesso alla porta seriale/USB. Che cosa posso fare?

Questo messaggio viene visualizzato quando &kstars; non riesce a comunicare col telescopio. Ecco alcune cose che puoi fare:

1. Controlla di avere i permessi sia in lettura che in scrittura per la porta a cui stai cercando di connetterti.

2. Controlla il cavo di connessione, assicurati che sia in buono stato e provalo con altre applicazioni.

3. Controlla l'alimentazione del tuo telescopio, assicurati che ci sia corrente e che il telescopio sia correttamente alimentato.

4. Imposta la porta corretta nel Pannello di controllo INDI sotto il menu Periferiche. La porta predefinita è `/dev/ttyS0`.

5. Riavvia &kstars; e prova ancora.

&kstars; afferma che il telescopio è in linea e pronto, ma non trovo il relativo mirino, dove si trova?

&kstars; ottiene le coordinate AR e DEC del telescopio al momento della connessione. Se l'allineamento è stato eseguito correttamente, dovresti vedere il mirino attorno alla posizione corrispondente nella mappa celeste. Tuttavia le coordinate AR e DEC fornite dal telescopio potrebbero essere scorrette (persino sotto l'orizzonte), il che rende necessario sincronizzare il telescopio con la posizione corrente.

Il telescopio si muove in direzioni casuali o non si muove del tutto. Che cosa posso fare?

Questo comportamento è dovuto perlopiù a impostazioni inesatte. Verifica i punti seguenti:

1. Il telescopio è allineato?

2. La modalità di allineamento del telescopio è corretta? Utilizza Pannello di controllo INDI per controllare e modificare queste impostazioni (`Alt/Az,Polar, Land`).

3. Le impostazioni di ora e data del telescopio sono corrette?

4. Le impostazioni di latitudine e longitudine del telescopio sono corrette?

5. La differenza rispetto all'UTC è corretta?

6. Gli assi di AR e DEC del telescopio sono bloccati saldamente?

7. L'interruttore N/S del telescopio (ove presente) è impostato correttamente per il tuo emisfero?

8. Il cavo tra il telescopio e il computer è in buone condizioni?

Se ritieni che tutte le impostazioni siano corrette, ma il telescopio continua a muoversi in direzioni casuali o a non muoversi del tutto, manda un resoconto a kstars-devel@kde.org