Software Release Notes for Build "AO4"

Release Date: Apr 19, 2010
Generic Release Name: AO4
Public Release Name: "Adaptive Optics" release 4
General Description: General development and some AOS modifications.

Telescope Operator Overview Information

  • GCS V2.3.0
    • modified output of getStatus command to show more information about selected AGW unit. It now shows unit number, probe position, associated rotator and filter name which closes IT #2473.
    • added basic functions and config parameter to AGw configuration files to support dark files in preparation to close IT #2531, this is not fully implemented yet but you might see some hints that it is coming soon
    • removed WFS_pupil_direction from config files and replaced it with WFS_pupil_dir_x and WFS_pupil_dir_y, to control the pupil shift direction on the axes independently. This was already in use as part of a patch to GCS
    • IT #2621 should be fixed in this release, which caused postage stamp readouts in ACQUIRE mode or for acquisition images with AGW #2 (it is actually a work-around for a problem in AzCam 4.0)
    • fixed a problem with Azcam 4.0 images not getting the FITS headers extension they were supposed to get. This problem also only applied to AGW #2 images.
    • extended the delay before use of AGw unit after power up from 6 to 10 seconds as I still experienced problems on the mountain when using the auto powerUp feature

  • GCSGUI V0.1.16
    • side parameter is now case insensitive
.

Support Astronomer Overview Information

  • The PSF now puts ACTOPT messages in SysLog for active optics operations on the secondary mirror.
  • New IRC commands ClearHotspot and ClearOffset exist to remove the PresetTelescope hotspot and offset objects. Note that the hotspot and offsets objects are not yet supported by the TCS.

The Details

Specific Tests that need to be performed with the Telescope

Patches to the Release

  • PCS_Version-5.2a (PCS.20100422)
    • The updateReferenceOrigin method which is used by the AOS to perform a pointing correction (reconcile the predicted and measured reference star locations) was reverted to the original implementation.
  • PSF Version 4.47
    • Active optics to the adaptive secondary is now supported.
  • ECS Version 2.18a (ECS.20100428)
    • The proper unit conversion was implemented for the Aftercooler pressure differential, HX0410. The new device reports in Inches of Water versus PSI, and the unit conversion to kPa was not updated at the time of the device change.

Known Bugs

  • none.

Release Overview

  • none.

Operating System, System Configuration, TCS and Hardware Computers

TCS Servers / Workstations

  • none.

agw-control computer

  • none.

jet computer, DSP, FPGA

  • none.

Networks

  • none.

PLCs

  • none.

TCS Subsystems and GUIs, and significant configuration files

lbt.conf

  • The parameter telDiskBufSize_B was added. This controls the size of the buffer file used during diagnostic collection.
  • The parameter TEL_DISK_BUF_DIR was added. This controls the location of the buffer file.

AGw control server

  • none.

AOS - Adaptive Optics

  • none.

ECS - Enclosure Control

  • ECS_Version 2.18
    • Updated routines to accommodate deprecated functionality in Telemetry Release 9.

ENV - Environmental Sensors

  • ENV Version 1.4
    • Remove deprecated telemetry features.
    • Finish() is no longer called on the telemetry collectors so the subsystem will not hang if at exit telemetry cannot flush the buffers. Any uncommitted samples in the buffers will be discarded.
  • ENVGUI Version 1.2
    • Display weather data in the proper color, instead of always red.

IIF - Instrument Interface

  • IIF Version 7.3
    • Add telescope mode INVALID for unrecognized modes. This is only for internal use.
    • AO support has been added to command UpdateTargetWavelength. The AO will be paused/resumed appropriately.
    • Add ICE commands CleaHotspot and ClearOffset to remove the PresetTelescope objects hotspot and offset.
    • Add command PresetClear, though it does nothing yet.
  • IIFGUI Version 2.2
    • Add display support for mode INVALID.

