1. Sep. 18th 2006 Stefan Koestner FwHw Tutorial ECS-tools for the CCPC/Tell1: How to create a framework component of your hardware and distribute it? challenging Tell

2. Sep. 18th 2006 Stefan Koestner FwHw Tutorial Framework components for hardware types (1)Check webpage if hardware type already exists: http://lhcb-online.web.cern.ch/lhcb-online/ecs/PVSS_DPTs/default.html (2) If yes, you can install the framework component (dplist, etc.) as framework component using fwInstallation tool. If not, create it with the FwHw tool. Note: if you want it to be used in boards of both types ‘SPECS’ and ‘CCPC’ define it as ‘GENERIC’. (it will adapt automatically when inserting into parent board) (3) Create a framework component (what this tutorial is all about) and make it available to the collaboration. (sending us an email to put it on the web)

3. Sep. 18th 2006 Stefan Koestner FwHw Tutorial Creating a datapoint list After you have represented your hardware as PVSS datapoint type, generate the datapoint list of the hardware representation: Go to Graphical Editor and click on ‘System Management’. (Some call it the ‘sheep’)

4. Sep. 18th 2006 Stefan Koestner FwHw Tutorial Inside ‘System Management’ choose ‘Database’ and click on ASCII manager Inside ‘ASCII Manager’ edit the name of your Component and tick ‘Datapoint types’, ‘Data points’ and ‘Original values’. Creating a datapoint list

5. Sep. 18th 2006 Stefan Koestner FwHw Tutorial Select by datapoint type: 1.) Select your hardware from datapoint type list 2.) Append it to the DPT selection list 3.) Click ‘Start’ to generate your datapoint list Unfortunately for bigger hardware types (e.g. the Tell1 board) each dependency has to be inserted separately. (shift-select does not work) Creating a datapoint list

6. Sep. 18th 2006 Stefan Koestner FwHw Tutorial How to distribute the hardware model (DP) For the component you have to create a directory (e.g. fwTell1DP) containing a subdirectory ‘dplist’. The directory path you have to specify in the installation tool when installing the component into your project. Copy the datapointlist you created before into the directory ‘dplist’.

7. Sep. 18th 2006 Stefan Koestner FwHw Tutorial How to distribute the hardware model (DP) fwTell1DP 1.0 10.07.2006./dplist/Tell1_structure.dpl./fwTell1DP.xml A.xml file (it is in the root of your project directory) with the same name as the directory supplies the installation tool with the necessary information: Documentation on the installation tool can be found under: http://itcobe.web.cern.ch/itcobe/Projects/Framework/Download/Components/ComponentInstallation /fwInstallationUCSurvey.pdf

8. Sep. 18th 2006 Stefan Koestner FwHw Tutorial How to distribute the hardware model (DP) If you want to add panels, add a directory ‘panels’ and put the appropriate line in the xml-file:./panels/NameOfThePanel.pnl In case scripts are provided put them into a directory called ‘fwHw_scripts’. For the sake of the potential users of your component, please make tests if everything works fine before you release it!!!