Instructions on How to Use the New Version of Cerberus

8/20/2019 Instructions on How to Use the New Version of Cerberus

1/27

Instructions on how to use the new version of Cerberus.

The program.

The program gets all its information from Argus over the network when in operation

and makes no contribution to the logical operation of the interlocks. It just reports

what it is told.

The program currently updates at 5 Hz.

The program gets its knowledge of which room it is in from the name of the computer

e.g. CERBERUS00 to CERBERUS07. CERBERUS0 is the test / spare machine (however

IP addresses are allocated to machines and PLCs by hand).

The code makes some consistency checks on the data to see if something has failed(reported as ‘BROKEN’ on the layout diagram). If it finds an inconsistency it reports it

on the screen immediately and if it is present for more than one second (to allow for

the possibility of network messages getting out of phase) it beeps (through the

speakers) once each time round the loop until the failure is rectified. The checks are –

• If a door is reported from two different rooms and the data is in conflict.

• If htt i tdf t diff t dth dtii flit


2/27

• If htt i tdf t diff t dth dtii flit

The program is configured from a text table in a file called ‘layout.txt’ without any

change to the compiled code. It can be configured for any laser configuration currentlywith an upper limit of up to 20 rooms and 100 each of doors, shutters, lasers and

enclosures (although this upper limit can be trivially changed, almost without limit).

Numbers need not be contiguous.

The file ‘Layout.txt’.

The whole program is defined by a text file called ‘layout.txt’ which can be saved and

restored for different application using operating system commands.

It can be entered / edited using any text editor e.g. Notepad, Word (provided it is

saved as a .txt file) etc.

There is a command per line. Line breaks are not allowed.

Each line terminated by a semi-colon (;).Anything after the semi-colon is treated as a comment.

An exclamation mark (!) at the beginning of a line defines that line as a comment.

Separators are a space or a / (which ever helps to make sense of the command).

Commands can occur in any order (but it is wise to group them). Not all commands

( ifd i t idbl itth idd bit iti )


3/27

A fully working example of this file is provided later.


4/27

The key words are –

A. Key words that can occur at the beginning of a line -

TestMode

This switches the program into a stand alone test mode enabling Cerberus to be set up

and tested on your local computer; giving you the opportunity to change the bit

information. When it is commented out (!TestMode ) the program will run in

production mode and get its bit information from Argus over the network.

There are no parameters (and, remember, the line must end with a semi-colon).

Recording

This turns on the recording of (and the ability to playback) the changes in the bit

pattern with a date and time stamp (not yet implemented).

BitPattern

Thidfi h thbit tt ( dthttbit h kb )id th


5/27

This defines a message to be written to the layout screen at the specified position in

the specified colour when a bit is set. It is followed by a number in the range 0 to 99and keywordsTitle,Colour, orMessageBit.Title is of the format ofTitlewith an

optional integer at the end defininf the font size (if it is missing the default is 8 point).

Colour is followed by the foreground and background colours in the format of

Colour.Messagebit is followed byOn orOff and a bit in the format ofBit.

Room

This defines the parameters for a room. It is always followed by the room number and

can then be followed by a key word fromTitle,Corners,NotTrippedBitPosition,

HazardousBitPosition,EmptyBitPosition,SearchingBitPosition,

AuthorisingBitPosition,EditInfoBitPosition,ServiceModeBitPosition,Sound,

ShowBeamStops ,Connection, IPAddr, EditInfoRoomScreen orDoorDisplay.

A room consists of an outline and a title with the possibility of associated comments.

It is drawn in black.

Door

Thidfi th t f d Iti l fll db d b d


6/27

This defines the parameters for a laser. It is always followed by a laser number and can

then be followed by a key word from Title,Position,Beam,InRoom,OnBitPosition,ComingOnBitPosition andNoHazardInRoom.

The laser consists of a title with the possibility of associated comments and a

rectangular box with a beam drawn from it. The rectangle is drawn solid if the laser is

on and hollow if it is off. It is drawn in green.

Enclosure

This defines the parameters for an enclosure. It is always followed by an enclosure

number and can then be followed by a key word from Title,Corners,InRoom,

ClosedBitPosition,HazardousBitPosition orOverriddenBitPosition.

The enclosure consists of a title with the possibility of associated comments and arectangular box. The rectangle is filled if the enclosure is hazardous and hollow if it is

not. If the enclosure is open then one side is not drawn. It is drawn in purple.

BeamStop

Thidfi th b t h tt td th d dil if


7/27

This defines the corners for rooms (up to 10 corners) and enclosures (up to 4 corners).They are pairs of numbers indicating the X and Y positions of the corners (it can be

helpful in long lists of numbers to use the / as a separator). The code completes the

