File: /dd/USER/NewNOT/Txt/UserInterface/definition.txt Project: Nordic 2.56 m Optical Telescope, New TCS Subject: Definition for User Interface Created: Ingvar Svardh 2005-02-08 to -14 after preliminary design and meeting and suggestions Last relevant changes: IS 2006-03-16 Minor adjustments. IS 2012-03-19 Previous version in definition.txt.060317 Cleaned up. Some newer additions, some explanations. Updated to actual implementation. This is a description on how the User Interface is built up. GENERAL: Basic solution with user terminal in control room as with the old TCS. Will look like the old one as much as reasonable. The user interface should be possible to run from any work station (PC) in a telnet session. The version permanently running in the control room on a VT100 compatible terminal (VT510) will in addition to the noncritical commands have all critical commands available like power, hatches etc. The user interfaces started from somewhere else will have only the noncritical commands and will need the usual daily updated access code for commands to be accepted. Engineering facilities are not included in the UI, that is for the expert(s) only. The UI (User Interface) on the terminal in the control room will have function keys to the right like the old TCS, the remote ones will have to use commands or special characters to achieve the same. Menus will be used where the functionality of a key is described together with the character associated with it so that remote users do not have to remember all details. Web weather server, Sequencer and instruments uses RPC functions as before but these are phased out gradually by using a socket server for sequencer and sending data from TCS to the Data Base frequently. SCREEN LAYOUT: A compressed display with 36 instead of 24 lines will be used, it is up to the users to decide if this feels good. Otherwise there would only be 7 instead of now 19 listing lines for status, catalogues and logs. Status of the most important things is displayed in the upper part of the screen like the old one with some additions like air mass, object pointed to, field rotation, humidity and filtered windspeed. The middle part of the screen is used for display of telescope status, catalogues and log files, choosen by meny functions. Page Up/Down (or Prev/Next) can be is used to navigate thru the pages. Keeping the PageUp/Down key pressed results in large page steps since there can be up to 10000 pages in the object catalogue. The telescope status pages contains info relevant for observers on the first few pages, then follows all kinds of status of the whole telescope system intended for staff only. Low on the screen we have the warning line, the command line and the status line. The lowest part contains the description of menu buttons (or -characters) functions. Example: Date yyyy-mm-dd Instr STANCAM (Alf-Def) TRACKING UpperHatch Opened UTgp hh:mm:ss Focus 12345 +1234 Augmode121.23 LowerHatch Undef STgp hh:mm:ss Obj abcd5678901234567890 AutoPos Full MirrorCovers Closed RA hh:mm:ss.ss Az 123.1234 GP X 123456 CameraProbe STANCAM DEC -dd:mm:ss.s Alt 12.1234 Y 123456 ADC Z 12.12 Rot +123.123 (999min) TV foc 123 CCDfilt 1 NOT# AirMa 1.12 FRot +123.123 TV fil Closed Name 12345678901234567 --------------------------------------------------------- WindFi 12.1m/s Hum123% 9 List/catalogue line 1 10 2 11 area for status listing and catalogue 3 12 4 13 5 14 6 15 7 16 8 17 9 18 10 19 11 20 12 21 13 22 14 23 15 24 16 25 17 26 18 27 19 --------------(row 28)--------------------------------------------------------- HH:MM:SS warning with time stamp (no date), remains until acknowledged by user Command: (71 chars for warning text) Status: --------------(row 32)--(inverse video on function key designations)----------- 0 1 Sel 2 Enter 3Insert 4Preset 5 Move 6Pres w 7 Sel 8 Get a 9 FK5 next object actual to sel mode ch par ang prev guide * nearest AltFunc+UP/ctrlY AltFunc+DOWN/ctrlB AltFunc+LEFT/ctrlG AltFunc+RIGHT/ctrlH Telescope DEC+ Telescope DEC- Telescope RA- Telescope RA+ CATALOGUE HANDLING: The new TCS handles catalogues like the old one. Some standard catalogues will in addition to the blank/focus fields also be available in TCS. Big catalogues will be possible, up to 50000 objects is allowed. COMMANDS: Commands are typed the same way as with the old tcs, full names like 'Field-Rotation' can be shortened like 'fi-ro'. Commands will as far as possible be the same as in the old TCS. PRESETS: Three levels of automation will be provided, the lowest just goes to the object without getting a guide star, the middle as now goes there, gets a guide star and positions the guide probe and TV filter, while the highest goes there, gets a guide star, sets guide probe and TV filter, puts star box at center and moves the telescope so that the guide star falls inside the star box and then starts guiding. KEYS: The most important difference from the old tcs is that the arrow keys UP/DOWN are used for command recall and LEFT/RIGHT for editing the command line. No mouse is used for the autoguider, boxes are moved by keys (and commands of course). The star box might be placed at center at a preset for convenience. The arrow keys + AltFunction on the VT510 keyboard and a corresponding ctrl-T/V/F/G on the pc keyboard and VT510 keyboard will be used for movement of things like Telescope RA/DEC, guide probe X/Y etc by defining the choice from a menu. See list below for the options. Functions from keys: Key Function Comment ---------- ------------------------- ------------------ 'A'-'Z', Alphanumerical keys 'a'-'z', for commands and '0'-'9', parameters '+', '-', ' ', '.', ':', '_', '/' Backspace Arrow UP Recall commands backwards Arrow DOWN Recall commands forwards Ends with empty line Arrow LEFT Move cursor left in command line Line is scrolled left/right if needed Arrow RIGHT Move cursor right in command line CR Interpret and execute typed command 'Return', 'Enter' (The ones below are for the VT510 terminal only) ............................................................................. PF1 Help on the currently typed command Parameters and ranges if unique command, otherwise partial command list PF2 Show status pages Updates also text 7 (right) 8 (right) 9 (right) Previous page Directory 10 pages backward 4 (right) 5 (right) 6 (right) free Change move mode free 1 (right) 2 (right) 3 (right) Next page Show page 10 pages forward 0 (right) free PF3 CATALOGUE MENU Show catalogue pages 7 (right) 8 (right) 9 (right) Select previous object Get a guide star Insert-Nearest-FK5 position guide probe for it 4 (right) 5 (right) 6 (right) Preset to selected Change move mode Preset to selected object object with parallactic angle 1 (right) 2 (right) 3 (right) Select next object Enter-Object Insert-Actual-Position mean coordinates 0 (right) Next catalogue menu . (right) START/STOP MENU Hatches, MirrorCovers, Building 7 (right) 8 (right) 9 (right) Open/Stop Upper Hatch Open/Stop Lower Hatch Open/Stop Mirror Covers 4 (right) 5 (right) 6 (right) Building Park Change move mode Building Hoist 1 (right) 2 (right) 3 (right) Close/Stop Upper Hatch Close/Stop Lower Hatch Close/Stop Mirror Covers 0 (right) free PF4 Stop telescope - (right) Clear command line 5 (right) Change move choice To choose function of AltFunction + arrow Up arrow Left arrow Right arrow Down or ctrl-T ctrl-F ctrl-G ctrl-V on remote PC. Each press on 5 will give the next choice. The definitions at bottom of screen will update correspondingly , (right) Log listing menu 7 (right) 8 (right) 9 (right) Previous page free 10 pages backward 4 (right) 5 (right) 6 (right) free Change move mode free 1 (right) 2 (right) 3 (right) Next page Last entries 10 pages forward 0 (right) free ............................................................................ ',' Change move choice Selections for the move choice: Telescope RA/DEC AltFunc+UP / ctrl-T Telescope DEC+ with offset size AltFunc+DOWN / ctrl-V Telescope DEC- with offset size AltFunc+LEFT / ctrl-F Telescope RA- with offset size AltFunc+RIGHT / ctrl-G Telescope RA+ with offset size Telescope RA/DEC and counter move guide probe, 'combined offset' Can be made during autoguiding. If guide probe reaches a limit, autoguiding is not switched on again, instead a warning is given AltFunc+UP / ctrl-T Telescope DEC+ with offset size AltFunc+DOWN / ctrl-V Telescope DEC- with offset size AltFunc+LEFT / ctrl-F Telescope RA- with offset size AltFunc+RIGHT / ctrl-G Telescope RA+ with offset size Guide probe X/Y AltFunc+UP / ctrl-T Guide probe Y- with probe step size AltFunc+DOWN / ctrl-V Guide probe Y+ with probe step size AltFunc+LEFT / ctrl-F Guide probe X+ with probe step size AltFunc+RIGHT / ctrl-G Guide probe X- with probe step size TV focus AltFunc+UP / ctrl-T TV focus + with 2 steps AltFunc+DOWN / ctrl-V TV focus - with 2 steps Star box X/Y AltFunc+UP / ctrl-T Star box Y- with 3 pixels AltFunc+DOWN / ctrl-V Star box Y+ with 3 pixels AltFunc+LEFT / ctrl-F Star box X- with 3 pixels AltFunc+RIGHT / ctrl-G Star box X+ with 3 pixels Background box X/Y AltFunc+UP / ctrl-T Background box Y- with 8 pixels AltFunc+DOWN / ctrl-V Background box Y+ with 8 pixels AltFunc+LEFT / ctrl-F Background box X- with 8 pixels AltFunc+RIGHT / ctrl-G Background box X+ with 8 pixels PageUp Previous page 'Prev' on VT510 Continously pressed gives large moves PageDown Next page 'Next' on VT510 '(' Select previous catalogue object ')' Select next catalogue object '?' Help on the currently typed command If for a unique command, parameters and ranges, if not unique then partial command list. If nothing on command line a command summary '!' Acknowledge a warning message WARNINGS: Warnings are displayed on the warning line on the terminal, a warning stays for about 8 seconds and is replaced by next one if there is any. The latest stays until it has been acknowledged. All warnings are also listed on the error screen in the control room which gives the 24 latest ones. All warnings of course also goes to a log file. Warnings are of the informational kind, the TCS will take proper actions when deemed necessary. LOG FILE: In addition to warnings, commands and other important things are also logged with a time stamp in order to help finding out what has been going on. A new log file starts at noon every day. The log table with the last about 4000 entries can be listed on the terminal for convenient follow up. Especially the last warnings will be of interest. A new facility is in use to send all entries to the observing system Talker. RECORDING OF DATA: A huge amount of the internal TCS data goes 2 times per second to the Data Base server. This data can be viewed in low and high resolution in the IntraNOT web pages. COMMANDS and FUNCTIONS: See the various web documents for these.