Керування астрономічними приладами за допомогою INDI
надає вам інтерфейс для налаштування і керування астрономічними інструментами за допомогою протоколу обміну даними INDI.
Протокол INDI підтримує значну кількість астрономічних інструментів, зокрема, ПЗЗ-фотокамери і прилади для фокусування. Поточний список підтримуваних пристроїв можна знайти на сторінці списку підтримуваних пристроїв INDI.

Налаштування INDI
Програма здатна безпосередньо керувати локальними або віддаленими пристроями за допомогою клієнт-серверної архітектури INDI. Пристрої INDI можна запустити у одному з трьох режимів:
Локальному: цей режим є найпоширенішим, він використовується для керування локальним пристроєм (тобто пристроєм, який з’єднано з вашим комп’ютером).
Серверному: у серверному режимі запускається сервер INDI для якогось з пристроїв, а потім цей сервер очікує на команди від віддалених клієнтів. Ви самі не можете керувати серверними пристроями, ви можете лише запустити і зупинити серверний режим для цих пристроїв.
Клієнтському: клієнтський режим використовують для з’єднання з віддаленими серверами INDI, на яких запущено пристрої INDI. У цьому режимі ви можете безпосередньо керувати віддаленими пристроями так, неначе вони є локальними.
Ви можете запустити локальний пристрій, встановити сервери INDI, і з’єднатися з віддаленими клієнтами за допомогою пункту Керування пристроями у меню Інструменти Пристрої.
Ось знімок вікна Керування пристроями:
Як запустити драйвери пристрою
Запуск драйверів пристрою
Запускати керування пристроями можна за допомогою ієрархічного списку пристроїв: позначте у ньому пристрій, а потім натисніть кнопку Запустити службу. Ви можете вибрати режим роботи (локальний або серверний), як це описано вище. Номер порту буде вибрано випадковими чином з діапазону від 7624 до 10.000. Щоб вказати певний порт, натисніть стовпчик порту, у рядку потрібного вам драйвера. У передбачено можливість запуску декількох драйверів на одному сервері INDI, отже на одному порті. Позначте у списку декілька пунктів пристроїв, а потім натисніть кнопку Запустити службу.
Щоб дізнатися як керувати віддаленими пристроями, прочитайте розділ про віддалене керування пристроями.

Налаштування телескопа
Більшість телескопів обладнується інтерфейсом RS232 для віддаленого керування. З’єднайте порт RS232 вашого телескопа з Послідовним або USB портом вашого комп’ютера. Традиційно, RS232 з’єднується з послідовним портом вашого комп’ютера, але оскільки у більшості портативних комп’ютерів цього порту вже немає (його замінив порт USB/FireWire), вам може знадобитися перехідний пристрій з послідовного порту на порт USB, щоб керувати обладнанням з сучасних портативних комп’ютерів.
Після з’єднання вашого телескопа з послідовним або USB-портом увімкніть ваш телескоп. Ми наполегливо рекомендуємо вам отримати і встановити найсвіжіші мікропрограми (firmware) для контролера вашого телескопа.
Перш ніж почати використання телескопа, вам слід вирівняти його. Виконайте цю операцію (юстування першого або другого рівня) відповідно до інструкції вашого телескопа.
Перш ніж з’єднатися з телескопом, потрібно перевірити параметри часу і розташування у . Правильні значення цих параметрів забезпечать належну точність стеження і синхронізації між телескопом і . Далі за текстом розміщено покроковий опис процесу безпосереднього з’єднання пристрою з вашим комп’ютером. Щоб з’єднатися з віддаленим пристроєм і встановити над ним керування, зверніться до розділу про віддалене керування пристроями.
Ви можете скористатися Майстром налаштування телескопа — він перевірить всю потрібну інформацію у процесі своєї роботи. Він може провести автоматичне сканування портів вашого комп’ютера на предмет наявності з’єднаних з ним телескопів. Запустити цей інструмент можна за допомогою пункту Майстер налаштування телескопа з меню Пристрої.
Якщо ви віддаєте перевагу іншому шляху, телескоп можна з’єднати з комп’ютером, послідовно виконуючи такі кроки:
Встановіть ваше географічне розташування. Для цього відкрийте вікно Встановлення географічного розташування вибором пункту Географічне... з меню Параметри, натисканням кнопки з піктограмою земної кулі на панелі інструментів або за допомогою комбінації клавіш G.
Встановіть ваш місцевий час і дату. Ви можете змінити час за допомогою пункту Встановити час... з меню Час або натискання кнопки з піктограмою годинника на панелі інструментів. Вікно Встановити час використовує стандартний віджет для вибору дати. Якщо вам потрібно буде згодом скоригувати час на поточний час системи, просто виберіть пункт Встановити поточний час з меню Час.
Відкрийте меню Інструменти Пристрої і виберіть пункт Керування пристроями.
У стовпчику Пристрій виберіть модель вашого телескопа.
Натисніть кнопку Запустити службу.
Натисніть кнопку Закрити, щоб закрити діалогове вікно керування пристроями.

