GLAST/LAT > DAQ and FSW > FSW

FSW B0-6-8 Release Notes


This page summarizes the functionality included in FSW Release B0-6-8 and lists the JIRA issues resolved in the Release.

User procedures for B0-6-6 are described in the LAT Flight Software User Guide. A cumulative list of procedure changes since that Release is provided below. Users of B0-6-8 should also review the entries for the JIRA items resolved in B0-6-8.

Additional files, materials, and release documentation for B0-6-8 (including complete 0-6-8 command and telemetry interface reference documentation) are available on the B0-6-8 Release Page.

I. Functionality of B0-6-8

B0-6-8 supports end-to-end operation of the LAT using the SIU and EPUs. 0-6-8 has the following capabilities:

  • Full support for LAT internal hardware interfaces and the LAT external interfaces with the Spacecraft.
  • Full boot capabilities on the SIU and EPUs
  • CPU watchdog management
  • Command and telemetry processing and a complete set of commands and telemetry to support end-to-end operations, as well as handle Spacecraft ancillary messages
  • Processing of all time signals and messages from the Spacecraft, and drift-corrected timekeeping
  • CPU memory and EEPROM file system management
  • Delivery of event data from the hardware to the Spacecraft Solid State Recorder
  • Configurable filtering of event data
  • Collection of charge injection calibration data
  • Operational mode control to manage pointed observations, sky survey observations, and target of opportunity observations
  • Load shed management and operations during SAA transit
  • Thermal control system
  • Instrument configuration by file and readback of instrument configuration

B0-6-8 does not support collection of instrument diagnostic data (CR calibration data, trigger rate data, etc). It does not fully implement automatic repoint requests or the LAT GRB detection algorithm.

II. Changes Affecting Procedures Since Release 0-6-6

  • B0-6-7: At the end of a physics data taking run using LPA, on receipt of the LPASTOP command, FSW checks whether the detector configuration changed during the run. If the configuration did change, the detector register configuration data is dumped to the SSR in telemetry with APID 1021.
  • B0-6-7: The contents of various hardware error and status (ESR) registers are now sent with other LAT detector configuration dump telemetry to the Solid State Recorder. If the LPALATCCNSFLG of the LPASTART command is set to instruct FSW to dump the LAT configuration to the SSR at the start of  the data collection run, a separate telemetry packet of  ESR data is sent along with the configuration register dump data. The ESR packet is sent any time the detector configuration is dumped - in response to an LPASTOP command (see the previous note) or in response to the LIMLATCRECORD command. The ESR data packet has the same APID (1021) as the other configuration data telemetry; within the telemetry packet, the ESR data is organized as a single LSFdatagram with TypeID = 0x900 wrapping a single LSFcontribution with TypeID = -1. The ESR data packet is always the last telemetry packet in any sequence of packets with APID 1021 dumped in response to LPASTART, LPASTOP, or LIMLATCRECORD. See FSW-594 for the list of ESR registers dumped.
  • B0-6-8: New status information was added to thermal control telemetry, both in the LTC diagnostic telemetry packet (DiagLTC, APID 730) and in the housekeeping LtcData0 packet (APID 558). Both packets contain a new field, LTCHTRREG, recording the current state of the LTC system (running or stopped, active or passive) and the current state of the SIB heater control register for each heat pipe reservoir heater, 0-11. See the 0-6-8 command and telemetry handbooks (Cmd_Tlm_*.pdf)  on the B0-6-8 Release Page for the layout and encodings of the new field.
  • B0-6-8: The ITOS definition for the Slew-Request command (APID 1536) sent by FSW to the spacecraft as part of the ARR response sequence was added to the ITOS database. The command definition had previously been hard-coded into the LAT Instrument Manager application code, but not "published" as part of FSW's ITOS products (database and command and telemetry handbook) .
  • B0-6-8: When performing "fast boot", the boot code now takes secondary boot flags from the Boot Diagnostics Area in RAM instead of using hard-coded defaults. Operators wishing to use fast boot can issue the LBTRTOSEXEC telecommand (APID 1600), setting the secondary boot flags as desired; later reboots with the LBTRESET telecommand (using the fast boot option settings) will then use the pre-set secondary boot flags. Alternatively, operators may set the secondary boot flags directly in RAM using the LMEMLOADMEM command. The secondary boot flags start at address 0000FF84 and occupy 4 bytes. The encoding of the secondary boot flags is documented in the Primary Boot Code Design Document on the FSW Traveler Documents page, and various CPU boot use cases are described in the FSW User Guide .

III. FSW Packages Changed or Added in B0-6-8

B0-6-8 provides “flight” code modules, which are loaded and executed on LAT CPUs, and the corresponding source code. In addition, B0-6-8 contains unit tests, test support code, ground support utilities, and qualification test documents and scripts.

  • FSW packages that were changed or added since B0-6-7 are itemized here.
  • All FSW packages in B0-6-8 are itemized here.

IV. JIRA Items Resolved in B0-6-8

Bug

  • [FSW-593] - RITTEMP/RESTEMP go "BROKEN" after LTCRESTART
  • [FSW-603] - LTC temperature memonics *defined in LHK* do not match actual sensor data
  • [FSW-604] - LTC estimation value drifts when sensor is in BROKEN state
  • [FSW-611] - LTCSTOP followed by LTCRESTART telecommand generates errors
  • [FSW-612] - CRC configuration register is incorrectly cloned in LATC_capture
  • [FSW-613] - PBC should use SBC flags found in RAM when performing a fast boot.
  • [FSW-616] - Add LHK AEM DAB Diagnostic Mnemonics
  • [FSW-619] - Some errors in the ESR hack code in LATC
  • [FSW-627] - LCAT_tlm_db.py for FSW 0.6.8 mismaps packets 0x223, 0x224, 0x225, 0x283, 0x284, 0x285

Improvement

  • [FSW-247] - LATC needs to be split into three new packages, RIM, LCFG and QCFG
  • [FSW-590] - Add LTC state information to telemetry
  • [FSW-591] - Add SIB heater control register contents to LTC telemetry
  • [FSW-598] - SUROM boot code must configure WAITR for the RAD750 CPU
  • [FSW-599] - SBC should clear the 'fast boot' primary boot flag when returning to PBC as a result of an error.
  • [FSW-606] - Update LHK PDU Mnemonics Mapping to Match Hardware
  • [FSW-610] - LIM should provide an LCAT definition for the Slew-Request command that it sends to the spacecraft.
  • [FSW-615] - LATC read of ESR should occur before the LATC_capture operation
  • [FSW-620] - ACD LCI data corruption in AcdVetoCal (really a hitmap test)

Task

  • [FSW-621] - The CAL pedestals and gains used when dealing with GLEAM Monte Carlo data need updating to keep them in line with what is used in GLEAM