Software Release Notes for Build 21
Release Date: Feb 19, 2009
Generic Release Name: B21
Public Release Name: TCS Internal Test Release
Specific Tests that need to be performed with the Telescope
Patches to the Release
- This release implements interface changes in the IIF for both the C++ and C interfaces. All IIF clients must be rebuilt.
- This release of PCS Version 3.32 requires IIF 5.21 or greater (but not 5.22) and IRTC 1.2.00 due to a public interface change to utilize the function UpdatePointingReference().
- The communication between GCS and the GCSGUI has been improved to reduce the number of necessary client calls to visualize images and related data, which should reduce the load on the subsystem with increasing numbers of simultaneously running GCSGUIs.
Operating System, System Configuration, TCS and Hardware Computers
TCS Servers / Workstations
jet computer, DSP, FPGA
TCS Subsystems and GUIs, and significant configuration files
AGw control server
AOS - Adaptive Optics
ECS - Enclosure Control
ENV - Environmental Sensors
IIF / IRS - Instrument Interface
- IIF Version 5.21
- Rename the UpdatePointingOrigin command to UpdatePointingReference. It takes an addition argument, the offset type. This change requires PCS Version 3.30.
- IIF Version 5.24
- Make MODE_NONE the lowest entry in the modeType enum since it is now being used as part of the control strategy (IssueTrak #1851). This is an interface change for both the C and C++ interfaces.
- Add Preset status value CANCELED to distinguish from NONE. CANCELED is now set when the mount is off source for more than 4 seconds.
- Check for "small" Offsets and skip mirror collimation if so. "small" is a distance less than a threshold (default 2 arc-sec) and time since last collimation less than a threshold (default 2 min).
- Support setting thresholds for "small" Offsets.
- Add coordinate type COORD_RADEC_DT for future differential tracking.
- Support PSF Rz collimation flag. The flag indicates whether the M3 Rz (selector) axis should be collimated when the other three axes are.
- Fix RotateZ command for adjusting the M3 Rz position. The units were corrected, and a different method called to insure the OSS is actually asked to move the mirror independent of the Rz collimation flag.
- Use last Preset state to skip "missing collimation" calculation for the first Preset or if the previous Preset was canceled. This will keep the mirrors in better alignment after a move to horizon to close/reopen the enclosure.
- IIFGUI Version 1.18
- Support new Preset status CANCELED.
- Support setting thresholds for "small" Offsets.
- Add a status display for Offsets to show progress.
GCS - Guiding Control - V2.1.0
- added 4 flags to LBT.conf to start making the transition from a statically configured GCS test mode to a dynamical one, controlled through lbt.conf changes:
GCS.profiling controls if GCS should log additional profiling messages in SysLog
GCS.noAGW tells GCS to not try to talk to the AGW stage,
GCS.noTCS tells GCS to not talk to other parts of TCS, i.e. PCS/PSF,
GCS.noAzCam tells GCS that there are no real camera images available and causes them to be synthesized.
Once you've changed any of the flags described above you have to restart GCS as they are only read in at startup.
- Added GCS.starOverlay to lbt.conf to control if artificial stars should be added to images.
- removed all compile time flags from GCSGlobals.hpp that might need to be changed during run-time. Explicitly this is NOTCS, NOAZCAM, NOOACONTROL, AZCAM_STAR_OVERLAY, GCS_TESTING, PROFILING and the macro GUI_TESTING. If necessary you can now set these flags in lbt.conf as described above. GCS_TESTING and GUITESTING were removed completely as GUITESTING has now to be set flag by flag in lbt.conf and the GCS_TESTING conditional sections were permanently added to the code.
- added a number of DD variables to GuideCam. and WFSCam. subsection to prepare for the reduction of GUI client calls to GCS which will lead to less load on the subsystem and less processing overhead.
- reduced the number of necessary client calls for the GUI to visualize the guide images. All parameters are now being written to the DD the GUI reads it from there. The centroids are being added to the FITS headers and the GUI reads it from the headers. The final call necessary is the getGuideImage call that transfers the image to the client.
- fixed a very old bug deep in the CamImage class that caused the last pixel of an image to get lost when transferred through CommonSW this caused some funny effects when visualizing the acquisition and guide images in GCS GUI which appeared to never have the contrast just right. Now they have.
- fixed the problem with the GUI not showing an acquisition image when no guide star was found and the window showing the CCD readouts doesn't steal the focus anymore as it just stays open as long as the GUI is running.
LSS - Logging and Events
MCS / mcstemp - Mount Control
OSS - Optical Support
- OSS version 1.31
- Added code to allow any errors at the low-level communication with the UMAC to bubble up more details than just the fact that the communication failed.
- Added a mutex around data reads and writes called by tel and refmem for the tertiary mirror. This is necessary now that a string (the focal station name) is being written to RM.
- Added code to support the new 'adjustFocalStation' command. Also added messages to support the more detailed error status coming from the underlying UMAC class for both the secondary and tertiary UMAC.
- Added focal station variable updates to reflective memory. These are:
| is_at_focal_station || A boolean which is true if we have been sent to a focal station, false if we never have. |
| focal_station_rel_pos || Four values (0..3) representing the relative kinematic position, measured from the last commanded focal station. |
| current_focal_station || The name of the last commanded focal station. If no focal station has been commanded, this will be an empty string. |
PCS - Pointing Control
- PCS Version 3.32 - Requires IIF 5.21 (not 5.22) and IRTC 1.2.00
- Can now use PCS function, UpdatePointingReference(). This function only has meaning with respect to and is to be used in conjunction with the OffsetPointing() command. The OffsetPointing() command allows the user either to change the place on the sky where the telescope is pointing, or to change the place in the focal plane where an astronomical object is imaged. This command allows the user to "save" the current sky or focal plane location achieved via the OffsetPointing() command; the location can then be used as the new reference position for the sky or focal plane. UpdatePointingReference() needs to support all offset coordinate systems which can be used with the OffsetPointing() command. OFFSET_RADEC and OFFSET_DETXY are the only systems currently fully supported by both OffsetPointing() and UpdatePointingReference(). Originally released in B18.
- The XFLIP in the LUCIFER transform is still set to TRUE. This is the configuration which LUCIFER has been using since Commissioning began. This value eventually must be changed to FALSE in coordination with the LUCIFER team.
- Added a try/catch block to the "setPointingLog()" function. If for some reason the log file cannot be created/opened/written, the error will be caught. Previously, the error would crash PCS.
- Added a failed event for this command.
- Added change to Telescope.cpp and TrajectoryGenerator.cpp to accommodate additional diagnostics. This was a patch to B20.
- Deleted events for obsolete function setNewTarget(). This function was replaced with setEquatorialTarget() in B19.
- Deleted obsolete events for setNewTarget.
- Added TEL "db_inconsistent" to the try/catch for the three working telemeters in PCS.
- Added a check on the telCollector to ensure it exists before invoking telCollector->finish().
PMC - Primary Mirror Cell
PSF - Point Spread Function
- PSF Version 4.32
- Add a flag to control whether the Rz (selector) tertiary axis is to be included when collimating the tertiary mirror.
- Add a flag to skip doing the "missing collimation" calculation in the primary mirror secondary active optics offload. This is used to prevent the "missing collimation" calculation for the very first Preset, or if the previous Preset was canceled, which happens when the enclosure is abruptly closed.
- Require the IIF to be running and the Preset status to be DONE before issuing primary mirror position error events. This will stop many unwanted events.
- Keep the time of collimation for all mirrors so the IIF Offset command can tell how long ago a collimation was done.
- Turn off the pending WFS flag if the Preset mode becomes NONE. This happens when the telescope is moved manually by the operator, and guiding is stopped.
- PSFGUI Version 4.18
- Add support for displaying and setting the enable Rz collimation flag.
SDB - Star Database
WX - Weather Station
TCS Common Software
commandreturn - client command status returns
commandsequencer - client/subsystem command handling
core - foundation routines
datadictionary - reflective memory and event support
eventhandler - event handling
networkconfig - subsystem management
reflectivememory - global shared memory
rpc - communication protocol
setvalue - reflective memory access
tcs_config - tcs configuration
DDEditor - Data Dictionary Editor
DDBrowser - Data Dictionary Browser
DDViewer - Data Dictionary Viewer
Instruments and Environmental Sensors
DIMM - Differential Image Monitor
IRC - Infrared Test Camera Client
LBC - LBT Binocular Camera
LBTO Weather Station - 3DWGUI
MAT - Mount Axillary Telescope
- 29 Oct 2008
- 16 Feb 2009
Topic revision: r9 - 06 Oct 2009, NormCushing