STUDY OF CONTROL SYSTEM STUDIO (CSS) AND DEVELOPMENT OF CONTROL PANEL FOR PF AR VACUUM DISPLAY

Transcription

1 STUDYOFCONTROL SYSTEMSTUDIO(CSS) ANDDEVELOPMENTOF CONTROLPANELFOR PF ARVACUUMDISPLAY PrachiChitnis RRCAT,Indore,INDIA 23Feb,2010 1

2 INDEX Pageno. SYNOPSIS 3 CHAPTER 1 INTRODUCTION 4 CHAPTER 2 DOWNLOADINGANDINSTALLING 8 CHAPTER 3 GETTINGSTARTED 11 CHAPTER 4 SYNOPTICDISPLAYSTUDIO 15 CHAPTER 5 ADLCONVERTER 20 CHAPTER 6 PVTABLE 21 CHAPTER 7 PROBE 22 CHAPTER 8 PF ARVACUUMPANELDESIGNINCSS 23 REFERENCES 24 2

3 SYNOPSIS The research activity involved the study of the Control System Studio(CSS), which is the Integrated Development Environment (IDE)for development of full fledged control system applications.itisaneclipserichclientplatformbasedide,andisusedtodesignanddevelop controlsystemsbasedonepics,tango,tineetc. TheworkinvolvedthestudyofvarioustoolsavailableinCSS,likeSynopticDisplayStudio(SDS), ADLConverter,Probe,PVTableetc. TheworkalsoinvolvedthedevelopmentofcontrolpanelsforPF ARVacuum.Twopanelsare createdforthedisplay.thefirstoneisanexactreplicaofthepreviouspanelthatwasdesigned indm2k.thesecondoneisthemodifiedversionwithgradientcolorcoding.thecolorgradient iscodedinjavascript. Finally,atwodaytraining presentationforcsswasgiventothekekbcontrolsgroup. 3

4 CHAPTER1INTRODUCTION CONTROLSYSTEMSTUDIO The Control System Studio (CSS) is an Eclipse RCP based development platform and the fundamentformanyapplicationslikeepics,tangoetc.asmostoftheseapplicationsdealwith processvariablesandconnectionstocontrolsystems,thecsscoreprovidesthenecessaryapis foraconvenientstart. The integrated development environment of CSS provides facility for database development, alarmmanagementsystem,displaydevelopmentandconversion,datatrending,diagnostictools etc. The Data Access Layer (DAL) is the core of the connection APIs. It communicates to EPICS throughcaj(channelaccessjava),whichisapurejavaimplementationofthecaprotocol.in the(near) future it will be possible to connect to TINE and TANGO control systems through DALaswell.ATINEintegrationisalreadyavailableasBeta.DALisaninherentpartoftheCSS CorebutcanalsobeusedasalibraryinanyotherJavaapplication.SimpleDALisaconnection layerbuiltontopofdal.itprovidesaslim,lesscomplexapithatallowsforamucheasierstart fordevelopersdealingwithprocessvariablesintheirapplications.usingsimpledalimpliesa certain syntax for process variable addresses that enables applications to make use of the followingfeatures: Accessdifferentcontrolsystems(e.g.TINEandEPICS)inoneapplication usecharacteristics,aconceptforresourcesavingaccesstorecordfields queryprocessvariablesindifferenttypes usesimulatedchannels addresssystemfunctionsasprocessvariable 4

5 TherearevariousutilitiesavailablewiththeCSSsuchas: Displayapplications(e.g.TheSynopticDisplayStudio). Alarmingtoolsandapplications. Trendtoolsandapplications. DiagnosticTools Diagnostictoolsandapplications. Configurationtoolsandapplications. Managementtoolsandapplications. Editors Utilities Processvariableaddresssyntax Thegeneralsyntaxofaprocessvariableaddressisdefinedasfollows.Thisusesthemetasyntax basedontheextendedbackus NaurForm [1]address::=[protocol]id[type] [2]protocol::=('dal epics' 'dal tine' 'dal tango' 'local')'://' [3]id::=(letter specialcharacter)+ [4]type::=','('double' 'int' 'long' 'string' 'enum') [5]letter::='A'... 'Z' 'a'... 'z' [6]specialcharacter::=':' '/' '\' '.' '[' ']' [7]number::=digitWithoutZero(digit)* 5

