# RELEASE_NOTES

Release notes for the LCLS-II MPS central node IOC.

## Releases:
* __central_node_ioc-R2-1-1__:
  * Update `central_node_engine` to version `central_node_engine-R2-1-1`.

* __central_node_ioc-R2-1-0__:
  * Update `central_node_engine` to version `central_node_engine-R2-1-0`.
  * Add support to read and write the app timeout enable bits.

* __central_node_ioc-R2-0-0__:
  * Update FW to version `7ef9f2d`.
  * Update the central_node_engine to version `central_node_engine-R2-0-0`.
  * Update `MpsCentralNodeConfig.yaml` to support all 1024 apps.
  * Improve evaluation processing pipeline.
  * Fixes/Improvements for the dual CN operation.
  * Cleanup `sioc-sys0-mp01` startup script.
  * Expose Pgp2bAxi counter for all 14 channels.
  * Create second DEV IOC for the dual-carrier configuration.
  * Add support for the `yamlDownloader` module, and use it to download the
    YAML files from the FPGA, instead of a local copy of the YAML files.
  * Add the `yaml_fixes` directory to hold local patched YAML files,
    and point CPSW's `YAML_DIR` env var to it.
  * Load the database from the `PHYSICS_TOP` location.
  * Fix a DESC field which was too long.
  * Update the YCPSWASYN register mapping, according to changes in the new
    YAML files.
  * Add new options to the `mps` shell command, to get information about
    the power class changes info.

* __central_node_ioc-R1-5-0__:
  * Merge changes from the EIC branch.
  * Update buildroot to version 2019.08.
  * Update CPSW to version R4.4.1. This implied update boost to version
    1.64.0 and yaml-cpp to version yaml-cpp-0.5.3_boost-1.64.0.
  * Update central_node_engine to version central_node_engine-R1-7-0.
  * Update EPICS base to version R7.0.3.1-1.0. This implied updating
    all EPICS modules to the latest version:
    - asyn too version R4.32-1.0.0.
    - seq to version R2.2.4-1.2.
    - autosave to version R5.8-2.1.0.
    - caPutLog to version R3.7-1.0.0.
    - iocAdmin to version R3.1.16-1.3.2.
    - miscUtils to version R2.2.5.
    - ycpswasyn to version R3.3.3.
    - yamlLoader to version R2.1.0.
  * Fix all compilation warnings.
  * Fix bug in YAML file, which is caught by the new version of CPSW.
  * Fix path to the DEV version of PHYSICS_TOP.
  * Rename SYS2 to SYS0.
  * Add the display directory to the gitignore file.

* __central_node_ioc-R1-4-2-eic (EIC branch)__:
  * Update MCS file with version loaded in EIC.

* __central_node_ioc-R1-4-1-eic (EIC branch)__:
  * Renamed SYS2 to SYS0

* __central_node_ioc-R1-4-0-eic (EIC branch)__:
  * Build agaist central_node_engine-R1-6-0-eic (branch)
  * New central_node_engine has bug fixes for AOM/Shutter control
  * The UNLATCHALL PV now also clears FW mitigation latched while
    enabling AOM.

* __central_node_ioc-R1-3-1-eic (EIC branch)__:
  * Addition of PV for disabling AOM $(IOC):AOM_DISABLE

* __central_node_ioc-R1-3-0-eic (EIC branch)__:
  * Build against central_node_engine-1-5-0-eic (branch)
  * Addition of $(IOC):LINAC_TM_PC containing PC sent to timing

* __central_node_ioc-R1-2-12__:
  * Build against central_node_engine-R1-4-1.

* __central_node_ioc-R1-2-11__:
  * Build against central_node_engine-R1-4-0.

* __central_node_ioc-R1-2-10__:
  * Addition of $(IOC):DISABLE_BEAM PV: this allows operators to
    disable the gun shutter.

* __central_node_ioc-R1-2-9__:
  * Build against central_node_engine-R1-3-1. MPS is not enabled
    after configuration is loaded the first time.

* __central_node_ioc-R1-2-8__:
  * Build against central_node_engine-R1-3-0
  * Addition of PV to clear beam fault violations [$(IOC):BEAM_FAULT_CLEAR]

* __central_node_ioc-R1-2-7__:
  * Addition of support for FaultState PVs
  * st.cmd now loads the file fault_states.db (for FaultState PVs)
  * Version compatible with mps_config-2018-09-10-a, earlier
    mps_config versions don't have the fault_states.db file

* __central_node_ioc-R1-2-6__:
  * Version built against central_node_engine-R1-2-4, minor fix
    to the beam charge verification table readback ('mps show fw'
    command)

* __central_node_ioc-R1-2-5__:
  * Version built against central_node_engine-R1-2-3, the only
    difference to previous version is that the beam charge table
    is now populated with values from the configuration database
    (as opposed to hardcoded test numbers).

* __central_node_ioc-R1-2-4__:
  * Add PVs to control and readback the status of the timing core.
  * Rename IOC directory to sioc-sys2-mp01.
  * Update Central Node FPGA IP address to 10.0.0.102.
  * Give executable permission to st.cmd.
  * Update PHYSICS_TOP path used in PROD.
  * Use dictionary file which is shipped with the IOC application.
  * Add PVs to save and load register configuration via CPSW YAML.
  * Rename the directory yaml to firmware.
  * Add the FW mcs file to the IOC app so it can be (re)load in PROD.
  * Add the YAML definition file corresponding to the current FW image
    to the IOC application and reference that file from st.cmd.

* __central_node_ioc-R1-2-3__:
  * Fixes to the bypass string PVs, each analog threshold
    has a separate bypass string - which is indicated by
    the INP address calculated by the scripts that export
    information from the MPS database. When number of seconds
    reaches zero the string is set back to 'Not Bypassed'

* __central_node_ioc-R1-2-2__:
  * build against central_node_engine-R1-2-2
  * Addition (again) of code to retrieve status of ignore
    condition for analog integrator (used for TORO DIFF
    for EIC)

* __central_node_ioc-R1-2-1__:
 * built against central_node_engine-R1-2-1

* __central_node_ioc-R1-2-0__:
  * built against central_node_engine-R1-2-0
  * not compatible with R1-1-x

* __central_node_ioc-R1-1-0__:
  * built against central_node_engine-R1-1-0

* __central_node_ioc-R1-0-0__:
  * first version for EIC
