# Control del telescopi amb INDI

KStars proveeix d'una interfície per a configurar i controlar instruments d'astronomia mitjançant el protocol INDI.

El protocol INDI suporta una varietat d'instruments d'astronomia, tals com les càmeres CCD i focalitzadors. Actualment, KStars suporta els següents dispositius:

## Telescopis suportats

Telescopi | Controlador del dispositiu | Versió
--- | --- | ---
LX200 8"-12" Classic | LX200 Classic | 0.5
LX-90, LX50, ETX90 | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.2
LX200 Classic 16" | LX00 16" | 0.2
Celestron GPS | Celestron GPS | 0.2
Celestron NexStar | Celestron GPS | 0.2
Astro-Physics AP | LX200 genèric | 0.1
Astro-Electronic FS-2 | LX200 genèric | 0.1
Losmandy Gemini | LX200 genèric | 0.1
Mel Bartels Controllers | LX200 genèric | 0.1

## Focalitzadors suportats

Focalitzador | Controlador del dispositiu | Versió
--- | --- | ---
Meade LX200GPS Microfocuser | LX200 GPS | 0.1
Meade 1206 Primary Mirror Focuser | LX200 genèric | 0.1
JMI NGF Series | LX200 genèric | 0.1
JMI MOTOFOCUS | LX200 genèric | 0.1

## Connexió del focalitzador

Els focalitzadors s'hauran de connectar al port focalitzador sols en els telescopis LX200 GPS, Autostar o Classic.

KStars els pot controlar de forma local i remota mitjançant l'arquitectura client/servidor de INDI. La configuració client/servidor s'empra per a controlar un dispositiu local (&ead;, un dispositiu afegit a la vostra màquina) i també s'usa per a establir un servidor al que puguin connectar-se els clients remots. Una configuració remota/client s'usa per a connectar un client a màquines remotes que executin un servidor INDI.

El controlar el vostre telescopi amb KStars requereix d'unes poques passes simples. És vital completar cada passa abans de moure's a la següent.

## Configuració del telescopi

La majorí de telescopis s'equipen amb la interfície RS232 per al control remot. Connecteu el RS232 del vostre telescopi al port sèrie/USB del vostre ordinador. Tradicionalment, el RS232 es connecta al port sèrie, però molts portàtils nous els abandonen en favor dels ports USB/FireWire, possiblement necessitareu obtenir un adaptador sèrie-a-USB per a emprar-lo amb portàtils nous.

Després de connectar el vostre telescopi amb el port sèrie/USB, gireu el vostre telescopi. Es altament recomanat que descarregueu i instal·leu l'últim microprogramari (firmware) per al controlador del vostre telescopi.