6 [8]digit::='0'... '9' [9]digitWithoutZero::='1'... '9' Thereare3optionaland1mandatoryfragmentsthatconstituteafullprocessvariable address(line1). The protocol(line 2) is optional and defines the connection protocol. If a prefix is not specified,adefaultprotocolischosenaccordingtothesettingsofthecss Core/Control Systempreferencepage. The id (line 3) is mandatory. It must be a globally unique name identifying the informationyouwanttoaddress. Thetype(line5)isoptional,too.Itcanbeusedtospecifytheexpectedreturntypefor channelvaluesexplicitly. SyntaxforEPICS WhenEPICSchannelsareaddressed,line3isasfollows: [3a]id::=recordname['.'fieldname][characteristic] [10]recordname::=(letter specialcharacter)+ [11]fieldname::=(letter)+ [12]characteristic::='['(letter)+']' AnEPICSprocessvariableisalwaysidentifiedbyitsrecordname(line10)which isthereforemandatory. Optionallyafieldnamecanbeprovidedtoaddressasinglefieldofarecord(line11).If nofieldnameisprovidedtheaddressdefaultstothe.valfield. The characteristic (line 12) is optional as well. If defined it allows for accessing additional information of a record without establishing a new connection. All characteristicsofthesamerecordsharethesameconnection.soingeneralitisagood ideatousecharacteristicswheneverpossibletosavesystemresources.thesecanbe [Position] position [Description] longdescription [displayname] shortdescription [propertytype] type [resolution] number of bits used for ADC conversion of analog value when sampled [minimum] minimumallowedvalue [maximum] maximumallowedvalue [graphmin] minimumallowedvaluewhendisplayed(e.g.inachart) [graphmax] maximumallowedvaluewhendisplayed(e.g.inachart) [format] Cprint fstyleformatthatisusedtorenderthevalue [units] unitsofthevalue [scaletype] scaletypeforplotting(linearorlogarithmic) [warningmax] upperwarninglimit [warningmin] lowerwarninglimit [alarmmax] upperalarmlimit [alarmmin] loweralarmlimit [sequencelength] sequencelength [enumvalues] enumvaluearray(returnsobject[]) 6

7 [enumdescriptions] enumvaluedescriptions(returnsstring[]) [bitdescriptions] bitdescriptions(returnsstring[]) [conditionwhenset] activebitsignificance [conditionwhencleared] inactivebitsignificance [bitmask] bitsrelevance 7

8 CHAPTER2DOWNLOADINGANDINSTALLINGCSS There are various versions of CSS. The major ones include the DESY and SNS versions. CSS comeswithasubsetoftheallassociatedtoolsdependingupontheversion.thefollowingtable showsacomparisonbetweenvariousversions. Download links Operator Panel Editor Prototype Data Browser, 'Stripchart' live and archived data Post Analyzer Basic fitting and correlation of Data Browser data Probe Inspect live PVs EPICS PV Tree Display a PV's input link hierarchy PACE Table editor for 'critical' PVs RDB Table Generic editor for RDB data System Monitor Memory usage info Therapist Clock Channel Access Client EPICS network library Channel Archive Client Access to 'old' Channel Archiver RDB Archive Client Access to BEAUTY Other Archive Clients Access to AAPI, Data Basic EPICS SNS Office SNS CCR DESY SNS MS Windows MS Windows Full SNS DESY CSS Mac OS X x86 Mac OS X x86 Sources site RH Linux x86 RH Linux x

9 Logger,... PV Utility Map Devices and IOCs to PVs Rack Utility Locate devices in racks PV Fields View EPICS record info for PVs SNS ELog Support Interfaces various tools to SNS ELog Message Log Viewer Viewer for the CSS Message log (in RDB, from JMS) BEAST GUI User Interface of the Best Ever Alarm System Toolkit LDAP Authentication & Authorization Login support for alarm GUI and SDS Kerberos + LDAP Authentication & Authorization Login support... Synoptic Display Operator Panel Editor Non-EPICS DAL Clients Network library for TINE,... Screenshot Take screen shots, send to DESY ELog SNL Editor EPICS Sequencer IDE I/O Configurator Tool DESY Profibus Config Tool DCT DESY Database Creation Tool Namespace Tool DESY LDAP Access AMS GUI GUI for DESY alarm management system

