![]() |
A simple library for VME access |
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:
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.