1. TBPM Front-End Software Design Review
L.Piccoli
April

2. Contents Generic Framework Diagram Tevatron BPM Diagram Class Diagram
Control Task
Data Acquisition Tasks
Data Buffers and Data Sources
Buffer Readout
Alarms
Triggers
ACNET
Tevatron BPM Diagram
Class Diagram

3. Trigger MOOC/Backdoor Data Source (EchoTek or buffer) Trigger Queue
Acquisition
Task
Data Buffer
Data
TCLK
State Devices
Spawn
Suspend
Resume
Delete
2ms, 1sec
Alarm
Control
Task
Buffer
Readout
Task
Trigger
Alarm Queue
Alarm
Alarm/Clear
TCLK
State Devices
Control request
Triggers
Status
Data request
Alarm
Task
Request Queue
Data
Control Queue
Data request
Mode change
Control request
Alarm
Queue
Task
SW or HW Buffer
MOOC/Backdoor

4. Control Task Receive external commands (from MOOC)
Mode change, set diagnostics, calibration
Control data acquisition tasks
Start, stop, pause and resume
Receive state device changes and TCLKS
Configure EchoTek and timing board on mode changes
TCLK
State Devices
Spawn
Suspend
Resume
Delete
Control request
Triggers
Status
Alarm/Clear
Control
Task

5. Data Acquisition Tasks
Receive commands and triggers through input queue
When a trigger is received:
Get data from a Data Source
Store data into a Data Buffer
A Data Source can be either Hardware or an internal Data Buffer
Data
Acquisition
Task
Trigger Queue
Spawn
Suspend
Resume
Delete
Alarm
Trigger

6. Buffers Data Source Data Buffer Data Buffer is a Data Source
Define operations for retrieving data
Data Buffer
Provide interface for storing data in the front-end memory
Data Buffer is a Data Source
Reading hardware or an internal buffer should be transparent for the Data Acquisition Tasks

7. Buffer Readout Handled by Buffer Readout Tasks
Number of tasks settable
Request comes through the MOOC callback, which makes a request to the Buffer Readout Task
Task selects buffer based on the request
Data is packed according to online specifications (doc #860)
Request Queue
Data
Data request
Buffer
Readout
Task
Data Buffer

8. Alarms Any task can generate alarms within the system
Internal alarms are handled by an Alarm Task
Input alarm queue
Alarm Task decides what internal alarms or combination of alarms trigger an external alarm
Control Task or user command can clear alarm conditions
Alarm Queue
Alarm
Task
Internal
Alarms

9. Triggers Created by Trigger Generators Type of triggers:
2ms, 1sec
TCLK
State Devices
Created by Trigger Generators
Type of triggers:
TCLKs
State Device Changes
Time events (2 ms, 1 sec)
Triggers are sent to the input queues of the Data Acquisition Tasks
Tasks are in a loop doing data acquisition and waiting for triggers

10. ACNET ACNET communication is handled by a set of callbacks, providing:
Standard communication with the system
Reduced number of entry points
Support other communication mechanisms besides ACNET (e.g. backdoor)

11. Injection Turn by Turn Buffer
EchoTek
Queue
BPM
Fast Abort
Task
2ms
Task
Trigger
Trigger Queue
BPM Fast Abort Buffer
Hardware
BPM
Slow Abort
Task
1sec
BPM Slow Abort Buffer
Trigger
Trigger Queue
Data Buffer
EchoTek
Data Source & Buffer
Turn by
Turn
Task
Turn by Turn Buffer
Trigger Queue
Injection
TurnByTurn
Task
EchoTek
Trigger Queue
Injection Turn by Turn Buffer
Buffer
Readout
Task
BPM
Profile
Task
BPM Fast Abort Buffer
Trigger Queue
BPM Profile Buffer
BPM
Display
Task
BPM Fast Abort Buffer
Trigger Queue
BPM Display Buffer
Alarm
BLM
Fast Abort
Task
1sec
Trigger
Trigger Queue
BLM
BLM Fast Abort Buffer
Data request
BLM
Display
Task
Trigger Queue
BLM Display Buffer
Suspend
Resume
Alarm
Alarm Queue
Request Queue
Data
Timing
Control
Task
Alarm/Clear
Calibration
Alarm
Task
Status
Alarm State
Data request
Trigger
Control Queue
Alarm
TCLK
State Devices
Mode change
Control request
MOOC/Backdoor

12. Software Portability Generic framework allows reusability of:
Data acquisition model
Data buffer model
Control model
Event model
Alarm system
Only classes that contain code for the new environment need to be written:
Define control operations (mode change, hardware configuration)
Define data types and structures
Hardware access classes
Specific data acquisition routines
Alarm conditions

13. Class Diagram