10 Generic 'Welcome' Generic CSS Introduction, Channel Access setup info SNS-specific 'Welcome' CSS Introduction with SNS Example PVs DESY-specific 'Welcome' How to download optional plug-ins No Specific Settings Channel Access, Archive etc. not configured Settings for SNS Office Network Setup for SNS CA Gateway and Archives Settings for SNS CCR Setup for SNS CCR IOCs etc. Settings for DESY Setup for DESY Kerberos, LDAP, JMS etc. Legend: Included, Optional online update. - - DOWNLOADINGANDINSTALLATION ItisrecommendedthatthestandardversionofCSSshouldbedownloadedforthefirstuse.It consistsofthecssplatformandcommoncontrolsystemapplications. 1) Pre requisites Javaversion1.6orhigherisrequired 2) Download Thelinktothisishttp://css.desy.de/content/e413/index_eng.htmlPlease choosetheversionaccordingtoyouroperatingsystem. 3) Extracting extractthedownloadedzipfileinadirectoryofyourchoice. 4) Starting a. Windows Runthefilecss.exeunderCSS<Top>. b. Linux Setexecutablemodeforthefile css undercss<top> 5) Login TheXMPPlogincanbecancelledforinitialuse.Thisloginsyouasanonymous user into the XMPP server specified in the preferences. The XMPP server is used for remotemanagement.onecanalsosetuphisownxmppserver. 10

11 CHAPTER3GETTINGSTARTED WhenyoustarttheCSSforthefirsttime,itwilllooklikethis: CSSMenuBar AllfeaturesoftheCSSareaccessiblethroughtheCSSMenuBar.Itprovidesthefollowingmenu entries: FILE CSS New Createanewfolder,resource, SwitchWorkspace ChangetheworkspaceoftheCSSinstance. Exportpreferences WritecurrentpreferencesoftheCSSinstanceinafile. OpenWorkspaceNavigator Opentheview'Workspace'. Import ImportresourcefromCVSintheworkspace. Exit ShutdownyourCSSinstallation. AllavailableCSSapplicationsarelinkedintotheCSSmenu.DependingontheCSSdistribution thismenuprovidesasubsetofthefollowingentries. 11

12 Display Display applications (e. g. The Synoptic Display Studio, PV table, ADL converter). Alarm Alarmingtoolsandapplications Trends Trendtoolsandapplications(Databrowser) DiagnosticTools Diagnostictoolsandapplications.(EPICSPVtree,probe) Configuration Configurationtoolsandapplications.(DCT,contacts) Management Managementtoolsandapplications. Editors Utilities(clock,therapist,systemmonitor) Preferences Open the central CSS configuration dialog that provides access to all CSS settings. QUICKSTART TheQuickstartmenuholdslinkstoSynopticDisplaysintheworkspace.Theycan beaddedviacontextmenuofadisplay. WINDOW HELP OpeninNewWindow OpenanewCSSwindow. Open Perspective Select and open a particular CSS perspective. In the CSS context, a perspectiveisasetofuserinterfaceelementsthatarepositionedinacertainway. ShowView OpenaparticularCSSview.IntheCSScontext,aviewisanelementofthe userinterfacethatdisplayssomethingandcanbefreelyarrangedbytheuser. Welcome AboutCSS Openthe About dialogthatcontainsthecsslicenseagreement. Help Contents Open the CSS help system. There you may find a more detailed descriptionofthebasicuserinterfaceconceptsandallsystemsettings. KeyAssist Openanoverviewofallshortcuts. Cheat Sheets Shows available Cheat Sheets. Cheat Sheets are step by step documentations. SoftwareUpdates ManagethelocalCSSinstallationbyinstallingandupdatingfeatures. >findandinstall >searchfornewfeaturestoinstall >DESYCSS 12

