<div style="margin-bottom:25px; background-color:silver; padding:7px; border:solid 1px #847f93;">'''Warning:''' The information on this page is '''not''' up-to-date. The version of the Telescope Control plug-in released with Stellarium 0.10.5 is newer and has a slightly different interface. This page will be updated later.</div>

−

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.

+

:''See [[Telescope Control]] for general information about telescope control in Stellarium.''

+

----

+

The Telescope Control plug-in allows Stellarium to control a telescope on a computerized mount (a "Go To" or "Push 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.

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.

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

+

+

== Abilities and limitations ==

+

This plug-in allows Stellarium to send only "'''slew'''" ("go to") commands to the device and to receive its current position. It cannot issue any other commands, so users should be aware of the possibility for mount collisions and similar situations. (To abort a slew, you can start another one to an object in a safe position.)

+

+

As of the current version, this plug-in doesn't allow satellite tracking, and is not very suitable for Moon or planetary observations.

* Never point your telescope at the Sun without a proper solar filter installed. The powerful light amplified by the telescope WILL cause irreversible damage to your eyes and/or your equipment.

+

* Even if you don't do it deliberately, a slew during daylight hours may cause your telescope to point at the sun on its way to the given destination, so it is strongly recommended to avoid using the telescope control feature before sunset without appropriate protection.

== Using the Telescope Control plug-in ==

== Using the Telescope Control plug-in ==

−

=== Configuration ===

+

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

+

* '''DIRECT CONNECTION''': A [[#Supported devices|device supported by the plug-in]] is connected with a cable to the computer running Stellarium;

+

* '''INDIRECT CONNECTION''':

+

** a device is connected to the same computer but it is driven by a [[Telescope Control (client-server)|stand-alone telescope server program]] or a [[Telescope Control#Third party applications|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.

+

+

Most older telescopes use cables that connect to a {{wikipedia-en|serial port}} (RS-232), the newer ones use {{wikipedia-en|Universal Serial Bus|USB}} (Universal Serial Bus). On Linux and Max OS X both cases are handled identically by the plug-in. On Windows, a USB connection may require a "virtual serial port" software, if it is not supplied with the cable or the telescope. Such a software creates a virtual ("fake") COM port that corresponds to the real USB port so it can be used by the plug-in.

The plug-in's main window can be displayed by pressing Alt+0 or the "Telescopes window" button on the bottom toolbar.

−

==== Main window ====

http://img201.imageshack.us/img201/6854/telescopecontroltabtele.png

http://img201.imageshack.us/img201/6854/telescopecontroltabtele.png

+

The '''Telescopes''' tab displays a list of the telescope connections that have been set up:

+

* the number ('''#''') column shows the number used to control this telescope. For example, for telescope #2, the shortcut is Ctrl+2.

+

* the '''Status''' column indicates if this connection is currently active or not. Unfortunately, there are some cases in which "Connected" is displayed when no working connection exists.

+

* the '''Type''' field indicates what kind of connection is this:

+

** '''local, Stellarium''' means a DIRECT connection to the telescope (see [[# Using the Telescope Control plug-in|above]]);

+

** '''local, external''' means an INDIRECT connection to a program running on the same computer;

+

** '''remote, unknown''' means an INDIRECT connection over a network to a remote machine.

−

==== Serial cable connection ====

+

To set up a new telescope connection, press the '''Add''' button. To modify the configuration of an existing connection, select it in the list and press the '''Configure''' button. In both cases, a telescope connection configuration window will open.

The topmost field represents the choice between the two types of connections, DIRECT and INDIRECT respectively (see [[# Using the Telescope Control plug-in|above]]):

+

+

http://img697.imageshack.us/img697/9157/telescopecontrolconnect.png

+

+

The type of connection determines what information should be entered in the other fields, so it is at the top.

+

+

==== Telescope properties ====

+

http://img89.imageshack.us/img89/7180/telescopecontrolproptel.png

+

;Name

+

: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 ====

+

This section is active only for DIRECT connections (see [[#Connection type]]).

+

+

http://img89.imageshack.us/img89/9915/telescopecontrolpropdev.png

+

;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 cable, 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:

+

:<pre>ls /dev/*</pre>

+

:This will list all devices, the full name of your serial port should be somewhere in the list (for example, "/dev/cu.usbserial-FTDFZVMK").

+

:On Mac OS X 10.6. / 64bit it might be that the original drivers from Prolific do not actually connect to the NexStar-based hand controller even though it shows "connected" in the telescope control. A remedy is to download a driver (for the Prolific 2303-based adapters) which is 64bit compatible. One solution could be the driver from this homepage: http://sourceforge.net/projects/osx-pl2303/:

+

+

;Device model

+

:see [[#Supported devices]] below.

+

+

==== Connection settings ====

+

http://img697.imageshack.us/img697/1374/telescopecontrolpropcon.png

+

+

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

+

+

'''Host''' can be either a host name or an {{wikipedia-en|IPv4}} address such as "127.0.0.1". The default value of "localhost" means "this computer".

+

+

'''Port''' refers to the TCP 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]].)

+

+

For INDIRECT connections, modifying the default host name value makes sense only if you are attempting a remote connection over a network. In this case, it should be the name or IP address of the computer that runs a program that runs the telescope.

==== Field of view circles ====

==== Field of view circles ====

Line 28:

Line 107:

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.

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

+

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 ===

=== Sending commands ===

Line 36:

Line 115:

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

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.

+

+

See the section above about [[#Field of view circles]] for a possible practical application.

+

+

This feature is a (descendant?) of the "Dummy" type of telescope in [[Telescope Control (client-server)|the old way of doing things]].

== Advanced use ==

== Advanced use ==

+

+

== Supported devices ==

+

:''Main page: [[Telescope Compatibility]]''

+

+

All devices (except [[#Stellarium Virtual Telescope|one]]) listed in the [[#Device settings|"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 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 [[#Telescope properties|"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|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. [http://www.iceinspace.com.au/forum/showpost.php?p=554948&postcount=18]

+

+

Not included in the device list (for now):

+

;Sky-Watcher SynScan AZ mount

+

:The Sky-Watcher SynScan AZ GoTo mount is used in a number of telescopes. [http://www.opticalvision.co.uk/astronomical_telescopes/sky-watcher/sysncan_az_go-to_computerised_telescopes] '''SynScan''' is also the name of the hand controller used in other Sky-Watcher GoTo mounts, and it seems that any mount that uses a SynScan controller version 3.0 or greater is supported by the plug-in, as it uses the NexStar protocol. To use any of these mounts with the plug-in, choose '''Celestron NexStar (compatible)''' from the device list.

== External links ==

== External links ==

+

* [http://www.youtube.com/watch?v=bxOP-thX2ts Controlling the Meade ETX-LS 6 with Stellarium], a YouTube video by John Kramer

+

* [http://www.iceinspace.com.au/63-581-0-0-1-0.html Ice in Space &raquo; Stellarium Telescope Control with a HEQ5/EQ6], an article by Karl van Louwersen on how to use this plug-in with StellariumScope and EQMOD

+

+

[[Category: Telescope Control]]

+

[[Category: Plugins]]

Latest revision as of 15:20, 24 April 2012

Warning: The information on this page is not up-to-date. The version of the Telescope Control plug-in released with Stellarium 0.10.5 is newer and has a slightly different interface. This page will be updated later.

This plug-in allows Stellarium to send only "slew" ("go to") commands to the device and to receive its current position. It cannot issue any other commands, so users should be aware of the possibility for mount collisions and similar situations. (To abort a slew, you can start another one to an object in a safe position.)

As of the current version, this plug-in doesn't allow satellite tracking, and is not very suitable for Moon or planetary observations.

WARNING: Stellarium CANNOT prevent your telescope from being pointed at the Sun.

Never point your telescope at the Sun without a proper solar filter installed. The powerful light amplified by the telescope WILL cause irreversible damage to your eyes and/or your equipment.

Even if you don't do it deliberately, a slew during daylight hours may cause your telescope to point at the sun on its way to the given destination, so it is strongly recommended to avoid using the telescope control feature before sunset without appropriate protection.

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.

Most older telescopes use cables that connect to a serial port (RS-232), the newer ones use USB (Universal Serial Bus). On Linux and Max OS X both cases are handled identically by the plug-in. On Windows, a USB connection may require a "virtual serial port" software, if it is not supplied with the cable or the telescope. Such a software creates a virtual ("fake") COM port that corresponds to the real USB port so it can be used by the plug-in.

local, external means an INDIRECT connection to a program running on the same computer;

remote, unknown means an INDIRECT connection over a network to a remote machine.

To set up a new telescope connection, press the Add button. To modify the configuration of an existing connection, select it in the list and press the Configure button. In both cases, a telescope connection configuration window will open.

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.

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 cable, 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").

On Mac OS X 10.6. / 64bit it might be that the original drivers from Prolific do not actually connect to the NexStar-based hand controller even though it shows "connected" in the telescope control. A remedy is to download a driver (for the Prolific 2303-based adapters) which is 64bit compatible. One solution could be the driver from this homepage: http://sourceforge.net/projects/osx-pl2303/:

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 "127.0.0.1". The default value of "localhost" means "this computer".

Port refers to the TCP 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.)

For INDIRECT connections, modifying the default host name value makes sense only if you are attempting a remote connection over a network. In this case, it should be the name or IP address of the computer that runs a program that runs the telescope.

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

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.

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.

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.

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]

Not included in the device list (for now):

Sky-Watcher SynScan AZ mount

The Sky-Watcher SynScan AZ GoTo mount is used in a number of telescopes. [2]SynScan is also the name of the hand controller used in other Sky-Watcher GoTo mounts, and it seems that any mount that uses a SynScan controller version 3.0 or greater is supported by the plug-in, as it uses the NexStar protocol. To use any of these mounts with the plug-in, choose Celestron NexStar (compatible) from the device list.