line from the first to the final co-ordinate.

NotTrippedBitPosition(used after room)

This defines the bit information that indicated that the room is tripped. It is reported

after the room title and a voice message is issued if not turned off. It is followed by the

bit position (see above).

HazardousBitPosition(used after room)

This defines the bit information that indicated that the room is hazardous. It isreported after the room title and the room is flood filled with light red. It is followed

by the bit position (see above).

EmptyBitPosition(used after room)

Thidfi thbitif ti thtiditdthtth i tIti td


8/27

This defines the bit information that indicates that the information for a room on the

door / wall display can be edited. It is set by a protected button the touch screen inthat room. It brings up a box on the layout screen that enables the authorised person

to edit the information and then exit or cancel the operation. It is followed by the bit

position (see above).

EditInfoRoomScreen (used after room}

This indicated the room containing the layout screen which will be used to edit the

information for this room. If it is not specified then it will default to be the same as the

room number.

Sound(used after room)

This defines whether a room will use sound output or not. It is followed by the keywordOn orOff.

ShowBeamStops(used after room)

This defines whether the door / wall display for a room will show beam stop

if ti Itifll db thk dO Off


9/27

display for this room are always shown on screens 0 and 1 respectively. A graphics

card must be provided to provide enough screens to satisfy this command or these

commands as it can be repeated until all screens are used.

OpenPosition (used after doors and shutters)

This defines the position of the open device. It is followed by 4 numbers showing X1,

Y1, X2 and Y2 for the position on the screen.

ClosedPosition(used after doors and shutters)

This defines the position of the closed device. It is followed by 4 numbers showing X1,

Y1, X2 and Y2 for the position on the screen.

OpenBitPosition (used after shutter)

This defines the bit information that indicated that the item is open in the case of a

door or fully open in the case of a shutter. It is used to draw the device on the screen.

It is followed by the bit position (see above). If a door or shutter is reported from two

rooms enter two values for this bit position, otherwise just enter one.


10/27

ClosedBitPosition (used after door, enclosure and shutter)

This defines the bit information that indicated that the shutter is fully open. It is used

to draw the shutter on the screen. It is followed by the bit position (see above). If a

door or shutter is reported from two rooms enter two values for this bit, otherwise just

enter one.

OverriddenBitPosition (used after door and enclosure)

This defines the bit position that indicated the door or enclosure is overridden. It is

reported after the title for that item. It is followed by the bit position (see above). If

there is no override, just leave the line out for this item.

AboutToOpenBitPosition (used after shutter)

This defines the bit position indication that the shutter is about to open. It is reported

after the title for the shutter and via a voice message. It is followed by the bit position

(see above).

InRoom (used after laser, shutter and enclosure)


11/27

This indicated the position where the beam is drawn. It is followed by four numbers

being X1,Y1, X2 and Y2.


12/27

OnBitPosition (used after laser)

This defines the bit position indication that the laser is on. It is used to draw the laser.

It is reported via a voice message. It is followed by the bit position (see above).

ComingOnBitPosition (used after laser)

This defines the bit position indication that the laser is about to come on. It is reported

after the title for the laser. It is reported via a voice message. It is followed by the bit

position (see above).

NoHazardInRoom (used after laser)

This defines the rooms that this laser can not produce a hazard in. It is followed bu anumber of room numbers.

InEnclosure (used after laser)

This indicates the laser is in an enclosure. It is followed by a number which is a valid

l b Ifthl i ti l jt itthili


13/27

Laser (used after connections)

This is used to define which room is the laser room for connections.

Laser (used after BeamStop)

This is used to define the location of the above message.

Room (used after Colour)

This defines the colour that the title and room walls etc. are drawn in.

Background (used after Colour)

This defines the colour that the non hazardous room background is drawn in.

Hazardous (used after Colour)

This defines the colour that the hazardous room background is drawn in.

D ( dft Cl )


14/27

This defines the colour that the hazardous enclosure is filled in.

OnBit (used after Colour)

This defines the colour that the bits are drawn in when they are on.

OffBit (used after Colour)

This defines the colour that the bits are drawn in when they are off.


15/27

Operation in test mode.

If the keyword ‘TestMode’ is present anywhere in the table, then a button will be

drawn at the bottom right hand corner of the screen labelled ‘Test Mode’. This will

open a window with a number of check boxes (drawn to reflect the settings in the

table) which enables the user to change the bits used by the program. In this mode the

data is not requested from Argus via the network. This allows the user to completely

define the operation and look of Cerberus and test it on any computer.

The check boxes are minimally labelled but the function is in order of item number.

There is a spin edit which allows this machine to appear to be in any room for test

purposes.

To make the program operational just comment out TestMode with a ‘!’ and run theprogram. If this is done on a machine not connected to the interlock network the

