A U.S. Department of EnergyOffice of Science LaboratoryOperated by The University of Chicago

Argonne National Laboratory

Office of ScienceU.S. Department of Energy

IRMIS Technical Details

D. A. Dohan, SLAC EPICS Collaboration Meeting, Apr.26, 2005

2

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

Workshop summary (excerpt)

• Work breakdown – CA client crawlers

- adl,alh – Janet Anderson, APS

- SDDS – APS

- EDL – J. Sinclair

- SNC – R. Chestnut

- CA archiver – SLAC

- Channel Watcher – M. Zelazny

- BURT s/r – T. Birke

- CDEV – T. Birke

- XAL – J.Patton

- CA Security – APS

3

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

(generic) PV_Client Schema

4

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

PV Client Crawlers

• Janet Anderson at APS has built the following PV client crawlers:- MEDM clients (.adl files)- Alarm Handler (.alh)

• The Alarm Handler and MEDM crawlers have been tested at APS

• These crawlers are installed in the tarball- Useful as ‘prototype’ crawler code example

5

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

IOC Table

• generic IOC attribute table added to IRMIS::Base

6

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

PV Crawler Enhancements

• Crawler inserts directly into the RDB- ‘Agnostic’ (Oracle sequences vs MySQL Autoincrement)- 2 sets of DDL - template for different vendor RDBMS

• PV Crawler - minor tweaks- PV schema has remained unchanged- 100% ‘reach’ at APS- BESSY results:

7

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

BESSY results: (email from Thomas Birke)

Don Dohan wrote:

>> Participants in the IRMIS Collaboration meeting:

>> The IRMIS::Base web-site is now available at the EPICS site:

...

Congratulations to this first roll-out.I immediately downloaded this first version and got it running here at BESSY.

The result is: I successfully crawled all of our machine-group IOCs, adl-files and alh-files.

And the PV-viewer works just fine.

There were just little changes I had to make to get everything working (see attached diff-output).

…

I just started writing the crawlers that I volunteered for (burt, cdev,

…

Are there plans to set up a forum/wiki/mailing-list for irmis-related questions/documentation/...?

Greetings from Berlin,you really did a good job.

Thomas

8

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

Enhancements (cont’d)

• SNS PV crawler enhancements- save intermediate ‘path’ results of parsing cdCommands

- should these be in IRMIS::Base – or are they site specific?- possibility: store this information as part of the ioc attr table?

• XAL enhancements- Desktop

• PV Client viewer

• IOC Attribute viewer

9

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

• xal demo of crawler, and link to ioc_table

10

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

Get it

• Go to EPICS main page, then click on the IRMIS tab- IRMIS ‘primer’- Copies of presentations at kickoff meeting- Tarball (with the above enhancements)

- Extensive Readme- Site specific tailoring with site.build.properties file- PV crawler- XAL/CDW framework- Hibernate framework (subset)- PV viewer- IOC viewer- PV Client viewer

11

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

Work in Progress - tying it all together

record

nametypedbd definition

ioc

name

field

typevaluedb load line

component

namelogical numberphysical descriptorserial number

component type

namedescriptionform factormanufacturerfeature sheetfunction

port

nameconnector type

is part of

pin

designator signal name

is part of

conductor

pin_a connectionpin_b connection

cable

colorlabel

client of

ioc attribute

typevalue

record client

typefile path

is a

is part ofis part of

loaded in

is cpuprop of

pv name

12

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

PV <---> Cmpnt relationship

miner

Cmpnt

Editor

App

dev support

cmpnt; port; pin

pv,dbd,st.cmd

dbior

hueristics

The ultimate goal is to create and maintain a hierarchy of control cmpnts. A 'miner' process uses the st.cmd/pv/dbd datastore as the primary source of information. The cmpnt database must capture the hierarchy (ie connection) information, and the goal is to make it concurrent/consistent with the PV database

The expansion of the cmpnt table into master/detail port and pin tables is handled with cmpnt-type port/pin tempates

An additional source for information for the miner are the dbior reports. For example, these are helpful for extracting VXI chassis and MXI connection information.

To complete the scheme to include non-control cmpnts, and to resolve issues that the miner cannot determine strictly from the pv and ds tables, a user application is required to manually create and update a cmpnt-instance rules table. This user application replaces the cmpnt_table editor in vcct2.0, which adjusts the cmpnt table directly.

An externally maintained device support table provides rules that relate an IO string format to a particular component type.

The cmpnt;port;pin tables not only contain the component hierarchical information:- the pin <-> PV relationship is also established, relating EPICS records to hardware components

13

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

• If the miner is run at boot time:- alert user if new records detected without corresponding entries

in the component database. - increase the ‘exhaustive’ coverage of the hardware database

as well as the PV-to-HW connections/links

14

Pioneering Science andTechnology

Office of Science U.S. Department

of Energy

Future

• User/Reference Manual- Tracked to the IRMIS release- Birke: Are there plans to set up a forum/wiki/mailing-list for irmis-

related questions/documentation/...?

• IRMIS Developers Session – ICALEPCS 2005?