Telescope Control plug-in

From Stellarium Wiki
Revision as of 19:34, 17 March 2010 by Daggerstab (Talk | contribs)
Jump to: navigation, search


The Telescope Control plug-in allows Stellarium to control a telescope on a computerized mount (a "Go To" telescope) and offers a graphical user interface for setting up the connection.

It has been included as a static plug-in in Stellarium since version 0.10.3.

This page covers version 0.1.9, the one distributed with Stellarium 0.10.3 and 0.10.4.


Using the Telescope Control plug-in

There are two general ways to control a device with this plug-in, depending on the situation:

  • DIRECT CONNECTION: A device supported by the plug-in is connected with a cable to the computer running Stellarium;
    • a device is connected to the same computer but it is driven by a stand-alone telescope server program or a third-party application that can "talk" to Stellarium;
    • a device is connected to a remote computer and the software that drives it can "talk" to Stellarium over the network; this software can be either one of Stellarium's stand-alone telescope servers, or a third party application.


Main window


Telescope connection configuration window

The telescope connection configuration window (full image)...

Connection type


Telescope properties


The name of the telescope that will be displayed on the screen next to the telescope reticle.
Connection delay
If the movement of the telescope reticle on the screen is uneven, you can try increasing or decreasing this value.
Start/connect at startup
Check this option if you want Stellarium to attempt to connect to the telescope immediately after it starts. Otherwise, to start the telescope, you need to open the main window, select that telescope and press the "Start/Connect" button.

Device settings


Serial port
sets the serial port used by the telescope.
The list contains the default values for the first four serial ports. On Windows, these are COM1 to COM4, on Linux these are /dev/ttyS0 to /dev/ttyS3, on Mac OS X the list is empty as it names its ports in a peculiar way. On all three platforms the list can be edited and new values can be added. (If you are using a USB-to-serial adapter, the default serial port of your telescope most probably is not in the list.)
To list all valid serial port names in Mac OS X, open a terminal and type:
ls /dev/*
This will list all devices, the full name of your serial port should be somewhere in the list (for example, "/dev/cu.usbserial-FTDFZVMK").
Device model
see #Supported devices below.

Connection settings


Both fields here refer to communication over a network (TCP/IP). Doing something with them is necessary only for INDIRECT connections.

Host can be either a host name or an IPv4 address such as "". The default value of "localhost" means "this computer".

Port refers to the TCP/IP port used for communication. The default value depends on the telescope number and ranges between 10001 and 10009.

Both values are ignored for DIRECT connections. (Unless a certain option is checked, but this is Advanced Use.)

Field of view circles

A series of circles representing different fields of view can be added around the telescope marker. This is a relic from the times before the Oculars plug-in existed.


In the telescope configuration window, click on "User Interface Settings". Mark the "Show FOV circles" options, then enter a list of values separated with comas in the field below. The values are interpreted as degrees of arc.

This can be used in combination with the #Stellarium Virtual Telescope to display a moving marker with the Telrad circles. In this case, the list of FOV values should be "0.5, 2, 4".

Sending commands

Once a telescope is successfully started/connected, Stellarium displays a telescope reticle labelled with the telescope's name on its current position in the sky. The reticle is an object like every other in Stellarium - it can be selected with the mouse, it can be tracked and it appears as an object in the Search window.

To send a "slew" command to the telescope, select an object (e.g. a star) and press the number of the telescope while holding down the Ctrl key. (For example, Ctrl+1 for telescope #1.)

As of version 0.1.9/Stellarium 0.10.4, there is no way to slew to a specific set of coordinates.

Stellarium Virtual Telescope

If you want to test this plug-in without an actual device connected to the computer, choose "Stellarium Virtual Telescope" from the "Device model" list. It will show a telescope reticle that will react in the same way as the reticle of a real telescope controlled by the plug-in. In this case, the value of "Serial port" is ignored.

This feature is a (descendant?) of the "Dummy" type of telescope in the old way of doing things.

Advanced use

Supported devices

Main page: Telescope Compatibility

All devices (except one) listed in the "Device model" list are convenience definitions using one of the two built-in interfaces: the Meade LX200 (the Meade Autostar controller) interface and the Celestron NexStar interface.

The device list contains the following:

Celestron NexStar (compatible)
Any device using the NexStar interface.
Losmandy G-11
A computerized telescope mount made by Losmandy. (Meade LX-200/Autostar interface)
Meade Autostar Compatible
Any device using the LX-200/Autostar interface.
Meade ETX-70 (#494 Autostar, #506 CCS)
The Meade ETX-70 telescope with the #494 Autostar controller and the #506 Connector Cable Set. According to the tester, it is a bit slow, so its default setting of "Connection delay" is 1.5 seconds instead of 0.5 seconds.
Meade LX200 (compatible)
Any device using the LX-200/Autostar interface.
Stellarium Virtual Telescope
A fake telescope. :)
Wildcard Innovations Argo Navis (Meade mode)
Argo Navis is a "Digital Telescope Computer" by Wildcard Innovations. It is an advanced digital setting circle that turns an ordinary telescope (for example, a dobsonian) into a "Push To" telescope (a telescope that uses a computer to find targets and human power to move the telescope itself). Just don't forget to set it to Meade compatibility mode and set the baud rate to 9600B. [1]

External links

Personal tools
in this wiki
other languages