results will be undefined (and possible catastrophic).

Fully working example

A l ffll ki l fil( i i d)i i bl Th


16/27

Room 0 Connection 4one;Room 0 DoorDisla, 1 150 10;Room 0 DoorDisla, 3 1300 0;Room 0 DoorDisla, 3 1310 30;Room 0 DoorDisla, % 130 0;Room 0 DoorDisla, % 6 1330 %0;Room 0 DoorDisla, 6 ( 130 60;

Room 1 Title &sc*room 510 310 0;Room 1 Corners 500/300 160/300 160/%00 500/%00;Room 1 4otTriedBitosition 1/0/0;Room 1 HazardousBitosition 1/0/1;

Room 1 $mt,Bitosition 1/0/;Room 1 earcingBitosition 1/0/3;Room 1 7utorisingBitosition 1/0/;Room 1 $dit+n'oBitosition 1/0/11;Room 1 er8iceModeBitosition 1/0/1;Room 1 ound &n;Room 1 o2Beamtos &'';Room 1 Connection 4one;Room 1 +7ddr 1(91696.93 0101 16;

Room Title "71 310 0 0;Room Corners 300/10 160/10 160/300 300/300;Room 4otTriedBitosition /0/0;Room HazardousBitosition /0/1;Room $mt,Bitosition /0/;Room earcingBitosition /0/3;Room 7utorisingBitosition /0/;Room $dit+n'oBitosition //3;

i d i i i //


17/27

Room Connection T7;Room +7ddr 1(91696.96 0101 1;

Room % Title T7$ 0 350 0;Room % Corners 10/3.0 300/3.0 300/300 %00/300 %00/6%0 10/6%0;Room % 4otTriedBitosition %/0/0;Room % HazardousBitosition %/0/1;Room % $mt,Bitosition %/0/;Room % earcingBitosition %/0/3;Room % 7utorisingBitosition %/0/;Room % $dit+n'oBitosition %/0/5;Room % er8iceModeBitosition %/0/10;

Room % ound &n;Room % o2Beamtos &'';Room % Connection T7;Room % +7ddr 1(91696.9( 0101 1;

Room 6 Title T7 0 660 0;Room 6 Corners 10/6%0 6%0/6%0 6%0/..0 10/..0;Room 6 4otTriedBitosition 6/0/0;Room 6 HazardousBitosition 6/0/1;

Room 6 $mt,Bitosition 6/0/;Room 6 earcingBitosition 6/0/3;Room 6 7utorisingBitosition 6/0/;Room 6 $dit+n'oBitosition 6/0/10;Room 6 $dit+n'oRoomcreen 0;Room 6 er8iceModeBitosition 6/0/11;Room 6 ound &n;Room 6 o2Beamtos &'';Room 6 Connection T7;

6 dd 1( 16 6. . 0101 16


18/27

utter 1 &enBitosition /0/10 /0/%;utter 1 ClosedBitosition /0/11 /0/6;utter 1 7)outTo&enBitosition /0/1;

utter Title T7$*sutter 330 .0 0;utter &enosition 330 56 3%0 56;utter Closedosition 310 300 330 300;utter +nRoom ;utter 7lso+nRoom %;utter &enBitosition /0/13 %/0/%;utter ClosedBitosition /0/1 %/0/6;utter 7)outTo&enBitosition /0/1%;

utter 3 Title "7*sutter %30 .0 0;utter 3 &enosition %30 56 %%0 56;utter 3 Closedosition %10 300 %30 300;utter 3 +nRoom ;utter 3 7lso+nRoom 3;utter 3 &enBitosition /1/0 3/0/%;utter 3 ClosedBitosition /1/1 3/0/6;utter 3 7)outTo&enBitosition /1/;

utter Title T7*sutter %30 630 0;utter &enosition %30 66 %%0 66;utter Closedosition %10 6%0 %30 6%0;utter +nRoom 3;utter 7lso+nRoom 6;utter &enBitosition 3/0/( 6/0/%;utter ClosedBitosition 3/0/. 6/0/6;utter 7)outTo&enBitosition 6/0/(;


19/27

"aser 3 Title "7*$*1 1100 .0 0;"aser 3 osition 1100 6% 110 (%;"aser 3 Beam 1100 (0 10.0 (0;"aser 3 +n$nclosure 0;"aser 3 &nBitosition /1/.;"aser 3 Coming&nBitosition /1/5;

"aser Title T7:*1 00 110 0;"aser osition 00 5% 0 10%;"aser Beam 00 100 1.0 100;"aser +nRoom ;

"aser &nBitosition /0/(;"aser Coming&nBitosition /0/.;

"aser % Title T7$*1 00 10 0;"aser % osition 00 35% 0 0%;"aser % Beam 00 00 1.0 00;"aser % +nRoom %;"aser % &nBitosition %/0/(;"aser % Coming&nBitosition %/0/.;

"aser 6 Title "7*1 %0 3(0 0;"aser 6 osition %% 00 %%% 0;"aser 6 Beam %%0 0 %%0 0;"aser 6 +nRoom 3;"aser 6 &nBitosition 3/0/5;"aser 6 Coming&nBitosition 3/0/10;

"aser ( Title T7*1 00 660 0;

( i i 00 65% 0 (0(


20/27

Message 0 Title "aser*1*is*on*auto 10 10 0;Message 0 Colour 100/100/100 0/0/0;Message 0 MessageBit //.;

Message 1 Title "aser**is*on*auto 10 0 0;Message 1 Colour 100/100/100 0/0/0;Message 1 MessageBit //5;

C Reason 28/2/05

Next Page - Bit definitions for Test Interlock System (including a blank form).


21/27

Room

Word Bit 15 Bit 14 Bit 13 Bit 12 Bit 11 Bit 10 Bit 9 Bit 8 Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0

0 Item

Meaning

1 ItemMeaning

2 Item

Meaning

3 Item

Meaning

4 Item

Meaning

5 Item

Meaning

6 ItemMeaning

7 Item

Meaning

8 Item

Meaning

9 Item

Meaning

10 Item

Meaning

11 Item

Meaning

12 Item

Meaning

21


22/27

Room 1 (Oscillator Room – Osc)


0 Item Osc Rm Osc Rm Laser 1 Laser 1 Laser 0 Laser 0 Shut 0 Shut 0 Osc Rm Osc Rm Osc Rm Osc Rm Osc Rm

Meaning Service Edit Inf About On About On Full Cl Full Op Authorising Searching Empty Hazard Tripped

1 Item

Meaning

2 Item

Meaning

3 Item

Meaning

4 Item

Meaning

5 Item

Meaning

6 Item

Meaning7 Item

Meaning

8 Item

Meaning

9 Item

Meaning

10 Item

Meaning

11 Item

Meaning

12 Item

Meaning

22


23/27


24/27

Room 3 (Laser Area 4 – LA4)


0 Item LA4 LA4 Laser6 Laser 6 Shut 4 Shut 4 Shut 3 Shut 3 LA4 LA4 LA4 LA4 LA4

Meaning Service Edit Inf About On Full Cl Full Op Full Cl Full Op Authjor Search Empty Hazard Tripped

1 Item

Meaning

2 Item

Meaning

3 Item

Meaning

4 Item

Meaning

5 Item

Meaning

6 Item

Meaning7 Item

Meaning

8 Item

Meaning

9 Item

Meaning

10 Item

Meaning

11 Item

Meaning

12 Item

Meaning

24


25/27

Room 4 (Target Area West – TAW)


0 Item Door 21 TAW TAW Laser 4 Laser 4 Shut 1 Shut 1 TAW TAW TAW TAW TAW

Meaning Open Service Edit Inf About On Full Cl Full Op Authjor Search Empty Hazard Tripped

1 Item

Meaning

2 Item

Meaning

3 Item

Meaning

4 Item

Meaning

5 Item

Meaning

6 Item

Meaning7 Item

Meaning

8 Item

Meaning

9 Item

Meaning

10 Item

Meaning

11 Item

Meaning

12 Item

Meaning

25


26/27

Room 5 (Target Area East – TAE)


0 Item TAE TAE Laser 5 Laser 5 Shut 2 Shut 2 TAE TAE TAE TAE TAE

Meaning Service Edit Inf About On Full Cl Full Op Authjor Search Empty Hazard Tripped

1 Item

Meaning

2 Item

Meaning

3 Item

Meaning

4 Item

Meaning

5 Item

Meaning

6 Item

Meaning7 Item

Meaning

8 Item

Meaning

9 Item

Meaning

10 Item

Meaning

11 Item

Meaning

12 Item

Meaning

26


27/27

Room 6 (Petawatt Target Area – TAP)


0 Item TAP TAP Laser 47 Laser 47 Shut 4 Shut 4 Shut 4 TAP TAP TAP TAP TAP

Meaning Service Edit Inf About On About Full Cl Full Op Authjor Search Empty Hazard Tripped

1 Item

Meaning

2 Item

Meaning

3 Item

Meaning

4 Item

Meaning

5 Item

Meaning

6 Item

Meaning7 Item

Meaning

8 Item

Meaning

9 Item

Meaning

10 Item

Meaning

11 Item

Meaning

12 Item

Meaning

27

Instructions on How to Use the New Version of Cerberus

Documents

Transcript of Instructions on How to Use the New Version of Cerberus