Case Study: Adding "-> Logbook..." to CSS Data Browser

Deciding on the level of integration

...

I decided to use the "very low level" of integration, because that seems like the easiest way to work with CSS.

http://css.desy.de/content/e760/e761/index_eng.html^{Image Modified}

Checking out CSS source code

...

Installation of Mercurial

• Download Mercurial source code from http://mercurial.selenic.com/release/mercurial-1.6.4.tar.gz^{Image Modified}
• Type "make local" in the top directory
• Install MercurialEclipse
  • http://www.javaforge.com/project/HGE#download^{Image Removed} (update site is fine)
  Clone , too, but don't use it as such need clarification from Kay & Co.

  Clone the CSS repository

• http://sourceforge.net/apps/trac/cs-studio/wiki/SourceRepository^{Image Modified}
  • Use 'read-only' => http://cs-studio.hg.sourceforge.net:8000/hgroot/cs-studio/cs-studio^{Image Modified} (no account/password)

    More heap space

    Increase memory for Eclipse

    needed

• Edit eclipse.ini in $ECLIPSE_HOME (768 1024 MB is what I haveended up with)

  Java 1.6 needed for some

  Import the necessary CSS plugins as Eclipse projects

• Developing The minimum list of plugins to develop with DataBrowser need clarification from Kay & Co.
  Image Modified

  Checkout HLA projects from CVS

  Create the edu.stanford.slac.save2logbook plugin for HLA code

• Copy the Save2Logbook source to this plugin and configure it for use by DataBrowser

  Add the dependency to edu.stanford.slac.save2logbook to the DataBrowser

  Adding existing HLA code/library Wrap as a

  plugin

• Eclipse bug: Start If plugins panel is empty, start typing the plugin name before selecting a plugin you depend on

  Modify DataBrowser and Save2Logbook plugins

• Add JFace Button, called '-> Logbook...'
• Add JFace ActionListener to generate an Eclipse (Graphics) image
• Add a method in Save2Logbook that saves an Eclipse image as a JPEG file

  Test by running DataBrowser as an Eclipse application

  Create a SLAC DataBrowser product

• Select CSS Data Browser as the application
• Modify CSS splash

  Export SLAC DataBrowser to some directory

  When launching SLAC DataBrowser for the first time, configure EPICS and DataBrowser EPICS preferences

Major To-Dos

• Headless build
• "Workspace in use" issues

Resources

How to develop with CSS

• Overview https://ics-web.sns.ornl.gov/css/EPICS2010Intro/EclipseCSSDevIntro1.pdf
• Demos http://css.desy.de/content/e70/e10/index_eng.html
• JavaDoc http://css-javadoc.desy.de/
• Plugins http://css.desy.de/epicsgroup/css/content/e428/e396/e402/e491/CSSPluginOverview.htm
  • DAL
    • http://css.desy.de/content/e428/e791/e1323/e1324/index_eng.html
    • http://css.desy.de/content/e428/e791/e1296/e1344/index_eng.html
  • Preferences
    • http://sourceforge.net/apps/trac/cs-studio/wiki/HierarchicalPreferences
    • http://css.desy.de/content/e428/e1596/e1597/index_eng.html
  • Messages
    • http://css.desy.de/content/e428/e339/index_eng.html
    • Server http://sourceforge.net/apps/trac/cs-studio/wiki/JavaMessageServer
    • Log http://sourceforge.net/apps/trac/cs-studio/wiki/MessageLog
  • Authentication and Authorization http://sourceforge.net/apps/trac/cs-studio/wiki/AuthAndAuth
• Mailing list http://sourceforge.net/mailarchive/forum.php?forum_name=cs-studio-core

...