Типові параметри
Вам не потрібно буде встановлювати географічне розташування кожного разу під час з’єднання з телескопом. Вам слід зробити це лише одного разу, програма запам’ятає ваш вибір.
Тепер ви можете користуватися можливостями пристрою. Для керування телескопами у є два зручних графічних інтерфейси обміну інформацією:

Керування вашим телескопом
Керування з зоряної карти: кожному пристрою, який ви запустите за допомогою Керування пристроями, відповідатиме запис у контекстному меню, який надасть вам змогу керувати властивостями пристрою. Ви зможете віддавати команди Slew, Sync або Track безпосередньо з зоряної карти.
Ось знімок екрана з контекстним меню, у якому є пункт пристрою LX200 Classic:
Керування пристроями за допомогою карти неба
Панель керування INDI: за допомогою цієї панелі ви можете керувати всіма можливостями, які підтримує ваш пристрій.
Цю панель поділено на три основних розділи:
Вкладки пристроїв: кожен задіяний пристрій має свою вкладку на панелі INDI. Декілька пристроїв можна запустити одночасно: вони не заважатимуть одне одному.
Панелі властивостей на вкладках Основне керування та Параметри: властивості є ключовими елементами архітектури INDI. Кожному пристрою відповідає набір властивостей, за допомогою яких він обмінюється інформацією з клієнтом. Прикладом такої властивості є точка, куди у даний час спрямовано телескоп. Властивості, схожі за значенням, зазвичай поєднано у блоки або групи.
Перегляд журналів: пристрої повідомляють про свій стан і реакцію на команди, надсилаючи INDI-повідомлення. Кожному пристрою відповідає свій перегляд журналу. Зазвичай, пристрій надсилає повідомлення лише своєму драйверу, але ніщо не забороняє пристроєві за потреби надсилати загальне повідомлення.
Панель керування INDI
Вам не потрібно використовувати один або інший інтерфейс, обидва можна використовувати одночасно. Дії з інтерфейсу карти неба автоматично повторюються на панелі керування INDI, і навпаки.
Щоб з’єднатися з вашим телескопом, ви можете вибрати пункт З’єднатися з контекстного меню вашого пристрою або натиснути кнопку З’єднатися на вкладці вашого пристрою на Панелі керування INDI.
Типово, здійснить спробу з’єднатися з портом /dev/ttyS0. Щоб змінити порт з’єднання, виберіть пункт Панель керування INDI з меню Інструменти Пристрої і змініть порт на вкладці відповідного пристрою.
автоматично оновлює дані щодо координат широти і довготи телескопа, а також часу на основі поточних параметрів роботи . Увімкнути або вимкнути цю типову поведінку можна за допомогою сторінки INDI вікна, яке можна відкрити за допомогою пункту меню Параметри Налаштувати .... За допомогою сторінки INDI ви також можете налаштувати на показ або вимикання повідомлень щодо стану INDI на смужці стану. Типово, порти сервера INDI мають номери у діапазоні від 7624 до 9000, але ви можете змінити цей діапазон за допомогою пунктів Від і До розділу Порт сервера.
Якщо вдасться зв’язатися з телескопом, програма отримає від нього поточні дані про ПС і СХЛ і покаже на зоряній карті візир, що позначає точку, у яку спрямовано телескоп. Ви можете наказати програмі приховати візир, що позначає цю точку за допомогою сторінки INDI у вікні, яке можна відкрити за допомогою пункту меню Параметри Налаштувати ... submenu.

Синхронізація вашого телескопа
Якщо ви виконали візирування вашого телескопа і останньою зіркою для візирування була, наприклад Вега, позначка візира має знаходитися поряд з Вегою. Якщо візир не знаходить у правильній позиції, ви можете навести вказівник миші на Вегу, клацнути правою кнопкою і вибрати команду Sync з меню вашого телескопа. Виконана вами дія — це наказ телескопу синхронізувати його внутрішні координати з координатами Веги, тепер візир має знаходитися на позначці Веги.
Ну ось: тепер ваш телескоп готовий до вивчення небес!

ПОПЕРЕДЖЕННЯ
Ніколи не спрямовуйте телескоп на Сонце. Спрямування телескопа на Сонце може спричинити невиправні ушкодження ваших очей і вашого обладнання.

Налаштування ПЗЗ і захоплення відео
Запустити пристрої ПЗЗ і відео-захоплення можна за допомогою пункту Керування пристроями у меню Інструменти Пристрої. Так само, як і для всіх пристроїв INDI, доступ до деяких з елементів керування пристроями можна отримати напряму з зоряної карти. Повноцінне керування пристроєм можна здійснювати за допомогою Панелі керування INDI.
Стандартним форматом, у якому проводитиметься захоплення зображень є FITS. Одразу після захоплення і отримання зображення автоматично буде показано у вікні Переглядача FITS .

Налаштування INDI
За допомогою сторінки налаштовування INDI ви можете змінювати клієнтські параметри INDI. Щоб відкрити її, натисніть пункт INDI у вікні, яке відкривається пунктом меню Параметри Налаштувати .... Це вікно поділено на декілька основних категорій: Загальна, Оновлення пристроїв, Показ та Порт сервера:
Загальне
Сервер INDI: вкажіть виконуваний файл сервера INDI у вашій системі. Типово, у використовується виконуваний файл /usr/bin/indiserver.
Каталог XML-драйверів INDI: вкажіть каталог, у якому зберігаються драйвери INDI у вашій системі. Типово, у використовується каталог /usr/share/indi.
Типова тека FITS: визначає теку, куди буде збережено всі захоплені зображення FITS. Якщо не вказано ніякої теки, зображення зберігатимуться у теці, на яку вказує системна змінна $HOME.
Оновлення дати і розташування
KStars оновлює усі пристрої: KStars є основним джерелом даних щодо часу і розташування. Дані щодо часу і розташування для усіх пристроїв INDI синхронізуються із даними у параметрах KStars.
Лафет оновлює дані KStars: лафет є основним джерелом даних щодо часу і розташування. Дані щодо часу і розташування у KStars синхронізуються із даними у параметрах контролера.
GPS оновлює дані KStars: драйвер GPSт є основним джерелом даних щодо часу і розташування. Дані щодо часу і розташування у KStars синхронізуються із даними у параметрах GPS.
Час: автоматично синхронізувати дату і час KStars з джерелом оновлення.
Розташування: синхронізувати параметри розташування KStars з джерелом оновлення.
Дисплей
Перехрестя телескопа: якщо позначено цей параметр, показуватиме рамку пристрою телескопа на зоряній карті. Перехрестя буде показано після успішного з’єднання з телескопом, а його розташування періодично оновлюватиметься. Поряд з рамкою буде розміщено назву телескопа. показує по рамці на кожен з’єднаний телескоп. Щоб змінити колір рамки телескопа, скористайтеся вікном Налаштувати . Виберіть у ньому сторінку Кольори, а потім змініть колір пункту Індикатор цілі на бажаний.
Незалежне вікно: робить вікно Переглядач FITS незалежним від основного вікна програми.
Сповіщення: показувати повідомлення INDI як сповіщення стільниці замість вікон.
Порт сервера
Задайте діапазон портів, які буде прослуховувати INDI сервер після запуску нових драйверів.

Принципи INDI
Одним з ключових елементів INDI є припущення, що пристрої можуть самі надавати свій опис. Його реалізовано за допомогою XML, який описує загальну ієрархію, яка відповідає канонічним і неканонічним пристроям. У INDI коженl пристрій може мати одну або декілька властивостей. Кожна з властивостей може мати один або декілька елементів. Всього існує чотири типи властивостей INDI:
Текстова властивість.
Числова властивість.
Властивість-перемикач (у графічному інтерфейсі таким властивостям відповідають кнопки або поля для позначок).
Властивість світла (у графічному інтерфейсі таким властивостям відповідають кольорові лампочки).
Наприклад, всі пристрої INDI маються стандартну властивість-перемикач CONNECTION. Властивість CONNECTION має два елементи-стани перемикання: CONNECT і DISCONNECT. обробляє загальний опис властивостей у XML і будує графічний відповідник властивості придатний для людського сприйняття.
На панелі керування INDI ви можете знайти багато властивостей, доступ до яких не можна отримати з зоряної карти. Перелік цих властивостей залежить від конкретного пристрою. Але всі властивості мають спільні риси, які визначають спосіб, у який їх буде показано і використано:
Дозвіл: властивість може бути придатною лише для читання, лише для запису або придатною як для читання, так і для запису. Прикладом придатної для читання і для запису властивості є координата прямого сходження телескопа. Ви можете ввести нову координату прямого сходження, і телескоп, відповідно до поточних параметрів, змінить спрямування або синхронізується у відповідності з введеним значенням. Крім того, після зміни спрямування телескопа його координату прямого сходження буде оновлено і надіслано як підтвердження клієнтові.
Стан: перед пунктом кожної властивості є індикатор стану (кругла лампочка). Кожна властивість має певний стан і відповідне позначення кольором:

Кольори станів INDI
Стан	Колір	Опис
Не задіяно	Сірий	Щодо цієї властивості пристрій не виконує ніяких дій
Гаразд	Зелений	Остання дія з цією властивістю пройшла вдало, її задіяно
Зайнятий	Жовтий	Властивість пов’язана з поточною дією
Попередження	Червоний	Властивість перебуває у критичному стані і вимагає негайного втручання
У разі потреби стани властивостей оновлюються драйвером пристрою. Наприклад, якщо телескоп знаходиться у стані переспрямування на нову ціль, властивості RA/DEC буде показано як Зайнятий. Якщо процес переспрямування буде успішно завершено, властивості змінять стан на Гаразд.
Контекст: числові властивості можуть приймати і обробляти числа у двох форматах: десятковому і шестидесятковому. Шестидесятковий формат зручний для екваторіальних та географічних координат. Ви можете використовувати будь-який зручний для вас формат. Наприклад, наступні числа є рівними між собою:
-156.40
-156:24:00
-156:24
Час: стандартним часом для пов’язаного з INDI обміну інформацією є Всесвітній час UTC у вигляді РРРР-ММ-ДДTГГ:ХХ:СС, у відповідності зі стандартом ISO 8601. автоматично використовує для обміну інформацією правильний формат часу UTC. Ви можете увімкнути або вимкнути автоматичне оновлення часу за допомогою сторінки налаштування INDI у параметрах програми.

Керування віддаленими пристроями
надає доступ до простого, але водночас потужного рівня віддаленого керування пристроями. Докладний опис цього рівня наведено у білій книзі INDI.
Для віддаленого керування вам потрібно налаштувати обидва комп’ютери: сервер і клієнт.
Сервер: щоб підготувати пристрій до віддаленого керування, виконайте дії згідно кроків, зазначених у описі налаштування клієнта/сервера. Після запуску служби пристрою у Керуванні пристроями у стовпчику Порт з’явиться номер порту. Окрім номеру порту вам потрібна буде назва вузла або IP-адреса вашого сервера.
Клієнт: виберіть пункт Керування пристроями з меню Інструменти Пристрої, а потім відкрийте у відповідному вікні вкладку Клієнт. На вкладці Клієнт ви можете додавати, змінювати або вилучати вузли. Додати вузол можна натисканням кнопки Додати. Введіть назву вузла або IP-адресу сервера у поле Вузол, а замість номера порту введіть номер порту отриманий від комп’ютера-сервера на першому кроці.
Клієнт INDI
Після додавання вузла відкрийте його контекстне меню за допомогою правої кнопки миші, щоб З’єднатися з ним або Від’єднатися від нього. Якщо з’єднання буде встановлено, ви зможете керувати вашим телескопом з Зоряної карти або Панелі керування INDI у той спосіб, що описано у розділі щодо клієнтського і серверного режиму. Ну ось, власне, і все.

