You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

  • As of June 17th 2011, there may be a bug in reloading the Config DB after faults were removed.
  1. #Setup
    1. #Environment
    2. #Dependencies
    3. #Test inside Eclipse
  2. #Development
    1. #Overview
    2. #Classes and Functions
  3. #Release with Eclipse

Setup

Environment

  • Check out the CVS module physics/mps/mpsconfig into your workspace
    • From now on, the root of project is referred to as $MPSCONFIG_ROOT
  • Use ant to build the mpsconfig.jar

Dependencies

  • ezJCA (version R0-0-10)
  • javainterfaces (current version)
  • Oracle JDBC driver (under $MPSCONFIG_ROOT/lib/)
  • Sqlite JDBC driver (under $MPSCONFIG_ROOT/lib/)
  • xal4lcls
    • ext.jar (current version)
    • xal.jar (current version)

Test

  • To test your changes, you can run the MPS GUI
    • Check out the MPSGui project
    • Add the MPSConfig project to MPSGui's build path
    • Remove the library mpsconfig.jar from MPSGui's build path and replace it with the one you have built.

Development

Overview

Classes and Functions

edu.stanford.slac.mps.epics.ControlSystem
  • Monitors current Macro state numbers from IOC:BSY0:MP01:TTBLST.VALA
  • Bypasses faults to a value for a time duration
  • Monitors bypassed faults and end times
  • Given a fault name, gets current state, type, and timestamp
    of the fault
  • Given a PV, gets beam rate names (MPS and actual)
  • Translates between EPICS and Java time
edu.stanford.slac.mps.jdbc.JDBCMonitor
  • Loads all data from Config/Logic DB
    • Config DB URL prefix: jdbc:sqlite:/usr/local/lcls/epics/iocTop/MachineProtection/mpsConfiguration/database/
    • Logic DB URL prefix: jdbc:sqlite:/usr/local/lcls/epics/iocTop/MachineProtection/mpsConfiguration/algorithm/
  • Checks periodically for new versions
    • Current Config DB version is stored in IOC:BSY0:MP01:DBVERS
    • Current Logic DB version is stored in IOC:BSY0:MP01:ALGRNAME
edu.stanford.slac.mps.jdbc.config.ConfigDB
  • Singleton
  • Serves as a facade to information about faults
  • SQL queries are in the file sqlite.properties in the package edu.stanford.slac.mps.jdbc.config
edu.stanford.slac.mps.jdbc.logic.LogicDB
  • Singleton
  • Serves as a facade to information about Macros (and states), ignore conditions, current MacroStates
  • SQL queries are in the file sqlite.properties in the package edu.stanford.slac.mps.jdbc.logic

Release with Eclipse

  • Add a note in $MPSGUI_ROOT/RELEASE_NOTES
    • Increment the tag version accordingly
  • Commit to CVS
  • Tag with mpsconfig-R#-#-#

  • Check out the tagged version into your workspace on dev using eco

    $ cd ~/workspace
$ eco
Enter name of module/package to checkout: mpsconfig
Enter name of tag or [RETURN] to use HEAD>mpsconfig-R0-0-11
Using mpsconfig-R0-0-11. The name of the directory will be mpsconfig-R0-0-11.
cvs checkout -P -r mpsconfig-R0-0-11 -d mpsconfig-R0-0-11 mpsconfig
cvs checkout: Updating mpsconfig-R0-0-11
...
$ cd mpsconfig/mpsconfig-R0-0-11/
$ ant
  • This should generate the jar file in mpsconfig.jar
  • You can then use cram push and cram upgrade to upgrade the mpsconfig package
  • Note that mpsconfig is a dependent jar and is used by the other MPS packages. You will need to build new versions of these packages to use the new version of mpsconfig.
  • No labels