# Styr dit teleskop med INDI

KStars giver dig mulighed for at indstille og kontrollere astronomiske instrumenter via INDI-protokollen.

INDI-protokollen understøtter en række astronomiske instrumenter som fx CCD-kamaraer og fokuseringsenheder. I øjeblikket understøttes følgende enheder i KStars:

## Understøttede teleskoper

Teleskop | Enhedsdriver | Version
--- | --- | ---
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 Generic | 0.1
Astro-Electronic FS-2 | LX200 Generic | 0.1
Losmandy Gemini | LX200 Generic | 0.1
Mel Bartels Controllere | LX200 Generic | 0.1

## Understøttede fokuseringsenheder (okularudtræk)

Fokuseringsenhed (okularudtræk) | Enhedsdriver | Version
--- | --- | ---
Meade LX200GPS Microfocuser | LX200 GPS | 0.1
Meade 1206 Primary Mirror Focuser | LX200 Generic | 0.1
JMI NGF Series | LX200 Generic | 0.1
JMI MOTOFOCUS | LX200 Generic | 0.1

## Tilslutning af fokuseringsenhed

Fokuseringsenheden (okularudtrækket) skal være forbundet til fokuseringsporten i LX200 GPS, Autostar eller Classic teleskoper.

KStars kan kontrollere enheder forbundet lokalt eller på andre maskiner via INDI server/klient arkitekturen. Lokal/server indstillingen bruges til at kontrollere en enhed tilsluttet lokalt (fx et teleskop der er sat til din egen computer), men er også beregnet til at oprette en server som andre klienter kan koble sig på. Fjern/klient indstillingen bruges til at tilslutte en klient til en fjernserver der kører en INDI-server.

At kontrollere dit teleskop med KStars kræver at du gennemgår nogle få enkle trin. Det er vitalt at hvert trin bliver afsluttet før du begynder på det næste trin.

## Teleskopopsætning

De fleste teleskoper har et RS232-stik til fjernkontrol. Sæt RS232-stikket fra dit teleskop i din computers Seriel/USB-port. Traditionelt bruger RS232 en seriel port til forbindelsen til computeren, men da mange nye bærbare computere har droppet serielporten til fordel for USB/FireWire-porte er du måske nød til at bruge en seriel til USB-adapter for at kunne bruge din bærbare.

Når du har forbunder dit teleskop til Seriel/USB-porten tænder du teleskopet. Det anbefales meget at du henter og installerer det seneste firmware til din teleskop-controller.

Teleskopet skal kalibreres før det kan bruges ordentligt. Kalibrer dit teleskop (en eller to-stjernerskalibrering) som vist i dit teleskops manual.

## KStars INDI-opsætning

&kstars; har brug for at fastslå tid og sted før det forbinder til teleskopet. Det sikrer ordentlig følgning og synkronisering mellem teleskopet og &kstars;. Følgende skridt vil sætte dig i stand til at skabe forbindelse til en enhed der er tilsluttet direkte til din computer. For at skabe forbindelse til enheder tilsluttet andre computere se sektionen Kontrollér fjerne enheder.

For at få forbindelse til et lokalt teleskop, følg disse skridt:

1. Angiv det geografiske sted du befinder dig. Åbn vinduet Sæt geografisk sted ved: at vælge Sæt geografisk sted... fra menuen Opsætning, trykke på Globus-ikonet på værktøjslinjen eller taste &Ctrl;g.

2. Angiv din lokale tid og dato. Du kan skifte til ethvert tidspunkt eller dato ved at vælge Sæt tiden... fra menuen Tid eller ved at trykke på tidsikonet på værktøjslinjen. Vinduet Sæt tiden bruger &kde;s standardtidsvælger kombineret med 3 drejevælgere til at indstille timer, minutter og sekunder. Hvis du får brug for at sætte uret tilbage til den aktuelle tid, kan du bare trykke på Sæt tiden til nu i menuen Tid.

3. Klik på menuen Enheder og vælg Enhedshåndteringen.

4. Vælg din teleskopmodel i kolonnen Enhed.

5. Højre-klik på enheden og vælg Kør servicen.

6. Klik O.k. for at lukke enhedshåndteringen igen.

Her er et skærmbillede af Enhedshåndteringen:

Kørende enhedsdrivere
Start enhedsdrivere

Du er nu klar til at bruge enhedens muligheder. &kstars; tilbyder to forskellige muligheder for at styre teleskopet med en grafisk brugerflade:

### Styr dit teleskop

1. Kontrol via stjernekortet: For hver enhed du har startet i Enhedshåndteringen vises et tilhørende menupunkt i popop-menuen hvor du kan styre indstillingerne for enheden. Du kan udføre kommandoer som `Flyt, Synk,` og `Spor` direkte fra stjernekortet.

   Her er et skærmbillede af popop-menuen med et aktivt LX200 Classic-teleskop:

   Kontrollér enheder fra stjernekortet

2. INDI kontrolpanel: Kontrolpanelet tilbyder brugeren at styre alle de muligheder en enhed understøtter, så du kan styre dit teleskop i alle detaljer. Egenskaber som portindstillinger, håndtering af sted, og kontrol over drejning kan bl.a. styres fra INDI kontrolpanelet.

   Panelet er inddelt i tre hovedsektioner:

   - Enhedsfaneblade: Hver aktiv enhed har sit faneblad i INDI-panelet. Flere enheder kan køre samtidig uden at influere på styringen af de andre enheder.

   - Visning af egenskaber: Egenskaber er nøgleelementet i INDI-arkitekturen. Hver enhed definer et sæt egenskaber til kommunikation med klienten. Den nuværende position af teleskopet er et eksempel på en egenskab. Semantisk ens egenskaber er normalt indeholdt i logiske blokke eller grupperinger.

   - Logfremvisere: Enheder rapporterer deres status og modtagne kommandoer ved at sende INDI-meddelelser. Hver enhed har sin egen logvisning, og alle enheder deler en generisk logfremviser. En enhed sender normalt kun meddelelser til sin enhedsdriver, men enheder har også lov at sende generiske meddelelser hvis det er nødvendigt.

   INDI kontrolpanel

Du er ikke begrænset til at bruge en grænseflade af gangen, de kan bruges samtidigt. Handlinger fra stjernekortet bliver automatisk overført til INDI-kontrolpanelet og omvendt.

Endeligt, for at tilslutte til dit teleskop kan du enten trykke på Forbind på din enhedspopop-menu. Alternativt kan du trykke på Forbind på enhedsfanebladet i INDI-kontrolpanelet.

Som standard prøver KStars at tilslutte til porten `/dev/ttyS0`. For at ændre forbindelsesporten kan du vælge INDI-kontrolpanel fra menuen Enheder og ændre porten på enhedens faneblad.

&kstars; opdaterer automatisk teleskopets længdegrad, breddegrad og tid ud fra de aktuelle indstillinger i &kstars;. Du kan slå disse opdateringer fra og til i menuen Enheder under Konfigurér INDI.

Hvis &kstars; kommunikerer succesfuldt med teleskopet, vil &kstars; modtage den aktuelle RA og Dekl fra teleskopet og vil vise et trådkors på stjernekortet der indikerer teleskopets position.

### Synkronisér dit teleskop

Hvis du kalibrerede dit teleskop og den sidste stjerne du brugte under kalibreringen fx var Vega, vil der være et trådkors der peger på Vega. Hvis trådkorset peger forbi målet kan du højreklikke på Vega på stjernekortet og vælge `Synkronisér` på teleskopmenuen. Denne handling vil få teleskopet til at synkronisere sine interne koordinater med Vegas. Teleskopets trådkors skulle nu pege korrekt på Vega.

Færdig! Dit teleskop er klar til at udforske himlen!

### ADVARSEL

Brug aldrig et teleskop til at se direkte på solen. Hvis du kigger direkte på solen kan både dine øjne og dit teleskop blive ødelagt for altid

## INDI koncept

INDI-kontrolpanelet indeholder mange egenskaber for enheder man ikke kan nå fra stjernekortet. De tilgængelige egenskaber er forskellige fra enhed til enhed. Men alle egenskaber deler fælles muligheder der afgør hvordan de vises og bruges:

- Tilladelse: Til alle egenskaber kan du enten have "kun læsetilladelse", "kun skrivetilladelse" eller "både læse- og skrivetilladelse". Teleskopets rektascension er et eksempel på en egenskab hvor du både har læse- og skrivetilladelse. Du kan angive en ny rektascension, baseret på de aktuelle indstillinger, og teleskopet vil enten dreje til eller synkronisere med det nye input. Ydermere sendes teleskopets opdaterede rektascension tilbage til klienten når det drejes.

