Software Release Notes for Build "BP3"

Release Date: September 16, 2010
Generic Release Name: BP3
Public Release Name: "Binocular Operations" release 3
General Description: Updates and improvements to many of the TCS subsystems, as well modifications needed to support binocular operations.

Telescope Operator Overview Information

  • none.

Support Astronomer Overview Information

  • PCS support for an Offset or HotSpot specified in the IIF PresetTelescope command.
  • The PCS setcentroid command (IIF OffsetGuiding) will now support LBTI in addition to LBC and MAT.
  • Binocular support
    • Synchronous and asynchronous PresetTelescope and OffsetPointing (RA/Dec only).
    • The pointing correction (rectification of predicted versus measured location of the guide star) is synchronous by default.
    • Pointing Log data is always collected for both sides of the telescope when this functionality is requested.
  • The IIF tries to trap all illegal/unsupported parameters and combinations of parameters in Preset and Offset. However, I'm sure some have slipped through.
  • The IRTC supports the BinocularControl command.
  • There is a new command line tool 'psfclient' which can be used to set values in the PSF. Entering an incomplete command will generate a short help message. The command supports sides, optical elements, and move types. The parameters which can be set are
    • global offsets
    • pointing tip/tilts
    • active optics offsets
    • shell offload

The Details

Specific Tests that need to be performed with the Telescope

Patches to the Release

  • none.

Known Bugs

  • none.

Release Overview

  • none.

Operating System, System Configuration, TCS and Hardware Computers

  • none.

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

  • Many changes, too numerous to mention.

AGw control server

  • none.

AOS - Adaptive Optics

  • none.

ECS - Enclosure Control

  • none.

ENV - Environmental Sensors

  • ENV Version 1.5
    • Add "ENV" at start of all event descriptions to make GUI display correct (IssueTrak 2734).
    • Add anemometer specific telemetry events.
    • Remove "frame" parameter from anemometer frameError event.
    • Do not talk to the moxa if simulating the anemometer.
    • Make anemometer simulate true for locales "testing" and "downtown".

  • ENV Version 1.6
    • Convert underscores to blanks in telemetry names to conform to the newest requirements.
    • Add methods get_disk_buffer_dir() and get_disk_buffer_size() for telemetry r11.

  • ENVGUI Version 1.3
    • Add displays for anemometer and DIMM.

IIF - Instrument Interface

  • IIF Version 7.6
    • Allow MoveXY command to specify OPE M1M2.
    • Overlap the primary mirror and secondary mirror motions in MoveXYZ.
    • Add checks to RotReady for done.

  • IIF Version 8.0
    • Clean up StepFocus command and check for supported OPE.
    • Add support for guiding and AO in TipTilt (not done yet) and add standard command error checks.
    • Check swing arm configuration in Preset and Authorize and set warning if not correct.
    • Changes for binocular PCS (reflective memory and methods).
    • Add synchronized Presets.
    • Preset checks for PCS weight of zero.
    • Add Preset event 'rejected' and use it for all unconditional rejects.
    • Rename PresetClear command to BinocularControl, and allow it to support multiple functions.
    • Add synchronized Offsets.

  • IIF Version 8.1
    • Improve error handling for RotReady.

  • IIF Version 8.2
    • Add better error handling and wait for done in RotReady.
    • Clear synchronous condition when instrument authorized.
    • Allow BinocularControl command if instrument is authorized on either side.
    • Ignore BinocularControl if in 'mono' mode.
    • Add CANCELSYNCPRESET and CANCELSYNCOFFSET support to BinocularControl command.
    • Write C Instrument Interface Control Document.
    • Bring all documents up to date.
    • Remove X and Y coordinate from rotation point in RotateCommon command. (Note: documents are now not up to date!)
    • Implement RotateCommon.
    • Add standard checks to RotatePrimary command.
    • Clean up RunAO command. Only do GCS related operations for the proper focal stations.
    • Rewrite commands SetPMTerm, SendWavefront, RotateZ, Move, Guide, and GetTrajectory in standard form with standard checks.
    • Check for supported OPE in SendWavefront.
    • Put OPE in events for Move.
    • Check for AZALT coordinate system in Guide.
    • Check for instrument LBC in GetTrajectory.
    • Deserialize the command return from the PCS to check for errors in GetTrajectory.
    • Clean up Preset reject events.
    • Check for many unsupported/illegal parameters in Preset.
    • Pass offset and hotspot in Preset to PCS.
    • Clean up Offset reject events.
    • Check for many unsupported/illegal parameters in Offset.
    • Add calls to PCS to set the PCS lock state in Preset and Offset.

  • IIFGUI Version 3.0
    • Add PCS weight display.
    • Add Sync/Async Preset display.
    • Add CancelSync support.
    • Add sync/async Offset display.
    • Fix weight display.
    • Add "Mono" to preset sync display when one side has weight 0.
    • Add OffsetSync status display and cancel operation.

  • IIFGUI Version 3.1
    • Add acceptBinocularControl support.
    • Use C++ headers.
    • Clean up PCS and MCS data displays.

