DIM-PVSS dictionary

This document is a working document between Pietro and Ombretta to define exactly data exchange between TOF Linux PC having optical link connection with TOF crates and top PVSS layer for TOF.

Crate FedServer specifications

All commands and services are accessible with postfix _ where <DRMID) ranges from 0 to 71. (nota: la lista seguente e' parzialmente incompleta perche' mancano molti comandi relativi a DRM FIXME).

Commands and services are based on a FSM organized at single VME slot level.

DIM Commands available ("single action") on Crate FedServer

xx refers to CrateId

Even tags identify commands where only one value is submitted. It is always possible, when relevant, to submit a value lists. For example

ENA_SLOT_21 1 2 3

will enable slots 1, 2 e 3 on CrateId 21.

Odd tags identify commands where a pair of value is submitted. It is possible to specify pairs lists. For example

SET_PDL_18 8 10

will set PDL 8th to value 10 on CrateId 18.

ENA_CHAN 5

ENA_ commands follow convention that if a negative value is passed the target will be disabled. For example:

ENA_SLOT_31 -6

will disable slot 6 on CrateId 31

DIM Commands ("FSM" transition) available on Crate FedServer

These commands correspond to complex action, normally used during FSM State Transition. They apply to single slot and accept just a value (or a list of values).

GOTO_READY_37 2 3 4 5 6 7 8 9 10 11 12 1

(order is important! 1 must be the last one)

DIM Commands ("PVSS" info ) available on Crate FedServer

These commands correspond (Bits 6 and 7 set) to information sent by the PVSS to make them available to the FedServer.

The DCS_COM fields are type, param and a generic message. This generic command is used to distribute information as well as to send "super-commands" to the FED Software layer.

Below the defined types:

The READY_LOCKED state for the top node of the FSM should generate the following DCS_COM message: 2 3 string

DIM Services available on TOF Crate FedServer

xx stands for crateId.

Please note that a custom msg type has been created (FED_MSG_BOOT = 0x80). This message is published when the vmesrv is booted. The PVSS application, when that message is published by crate xx, will force update of commands SLOT_PW_xx, signalling slot power status to the booted server.

A TOF_SLOT_xx (for each of its 12 values corresponding to the different slots) can assume the values listed in the table below

Nota per la procedura di START/STOP RUN

* quando viene inviata una richiesta di START run di ALICE da ECS a DAQ, AliceTOFDCS e TRIGGER, il AliceTOFDCS TOF dara' l'ok all'ECS a procedere alla DAQ di TOF solo e soltanto quando per tutti i crate TOF inclusi, tutti gli slot inclusi nella configurazione richiesta saranno in READY mode e non prima. * quando viene inviata una richiesta di STOP run di ALICE da ECS a DAQ, AliceTOFDCS e TRIGGER, il AliceTOFDCS TOF inviera' ai crate TOF il comando GOTO_STDBY_CONFIGURED a un dato crate soltanto dopo che la DAQ avra' dichiarato che tale crate (cioe' quella data DDL) non e' piu' in data taking.