MOON

This is an old revision of the document!

---

# telescope-server Server that handles the dirty work of converting various CBW, NG, and ITHX devices into a simple to use NG protocol end. When users need the latest data from a device use this.

## NG Depending on the telescope site, the obsserver ID is: ``` BOK VATT BIG ```

The system ID will always be: ``` SERVER ```

An example of an NG request at the Bok is: ```bash dan@lump: ~ $ echo “BOK SERVER 123 REQUEST LEGACYTCS” | nc 10.30.1.5 5750 BOK SERVER 123 0 07:44:48.20 +31:50:44.7 +00:00:02 07:46:11 90.0 -56.3 1.00 D2000.000 2459234.8 1 -142.5 07:13:02.4 ``` ### NG Commands @ Bok ``` ```

### NG Requests @ Bok ``` CBWWIND Wind information from SuperLOTIS

                  Args: N/A
                  Notes: Will return empty values as '--'
                  Units: Speed = mph Dir = degrees
                  Returns: [SPD DIR GUS GDIR] or FAILED
                      SPD (wind speed) = XX.xx
                      DIR (wind direction) = XXX.xx
                      GUS (gust speed) = XX.xx
                      GDIR (gust direction) = XXX.xx
                 

CBWINOUT CBW Temperature sensors in and outside the dome

                  Args: N/A
                  Notes: Will return empty values as '--'
                  Units: Temp = f Humdity = %
                  Returns: [OT] [OH] [IT] [IH] [CT] or FAILED
                      OT (outside temp) = XX.xx
                      OH (outside humidity) = XX.xx
                      IT (inside temp) = XX.xx
                      IH (inside humidity) = XX.xx
                      CT (control room temp) = XX.xx

ITHXMIRRORCELL Mirror cell ITHX sensors

                  Args: N/A
                  Notes: Will return empty values as '--'
                  Units: Temp, Dew Point = f Humdity = %
                  Returns: [MT] [MH] MDP] or FAILED
                      MT (mirror temp) = XX.xx
                      MH (mirror hum) = XX.xx
                      MDP (mirror dew) = XX.xx

ITHXUPPERDOME Upperdome ITHX sensors

                  Args: N/A
                  Notes: Will return empty values as '--'
                  Units: Temp, Dew Point = f Humdity = %
                  Returns: [UT] [UH] [UDP] or FAILED
                      UT (upperdome temp) = XX.xx
                      UH (upperdome hum) = XX.xx
                      UDP (upperdome dew point) = XX.xx

CBWTUBE Tube cbw

                  Args: N/A
                  Notes: Will return empty values as '--'
                  Units: Temp = f Humdity = %
                  Returns: [NST] [MT] [90P] or FAILED
                      NST (north strut temp) = XX.xx
                      MT (mirror temp) = XX.xx
                      90P (90Prime temp) = XX.xx

LEGACYTCS Telemetry information

                  Args: N/A
                  Notes: 
                  Units: 
                  Returns: [MOT] [RA] [DEC] [HA] [LST] [ALT] [AZ] [SECZ] [E] [JD] [DI] [DAZ] [UT] or FAILED
                      MOT (motion) = X
	                    RA (right ascension) = HH:MM:SS.ss
	                    DEC (declination) = +DD:MM:SS.s
	                    HA (hour angle) =  +HH:MM:SS
                      LST (local sidereal time) = HH:MM:SS
                      ALT (altitude) = XX.x
                      AZ (azimuth) = XXX.x
                      SECZ (airmass) = X.xx
                      E (epoch) = EEEE.e
                      JD (julian date) = JJJJJJJJ.j
                      DI (dome init) = X
                      DAZ (dome azimuth) = XXX.x
	                    UT (universal time) = HH:MM:SS
	                    

IIS IIS reading

                  Args: N/A
                  Notes: 
                  Units: iis = degrees
                  Returns: [IIS] or FAILED
                      IIS (iis) = XXX.xx
                  

RAOIL RA oil reading

                  Args: N/A
                  Notes: 
                  Units: raoil = psi
                  Returns: [OIL] or FAILED
                      OIL (RA oil) = XX.xx
	

DOMESHUTTER Dome shutter state

                  Args: N/A
                  Notes: 
                  Units: 
                  Returns: [DSS] or FAILED
                      DSS (dome shutter state) = OPENED, CLOSED, UNKNOWN

```