GCS - Guiding Control

  • none.

LSS - Logging and Events

  • LSSGUI Version 1.7
    • Add underpinnings for sound support. GUI uses NAS (Network Audio System) (if available) to play sounds.
    • Add "sound" directory for every subsystem.

MCS / mcstemp - Mount Control

  • none.

OSS - Optical Support

  • none.

PCS - Pointing Control -

  • PCS_Version-6.6
  • GENERAL
    • Implemented changes imposed by the Telemetry System where component/telemeter names were changed to conform to new rules for telemetry.
    • Modified the setCentroid method (IIF OffsetGuiding function) to handle guide centroids appearing to be issued from any instrument computing their own centroids in the AZ/EL reference frame. The focal length of the telescope needed to be accommodated appropriately. This was modified, in particular, for use by LBTI.
    • Separated the trajectory generation from the back computation of the "achieved" coordinates. Created a new class, EncoderFeedback, which will handle any back computation which needs to be done.
    • Added support for the HotSpot (pointing origin) to be used when provided as part of the PresetTelescope command. Specification of these values overrides the default values contained in the PCS configuration file.
    • Added support for handling an Offset when provided as part of the PresetTelescope command.
    • Added code to perform the basic computation to generate the mount/axes polynomials, as well as the tips and tilts for the PSFL and PSFR. This incorporates the use of the Optics virtual telescopes.
    • Added the setPointingOrigin() function to support the TO modifying the pointing origin base from the PCSGUI. Please note this is NOT the same as absorbing the pointing origin which takes the current offset values from the current pointing origin base, and creates a new pointing origin base from these values internally.
      Signature: string setPointingOrigin (int side, string coord, double value)
  • BINOCULAR
    • OffsetTelescopeEquatorial (offsets done in RA/Dec): This command now supports synchronized offset requests, as well as standard asynchronous requests.
    • Created a new command which allows one to indicate the desire for synchronized offsets. The synchronization can be invoked by the "binocular control" command via the IIF and can be aborted in the same manner as the synchronized presets.
      Signature: string synchronizeOffsets (void)
    • The pointing correction (update of the guide origin) is always synchronized. However, if the wait is aborted explicitly, the single update will proceed but indicate a FAILED status.
    • Collection of pointing log data is now done for both sides of the telescope by default. The file names can no longer be set by the user. Instead, the files are located in /home/telescope/PointingLogs and are named for the UT Date YYYYMMDD_[SX|DX].log. If logging were stopped and restarted on the same UT Date, the log data will be appended to the existing file.
    • Added new client command so the locking/unlocking of a telescope side can be controlled externally by the IIF.
      Signature: string setLockState (int side, bool lockState)

PCS GUI

  • none.

Preset GUI

  • none.

Pointing Kernel / Pointing Kernel tools

  • none.

PMC - Primary Mirror Cell

  • PMC Version 5.9
    • Add support for new outer loop synchronous forces flag.
    • Remove outer loop synchronous forces flag from the mirror report to allow AO5 PMC to keep working. This will be reinstated sometime in the future.
    • Add methods get_disk_buffer_dir() and get_disk_buffer_size() for telemetry r11.

  • PMCGUI Version 5.8
    • Add support for displaying and setting the new outer loop synchronous forces flag.
    • Updated documentation.

PSF - Point Spread Function

  • PSF Version 4.49
    • Add psfclient command line tool to provide program access to PSF functions.
    • Support offloading thin shell offloads (Z2, Z3,Z4) on M2 hexapod to M1. (IssueTrak 2757).
    • Overlap M1 and M2 collimations in setInstrumentOffsets() when offloading to M1.
    • Use command name instead of number in psfclient.
    • Improvements to psfclient: usage information, case insensitive parameters, accept command name abbreviations.
    • Remove RotateCommon client command. The functionality is now performed in the IIF.
    • Split pointing offsets into mode 1 and mode 3 data.
    • Add mode argument to client command setPointingOffsets.
    • Add methods get_disk_buffer_dir() and get_disk_buffer_size() for telemetry r11.

  • PSFGUI Version 2.29
    • Add flag to control offloading to M1 from shell offloads on hexapod.
    • Add support for mode 1/mode 3 split pointing offsets.
    • Show mode 1/mode 3 sum in existing displays.
    • Add two additional forms to show mode 1 and mode 3 values separately.

TCS GUI

  • none.

WX - Weather Station

  • none.

TCS Common Software

commandreturn - client command status returns

  • none.

commandsequencer - client/subsystem command handling

  • none.

core - foundation routines

  • Do not throw a LoadFailure exception in Configuration::parse(). Instead, do not make an entry for the failing line and generate a SysLog error message with the lbt.conf line number. When the variable is read the caller will get the exception for the missing variable. IssueTrak 2736.

datadictionary - reflective memory and event support

  • Zero out unused parts of a binary event entry to aid in troubleshooting.

eventhandler - event handling

  • none.

networkconfig - subsystem management

  • Change 'netconfig ps' command to look for IRS instead of irs, and add check for IRTC.

reflectivememory - global shared memory

  • none.

rpc - communication protocol

  • none.

setvalue - reflective memory access

  • Clean up: Remove unnecessary #includes, remove DEBUG conditional code, and convert printfs to SYSLOG.
  • Remove all traces of callbacks and RPCs since it was not supported and never used. The included removing the following modules: SetValueXMLGenerator, SetValueXMLParser, SetValueCallback, SpecialCallHandler, ServerMain, and ConfigSetValue.

tcs_config - tcs configuration

  • none.

TCS Tools

DDEditor - Data Dictionary Editor

  • Allow the user to exit the program if auto-correct changes are needed.

DDBrowser - Data Dictionary Browser

  • none.

DDViewer - Data Dictionary Viewer

  • none.

Event Editor

  • Allow the user to exit the program if auto-correct changes are needed.

Telemetry

Collector

  • none.

Instruments and Environmental Sensors

DIMM - Differential Image Monitor

  • none.

idl

  • none.

iraf

  • none.

IRTC - Infrared Test Camera

  • IRTC Version 2.1.3
    • Change BinocularControl flag from int to string.
    • Update help text for BinocularControl.

  • IRTC Version 2.2
    • Convert to LBT build system (Stephen).
    • Remove X and Y coordinates from RotateCommon command.
    • Convert executables to upper case (Stephen).
    • Clean up proxy handling for IRC.
    • Change display names to IRS, IRTCGUI.

LBC - LBT Binocular Camera

  • none.

LBTO Weather Station - 3DWGUI

  • none.

MAT - Mount Axillary Telescope

  • none.

All Sky Monitor

  • none.

-- MicheleDeLaPena - 10 Sep 2010
Topic revision: r4 - 14 Sep 2010, ChrisBiddick
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