# Astronomisk enhedskontrol 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
Autostar baserede teleskoper | LX200 Autostar | 0.5
LX200 GPS 8"-16" | LX200 GPS | 0.5
LX200 Classic 16" | LX00 16" | 0.5
NexStar GPS, CGE, AS-GT | Celestron GPS | 0.5
Ny GT, NexStar 5i/8i | Celestron GPS | 0.5
Takahashi Temma | temma | 0.1
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.

## Understøttede CCD'er

CCD | Enhedsdriver | Version
Finger Lakes Instruments CCDs | fliccd | 0.1

## Understøttede net-kameraer

Netkamera | Enhedsdriver | Version
Alle enheder som virker med Video4Linux | v4ldriver | 0.1
Philips netkameraer | v4lphilips | 0.1

## INDI-opsætning

Kstars kan styre lokale enheder og fjernenheder fint via INDI's klient/server-arkitektur. INDI-enheder kan køres i tre forskellige tilstande:

1. Lokalt: Den lokale tilstand er den almindeligste, og bruges til at styre lokale enheder (&ie; en enhed som er koblet til din maskine).

2. Server: Servertilstand etablerar en INDI-server for en vis enhed og venter på tilslutning fra fjernklienter. Du kan ikke styre serverenheder, du kan kun starte og afslutte dem.

3. Klient: Klienttilstand bruges til at tilslutte til INDI-fjernservere som kører INDI-enheder. Du kan styre fjernenheder fint som lokale enheder.

Du kan styre lokale enheder, oprette INDI-servere og forbinde til fjernklienter fra Enhedshåndteringen i menuen Enheder.

Her er et skærmbillede af Enhedshåndteringen:

Kørende enhedsdrivere Start enhedsdrivere

Du kan styre enheder ved at søge i enhedstræet, vælge en særlig enhed, og derefter klikke på knappen Kør tjeneste. Du kan vælge køretilstand, enten lokal eller server, ifølge definitionen ovenfor.

For at styre fjernenheder, se afsnittet Fjernstyring af enhed.

## 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-adaptor 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. Kalibrér dit teleskop (en eller to-stjernerskalibrering) som vist i dit teleskops manual.

&kstars; har brug for at fastslå tid og sted før det forbinder til teleskopet. Det sikrer ordentlig følgen 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.

Du kan bruge teleskopguiden, den vil så kontrollere al information som kræves mens den køres. Den kan automatisk afsøge porte efter forbundne teleskoper. Du kan køre guiden ved at vælge Teleskopguide i menuen Enheder.

Alternativt kan du få forbindelse til et lokalt teleskop, ved at udføre følgende 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.

### Ofte bruge indstillinger

Du behøver ikke indstille geografisk sted hver gang du forbinder til et teleskop. Justér blot indstillingerne efter behov.

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-indstillingsfelt: Feltet tilbyder brugeren alle de funktioner som understøttes af en enhed.

   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.

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.

## Indstilling af CCD- og videoindfangning

Kstars understøtter Finger Lakes instruments CCD'er og alle enheder som virker med Video4Linux. De udvidede funktioner for Philips netkameraer understøttes også.

Du kan køre CCD- og videoenheder fra Enhedshåndteringen i menuen Enheder. Som alle INDI-enheder, er en der adgang til en vis styring af enheden fra himmelkortet. Enheden kan styres fuldstændigt fra INDI-kontrolpanelet.

Standardformatet for at tage billeder er FITS. Når et billede er taget og hentet, vises det i Kstars FITS-visning. For at tage en følge af billeder, bruges værktøjet Tag billedsekvens i menuen Enheder. Værktøjet er inaktivt indtil du opretter en forbindelse til en billedenhed.

## INDI koncept

Hovednøglebegrebet i INDI er at enheder har mulighed for at beskrive sig selv. Dette opnås ved at bruge XML til at beskrive et generelt hierarki som både kan repræsentere konventionelle og ikke-konventionelle enheder. I INDI kan alle enheder indeholde en eller flere egenskaber. Alle egenskaber kan indeholde et eller flere elementer. Der er fire typer INDI-egenskaber:

- Tekstegenskab.

- Nummeregenskab.

- Skifteegenskab (repræsenteres med knapper og afkrydsningsfelter i den grafiske grænseflade).

- Lysegenskab (repræsenteres af farvede lysdioder i den grafiske grænseflade)

Alle INDI-enheder deler den standardiserede skifteegenskab CONNECTION. Egenskaben CONNECTION har to elementer CONNECT og DISCONNECT. Kstars tolker den generelle XML-beskrivelse af egenskaber og bygger en repræsentation i en grafisk grænseflade som er passende for direkte interaktion med brugeren.

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 "underliggende"-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 maskine der står et andet sted, `fjern_maskine`, og forbinde dem til &kstars; på din lokale maskine.

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

$ `ssh` -L `lokal_port`:`fjern_vært`:`fjern_port`

Det binder `lokal_port` på den lokale maskine til `fjern_port` på `fjern_vært`. Efter at du har logget ind startes indiserver en på fjernmaskinen:

$ `indiserver` -p `fjern_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 `lokal_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.

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å skriv 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. Kontrollér at du både har læse- og skriverettighed for porten du forsøger at forbinde til.

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

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

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

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