Як запустити сервер INDI з командного рядка
Хоча надає вам змогу без проблем запустити сервер INDI, ви можете зробити це і з командного рядка.
Оскільки INDI є незалежним серверним компонентом, ви можете запускати сервер INDI на вузлах, де не встановлено . Для запуску на віддалених вузлах INDI можна зібрати окремо. Крім того, драйвери пристроїв записують повідомлення у stderr, ці повідомлення будуть корисними для усунення можливих проблем. Синтаксис команд сервера INDI такий:
$ indiserver [параметри] driver [драйвер ...]

Параметри:
 -l d     : записувати журнал драйвер а до файла <d>/РРРР-ММ-ДД.islog
 -m m     : «вбити» клієнт, якщо він споживатиме понад вказану кількість мегабайтів, типово, 128.
 -d m     : відкидати потоків блоки даних, якщо клієнт споживатиме понад вказану кількість мегабайтів, типово 5. 0 — вимкнути.
 -p p     : змінити IP-порт, типовим є порт 7624.
 -r r     : максимальна кількість перезапусків драйвера при помилці, типова кількість — 10.
 -f шлях  : шлях до каналу fifo для динамічного запуску та завершення роботи драйверів.
 -v       : показати ключові події, без обміну даними.
 -vv      : -v + вміст ключових повідомлень.
 -vvv     : -vv + увесь xml.
 driver   : виконуваний файл або [пристрій]@вузол[:порт]

Наприклад, щоб запустити сервер INDI разом з драйвером LX200 GPS так, щоб він очікував на з’єднання з портом 8000, слід виконати команду:
$ indiserver -p 8000 lx200gps

Безпечне віддалене керування
Припустімо, що нам потрібно запустити indiserver з драйверами INDI на віддаленому вузлі, віддалений_вузол, а потім зв’язатися з ним з , запущеного на локальному комп’ютері.
Увійдіть з локального комп’ютера на віддалений_вузол за допомогою команди:
$ ssh -L локальний_порт:віддалений_вузол:віддалений_порт
Ця команда пов’яже локальний_порт на локальному комп’ютері з віддаленим_портом на віддаленому_вузлі. Після вдалого входу до віддаленого вузла, запустіть на ньому indiserver:
$ indiserver -p віддалений_порт [драйвер...]
На локальному комп’ютері запустіть , потім відкрийте вікно Керування пристроями і додайте вузол на вкладці Клієнт. Вузлом має бути назва локального комп’ютера (зазвичай, 127.0.0.1), а номером порту має бути номер локальний_порт, використаний у попередніх кроках. Наведіть вказівник миші на запис вузла і клацніть правою кнопкою, а потім виберіть з контекстного меню пункт З’єднатися. Відбудеться безпечне з’єднання з віддаленим сервером INDI. Інформацію про вузол буде збережено для наступних сеансів роботи з програмою.

