# Управление на астрономически устройства с INDI

&kstars; предоставя интерфейс за конфигуриране и управление на астрономически инструменти чрез протокола INDI.

Протоколът INDI поддържа различни астрономически инструменти като CCD камери и фокусери. За актуален списък с поддържани устройства, моля, посетете страница с поддържани устройства на INDI.

## Настройка на INDI

&kstars; може да контролира безпроблемно локални и отдалечени устройства чрез INDI сървър/клиентска архитектура. INDI устройствата могат да работят в три различни режима:

1. Локален: Локалният режим е най-често срещаният и се използва за управление на локално устройство (т.е. устройство, свързано към вашата машина).

2. Сървър: Сървърният режим установява сървър INDI за определено устройство и чака връзки от отдалечени клиенти. Не можете да управлявате сървърни устройства, можете само да ги стартирате и изключвате.

3. Клиент: Клиентският режим се използва за свързване към отдалечени INDI сървъри, работещи с INDI устройства. Можете да управлявате отдалечени устройства безпроблемно като локални устройства.

Можете да стартирате локално устройство, да установите INDI сървъри и да се свържете с отдалечени клиенти от Инструменти Устройства Управление на устройства... от менюто.

Ето екранна снимка на прозореца Управление на устройства:

Стартирани драйвери на устройства Стартиране на драйвери на устройства

Можете да стартирате устройства, като прегледате списъка на устройствата, изберете конкретно устройство и след това щракнете върху бутона Старт на услугата. Можете да изберете режим на работа, локален или сървър, както е дефинирано по-горе. Номерът на порта се генерира на случаен принцип в диапазона от 7624 до 10 000. За да посочите порт, щракнете върху колоната с порт до желания драйвер. &kstars; позволява множество драйвери да работят под един сървър INDI и следователно един порт. Изберете няколко драйвера, след което натиснете бутона Старт на услугата.

За да управлявате отдалечени устройства, вижте раздела управление на отдалечено устройство.

## Настройка на телескопа

Повечето телескопи са оборудвани с RS232 конектор за дистанционно управление. Свържете жака RS232 на вашия телескоп към сериен/USB порт на вашия компютър. Традиционно RS232 се свързва към серийния порт на вашия компютър, но тъй като много нови лаптопи изоставиха серийния порт в полза на USB/FireWire портове, може да се наложи да използвате адаптер от сериен към USB, който да използвате с по-новите лаптопи.

След като свържете вашия телескоп към серийния/USB порт, включете вашия телескоп. Силно е препоръчително да изтеглите и инсталирате най-новия фърмуер за контролера на вашия телескоп.

Телескопът трябва да бъде подравнен, преди да може да се използва правилно. Подравнете вашия телескоп (подравняване с една или две звезди), както е илюстрирано в ръководството за вашия телескоп.

&kstars; трябва да провери настройките за време и местоположение, преди да се свърже с телескопа. Това осигурява правилно проследяване и синхронизация между телескопа и &kstars;. Следните стъпки ще ви позволят да се свържете с устройство, което е свързано към вашия компютър. За да свържете и управлявате отдалечени устройства, моля, вижте раздела управление на отдалечено устройство.

Можете да използвате помощника за настройка на телескопа и той ще провери цялата необходима информация в процеса. Той може автоматично да сканира портове за прикачени телескопи. Можете да стартирате помощника, като изберете елемента от менюто Устройства Помощник за настройка на телескопа.

Като алтернатива можете да се свържете с локален телескоп, като изпълните следните стъпки:

1. Задайте вашето географско местоположение. Отворете прозореца Задаване на географско местоположение, като изберете елемента от менюто Настройки Местоположение... или като натиснете иконата Глобус в лентата с инструменти или като натиснете &Ctrl;G.