GCS - Guiding Control System V2.3.0

  • modified output of getStatus command to show more information about selected AGW unit. It now shows unit number, probe position, associated rotator and filter name which closes IT #2473.
  • corrected usage hints for gcsClient when syntax was incorrect for a given command (it showed the side name instead of the command name). It now shows the command name again.
  • added configuration values guidecam_flatImg and WFScam_flatImg to all AGW configuration files to specify file name for flat images for each camera respectively.
  • added server and client functions to have GCS take a flat field image with the guide or WFS cam for the currently selected AGW unit and store it. These are:
    • {f_}requestNewFlatImage(guidecam/WFScam) - readout full CCD, buffer image, return image to GUI for visualization
    • {f_}requestCurrentFlatImage(guidecam/WFScam) - return currently used flat image to GUI for visualization
    • {f_}confirmFlatImage(guidecam/WFScam) - store buffered image on disk, keep previously active file as a backup, update internal copy of flat file for this camera
    • {f_}rejectFlatImage(guidecam/WFScam) - delete internally buffered image
    • {f_}restorePreviousFlatImage(guidecam/WFScam) - overwrite the current flat file with the backup copy of the previously used one, update internal copy of flat file for this camera
    • {f_}injectFlatImage(guidecam/WFScam) - transfer a flat image from client to server, store it after backing up previous flat image, update internal copy of flat file for this camera
  • updated WFS thread to not abort calculation if creation of GUI related sub image fails, as in IT #2622
  • removed WFS_pupil_direction from config files and replaced it with WFS_pupil_dir_x and WFS_pupil_dir_y, to control the pupil shift direction on the axes independently.
  • patched ThreadSocket class to not drop allocated socket
  • added mountain configuration for RFBG
  • fixed some problems with the AzCam destructor not stopping IST and then hanging in a join()
  • corrected path reference for flat file handling
  • added awareness to AzCam class about a failure to set ROI and to rely on internal ROI values thereafter to ensure resetting to full CCD readout for following acquisition
  • added events and log messages in the case of failed setROI commands
  • forcing setROIs for full frame when starting ACQUIRE mode and when acquiring a guide star
  • added a GCSSocket class based on TCPSocket and changed the default constructor to NOT create a sockfd on instantiation, instead you'd have to call GCSSocket::create() to get one
  • deriving ThreadSocket from GCSSocket now and eliminated the sockfd deletion that was necessary to bypass problems with TCPSocket's auto FD creation
  • ACQUIRE mode and GS acquisition evaluate image size and will resend full frame setROIs if image is smaller than detector size, this and the above measures should fix IT #2621
  • fixed a glitch with the Makefile.inc that was discovered by Tom. Thanks again!
  • support AzCam 4.0 generated FITS headers and continue to populate these briefer FITS headers with GCS generated values
  • automatically add missing FITS headers to guide, acquisition and wfs images
  • added an additional FITS header entry to every AzCam image that indentifies the AGw unit used and not just the type
  • extended the delay before use of AGw unit after power up from 6 to 10 seconds as I still experienced problems on the mountain when using the auto powerUp feature
  • added gcs[].GuideCam.flatFilename and gcs[].WFSCam.flatFilename to indicate which flat file is in use for the respective camera (if any at all).
  • added code to AGWCamera class to support the actual flat file subtraction from a camera image. It adapts to different sizes of images when dealing with guider images and
  • cuts out the correct region of the flat file for subtraction (yet to be tested).
  • enhanced CamImage class to report if a previously used operator succeeded or not.
  • started implementation of loading flat file from configuration settings during AGW initialization
  • auto converting binary flatRegionImg to FITS format
  • GCSGUI should now accept any case for the side parameter

LSS - Logging and Events

  • LSS Version 3.4
    • The events log file is now kept open, and a flush is performed after each write.

MCS / mcstemp - Mount Control

  • none.