Питання і відповіді щодо INDI
Що таке INDI?
INDI — це скорочення від Instrument-Neutral-Distributed-Interface (незалежний від інструментів розподілений інтерфейс), він є протоколом керування, розробленим Elwood C. Downey з Інституту ClearSky. використовує драйвери пристроїв, сумісні з протоколом INDI. INDI має багато переваг, серед них вільне з’єднання між апаратними пристроями і програмними драйверами. Авторам клієнтських програм, що використовують драйвери пристроїв (зокрема, ), зовсім не потрібно перейматися точним визначенням можливостей того, чи іншого пристрою. Під час запуску просто отримує інформацію від драйверів пристрою, а потім будує динамічний графічний інтерфейс відповідно до повідомлених можливостей пристрою. Тому ви можете отримувати повний спектр можливостей нових драйверів пристроїв без будь-яких змін у клієнтській частині .
Чи існують плани підтримки більшої кількості пристроїв?
Так. Автори планують розширити підтримку основних типів ПЗЗ фотокамер, засобів фокусування і телескопів. Якщо вам потрібна підтримка у INDI якогось окремого пристрою, будь ласка, надішліть про це листа за адресою електронної пошти indi-devel@lists.sourceforge.net
Які дії з керування телескопом може виконувати ?
Все залежить від марки вашого телескопа, але ви можете використовувати принаймні три команди: Slew, Track і Sync, які можна віддавати напряму з зоряної карти. Щоб виконання цих команд призводило до правильних результатів, вам слід спочатку вирівняти ваш телескоп. Для деяких телескопів список можливих дій значно ширший: керування розташуванням, режими зміни спрямування, фокусування, паркування тощо. Доступ до додаткових можливостей телескопа можна отримати з Панелі керування INDI, яка відкривається з меню Інструменти Пристрої.
У чому точно полягає різниця між командами Slew, Track і Sync?
Команда Slew наказує телескопу спрямуватися у певну точку, після того, як телескоп буде спрямовано у цю точку, його механізм продовжить слідкування за цією точкою з сидеричною швидкістю (тобто зі швидкістю, з якою рухаються небом зірки). Таке стеження добре спрацьовує для зірок, об’єктів каталогу Месьє, і майже всіх об’єктів поза нашою сонячною системою. Але рух небом об’єктів сонячної системи відрізняється від руху віддалених об’єктів, отже телескопові потрібна інша команда, щоб стежити за рухом об’єктів сонячної системи.
Для таких випадків призначено команду «track», вона наказує телескопові стежити за об’єктом з несидеричним рухом. Команду ж Sync призначено для синхронізації внутрішніх координат телескопа з координатами об’єкта, який ви обрали.
Чи можу я віддалено керувати моїм телескопом?
Так. Ви можете запустити сервер INDI на комп’ютері з’єднаному з вашим телескопом, цей сервер очікуватиме на запити від клієнтів . Після з’єднання з сервером ви зможете віддавати телескопові команди напряму з карти неба. Весь процес детально описано у розділі Віддалене керування пристроями.
Під час спроб З’єднатися, повідомляє, що телескоп не з’єднано з послідовним або USB-портом. Що робити?
Таке повідомлення з’являється, якщо не може зв’язатися з телескопом. Ось декілька дій, які можуть вам допомогти у визначенні причин помилки:
Перевірте, чи є у вас дозволи на читання і запис до порту, з яким ви намагаєтеся з’єднатися.
Перевірте з’єднувальний кабель, переконайтеся, що його не пошкоджено, і перевірте його за допомогою інших програм.
Перевірте живлення вашого телескопа, переконайтеся, що його увімкнено і що телескоп отримує достатньо енергії.
Виберіть пункт меню Інструменти Пристрої Панель керування INDI... і вкажіть належний порт у вікні Панель керування INDI. Типовим пристроєм є /dev/ttyS0
Перезапустіть і спробуйте ще раз.
повідомляє про те, що телескоп з’єднано і він готовий до виконання команд, але я не можу знайти візиру телескопа, де він?
отримує координати RA і DEC від телескопа за допомогою з’єднання. Якщо вирівнювання телескопа було виконано правильно, ви повинні побачити рамку поля зору навколо вашої цілі на карті неба. Але надані телескопом значення RA і DEC можуть бути і неправильними (навіть знаходитися під лінією горизонту), в такому разі вам потрібно буде відати команду Sync для спрямування телескопа на вашу поточну ціль. Щоб спрямувати телескоп у центр зображення і змусити його стежити за цією точкою, ви можете скористатися контекстним меню карти неба.
Рухи телескопа є помилковими, або він взагалі не рухається. Що робити?
Таку поведінку, зазвичай, спричинено некоректними параметрами, будь ласка, перевірте:
Чи було виконано вирівнювання телескопа.
Чи правильно вибрано режим вирівнювання. Скористайтеся Центром керування INDI, щоб перевірити і змінити параметри (Alt/Az,Polar, Land).
Чи правильно встановлено час і дату на телескопі.
Чи правильно встановлено довготу і широту на телескопі.
Чи правильно встановлено часовий пояс телескопа.
Чи міцно закріплено осі RA і DEC телескопа.
Чи правильно встановлено перемикач N/S (якщо такий є) на вашому телескопі, тобто чи відповідає він земній півкулі, у якій ви знаходитеся?
Чи не пошкоджено кабель, що з’єднує телескоп з комп’ютером.
Якщо ви переконані, що всі параметри було встановлено правильно, але телескоп все ж рухається неправильно, або взагалі не рухається, будь ласка, надішліть звіт про цю несправність за адресою електронної пошти indi-devel@lists.sourceforge.net.