# 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. Per avere una lista aggiornata dei dispositivi supportati, visita la pagina dei dispositivi supportati da INDI.

## 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 fossero 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 avviare le periferiche sfogliando l'albero delle periferiche, selezionando una periferica e premeno il pulsante Avvia servizio. Puoi scegliere la modalità di funzionamento, locale oppure server, come descritto sopra. Il numero della porta è generato in modo casuale nell'intervallo da 7624 a 10.000. Per specificare una porta, fai clic sulla colonna della porta, accanto al driver desiderato. &kstars; permette di usare più driver con un singolo server INDI, e quindi una porta. Seleziona più driver e premi il pulsante Avvia servizio.

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 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. 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. Premi il pulsante Avvia servizio.

6. Premi Chiudi 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.

   - Viste di proprietà nelle schede Controllo principale e Opzioni: 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.

   - Visore registro: le periferiche riportano il loro stato e rispondono ai comandi inviando messaggi INDI. Ogni periferica ha il proprio visore di registro. 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

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à automaticamente visualizzata dal Visore FITS di &kstars;.

## Configura INDI

La pagina INDI ti permette di modificare opzioni specifiche INDI lato cliente. La finestra è divisa in varie categorie principali: Generale, Aggiorn. autom. periferiche, Mappa celeste, Aggiorna fonte, Ruota filtri e Porta del server.

- Generale

  - `Cartella FITS predefinita:` specifica la cartella in cui saranno salvate tutte le immagini FITS. Se non viene indicata alcuna cartella, le immagini saranno salvate in $HOME.

  - `Porta telescopio:` la porta predefinita per il telescopio. Connettendoti a un servizio locale o remoto per un telescopio, &kstars; assegnerà automaticamente il valore predefinito alla porta di connessione.

  - `Porta video:` la porta video predefinita. Quando ti connetti a un servizio video locale o remoto, &kstars; utilizzerà automaticamente questo valore per la porta della webcam.

- Aggiorn. autom. periferiche

  - `Data/ora:` se supportato, aggiorna la data e l'ora del telescopio una volta connesso.

  - `Località geografica:` se supportato, aggiorna le informazioni sulla località geografica del telescopio (latitudine e longitudine) una volta connesso.

- Mappa celeste

  - `Mirino periferica:` se questa opzione è marcata, &kstars; visualizzerà un mirino sulla mappa celeste, corrispondente alla regione verso cui è puntato il telescopio. Il mirino è visualizzato dopo una connessione riuscita al telescopio, e la sua posizione viene aggiornata periodicamente. Il nome del telescopio è visualizzato vicino al mirino. &kstars; visualizza un mirino per ogni telescopio connesso. Per cambiare il colore del mirino, apri la finestra Configura &kstars;. Seleziona la scheda Colori e cambia il colore della voce Indicatore obiettivo.

  - `Messaggi INDI nella barra di stato:` quando questa opzione è marcata, &kstars; visualizzerà i messaggi di INDI nella barra di stato.

  - `Visualizzazione automatica FITS dopo cattura`: quando questa opzione è marcata, &kstars; visualizzerà le immagini FITS catturate nel Visore FITS.

- Aggiorna fonte: sincronizza &kstars; in base al tempo del computer oppure del dispositivo e all'impostazione della località.

- Ruota filtri: assegna dei colori alle posizioni nella ruota dei filtri (per esempio Posizione 1 Rosso, Posizione 2 Blu, eccetera). Puoi assegnare colori fino a dieci posizioni (da zero a nove). Per assegnare un colore, seleziona il numero della posizione dalla lista a discesa, quindi digita il nome del colore nella casella. Ripeti il processo per tutte le posizioni che desideri e quindi premi OK.

- Porta del server: specifica l'intervallo delle porte su cui il server INDI effettuerà il bind all'avvio dei nuovi driver.

## 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 nella pagina INDI della finestra di dialogo delle impostazioni.

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

-l d : registra i messaggi del driver su d/AAA-MM-GG.islog

-m m : termina il client se rimane indietro per più di questi MByte, predefiniti 10

-p p : porta IP alternativa, predefinita 7624

-f percorso : percorso di una fifo per avvio e spegnimento dinamico dei driver

-v : mostra eventi chiave, nessun traffico

-vv : -v con contenuto dei messaggi chiave

-vvv : -vv con XML completo

driver : eseguibile oppure dispositivo@host[:porta]

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 eseguito l'accesso, 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.

Quali operazioni sono fornite da &kstars; per il controllo del telescopio?

Dipende da qual è il tuo telescopio, ma le tre operazioni di base sono `Slew`, `Track` e `Sync`, che puoi eseguire direttamente dalla mappa celeste. Perché siano eseguite correttamente il tuo telescopio deve essere già allineato. Alcuni telescopi offrono una gamma più ampia di operazioni, come gestione del sito, modalità di movimento, messa a fuoco, posizione di riposo e così via. Puoi accedere alle funzionalità avanzate dei telescopi tramite il Pannello di controllo INDI nel menu Periferiche.

Qual è esattamente la differenza tra i comandi `Slew`, `Track` e `Sync`?

Il comando `Slew` ordina al telescopio di puntare un certo oggetto. Una volta che il telescopio ha raggiunto la posizione, continuerà a inseguire l'oggetto a velocità siderale (quella del movimento delle stelle sulla volta celeste). Ciò funziona bene per stelle, oggetti di Messier e praticamente tutto ciò che sta al di fuori del sistema solare. Ma gli oggetti del sistema solare si spostano a velocità differenti, perciò il telescopio deve inseguirli (`Track`) nel loro movimento.

Per questo motivo devi dare il comando `Track` se vuoi inseguire un oggetto con moto non siderale. Infine, `Sync` serve a sincronizzare le coordinate interne del telescopio con quelle di un oggetto selezionato.

Posso controllare il mio telescopio in remoto?

Sì. Puoi avviare un server INDI sulla macchina collegata al telescopio, e il server rimarrà in ascolto di richieste da clienti &kstars;. Una volta connesso, puoi controllare il telescopio direttamente dalla mappa celeste. Questa procedura è descritta in dettaglio nella sezione Controllo periferiche remote

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. Puoi utilizzare il menu contestuale per centrare la posizione del telescopio nella mappa celeste e attivare l'inseguimento.

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