2. Задайте вашето местно време и дата. Можете да промените всеки час или дата, като изберете Време Задаване на час... в менюто или като натиснете иконата Часовник в лентата с инструменти. Прозорецът Задаване на време използва стандартния за &kde; уиджет за избор на дата и час. Ако се наложи да върнете часовника обратно към текущото време, просто изберете елемента от менюто Време Връщане към системното време.

3. Щракнете върху елемента от менюто Инструменти Устройства Управление на устройства....

4. Под колоната Устройство изберете вашия модел телескоп.

5. Щракнете върху бутона Старт на услугата.

6. Щракнете върху Затваряне, за да излезете от диалоговия прозорец на управление на устройствата.

### Чести настройки

Не е необходимо да задавате географско местоположение и час всеки път, когато се свързвате с телескоп. Регулирайте настройките само според нуждите.

Вече сте готови да използвате функциите на устройството, &kstars; удобно осигурява два взаимозаменяеми &GUI; интерфейси за управление на телескопи:

## Управление на телескопа

1. Контрол на картата на небето: За всяко устройство, което стартирате в Управление на устройства, в изскачащото меню ще се покаже съответен запис, който ви позволява да контролирате свойствата на устройството. Можете да издавате команди като `Завъртване`, `Синх` и `Проследяване` директно от картата на небето.

   Ето екранна снимка на изскачащото меню с активно устройство LX200 Classic:

   Управление на устройства от картата на небето

2. Контролен панел INDI: Панелът предлага на потребителя всички функции, поддържани от дадено устройство.

   Панелът е разделен на три основни секции:

   - Раздели на устройството: Всяко допълнително активно устройство заема раздел в панела INDI. Няколко устройства могат да работят едновременно, без да се засяга работата на други устройства.

   - Изгледи на свойства в разделите Главен контрол и Опции: Свойствата са ключовият елемент в INDI архитектурата. Всяко устройство дефинира набор от свойства за комуникация с клиента. Текущото положение на телескопа е пример за свойство. Семантично сходните свойства обикновено се съдържат в логически блокове или групи.

   - Програма за преглед на регистрационни файлове: Устройствата отчитат състоянието си и потвърждават командите чрез изпращане на INDI съобщения. Всяко устройство има собствен изглед на журнал. Устройството обикновено изпраща съобщения само до своя драйвер, но на устройството е разрешено да изпраща общо съобщение, когато е подходящо.

   Контролен панел INDI

Не сте ограничени да използвате един интерфейс над друг, тъй като и двата могат да се използват едновременно. Действията от Небесната карта автоматично се отразяват в контролния панел на INDI и обратно.

За да се свържете с вашия телескоп, можете или да изберете Свързване от изскачащото меню на вашето устройство или като алтернатива можете да натиснете Свързване под раздела на вашето устройство в контролния панел на INDI.

По подразбиране &kstars; ще се опита да се свърже с порта `/dev/ttyS0`. За да промените порта за връзка, изберете елемента от менюто Инструменти Устройства Контролен панел на INDI... и променете порта под раздела на вашето устройство.

&kstars; автоматично актуализира дължината, ширината и времето на телескопа въз основа на текущите настройки в &kstars;. Можете да ги активирате/деактивирате, като използвате страницата INDI от елемента от менюто Настройки Конфигуриране на &kstars;.... С помощта на страницата INDI можете да конфигурирате &kstars; за показване или не на INDI съобщения за състояние в лентата на състоянието. По подразбиране номерата на портовете на INDI сървъра имат стойности между диапазона от 7624 до 9000, но можете лесно да промените диапазона, като използвате текстовите полета От: и До: от Сървърен порт раздел.

Ако &kstars; комуникира успешно с телескопа, той ще извлече текущите RA и DEC от телескопа и ще покаже кръст на картата на небето, показващ позицията на телескопа. Можете да скриете мерника, който маркира позицията на телескопа, като използвате страницата INDI от менюто Настройки Конфигуриране на &kstars;... вещ.

### Синхронизиране на вашия телескоп

Ако сте настроили телескопа си и последната звезда за подравняване е била например Вега, тогава мерникът трябва да е центриран около Вега. Ако мерникът е извън целта, тогава можете да с десния бутон щракнете върху Вега на картата на небето и да изберете `Синхронизиране` от менюто на вашия телескоп. Това действие ще инструктира телескопа да синхронизира вътрешните си координати, за да съответства на тези на Вега, а мерникът на телескопа сега трябва да е центриран около Вега.

Това е: вашият телескоп е готов да изследва космоса!

### ВНИМАНИЕ

Никога не използвайте телескопа, за да гледате слънцето. Гледането към слънцето може да причини необратимо увреждане на очите и оборудването ви.

## Настройка на CCD и видео заснемане

Можете да стартирате устройства CCD и заснемане на видео от елемента от менюто Инструменти Устройства Управление на устройства.... Както всички INDI устройства, някои от контролите на устройството ще бъдат достъпни от картата на небето. Устройството може да се контролира напълно от елемента Контролен панел на INDI....

Стандартният формат за заснемане на изображения е FITS. След като изображението бъде заснето и изтеглено, то автоматично ще се покаже в програмата за преглед на FITS на &kstars;.

## Конфигуриране на INDI

Страницата INDI ви позволява да променяте специфичните за INDI клиентски настройки. За достъп до нея изберете страницата INDI от Настройки Конфигуриране на &kstars;... от менюто. Прозорецът е разделен на няколко основни категории: Общи, Актуализации на устройството, Екран и Порт на сървъра:

- Общи

  - сървър INDI: Посочете двоичния файл на инсталиран сървър INDI във вашата система. По подразбиране &kstars; използва /usr/bin/indiserver.

  - XML директория на INDI драйвери: Посочете &XML; директория, където се намират INDI драйверите във вашата система. По подразбиране &kstars; използва /usr/share/indi директория.

  - Директория по подразбиране FITS: Посочете директорията, в която ще бъдат записани всички заснети FITS изображения. Ако не е указана директория, изображенията ще се съхраняват в `$HOME`.

- Актуализации на местоположението, часа и датата

  - KStars актуализира всички устройства: KStars е основният източник за настройките за час, дата и местоположение. Всички настройки за време и местоположения на INDI устройства се синхронизират с настройките на KStars.

  - Монтировката актуализира данните на KStars: Монтировката е основният източник на настройки за време и местоположение. Настройките за време и местоположение на KStars се синхронизират с настройките на контролера.

  - GPS актуализира KStars: GPS драйверът е основният източник на настройки за време и местоположение. Настройките за време и местоположение на KStars се синхронизират с GPS настройките.

  - Час и дата: Автоматично синхронизира датата и часа на KStars от източника на актуализация.

  - Местоположение: Синхронизира настройките за местоположение на KStars от източника на актуализация.

- Показване

  - Оптичен мерник на телескопа: Когато е отметнато, &kstars; показва целевия мерник на телескопа върху картата на небето. Мерникът се показва при успешно свързване с телескопа и местоположението му се актуализира периодично. Името на телескопа се показва до мерника. &kstars; показва един мерник за всеки свързан телескоп. За да промените цвета на мерника на телескопа, отворете прозореца Конфигуриране - &kstars;. Изберете страницата Цветове и след това променете цвета на елемента Рамка на желания цвят.

  - Независим прозорец: Направете прозореца на FITS визуализатора независим.

  - Известия за съобщения: Показване на INDI съобщения като известия на работния плот вместо диалогови прозорци.

- Порт на сървъра

  - Посочете диапазон от портове, към които INDI сървърът ще се свързва при стартиране на нови драйвери.

## INDI Концепции

Основната ключова концепция в INDI е, че устройствата имат способността да се описват. Това се постига чрез използване на &XML; за описване на обща йерархия, която може да представлява както канонични, така и неканонични устройства. В INDI всички устройства могат да съдържат едно или повече свойства. Всяко свойство може да съдържа един или повече елемента. Има четири вида INDI свойства:

- Свойство Номер.

- Свойство номер.

- Свойство Превключване (Представено в &GUI; чрез бутони и квадратчета за отметка).

- Свойството Светлина (Представено в &GUI; от цветни светодиоди).

Например, всички INDI устройства споделят свойството на стандартния превключвател CONNECTION. Свойството CONNECTION има два елемента: превключватели CONNECT и DISCONNECT. &kstars; анализира общото &XML; описание на свойствата и изгражда &GUI;, подходящ за директно човешко взаимодействие.

Контролният панел INDI предлага много свойства на устройството, които не са достъпни от картата на небето. Предлаганите свойства се различават от едно устройство на друго. Въпреки това всички свойства споделят общи характеристики, които ограничават начина им на показване и използване:

- Разрешение: Всички свойства могат да бъдат само за четене, само за запис или разрешени за четене и запис. Пример за свойство за четене и запис е Ректасцензия на телескопа. Можете да въведете нова Ректасцензия и телескопът, въз основа на текущите настройки или ще се насочи или ще се синхронизира с новите данни. Освен това, когато телескопът се завъртва, Ректасцензията се актуализира и изпраща обратно на клиентската машина.

- Състояние: Преди всяко свойство има индикатор за състояние (кръгъл светодиод). Всяко свойство има състояние и свързан цветен код:

  ## Цветен код за състоянията на INDI

  Състояние | Цвят | Описание
  Неактивно | Сив | Устройството не извършва никакви действия по отношение на това свойство
  Добре | Зелен | Последната операция, извършена за това свойство е била успешна и активна
  Заето | Жълт | Свойството извършва действие
  Внимание | Червен | Свойството е в критично състояние и се нуждае от незабавна проверка

  Драйверът на устройството актуализира състоянието на свойството в реално време, когато е необходимо. Например, ако телескопът е в процес на завъртане към цел, тогава свойствата RA/DEC ще бъдат сигнализирани като Заето. Когато процесът на завъртване завърши успешно, свойствата ще бъдат сигнализирани като Добре.

- Контекст: Числовите свойства могат да приемат и обработват числа в два формата: десетичен и шестдесетичен. Шестдесетичният формат е удобен при изразяване на време или екваториални/географски координати. Можете да използвате всеки формат, който ви е удобен. Например всички от следните числа са равни:

  - -156.40

  - -156:24:00

  - -156:24

- Час и дата: Стандартното време за всички комуникации, свързани с INDI, е универсално време UTC, определено като ГГГГ-ММ-ДДТЧЧ:ММ:СС в съответствие с ISO 8601. &kstars; координира автоматично правилното UTC време с драйверите на устройства. Можете да активирате/деактивирате автоматичните актуализации на времето от страницата на INDI в диалоговия прозорец за настройки.

## Дистанционно управление на устройство

&kstars; предоставя прост, но мощен инструмент за дистанционно управление на устройства. Подробно описание на инструмента е описано в белите страници на INDI.

Трябва да конфигурирате както сървърната, така и клиентската машина за дистанционно управление:

1. Сървър: За да подготвите устройство за дистанционно управление, следвайте същите стъпки в настройката локално/сървър. Когато стартирате услуга за устройство в Управление на устройства, номерът на порт се показва под колоната Порт. В допълнение към номера на порта, имате нужда също от името на хоста или IP адреса на вашия сървър.

2. Клиент: Изберете елемента от менюто Инструменти Устройства Управление на устройства... и вие може да добавяте, модифицирате или изтривате хостове в раздела Клиент. Добавете хост, като щракнете върху бутона Добавяне. Въведете името на хоста/IP адреса на сървъра в полето Хост: и въведете номера на порта, получен от машината сървър в стъпка 1.

INDI клиентска машина

След като добавите хост, щракнете с десния бутон върху хоста, за Свързване или Прекъсване на връзката. Ако се установи връзка, можете да управлявате телескопа от небесната карта или контролния панел на INDI точно както е описано в локален/сървър раздел. Това е толкова лесно.