OSS - Optical Support (version 2.11)

  • Updated telemetry classes to support telemetry 9 and greater.
  • Added code to handle exception which can be thrown by accessing properties of the mirror while it is in a disconnected state.
  • Added an enable-disable to the communication for the adsc and terc. In the case of the secondary, the TCP connection is broken, but for the tertiary, commands are just rejected, as severing the connection for one side will affect the other, since both sides use one UMAC.
  • This can be set via an lbt.conf setting so that at startup the communication is disabled to the UMAC, or via a button on each of the GUIs during runtime.
  • A new bit has been added to reflective memory called 'is_comm_disabled' showing the state of the communication to the UMAC for both objects.
  • Fixed bug in file upload to PMAC which would allow the file upload to continue, even if there was an error.
  • Added code to allow the OSS GUI to sense if the build it belongs to is not the same as the current build. The windows will be turned yellow if this is the case.
  • Added 'reverse_sel' to the terc selector to allow for the fact its direction may be reversed. This setting is in OSS.conf.
  • Removed the 'Version.hpp' file, since the version information is now held in 'Main.cpp'.
  • Paolo from ADS has modified the cfg file for the tertiary. the original name is 'UMAC_config_file_right_arm_fixed.CFG'. He has made changes to these files based on calibrations done to the UMAC on the mountain, since the amplifiers are new.
  • Under Paolo's direction, the focal station positions have been modified for the right side. The sign may need to be reversed in OSS.conf to be consistent with what is expected for the selector motion.
  • Under Paolo's instruction, modified the indicators for the 'isMirrorHomed' and 'isSelectorHomed'. Also fixed homing offsets for the home sequences for the selector and mirror.
  • Added more descriptive text to the state and status transistion events, as well as fixed the color on the Main OSS GUI.
  • Modified the 'wait for in position' code to fix a bug which caused it to return too fast.
  • Added more verbose error messages to the UMAC. These will be bubbled up to the IIF if an error occurs while running a command.

PCS - Pointing Control

  • PCS_Version 5.2
    • Updated routines to accommodate deprecated functionality in Telemetry Release 9.

PCS GUI

  • PCSGUI_Version 1.20
    • Updated the data dictionary item read for the authorized instrument and removed obsolete labels.

Preset GUI

  • none.

Pointing Kernel / Pointing Kernel tools

  • TPK_Version 1.8.1
    • Addressed a bug in the Optics Virtual Telescope track command; the mutex unlock was updated for the proper object.

PMC - Primary Mirror Cell

  • PMC Version 5.8
    • Remove deprecated telemetry features.
    • Finish() is no longer called on the telemetry collectors so the subsystem will not hang at exit if telemetry cannot flush the buffers. Any uncommitted samples in the buffers will be discarded.

PSF - Point Spread Function

  • PSF Version 4.46
    • Remove deprecated telemetry features.
    • Finish() is no longer called on the telemetry collectors so the subsystem will not hang at exit if telemetry cannot flush the buffers. Any uncommitted samples in the buffers will be discarded.
    • The primary mirror position limits are tightened close to the horizon (> 0.3 degree elevation) to avoid some panics.
    • The secondary and tertiary mirrors now have position limits similar to the primary mirror. Variables in lbt.conf specify the various limit values, including whether the checks are active. The checks are currently disabled.
    • SysLog messages were added for active optics operations on the secondary mirror.

SDB - Star Database

  • none.

TCS GUI

  • TCSGUI Version 1.18
    • The PCS "side" status is properly synchronized across multiple TCSGUIs.

WX - Weather Station

  • none.

TCS Common Software

commandreturn - client command status returns

  • none.

commandsequencer - client/subsystem command handling

  • Improved error handlilng in getResult()
    • The (new) error "ERROR: No result available yet" is returned if the command is still running.
    • The (existing) error "ERROR: No such command" is only returned if the command does not exist.

core - foundation routines

  • Add SysLog error message if thread create fails in Thread class.

datadictionary - reflective memory and event support

  • none.

eventhandler - event handling

  • none.

networkconfig - subsystem management

  • none.

reflectivememory - global shared memory

  • Added error check and SysLog message in GshmServer.cpp main receive loop to help debug shared memory timeouts.

rpc - communication protocol

  • none.

setvalue - reflective memory access

  • none.

tcs_config - tcs configuration

  • none.

TCS Tools

DDEditor - Data Dictionary Editor

  • none.

DDBrowser - Data Dictionary Browser

  • none.

DDViewer - Data Dictionary Viewer

  • none.

Event Editor

  • none.

Telemetry

Collector

  • none.

Instruments and Environmental Sensors

DIMM - Differential Image Monitor

  • none.

idl

  • none.

iraf

  • none.

IRTC - Infrared Test Camera

  • IRTC Version 2.1.1
    • Add commands ClearHotspot and ClearOffset to remove the hotspot and offset objects from the PresetTelescope command.
    • Add command PresetClear, although it has no effect yet.
    • Command help cleaned up.

LBC - LBT Binocular Camera

  • none.

LBTO Weather Station - 3DWGUI

  • none.

MAT - Mount Axillary Telescope

  • none.

All Sky Monitor

  • none.

-- NormCushing - 13 Apr 2010
Topic revision: r10 - 28 Apr 2010, MicheleDeLaPena
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback