Working With TheSky™

Since TheSky by itself is not compatible with the ASCOM environment, we've provided some adapter components to make it fit in. There are two different ways that TheSky can fit into the ASCOM environment:

  1. TheSky can look like an ASCOM compatible telescope. This is mainly useful when the telescope is a Paramount, which requires TheSky as part of its control system.
  2. TheSky can bypass its internal telescope control logic and instead use an ASCOM driver. This is useful when controlling a telescope that is not supported internally within TheSky, but has an ASCOM driver.

1. TheSky Using its Internal Telescope Logic (e.g. Paramount)

In this case, ASCOM astronomy software selects TheSky Controlled Telescope as its telescope type. This makes TheSky, TPOINT, ProTrack, and its internal telescope control logic look like any other ASCOM telescope driver. See the text below the diagram for details.

Diagram

This requires TheSky 6 Professional (TheSky 5 Level IV is supported for backward compatibility). When using one of the many programs that control telescopes via ASCOM drivers, you need to have the TheSky-Telescope driver and select "TheSky Controlled Telescope" as the telescope type. Of course, within TheSky itself, select your real telescope type (e.g. Paramount). This configuration (using TheSky as a telescope controller) is not limited to the Paramount; it can be used with any telescope type that can be controlled from TheSky's internal telescope logic.

If you receive a "permission denied" message when trying to connect, you need to enable TheSky's external control features:

  1. Start TheSky.
  2. In TheSky's Telescope menu, select Server Settings...
  3. In the Server Settings window, Remote client capabilities section, turn on all of the options ("allow" checkboxes).
  4. Also turn on Remote clients use Orchestrate's "ImageThenSlewTo" command.
  5. Click OK to close the Server Settings window.
  6. Now try connecting from your ASCOM astronomy program again. It should work.

You need to do steps 2-5 only one time.

2. TheSky Controlling a Telescope With an ASCOM Driver

In this case, TheSky plays the role of an ASCOM astronomy program that uses ASCOM drivers like any other. See the text below the diagram for details.

Diagram

In order to use ASCOM drivers for telescope control from within TheSky, you need to install the ASCOM "TeleAPI" plug-in. Download, unzip and read 'install.txt'. This gives instructions on how to install the adapter. After you have done this:

  1. Start TheSky
  2. In the Telescope menu, select Setup... TheSky's Telescope Setup window will appear.
  3. Set the Telescope or control system name to Telescope API.
  4. Click Settings... to display the ASCOM Telescope Chooser
  5. Select your telescope type in the Chooser.
  6. Now click Properties... in the Chooser. Verify the settings for your telescope type.
  7. Click OK in the Chooser.
  8. Click Close in Telescope Setup.
  9. Now, in TheSky's Telescope menu, select Link/Establish. You should see the crosshairs indicating your telescope's current position, and you now have telescope control in TheSky.

You need to do steps 2-9 only one time (unless you change your telescope type)