### Стартиране на INDI сървър от командния ред

Докато &kstars; ви позволява лесно да разположите INDI сървър; можете да стартирате INDI сървър и от командния ред.

Тъй като INDI е независим бекенд компонент, можете да стартирате INDI сървър на хост без &kstars;. INDI може да се компилира отделно, за да работи на отдалечени хостове. Освен това драйверите на устройства записват съобщения в `stderr` и това може да бъде полезно в ситуация на отстраняване на грешки. Синтаксисът за INDI сървър е следният:

`indiserver` [опции] драйвер [`драйвер` ...]

    Опции:
     -l d   : Записване в журнал на съобщенията на драйвера в <d>/YYYY-MM-DD.islog
     -m m   : Затваря клиента, ако изостава с повече от този брой MB, по подразбиране 128.
     -d m   : Отхвърляне на блоковите стрийминг данни, ако клиентът изостава с повече от този брой MB, по подразбиране 5. 0 за деактивиране.
     -p p   : Алтернативен IP порт, по подразбиране 7624.
     -r r   : Максимален брой на рестартиране на драйвера при грешка, по подразбиране 10.
     -f path : Път към FIFO за динамично стартиране и изключване на драйверите.
     -v    : Показване на ключови събития, без трафик.
     -vv   : -v + съдържание на ключовото съобщение.
     -vvv   : -vv + пълен xml.
     driver  : изпълним файл или [device]@host[:port]

Например, ако искате да стартирате INDI сървър, работещ с LX200 GPS драйвер и следящ за връзки на порт 8000, трябва да изпълните следната команда:

$ `indiserver` -p 8000 `lx200gps`

### Сигурност на отдалечените операции

Да предположим, че искаме да стартираме indiserver с INDI драйвери на отдалечен хост, `remote_host`, и да ги свържем към &kstars; работещ на локалната машина.

От локалната машина към отдалечения хост, `remote_host`, като напишете:

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

Това свързва `local_port` на локалната машина с `remote_port` на `remote_host`. След като влезете, стартирайте indiserver на отдалечения хост:

$ `indiserver` -p `remote_port` [`драйвер`...]

Обратно на локалната машина, стартирайте &kstars; след това отворете Управление на устройства и добавете хост под раздела Клиент. Хостът трябва да е локалният хост (обикновено 127.0.0.1), а номерът на порта трябва да е `local_port`, използван в стъпките по-горе. Кликнете с десен бутон върху хоста и изберете Свързване от изскачащото меню. &kstars; ще се свърже сигурно с отдалечения INDI сървър. Информацията за хоста ще бъде запазена за бъдещи сесии.

## INDI Често задавани въпроси

Какво е INDI?

INDI е протоколът за управление на Instrument-Neutral-Distributed-Interface, разработен от Elwood C. Downey от ClearSky Institute. &kstars; използва драйвери на устройства, които са съвместими с протокола INDI. INDI има много предимства, включително лесно свързване между хардуерни устройства и софтуерни драйвери. Клиентите, които използват драйверите на устройството (като &kstars;), изобщо не знаят за възможностите на устройството. По време на изпълнение, &kstars; комуникира с драйверите на устройството и изгражда напълно динамичен &GUI; въз основа на услугите, предоставяни от устройството. Следователно, нови драйвери на устройства могат да бъдат написани или актуализирани и &kstars; може да се възползва напълно от тях без никакви промени от страна на клиента.

Планирате ли да поддържате повече устройства?

Да. Планираме да поддържаме основните CCD камери и фокусери и да разширим поддръжката за повече телескопи. Ако искате INDI да поддържа конкретно устройство, моля, изпратете имейл до indi-devel@lists.sourceforge.net

Какви операции осигурява &kstars; за контрол на телескопа?

