Telescope Control plug-in

From Stellarium Wiki
(Difference between revisions)
Jump to: navigation, search
(more text - models and virtual telescope)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''UNDER CONSTRUCTION'''
+
<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.
 +
 +
<span style="color: red; font-weight: bolder">WARNING: Stellarium CANNOT prevent your telescope from being pointed at the Sun.</span>
 +
* 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 ==
=== Prerequisites ===
+
 
 +
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.
 +
 
 +
Telescope set-up (setting geographical coordinates, performing alignment, etc.) should be done before connecting the telescope to Stellarium.
 +
 
 +
To activate the Telescope Control plug-in:
 +
* open the Configuration window (press F2);
 +
* go to the Plugin tab;
 +
* select "Telescope Control" from the list;
 +
* check the "Load at startup" option;
 +
* exist Stellarium.
 +
The plug-in should be active the next time you start Stellarium.
 +
 
 
=== Main window ===
 
=== Main window ===
 +
The plug-in's main window can be displayed by pressing Alt+0 or the "Telescopes window" button on the bottom toolbar.
 +
 
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.
 +
 +
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.
  
 
=== Telescope connection configuration window ===
 
=== Telescope connection configuration window ===
Line 17: Line 57:
  
 
==== Connection type ====
 
==== Connection type ====
 +
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
 
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 ====
 
==== Telescope properties ====
 
http://img89.imageshack.us/img89/7180/telescopecontrolproptel.png
 
http://img89.imageshack.us/img89/7180/telescopecontrolproptel.png
 
;Name
 
;Name
 +
:The name of the telescope that will be displayed on the screen next to the telescope reticle.
 
;Connection delay
 
;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
 
;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 ====
 
==== Device settings ====
 +
This section is active only for DIRECT connections (see [[#Connection type]]).
 +
 
http://img89.imageshack.us/img89/9915/telescopecontrolpropdev.png
 
http://img89.imageshack.us/img89/9915/telescopecontrolpropdev.png
 
;Serial port
 
;Serial port
 
:sets the serial port used by the telescope.
 
: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.)
+
: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:
 
:To list all valid serial port names in Mac OS X, open a terminal and type:
 
:<pre>ls /dev/*</pre>
 
:<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").
 
: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
 
;Device model
:
+
:see [[#Supported devices]] below.
  
 
==== Connection settings ====
 
==== Connection settings ====
 
http://img697.imageshack.us/img697/1374/telescopecontrolpropcon.png
 
http://img697.imageshack.us/img697/1374/telescopecontrolpropcon.png
;Host
+
;Port
+
Both fields here refer to communication over a network ({{wikipedia-en|TCP/IP}}). Doing something with them is necessary only for INDIRECT connections.
  
'''User interface settings:'''
+
'''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".
* see the [[#Field of view circles|FOV circles]] section below
+
 
 +
'''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 59: 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 ==
Line 83: Line 146:
 
: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]
 
: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]
  
== Stellarium Virtual Telescope ==
+
Not included in the device list (for now):
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.
+
;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.
  
This feature is a (descendant?) of the "Dummy" type of telescope in [[Telescope Control (client-server)|the old way of doing things]].
+
== 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
  
== External links ==
+
[[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.
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.

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

Contents

[edit] 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.

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.

[edit] 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;
  • INDIRECT CONNECTION:
    • 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.

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.

Telescope set-up (setting geographical coordinates, performing alignment, etc.) should be done before connecting the telescope to Stellarium.

To activate the Telescope Control plug-in:

  • open the Configuration window (press F2);
  • go to the Plugin tab;
  • select "Telescope Control" from the list;
  • check the "Load at startup" option;
  • exist Stellarium.

The plug-in should be active the next time you start Stellarium.

[edit] Main window

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

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

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.

[edit] Telescope connection configuration window

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

[edit] Connection type

The topmost field represents the choice between the two types of connections, DIRECT and INDIRECT respectively (see above):

telescopecontrolconnect.png

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

[edit] Telescope properties

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.

[edit] Device settings

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

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:
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/:
Device model
see #Supported devices below.

[edit] Connection settings

telescopecontrolpropcon.png

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.

[edit] 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.

telescopecontrolcircles.png

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

[edit] 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.

[edit] 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 the old way of doing things.

[edit] Advanced use

[edit] 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]

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.

[edit] External links

Personal tools
Namespaces
Variants
Actions
in this wiki
other languages
Toolbox