13 CSSConsole TheCSScontainsitsownconsole.Thisconsoledisplaysystemmessagesofcertaineventsand informationaboutoccurrederrors. SynopticDisplayStudio(SDS) SDShasitsownperspective:Menu'Window' 'OpenPerspective' 'DisplayDevelopment'. Therearesomeexampleandtrainingdisplaysintegratedthatdemonstratesthefunctionalityof SDS: Menu 'CSS' 'Install Synoptic Display Demo Displays'. The training displays are in the workspacefolder'sdsdemodisplay/training'. For some displays a SoftIOC with special EPICS databases (Folder /SDS Demo Display/Training/EPICS_DBs_TrainingIOC) is necessary. A SoftIOC for MS windows can be foundonthecsshomepage.thedatabasesarepartofthatdistribution.forotherosyoucan copytheepicsdatabasesfromthesdsdirectorymentionedabovetoyouriocloaddirectory. TherearealsosomehelppagesavailableinCSS LOADINGCSSPLUGINS CSSplug insarethevarioustoolsavailablewithit.toaddtheseintothecss: 1. GotoCSSmenu >Help >Softwareupdates >FindandInstall 2. Select Selectfornewfeaturestoinstall 3. Selectthecheckboxfor Controlsystemstudioupdatesite 4. Click Finish 5. Expandthetreefor Controlsystemstudioupdatesite 6. Selecttheplug inyouwanttoinstallandclick selectrequired button. 7. Go next andacceptlicenseagreement. 8. Nextandclick Finish 9. Theinstalledplug inwillnowappearinthecssmenuunderappropriatecategory SETTINGEPICSPREFERENCES ThissettingisusedtospecifytheEPICSIOClocationandotherattributes 1. GotoCSSMenu >CSS >Preferences >CSScore >Controlsystem 2. SetthedefaultcontrolsystemasEPICS 3. UnderCSScore,gotoEPICS 4. SettheEPICSpreferenceshere. 13

14 CSS BASICTERMSANDCONCEPTS TheGraphicalUserInterface(GUI)oftheControlSystemStudioisbaseduponthefollowing concepts: Views Aviewisawindow likeuielementthattypicallyprovidesa view ondata.thecontrolsystem Studioanditsapplicationsprovidevariousviews.Theyareresizableandcanbefreelyarranged withinthecssmainwindow.viewsmayprovidetoolbarsthatyoucanusetoconfiguretheview. Ifyoustackviewsontopofeachotheryoucanselectthetopviewbyclickingonitstab.Despite theirname,viewscanbeusedtochangethedisplayeddata.everychangetoanitemofaviewis savedimmediately. Editors Aneditoristypicallyusedto edit thedataitdisplays.itsharesmanyfeatureswithviews.the maindifferencebetweenviewsandeditorsisthataneditorsaveschangestoitsitemsonly whenyouexplicitlychoosetosave.thereisonlyoneplaceinthecssmainwindowwhere editorscanappear.thisplaceiscalled editorarea. Perspectives Aperspectivedefinesanarrangementofvariousviews.Certainmenuortoolbarentriescanbe associatedtoaperspective. 14

15 CHAPTER4SYNOPTICDISPLAYSTUDIO SynopticDisplayStudio(SDS)isagraphicaloperatorinterfacethatrepresentsthestructureand currentstateofaplant.thestructureiscomposedofbasicelementssocalledwidgetslikelabels, metersorbargraphs.tobuildupapartofaplantthewidgetscanbearrangedintheeditmode ofsdsondisplays.intheexecuteorrunmodetheoperatorscancontroltheprocessesviathe displays. Navigator ThenavigatorviewshowstheCSSprojectsintheworkspace.ACSSprojectholdsthe configurationfilesforsdsdisplaysandfilesofothercssapplications. Editor/Palette TheEditorshowsthedisplaysintheeditmodeandprovidesgrid,align,ruler,etc.Ontheright sideisthepalettewithallavailablewidgets.thereisadraganddropsupportthatconnectsa processvariablefromanothercssapplicationautomaticallywithawidget. WidgetProperties Foreachselectedwidgetintheeditorthewidgetpropertyviewshowsallavailableproperties. Itispossibletodynamiseeachproperty.Thatmeansthatapropertyisconnectedtoaprocess variableandchangeswiththevalueofthevariable. Therearetwokindsofproperty 1. Static fixedduringexecutionmode 2. Dynamic changesduringexecutionmode STATICPROPERTIES SingleleftclickonapropertyonthePropertyViewsetsastaticproperty.Singleleftclickona propertyopensaneditor.therearesixgeneraleditors: Enteratext Enteranumber Chooseacolor Chooseafont Setaboolean Selectacomboitem Andthreespecialeditors: Add/changealiases Add/changeactions Generatetooltip 15