Зависи от конкретния телескоп, който използвате, но минималните три операции са `Завъртване`, `Проследяване` и `Синх`, които можете да изпълните директно от картата на небето. Вашият телескоп трябва да бъде подравнен, за да могат тези операции да се изпълняват правилно. Някои телескопи ви предлагат повече операции като управление на местоположение, режими на завъртване, фокусиране, паркиране и други. Можете да получите достъп до разширените функции на телескопите от елемента от менюто Инструменти Устройства Контролен панел на INDI....

Каква е точно разликата между `Завъртване`, `Проследяване` и `Синх`?

Командата `Завъртване` нарежда на телескопа да се придвижи към определена цел и след като телескопът достигне целта си, телескопът продължава да проследява тази цел със сидерична скорост (т.е. скорост, с която звездите се движат по небето). Това работи добре за звезди, обекти на Месие и всичко извън нашата слънчева система. Но обектите в слънчевата система пътуват по различен начин в небето и затова телескопът трябва да `Проследява` обектите, докато се движат.

Следователно, трябва да издадете команда за проследяване, ако искате да проследите обект с незвездно движение. От друга страна, `Синх` се използва за синхронизиране на вътрешните координати на телескопа с тези на обект, който изберете.

Мога ли да управлявам телескопа си дистанционно?

Да. Можете да стартирате INDI сървър на машината, свързана към вашия телескоп, и сървърът ще следи за заявки от клиенти на &kstars;. След като се свържете, можете да управлявате своя телескоп директно от картата на небето. Тази процедура е описана подробно в раздела Отдалечено управление на устройство.

Когато се опитам да извърша Свърване, &kstars; съобщава, че телескопът не е свързан към серийния/USB порт. Какво мога да направя?

Това съобщение се задейства, когато &kstars; не може да комуникира с телескопа. Ето няколко неща, които можете да направите:

1. Проверете дали имате права за четене и писане за порта, към който се опитвате да се свържете.

2. Проверете свързващия кабел, уверете се, че е в добро състояние и го тествайте с други приложения.

3. Проверете захранването на вашия телескоп, уверете се, че захранването е включено и че телескопът получава достатъчно енергия.

4. Изберете елемента от менюто Инструменти Устройства Контролен панел на INDI... и задайте правилния порт в диалоговия прозорец на контролния панел на INDI. Устройството по подразбиране е `/dev/ttyS0`

5. Рестартирайте &kstars; и опитайте отново.

&kstars; съобщава, че телескопът е онлайн и е готов, но не мога да намеря мерника на телескопа, къде е?

&kstars; извлича координатите на телескопите по RA и DEC при свързване. Ако подравняването ви е извършено правилно, тогава трябва да видите мерника около вашата цел в небесната карта. Предоставените от телескопа RA и DEC координати обаче може да са неправилни (дори под хоризонта) и тогава трябва да синхронизирате телескопа си с текущата си цел. Можете да използвате менюто с десен бутон, за да центрирате и проследите мерника на телескопа в картата на небето.

Телескопът се движи хаотично или изобщо не се движи. Какво мога да направя?

Това поведение се дължи най-вече на неправилни настройки, моля, проверете следния контролен списък:

1. Подравнен ли е телескопът?

2. Правилен ли е режимът на центриране на телескопа? Използвайте Контролен панел на INDI, за да проверите и промените тези настройки (`Alt/Az, Polar, Land`).

3. Правилни ли са настройките за час и дата на телескопа?

4. Правилни ли са настройките за дължина и ширина на телескопа?

5. Правилно ли е UTC отместването на телескопа?

6. Стабилно ли са заключени оста RA и DEC на телескопа?

7. Превключвателят N/S на телескопа (когато е приложим) правилно ли е настроен за вашето полукълбо?

8. В добро състояние ли е кабелът между телескопа и компютъра?

Ако смятате, че всички настройки са правилни, но телескопът все още се движи хаотично или изобщо не се движи, моля, изпратете доклад на indi-devel@lists.sourceforge.net.