 |
This is a library developped in order to simplify the control of a VME system used in CP3 at UCLouvain. It is developped in C++ but comes with Python bindings.
This project is mostly a rewrite of the code developped in 2014 for the test of CMS tracker modules for the HL-LHC upgrade.
Status of the supported boards:
| Board | Purpose | Implementaton | Tested | C++ | Python |
|---|---|---|---|---|---|
| V1718 | USB VME bridge | Full | yes | yes | yes |
| SY527 | CAEN Power system | Full | yes | yes | yes |
| N470 | CAEN NIM HV module | Full | yes | yes | yes |
| V288 | CAENET bridge | Full | yes | yes | yes |
| V812 | COINC / DISCRI | Full | yes | yes | yes |
| V1190 | TDC | Full | yes | yes | yes |
| 1151N | Lecroy Scaler | Full | yes | yes | yes |
| TTCvi | TTC controler | Full | yes | yes | yes |
The project is built through cmake:
cd build
cmake ..
make
[make install]
Examples of the use of the library in C++ are provided in the example directory. The typical usage consists in:
- the instantiation of a VmeUsbBridge
- the instantiation of the class corrresponding to the desired module, passing a pointer to the VME controller.
- in the case of CAEN HV modules, instantiate first the CAENET bridge, and then the HV module class, either directly (SY527PowerSystem or N470HVModule) or through HVModule::HVModuleFactory.
Python bindings are also provided so all the steps above can be done either interactively or through a script in Python.
In C++, a logging infrastructure is provided to help debugging the code. It uses the BOOST logging infrastructure and can be configured through a text file. ExampleFull.cpp shows how to configure the logger module. The following macros are provided:
| macro | debug level | purpose |
|---|---|---|
| LOG_TRACE(ARG) | TRACE | code |
| LOG_DEBUG(ARG) | DEBUG | code |
| LOG_INFO(ARG) | INFO | code |
| LOG_WARN(ARG) | WARNING | code |
| LOG_ERROR(ARG) | ERROR | code |
| LOG_FATAL(ARG) | FATAL ERROR | code |
| LOG_DATA_TRACE(ARG) | TRACE | user data |
| LOG_DATA_DEBUG(ARG) | DEBUG | user data |
| LOG_DATA_INFO(ARG) | INFO | user data |
| LOG_DATA_WARN(ARG) | WARNING | user data |
| LOG_DATA_ERROR(ARG) | ERROR | user data |
| LOG_DATA_FATAL(ARG) | FATAL ERROR | user data |
You are welcome to provide patches and fixes through github. New modules implementation is especially welcome, but we require it to be tested with hardware first.