INDIOpen Astronomy InstrumentationGet INDI

Building INDI tutorials

Build the example drivers and clients that ship with INDI.

JJasem MutlaqJuly 20182 min readEdit on GitHub

INDI Library currently ships with seven tutorials in the examples subdirectory. To build the tutorials, first install some pre-requisties on Ubuntu:

sudo apt-get install cdbs cmake git libcfitsio-dev libnova-dev libusb-1.0-0-dev libjpeg-dev libusb-dev libftdi-dev fxload libkrb5-dev libcurl4-gnutls-dev libraw-dev libgphoto2-dev libgsl0-dev dkms libboost-regex-dev libgps-dev libdc1394-22-dev

Then checkout INDI Library code from Github and build it:

mkdir ~/Projects
cd ~/Projects
git clone https://github.com/indilib/indi.git
mkdir -p build/indi
cd build/indi
cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug ~/Projects/indi
sudo make install

To run tutorial one for example, simply run:

indiserver -v examples/tutorial_one/tutorial_one

This will create an INDI server running tutorial one driver on port 7624 (by default) on the local machine. You can connect to the INDI server using any INDI compatible client such as KStars. If you are using KStars, perform the following steps:

  1. Select the Device Manager menu item from the Tools menu

    Device Manager

  2. Select the client tab and add a new host

    Add a new host

  3. Click Connect in the device manager to connect to INDI server running Tutorial One

    Connect to INDI server

  4. Client Connect/Disconnect to test tutorial one simple functionality in INDI Control Panel

    Use Simple Device driver

The INDI Library tutorials cover some of the basic aspects of INDI, namely:

TutorialDriverDescription
OneSimple DeviceThe most simple INDI driver. The tutorial covers what is required to build and run a minimal INDI driver.
TwoSimple TelescopeImplementation of a simple telescope driver using INDI event-driven framework
ThreeSimple CCDImplementation of a simple CCD driver that sends a randomly generated image to the client as FITS.
FourSkeletonDemonstration on how to utilize INDI’s skeleton files to build driver properties externally.
FiveRain and DomeDemonstration of INDI Snooping functionality that enables inter-driver communication.
SixClient ApplicationImplmentation of a simple client application that can connect to the Simple CCD driver and controls its temperature.
SevenAdvanced Telescope SimulatorSample implementation of a telescope driver that utilizes INDI’s Alignment Subsystem Infrastructure
Questions about this tutorial?Ask on the forum. Someone who has done it will answer.
Ask on the forum

Found a mistake? This page is a Markdown file.Edit this page on GitHub