16 LAYERMANAGEMENT: ToopentheLayerManagementMenu: Window >ShowView >Other >SynopticDisplayStudio >LayerManagement Insidethelayermanagementview,rightclicktoaddnewlayer,ormoveexisting Visibilityandorderofalayercanbechanged Visibilityofalayercanbetoggleddynamically Rightclickawidgettochangeitslayer DYNAMISATIONOFPROPERTIES Propertiesthataredynamicaremarkedwithagear wheel.toeditthedynamicbehaviorofa widgetpropertyrightclickontheappropriateoneinthepropertyviewandselect'configure DynamicAspects'. Thesimplestwayofdynamisationistoshowthecurrentvalueofaprocessvariableinthe display.theruleis'directconnection'.channelnamecanbetypeddirectlyhere,oranaliascan beusedinsteadofapvname Dynamicpropertiescanbeconfiguredbyrules(explainedlater) EachwidgethasaPrimaryPV, o o o ItisusedwhenyoucopyPVtoclipboard Forwardedtotheapplicationscalledbycontributionmenu Tiptext SoitisnecessarytodefineaprimaryPV ALIAS AliasisamacrothatcanbeusedinsteadoflongPVnameorsyntax.Ifthereisanaliassetfora processvariableitcanbeusedinotherpropertiesofthewidgettomaketypingeasier.itis markedbythesymbol'$'atthebeginningandendofthestring.eachwidgetcanhaveseveral aliases(e.g.fordisplayingseveralplotsonstripchart).aliascanbeforwardedtoanewdisplay also. 16

17 CONNECTIONSTATES Thebackgroundcolorchangesaccordingtotheconnectionstates(connectionlost,connected, unknown,initial).thecolorsforthesestatescanbecustomized.forthis 1. Rightclickonbackgroundcolorproperties 2. Configuredynamicaspects >Next 3. Addorremoveconnectionstatesbyrightclick 4. Editcolors RULES Rulescanbeusedtodefinethedynamicbehaviorofwidgetproperties.Therearetwotypesof rules;javarulesandecma/javascriptrules.itisrecommendedthatjavascriptrulesshouldbe usedforconfiguringdynamicpropertiesinsteadofjava,asnocompilationisneededinthiscase. Scriptedrulefilesshouldbekeptat SDSScriptRules folderundertheworkspace Rules InthetoppartoftheWindow'DynamicsWizard'isalistofallavailablerules.Therearetwo kindsofrules.the'javarules'markedwith areimplementedasajavaclass.theyare integratedinsdsanditisnecessarytoeditthesourcecodeoftheplug instoaddnewrules.the 'ECMAScriptRule'or'JavaScriptRule'markedwith arelocatedinthecssworkspaceinthe folder'sdsscriptrules'.toaddanewruleyouhavetostorethejavascriptfileinthefolderand itisavailablefortheproperties. RuleFilter 17

18 Theselectionofrulesinthelistdependsonthetypeofproperty.Thereturntypeoftherulehas tomatchthepropertytype.inthefirstlineoftherulethereturntypeisset.itispossibletouse alljavatypesasreturntypes. Parameter Thelowersectionholdsthelistofinputandoutputchannelsthattheruledefines.Inthevalue fieldyoucanusethealiasnamesthataredefinedinthewidgetordisplayinsteadoftheprocess variablename.itismarkedbythesymbol'$'atthebeginningandendofthestring. ACTIONDATA Actiondatasettingdefinestheactionwhichisperformedwhenawidgetisactivated(i.e.saya buttonisclicked) Actionscanbeoftwotypes Sendingvalue Openadisplay Eachwidgetcanhavearbitraryno.ofactiondata Actioncanbeexecutedfromthecontributionmenuaswell.Thecontributionmenuisinvoked byrightclickingawidget >CSS ><contributionmenu> CURSORS Cursorcanbechangedasthemousepointermovesoversomewidget Widgetpropertieshaveafieldforchangingcursor Therearetwokindofcursors 1. Systemcursors 2. Other actionenabled,actiondisabled DEFAULTDISPLAY 1. DefaultdisplayisthedefaultSDSfilewhichopensthroughthecontributionmenu (opendisplay) 2. Tosetthedefaultdisplaygotomainmenu >CSS >Preferences >CSSApplications >Display >DefaultDisplay 3. Setthedefaultfileandthealiasname QUICKSTART 1. QuickstartmenuisusedtoaddshortcuttoruntheSDSfilesdirectly. 2. TheSDSfilesaddedtoquickstartmenuwilldirectlyopeninexecutemode 3. Toaddfilestoquickstartmenu,rightclicktheSDSfileinnavigatorpane >addto quickstart 18

