TBPM Front-End Software Design Review L.Piccoli April 20 2004

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

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

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

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

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

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

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

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

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)

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

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

Class Diagram