Differences

This shows you the differences between two versions of the page.

--- tcs:legacy_tcs_socket_communction [2014/02/12 12:00]
scott
+++ tcs:legacy_tcs_socket_communction [2017/02/10 17:14] (current)
scott
@@ Line 1: / Line 1: @@
-=====Overview=====
+=====Legacy TCS Network Communication=====
-Legacy TCS only allows remote telescope communication and control through a serial port on the main TCS computer. In order to allow network communication and control of the telescope we have built software called Telcom to convert tcp/ip sockets to serial communication. To make sure this software is up and running on the BOK telescope you can check the website http://bokpop.as.arizona.edu and look for the table marked telemetry. This webpage queries the telcom server about once a second.
+===Overview===
+Legacy TCS only allows remote telescope communication and control through a serial port on the main TCS computer. In order to allow network communication and control of the telescope we have built software called Telcom to convert tcp/ip sockets to serial communication. To make sure this software is up and running on the BOK telescope you can check the website http://bok.as.arizona.edu:42080 and look for the table marked telemetry. This webpage queries the telcom server about once a second.
+=== ===
+You can find a list of legacy TCS commands [[tcs:list_of_network_commands| here]] .
 ===== Request syntax =====
+==== ====
 The Telcom server makes 14 pieces of information available.
@@ Line 12: / Line 18: @@
 | Hour Angle | HA | [+/-hh:mm:ss.ss] |
 | Secant z (Air Mass) | SECZ | [s.ss] |
-| Error state |ERROR| [E] ( a number or letter representing serial error state ) |
 | Epoch | EQ | D[YYYY.YYY] |
 | Julian Date | JD | [DDDDDDD.D] |
@@ Line 38: / Line 43: @@
 ==== "ALL" keyword ====
-If you want to get multiple pieces of data from the telcom server rapidly you can use the ALL keyword. This will return a string containing all the telemetry data described above which will have to be parsed. The string gives values seperated by 1 or more white spaces. The structure of the string is given in the table below.
+If you want to get multiple pieces of data from the telcom server rapidly you can use the ALL keyword. This will return a string containing all the telemetry data described above which will have to be parsed. The string gives values seperated by 1 or more white spaces. The table below shows the order the values are placed in the string.
 ^Return Values | MOT | RA | DEC | HA | ST | EL | AZ | SECZ |  EQ | JD | WOBBLE | DOME | UT | IIS |
 ^Example Value |0 | 221941.92 | +314308.8 | -00:00:00 | 22:20:19 |  90.0 |   +7.6 |  1.00 |  D2000.000 | 2456698.3 | 1 |-78.6 | 20:27:19.1 | 0.0 |
+An example string:
+^ BOK TCS 123 0  2231:27.64 +314312.0  +00:00:01 22:32:22  90.0  -29.2  1.00              2000.000 2456702.3 1        -115.4 20:23:36.5        0.0 ^
 It should be noted that all strings returned on the Telcom socket will end with a carriage return (\r).
@@ Line 48: / Line 56: @@
 ===== Command Syntax =====
+==== ====
 The syntax for sending commands to the Telcom server is very similar to sending requests. The syntax looks like:
@@ Line 65: / Line 74: @@
 ^BOK TCS 123 OK^
-The <ERROR_STATE> value will be either "OK" or "BAD". "OK" means the command was understood and "BAD" means the command was NOT understood (not found in the list of commands). "OK" does NOT mean the command was executed. For example, if the Right Ascension is off and you send the command:
+The <ERROR_STATE> value will be either "OK" or "BAD". "OK" means the command was understood and "BAD" means the command was NOT understood (not found in the list of commands). "OK" does NOT mean the command was executed. For example, if the Right Ascension drive is turned off or disable and you send the command:
 ^BOK TCS 123 TRACKON^ (command for turning tracking on)
@@ Line 75: / Line 84: @@
 But the telescope will not start tracking because it can't when the drives are off.
-***For brevity sake the complete list of TCS command will not be written here. Instead they can be found [[tcs:list of network commands]]
+***For brevity sake the complete list of TCS commands will not be written here. Instead they can be found [[tcs:list of network commands]]
+===== Example Scripts =====
+Below  are some sample scripts to communicate with Telcom server
+==== telem_example.py ====
+This program gets the telemetry from The Telcom server and stores it in a python dictionary object and prints it
+out in a clean format.
+<code>
+#!/usr/bin/python
+"""
+Author: Scott Swindell, Steward Observatory
+A short example script to grab telemetry from the BOK Telcom server
+the Telcom server and store that information in a python
+dictionary object"""
+IPADDR = ""     #Available upon request
+PORT  = ""      #Available upon request
+TELID = "BOK"
+REF_NUM = 123
+REQUEST = "ALL"
+keyList = [
+        "ID"            ,
+        "SYS"           ,
+        "REF_NUM"       ,
+        "MOT"           ,
+        "RA"            ,
+        "DEC"           ,
+        "HA"            ,
+        "ST"            ,
+        "EL"            ,
+        "AZ"            ,
+        "SECZ"          ,
+        "EQ"            ,
+        "JD"            ,
+        "WOBBLE"        ,
+        "DOME"          ,
+        "UT"            ,
+        "IIS"
+                ]
+import socket
+#instantiate the socket class
+telSock = socket.socket( socket.AF_INET, socket.SOCK_STREAM )
+telSock.settimeout( 0.5 )
+#IPADDR = telSock.gethostbyname(HOST)
+telSock.connect( ( IPADDR, PORT ) )#open the socket
+reqString = "%s TCS %i REQUEST %s" %( TELID, REF_NUM, REQUEST )
+telSock.send( reqString ) #send the request
+resp = ""
+test = True
+#Grab 100 bytes at a time
+#from the socket and check for
+#timeouts.
+while test:
+        try:
+                inStuff = telSock.recv( 100 )
+        except socket.timeout:
+                if resp:
+                        print "No Telem Recieved"
+                test = False
+                break
+        if inStuff:
+                resp+=inStuff
+        else:
+                test=False
+#turn string into list, seperate by whitespace
+resp = resp.split(' ')
+cleanResp = []
+#remove all empty elements and new line
+#and put everything else in cleanResp
+for char in resp:
+        if char != '' and not char.endswith("\n"):
+                cleanResp.append( char )
+#gather the telemetry into a dictionary
+#for easy referencing
+telemDict = {}
+II = 0
+for key in keyList:
+        telemDict[key] = cleanResp[II]
+        II+=1
+#print them all out in
+#a nice clean way
+for (key, value) in telemDict.iteritems():
+        print "|%s\t|\t%s|" %( key.ljust( 10 ), value.ljust( 12 ) )
+</code>

MOON

User Tools

Site Tools

Differences

Page Tools