- Tilstand: Foran hver egenskab er der en tilstandsindikator (rund LED). Hver egenskab har en tilstand og en tilhørende farvekode:

  ### INDI tilstandsfarvekodning

  Tilstand | Farve | Beskrivelse
  --- | --- | ---
  Ledig | Grå | Enheden udfører ingen handling der har med denne egenskab at gøre
  O.k. | Grøn | Den sidste handling der blev udført på denne egenskab var vellykket og er aktiv
  Optaget | Gul | Egenskaben udfører en handling
  Advarsel | Rød | Egenskaber er i vanskeligheder og der kræves øjeblikkelig opmærksomhed

  Enhedsdriveren opdaterer egenskabens tilstandsvisning i realtid hvis det er nødvendigt. Hvis teleskopet fx er i gang med at dreje til et nyt objekt bliver egenskaben RA/Dekl. vist som Optaget. Når drejningen er færdig og alt gik fint vil egenskaben skifte til O.k..

- Sammenhæng: Egenskaber der er tal, kan modtage og behandle tallene i to forskellige formater: decimal og sexigismal. Formatet sexigismal er smart til tid eller koordinater i ækvatorsystemet eller det geografiske koordinatsystem. Du kan bruge det format du har lyst til. For eksempel er alle disse tal ens:

  - -156,40

  - -156:24:00

  - -156:24

- Tid: Standardtiden for al INDI-relateret kommunikation er Universel Tid (UTC) angivet i formatet ÅÅÅÅ-MM-DDTTT:MM:SS som angivet i standarden ISO 8601. &kstars; sender automatisk den korrekte UTC til enhedsdriverne. Du kan slå automatisk opdatering af tiden fra/til i menupunktet Konfigurér INDI i menuen Enheder.

## Kontrollér fjerne enheder

KStars indeholder et simpelt men kraftfuldt lag til fjernkontrol af enheder. En detaljeret beskrivelse af laget findes i "The INDI white paper".

Du skal konfigurere både server- og klientmaskinen for at kunne fjernstyre:

1. Server: For at forberede en enhed til fjernkontrol skal du gennemgå de samme trin som beskrevet under opsætningen af lokal/server. Når du starter en enhedsservice i Enhedshåndteringen vises et portnummer under kolonnen Lytteport. Udover portnummeret har du også brug for værtsnavnet eller IP-adressen på din server.

2. Klient: Vælg Enhedshåndteringen fra menuen Enhed og klik på fanebladet Klient. Du kan tilføje, ændre eller slette værtsmaskiner på fanebladet Klient. Tilføj en vært ved at trykke på knappen Tilføj. Skriv serverens værtsnavn/IP-adresse i feltet Vært og skriv det portnummer fra servermaskinen i 1. trin.

INDI klient

Efter at du har tilføjet en værtsmaskine, højreklik på værten for at Forbinde eller Afbryde forbindelsen. Hvis der er etableret forbindelse kan du kontrollere teleskopet fra Stjernekortet eller INDI-kontrolpanelet præcist som beskrevet under lokal/server. Så let er det!

### Kør en INDI-server fra kommandolinjen

&kstars; gør det nemt at starte en INDI-server, men du kan også starte en INDI-server fra kommandolinjen.

Da INDI er en uafhængig "bagende"-komponent, kan du køre en INDI-server på en maskine uden KStars. INDI kan kompileres selvstændigt så den kan køre på en fjern maskine. Ydermere skriver enhedsdriverne log-meddelelser til `stderr`, og det kan være en stor hjælp ved fejlretning. INDI-serverens syntaks er følgende:

$ `indiserver` [tilvalg] [`driver` ...]

Tilvalg:

-p p : alternativ IP port, standard 7624

-r n : max genstartsforsøg, standard 2

-v : flere informationer skrives til stderr

Hvis du fx ønsker at starte en INDI-server der skal køre en LX200 GPS driver og lytte efter forbindelser på port 8000, kan du bruge følgende kommando:

$ `indiserver` -p 8000 `lx200gps`

### Sikker fjernbetjening

Hvis nu for eksempel vi ville køre en indiserver og dens klienter på en fjern maskine, `fjern_maskine`, og forbinde dem til &kstars; på din lokale maskine.

Log ind på den fjerne maskine, `fjern_maskine`, ved at skrive:

$ `ssh` -L `port`:`lokal_vært`:`port` `fjern_maskine`

efter indlogning start indiserver på fjernmaskinen:

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

