# Controllo del telescopio 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
LX-90, LX50, ETX90 | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.2
LX200 Classico 16" | LX00 16" | 0.2
Celestron GPS | Celestron GPS | 0.2
Celestron NexStar | Celestron GPS | 0.2
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.

KStars può controllare senza problemi periferiche locali e remote tramite l'architettura client/server di INDI. La configurazione locale/server si usa per controllare una periferica locale (per esempio direttamente connessa al tuo computer) e anche per avviare un server a cui client remoti possano connettersi. Una configurazione remoto/client si usa per connettere un client a un host remoto su cui è in esecuzione un server INDI.

Controllare il tuo telescopio con KStars richiede alcuni semplici passi. È vitale portare a termine ogni passo prima di passare al successivo.

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

## Impostazione INDI in KStars

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

Per connetterti a un telescopio locale segui 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 ora... dal menu Tempo, o premendo l'icona tempo nella barra degli strumenti. La finestra Imposta 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.

Ecco un'immagine della finestra del Gestore periferiche:

Driver di periferica in esecuzione
Avvia driver di periferica

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, per consentire un controllo più dettagliato del telescopio. Proprietà come le impostazioni della porta, gestione dei siti di osservazione e controllo dei movimenti, per citarne solo alcune, si possono modificare dal pannello di controllo INDI.

   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.

Infine, 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 con successo 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.

## Concetti di INDI

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 con successo, 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!

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

Suppose we want to run an indiserver with INDI drivers on a remote host, `remote_host`, and connect them to &kstars; running on the local machine.

From the local machine log onto the remote host, `remote_host`, by typing:

$ `ssh` -L `local_port`:`remote_host`:`remote_port`

This binds the `local_port` on the local machine to the `remote_port` on the `remote_host`. After logging in, run indiserver on the remote host:

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

Back on the local machine, start &kstars; then open the Device Manager and add a host under the Client tab. The host should be the local host (usually 127.0.0.1) and the port number should be the `local_port` used in the steps above. Right-click on the host and select Connect from the popup menu. &kstars; will connect to the remote INDI server securely. The host information will be saved for future sessions.

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

Quali periferiche sono supportate da KStars?

Al momento, &kstars; supporta LX200 Classico, LX200 Autostar, LX200 GPS, LX200 16", e Celestron GPS.

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 il cavo di connessione, assicurati che sia in buono stato e provalo con altre applicazioni.

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

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

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