El telescopi necessita ser alineat abans de poder-lo usar correctament. Alineeu-lo (alineació d'una o dues estrelles) segons l'il·lustrat en el vostre manual del telescopi.

## Configuració INDI de KStars

&kstars; necessita verificar els valors de temps i de localització abans de connectar amb el telescopi. Això assegura un seguiment i sincronització adequada entre el telescopi i &kstars;. Les següents passes us permetran connectar amb un dispositiu que estiga connectat al vostre ordinador. Per a connectar i controlar els dispositius remots, si us plau, referiu-vos a la secció control remot del dispositiu.

Per a connectar amb un telescopi local, si us plau, realitzeu les següents passes:

1. Establir la vostra localització geogràfica. Obriu la finestra Estableix la localització geogràfica seleccionant l'ítem Estableix la localització geogràfica... des del menú Arranjament, o prement la icona en forma de Globus que hi ha a la barra d'eines, o prement &Ctrl;g.

2. Establir la vostra data i hora locals. Podeu canviar-les a qualsevol valor seleccionant Estableix temps... des del menú Temps, o prement la icona amb forma de rellotge que hi ha a la barra d'eines. La finestra Estableix temps empra un estri estàndard de &kde; per a especificar la data, junt amb tres caixes selectores per a establir les hores, els minuts i els segons. Si sempre necessiteu reajustar el rellotge al temps actual, simplement seleccioneu Estableix temps a Ara des del menú Temps.

3. Cliqueu a sobre del menú Dispositius i seleccioneu el Gestor de dispositius.

4. A sota de la columna Dispositiu, seleccioneu el model del vostre telescopi.

5. Clic dret a sobre del dispositiu i seleccioneu Engega servei.

6. Clicar a Bé per a tancar el diàleg del gestor de dispositius.

Aquesta és una instantània de la finestra del Gestor de dispositius:

Executar controladors de dispositiu
Iniciar controladors de dispositiu

Ara ja esteu preparat per a usar les característiques del dispositiu, &kstars; proveeix dues interfícies IGU convenientment intercanviables per al control de telescopis:

### Controlar el vostre telescopi

1. Controlar el mapa del cel: Per a cada dispositiu que engegueu en el Gestor de dispositius, es mostrarà l'entrada corresponent en el menú emergent permetent-vos que controleu les propietats del dispositiu. Podreu emetre comandaments com Gira, Sinc i `Segueix` directament des del mapa del cel.

   Aquesta és una instantània del menú emergent amb un dispositiu LX200 Classic actiu:

   Controlar dispositius des del mapa del cel

2. Plafó de control INDI: El plafó ofereix a l'usuari totes les característiques suportades per un dispositiu, per a un control més fi sobre el telescopi. Les propietats com els valors del port, gestió del lloc i els controls de gir, entre d'altres, es poden manipular des del plafó de control INDI.

   El plafó es divideix en tres seccions principals:

   - Pestanyes del dispositiu: Cada dispositiu actiu addicional ocupa una pestanya en el plafó INDI. Els dispositius múltiples poden funcionar simultàniament sense afectar l'operació dels altres dispositius.

   - Vista propietats: Les característiques són l'element clau en l'arquitectura INDI. Cada dispositiu defineix un joc de propietats per a comunicar-se amb el client. La posició actual del telescopi és un exemple d'una propietat. Semànticament, les propietats similars són usualment contingudes en blocs lògics o agrupacions.

   - Visors de la bitàcola: Els dispositius informen del seu estat i reconeixen comandaments enviant missatges INDI. Cada dispositiu té el seu propi visor del registre, i tots els dispositius comparteixen un visor de registres genèric. Un dispositiu usualment només envia missatges al seu controlador de dispositiu, però a un dispositiu se li permet enviar un missatge genèric quan això és apropiat.

   Plafó de control INDI

No teniu restriccions sobre l'ús d'una interfície o l'altra, fins i tot es poden emprar totes dues alhora. Les accions des del mapa del cel són reflexades automàticament en el Plafó de control INDI i viceversa.

Finalment, per a connectar amb el vostre telescopi, podeu seleccionar Connecta des del menú emergent, o alternativament, podeu prémer Connecta a sota de la pestanya del dispositiu en el Plafó de control INDI.

Per omissió, KStars intentarà connectar amb el porto `/dev/ttyS0`. Per a canviar el port de la connexió, seleccioneu Plafó de control INDI des del menú Dispositius i canvieu el port a la pestanya del dispositiu.

&kstars; actualitza automàticament la longitud, latitud i el temps del telescopi basant-se en els actuals valors a &kstars;. Podreu des/habilitar aquestes actualitzacions des del diàleg Configura INDI sota el menú Dispositius.

Si &kstars; es comunica amb èxit amb el telescopi, rebreu la AR i la DEC actual des del telescopi i es mostrarà una creueta en el mapa del cel que indicarà la posició del telescopi.

### Sincronitzar el vostre telescopi

Si heu alineat el vostre telescopi i l'última alineació ha estat una estrella, per exemple, Vega, llavores la creueta haurà de restar centrada al voltant seu. Si no és així i la creueta té l'objectiu apagat, llavores podeu fer un clic dret sobre Vega des del mapa del cel i `Sinc` des del menú del vostre telescopi. Aquesta acció instruirà al telescopi a sincronitzar les seves coordenades internes per a emparellar-les amb les de Vega, i la creueta del telescopi ara haurà de restar centrada al voltant de Vega.

Això ja està! El vostre telescopi està llest per a explorar els cels!

### ATENCIÓ

No empreu mai el telescopi per a mirar al Sol. Mirar al Sol pot malmetre irreversiblement els vostres ulls, així com al vostre equip

## Conceptes INDI

El plafó de control INDI ofereix moltes propietats del dispositiu que no són accessibles des del mapa del cel. Les propietats ofertes difereixen d'un dispositiu a l'altre. De tota manera, totes les propietats compartides amb característiques comuns ens obliga a explicar com es mostren i s'usen:

- Permisos: Totes les propietats poden habilitar sols lectura, sols escriptura o lectura i escriptura. Un exemple d'una propietat de lectura/escriptura és l'ascensió recta del telescopi. Podeu introduir una nova ascensió recta i el telescopi, basant-se en els valors actuals, girarà o sinc. a la nova entrada. A demés, quan el telescopi gira, la seva ascensió recta s'actualitza i s'envia altra vegada cap al client.

- Estat: Prefixat a cada propietat hi ha un indicador de l'estat (LED rodó). Cada propietat té un estat i un codi de color associat:

  ### Codi de color de l'estat INDI

  Estat | Color | Descripció
  --- | --- | ---
  Ociosa | Gris | El dispositiu no està realitzant cap acció en referència a aquesta propietat
  Bé | Verd | L'última operació realitzada en aquesta propietat ha estat realitzada amb èxit i és activa
  Ocupada | Groc | La propietat està realitzant una acció
  Alerta | Roig | La propietat està en condicions crítiques i necessita atenció immediata

  El controlador del dispositiu actualitza l'estat de la propietat en temps real quan això és necessari. Per exemple, si el telescopi està en el procés de gir cap a un objectiu, llavores les propietats AR/DEC seran senyalades com a Ocupada. Quan el procés de gir sigui completat amb èxit, les propietats seran senyalades com a Bé.

- Context: Les propietats numèriques poden acceptar i processar números en dos formats: decimal i sexagesimal. El format sexagesimal és convenient a l'expressar temps o coordenades equatorials/geogràfiques.Podeu emprar qualsevol dels dos formats segons creieu convenient. Per exemple, tots els següents números són iguals:

  - -156,40

  - -156:24:00

  - -156:24

- Hora: La hora estàndard per a totes les comunicacions relacionades amb INDI és UTC (temps universal) especificada com a YYYY-MM-DDTHH:MM:SS d'acord amb el ISO 8601. &kstars; comunica la hora UTC correcta del UTC automàticament amb els controladors dels dispositius. Podeu des/habilitar dites actualitzacions automàtiques de l'hora des del diàleg Configura INDI sota el menú Dispositius.

## Control remot del dispositiu

KStars proveeix d'una simple capa de gran abast per al control de dispositius remots. Una detallada descripció de la capa es descriu en el llibre blanc de INDI.

Necessitareu configurar les maquines del servidor i del client per al control remot:

1. Servidor: Per a preparar a un dispositiu per al control remot, seguiu les mateixes passes en la configuració local/servidor. Quan engegueu un servei de dispositiu en el Gestor de dispositius, un número de port serà mostrat a sota de la columna Port on escoltar. A demés del número de port, també necessitareu el nom de la màquina o adreça IP del servidor.

2. Client: Seleccioneu el Gestor de dispositius des del menú Dispositius i cliqueu a sobre de la pestanya Client. Sota aquesta pestanya podeu afegir, modificar o eliminar màquines. Afegiu-ne una clicant en el botó Afegeix. Introduïu l'adreça de nom màquina/IP del servidor en el camp Nom i el número de port obtingut des de la màquina servidor durant la passa 1.

Client INDI

Després de que afegiu una màquina, fer clic dret sobre la mateixa per a Connecta o Desconnecta. Si s'estableix una connexió, podreu controlar el telescopi des del mapa del cel o Plafó de control INDI exactament segons el descrit a la secció local/servidor. És tant fàcil com això!

### Executar un servidor INDI des de la línia de comandaments

Mentre que &kstars; us permet desplegar fàcilment un servidor INDI; podeu llançar un servidor INDI des de la línia de comandaments.

Atès que INDI és un component intern independent, podeu engegar un servidor INDI en un client sense KStars. INDI es pot compilar per separat per a funcionar sobre les màquines remotes. A demés, els controladors de dispositius registren missatges a `stderr` (eixida d'error estàndard) i això pot ser d'ajuda en una situació de depuració. La sintaxis per al servidor INDI és la següent:

$ `indiserver` [opcions] [`controlador` ...]

Opcions:

-p p : IP i port alternatiu, per omissió 7624

-r n : màxims intents de reinici, per omissió 2

-v : més missatges a l'eixida d'error estàndard (stderr)

Per exemple, si voleu engegar un servidor INDI executant un controlador LX200 GPS i escoltar les connexions sobre el port 8000, haureu d'executar el següent comandament:

$ `indiserver` -p 8000 `lx200gps`

### Assegurar les operacions remotes

Suposem que volem executar indiserver i els seus clients sobre una màquina remota, `màquina_remota`, i llavors connectar a &kstars; que funciona sobre la màquina local.

Des del registre de la màquina local per a la màquina remota, `màquina_remota`, escrivint:

$ `ssh` -L `port`:`màquina_local`:`port` `màquina_remota`

després d'accedir, s'executarà indiserver sobre la màquina remota:

$ `indiserver` -p `port` [`controlador`...]

En segon pla, en la màquina local, s'iniciarà &kstars; i després obrirà un Gestor de dispositius i afegirà una màquina sota la pestanya Client. La màquina haurà de ser `màquina_local` (generalment 127.0.0.1) i el número de port haurà de ser el `port` emprat en totes les anteriors passes. Clic dret sobre la màquina i seleccioneu Connecta des del menú emergent. &kstars; es connectarà amb el servidor INDI remot de forma segura. La informació de la màquina serà desada per a les sessions futures.

## Preguntes més freqüents sobre INDI

Què és INDI?

INDI és el protocol de control Instrument-Neutral-Distributed-Interface desenvolupat per Elwood C. Downey de l'Institut ClearSky . &kstars; empra als controladors de dispositiu que són compatibles amb el protocol INDI. INDI té moltes ventatges incloguen l'aclobat fluix entre els dispositius de maquinari i els controladors de programari. Els clients que emprin els controladors de dispositiu (com &kstars;) són totalment inconscients de les capacitats del dispositiu. En temps d'execució, &kstars; es comunica amb els controladors de dispositiu i construeix un IGU totalment dinàmic basat en els serveis proporcionats pel dispositiu. Pel qual, els controladors de dispositiu nous es poden escriure o actualitzar i KStars podrà prendre els ventatges complets d'ells sense cap canvi en el costat del client.

A quins dispositius dona suport KStars?

Actualment, &kstars; suporta LX200 Classic, LX200 Autostar, LX200 GPS, LX200 16" i Celestron GPS.

Teniu pensat suportar més dispositius?

Sí. Planegem afegir suport per a les càmeres CCD i focalitzadors més importants i estendre el suport per a més telescopis. Si desitgeu que INDI suporti un dispositiu en particular, si us plau, envieu-nos un correu electrònic a indi-devel@lists.sourceforge.net.

No tinc un port sèrie, com puc connectar al telescopi?

Molts ordinadors portàtils moderns ja no disposen d'un port sèrie. Necessitareu un adaptador sèrie-a-USB que estiga suportat sota Linux. Per exemple, el USA-19QW Serial to USB de Keyspan està molt ben suportat sota Linux i ha estat provat amb &kstars;. Necessitareu referir-vos a la documentació del vostre adaptador per a trobar quins ports proporciona (&pex; `/dev/ttyUSB0..../dev/ttyUSB9`).

Quan intento Connecta, &kstars; informa que el telescopi no està connectat al port sèrie/USB. Què puc fer?

Aquest missatge apareix quan &kstars; no pot comunicar-se amb el telescopi. Aquí teniu unes poques coses que podeu fer:

1. Comprovar el cable de connexió, assegureu-vos de que està en bones condicions i proveu-lo amb d'altres aplicacions.

2. Comprovar que la corrent arriba al telescopi, assegureu-vos de que la corrent està encesa i que el telescopi n'està obtinguen prou.

3. Establir el port correcte en el Plafó de control INDI sota el menú Dispositius. El port per omissió és `/dev/ttyS0`

4. Reiniciar &kstars; i provar-l'ho una altra vegada.

&kstars; informa de que el telescopi està connectat i a punt, però no puc trobar la creueta del telescopi, a on està?

&kstars; rep les coordenades AR i DEC des dels telescopis sobre la connexió. Si l'alineació ha estat realitzada correctament, llavors hauríeu de veure dita creueta en el mapa del cel al voltant del vostre objectiu. Tot i que, les coordenades AR i DEC proporcionades pel telescopi podrien ser incorrectes (fins i tot trobar-se sota l'horitzó) i necessitareu Sinc el vostre telescopi a l'objectiu actual.

El telescopi s'està movent erràticament o no es mou en tots. Què puc fer?

Aquest comportament sobre tot es deu a valors incorrectes, si us plau, verifiqueu el següent llistat:

1. Està alineat el telescopi?

2. Està el mode d'alineació del telescopi correcte? Useu el Plafó de control INDI per a comprovar i canviar aquests valors (`Alt/Az, Polar, Terra`).

3. Són correctes els valors hora i data del telescopi?

4. Són correctes els valors longitud i latitud del telescopi?

5. És correcte el UTC del telescopi?

6. Estan els eixos AR i DEC blocats firmement?

7. El valor N/S del telescopi (quan sigui aplicable) està establert correctament al vostre hemisferi?

8. Està el cable entre el telescopi i l'ordinador en bones condicions?

Si penseu que tots els valors estan correctes però el telescopi encara es mou erràticament o no fa res, llavores envieu un informe d'error a kstars-devel@kde.org.