19 4. Toinvokedisplaysdirectlyfromquickstart,gotomainmenu >quickstart >(click filename) 5. Toeditquickstartpreferencesgotomainmenu >CSS >Preferences >CSS Applications >Utilities >Quickstart 19

20 CHAPTER5ADLCONVERTER TheADLConverterisaCSSPlugInthatconvertsControlSystemDisplays.Thisconvertsonly fromadl FormattotheSynopticDisplayStudioformatfromtheControlSystemStudio. 1. TostartADLconverter,gotomainmenu >CSS >Display >ADLConverter 2. Click File touploadmedm/dm2kfile(.adlfile) 3. Selectpathofdirectoryforthedestinationfile(i.e.forthecss sdsfile) 4. Clickconvert 5. Multiplefilescanbeconvertedatonce 6. Addmultiplefilesbyaboveprocedure,oraddfolderwhichcontainsmultiplefiles (Subfolder;) NewConversion ToconvertothersetofADL Files,clearthelistby"Clear"buttonandchoosethenewADL Files andanewtargetworkspacepath.thenstartthenewconversion 20

21 CHAPTER6PVTABLE ThePVTableprovidesatabularviewofPVnamesandtheircurrentvalue.Onecanstartand stoplivevalueupdates.inaddition,onecantakea"snapshot"ofcurrentvalues,whichgets savedwhensavingthepvtabledocument.thepvtabledisplayindicatescurrentvaluesthat differfromthe"snapshot"valuesinred. Onecanconfiguretheupdaterateaswellasthethresholdforindicatingdifferencesbetween thecurrentvaluesandthosefromthesnapshot. TostartwithPVtable 1. Gotomainmenu >CSS >Display >PVTable 2. Rightclicktheemptyareainthetable > 3. WritethePVnametobemonitored,goonaddingnames 4. AgreenLEDsymbolatthetopiconbarisforstartingtheupdatesinPVtable. 5. TheupdateratecanbeconfiguredbyrightclickonthePVtable >config 21

22 CHAPTER7PROBE TheProbetoolallowsbasicreadingandwritingofPVs. Usage 1. EnteranameintothePVnametextboxandenter.Thetoolwilldisplaythecurrent valueofthegivenpvtogetherwithtimestampandstatus. 2. The'Adjust'checkboxopensadialogforwritinganewvaluetothePV. 3. Thestatusbarprovideserrormessages.IfallisOK,itdisplaysaslowlyaveragedupdate rateofthepv. 4. Italsodisplaysalarmzonesonthemeter 5. Themetercanbedisabledalsofromthe Meter checkbox 22

23 CHAPTER8PF ARVACUUMPANELDESIGNINCSS ControlpanelsforthePF ARVacuumaredesignedinSynopticDisplayStudio.Twopanelsare createdforthedisplay.thefirstoneisanexactreplicaofthepreviouspanelthatwasdesigned indm2k.thesecondoneisthemodifiedversionwithgradientcolorcoding.thecolorgradient iscodedinjavascript. Thedetailsofthefileare: 1. C:\css win32\css win32\css\workspace\prachi\pfarvacold.css sds Replicaofthepreviouspanel 2. C:\css win32\css win32\css\workspace\prachi\pfarvacnew.css sds Themodifiedversion 3. C:\css win32\css win32\css\workspace\sdsscript Rules\continousColorb2r_dis.css sdss Colorgradientscript 4. C:\css win32\css win32\css\workspace\prachi\wide_rainbow.gif GIFimageplacedonthepanel Thesynopticdisplayfilesarealsoaddedatthequickstartmenu. 23

24 REFERENCES Documentationfromhttp://css.desy.de CSSHelpandTrainingExamples 24