Tilbage på den lokale maskine starter du &kstars;, åbner Enhedshåndteringen og tilføjer værten på fanebladet Klient. Værten skal være `local_host` (som regel med IP-adressen 127.0.0.1) og portnummeret skal være den `port` vi har brugt på de foregående trin. Højre-klik på værten og vælg Forbind fra popop-menuen. &kstars; vil nu etablere en sikker forbindelse til INDI-serveren. Værtsinformationerne vil blive gemt til fremtidige sessioner.

## INDI Ofte Stillede Spørgsmål

Hvad er INDI?

INDIer Instrument-Neutral-Distributed-Interface's kontrolprotokol udviklet af Elwood C. Downey fra ClearSky Institute. &kstars; indeholder enhedsdrivere der er kompatible med INDI-protokollen. INDI har mange stærke sider inklusive løs kobling mellem hardware enheder og software-drivere. Klienter der bruger enhedsdriverne (fx &kstars;) er helt uafhængig af selve enhedens muligheder. Under brug kommunikerer &kstars; kun med enhedsdriveren og opbygger en helt dynamisk GUI baseret på de servicer enheden tilbyder. Derfor kan nye drivere tilføjes eller opdateres og KStars kan få fuldt udbytte af dem uden ændringer på klientsiden.

Hvilke teleskoper og andre enheder understøtter KStars?

I øjeblikket understøtter &kstars;: LX200 Classic, LX200 Autostar, LX200 GPS, LX200 16", og Celestron GPS.

Har I planer om at understøtte flere enheder?

Ja. Vi har planer om at understøtte udbredte CCD-kameraer, fokuseringsenheder og flere teleskoper. Hvis du vil have INDI til at understøtte en bestemt enhed, så send en e-mail til indi-devel@lists.sourceforge.net

Jeg har ingen serielport, hvordan kan jeg så tilslutte mit teleskop?

Mange moderne bærbare computere har ingen serielport. I disse tilfælde har du brug for en "seriel-til-USB"adapter som er understøttet i Linux. Eksempelvis er Keyspan's USA-19QW Serial to USB adapter godt understøttet i Linux og den er testet med &kstars;. Du må se i dokumentationen til adapteren hvilke porte den leverer ( fx `/dev/ttyUSB0 .... /dev/ttyUSB9`).

Når jeg prøver at Forbinde Siger &kstars; at teleskopet ikke er tilsluttet til seriel/USB-porten. Hvad kan jeg gøre?

Denne meddelelse kommer når &kstars; ikke kan kommunikere med teleskopet. Her er nogle få ting du kan gøre:

1. Tjek forbindelseskablet. Sørg for at det er i god stand og test det med andre programmer.

2. Tjek at teleskopet får strøm. Kontrollér at kontakten er tændt og at der er strøm nok.

3. Angiv den korrekte port i INDI-kontrolpanelet i menuen Enheder. Standardporten er `/dev/ttyS0`

4. Genstart &kstars; og prøv igen.

&kstars; skriver at teleskopet er online og klar, men jeg kan ikke finde teleskopets trådkors. Hvor er det?

&kstars; modtager teleskopets RA og Dekl. koordinater ved forbindelse. Hvis kalibreringen af teleskopet er korrekt, skulle du se trådkorset omkring det mål på stjernekortet. Men de RA og Dekl. koordinater teleskopet sender er måske ikke korrekte (måske ovenikøbet under horisonten) så du må synkronisere dit teleskop med dit nuværende mål.

Teleskopet bevæger sig uregelmæssigt eller det bevæger sig slet ikke. Hvad kan jeg gøre?

Opførslen skyldes som regel forkerte indstillinger, prøv at gennemgå denne tjekliste:

1. Er teleskopet kalibreret?

2. Er teleskopets kalibreringstilstand korrekt? Brug INDI kontrolpanel til at undersøge og ændre opsætningen (`Alt/Az,Polar, Land`).

3. Er teleskopets opsætning af tid og dato korrekt?

4. Er teleskopets opsætning af længde- og breddegrad korrekt?

5. Er teleskopets opsætning af UTC-afvigelse korrekt?

6. Er teleskopets RA og Dekl. akser spændt ordentligt?

7. Er teleskopets N/S omskifter (hvis den findes) sat korrekt til den jordhalvkugle du befinder dig på?

8. Er kablet mellem teleskopet og computeren i god stand?

Hvis du er sikker på at alle indstillinger er korrekte, men teleskopet stadig bevæger sig uregelmæssigt eller slet ikke, så send en rapport til kstars-devel@kde.org