CSO Telescope Control System Network Interface for eSMA

Hiroshige Yoshida
Caltech Submillimeter Observatory

1  Introduction

This document briefly describes the Caltech Submillimeter Observatory (CSO) Telescope Control System (TCS) Network Interface for the extended Submillimeter Array (eSMA).
Commands have initially been implemented according to the following specification documents: then updated to implement new commands specified in: Instead of duplicating details already given in the above documents, only the differences between the specifications and the CSO implementations will be discussed in the following sections.

2  General Descriptions

2.1  Network Interface Specification

The CSO TCS Network Interface server will be started by opening a TCP connection to host 128.171.xxx.xxx of port xxxxx. Communications between the server and clients are line-oriented. As specified in the "Description of the JAC Telescope Control System serial line interface," each line is delimited by a carriage return code (ASCII 0x0d).

2.2  Status Value

The CSO TCS Network Interface commands always return one of the following status values as the first item in a response line. The values 0-3 have been adopted from JAC's existing serial line interface code. The values 4-6 are CSO-extensions. Some of newly added commands, specified in PTCS TCS/UN/004, November 15, 2005, have a conflicting status value convention (1 for success and 0 for otherwise). This issue must be resolved in a future update.

2.3  Coordinate System

Unless noted otherwise, the following coordinate systems are supported: MOUNT, OBS, AZEL, HADEC, APP, GAL, Bnnnn, J nnnn, ICRF, ICRS and PLANET. ICRF and ICRS are equivalent to J2000. In some cases, MOUNT, OBS and AZEL coordinates are treated as if they are interchangable.

2.4  Guide Telescope

A guide telescope is not yet operational.

3  Command Descriptions

3.1  AOFFSET

3.2  GET_AIRMASS

3.3  GET_DEMAND

3.4  GET_GUIDING

3.5  GET_IMAGE_SCALE

3.6  GET_OBSERVATORY

3.7  GET_OFFSETS

3.8  GET_STATE

3.9  GET_TEL_BASE

3.10  GET_TIME

3.11  NOD

3.12  OFFSET

3.13  SET_BASE_HERE

3.14  SET_GUIDING

3.15  SET_TARGET

3.16  SET_SLEW

3.17  TOFFSET

3.18  XOFFSET

3.19  CHECK_SDFOCUS

3.20  CHECK_SDPOINT

3.21  GET_LOAD

3.22  GET_RECEIVER_STATUS

3.23  SD_FOCUS

3.24  SD_POINTING

3.25  SET_LOAD

3.26  SET_POLARIZER

3.27  SET_RECEIVER

3.28  GET_ONSOURCE

A  Revision History




File translated from TEX by TTH, version 4.03.
On 25 May 2012, 09:34.