How to install and run caQtDM...

  1. Requirements for linux: or

  2. what is caQTDM: caQtDM offers a collection of special widgets in order to display and control control system data in various ways. The widgets have been inspired from the well known MEDM package used at many EPICS sites. However caQtDM is not restricted to EPICS and can/could also support other control systems. At PSI caQtDM is used at several facilities and controls not only EPICS, but also simultanuously an older house-made system. Moreover support has already been introduced for EPICS4, but is still in development.

  3. how to use it: in case of existing MEDM files, these can be translated to Qt xml files by using the utility adl2ui contained in the package. Normally nothing will have to be changed in the resulting files, but in case of small problems, like for instance in overlapping order, the Qt4-designer can be used to correct these. However when you start from scratch, you will develop your screens with the Qt4-designer and display them by the caQtDM utility, which takes care of the data acquisition/control and the display. The conventions for the widgets and channels are fully compatible with MEDM and some other widgets have been added. The MEDM manual will give you normally all the necessary explanations for the different widgets while the mechanisms are the same. However you will have to get accustomed with the Qt4-designer utility and a quick look at its manual delivered with it, should give you an idea.

  4. how to install it: the latest version of caQtDM 3.1.4 has now a new build and installation procedure working for several linux platforms. First you will have to unpack the tar archive, which will create the nessary directories and files. In the upper directory you will find the necessary procedures to build the package, run it locally without installing and also an installtion procedure.

    1. you will have to install Qt-4.8 and qwt-6 when they are not already installed. On modern systems Qt4 should already be installed, but the qt4-designer not necessarily and you should install it (eventually with sudo apt-get install qt4-designer). qwt is normally not installed and you should install this too.

    2. you will have to install EPICS

    3. all the environment variables used for the installation will be defined in the script caQtDM_Env. When some of the variables are already defined in your environment, the script will use them, otherwise they will be defined. It is up to you to edit this file and adapt the variables to your environment.

    4. the script caQtDM_BuildAll will build you the package now into the directory ./caQtDM_Binaries. You should obtain there adl2ui, caQtDM, and as well as a designer directory containing 3 files libqtcontrols* if you encounter a problem when building due to some environment variable problem or while not everything was installed before, you may correct your problem and run the script again. In case you want to cleanup you use the script caQtDM_CleanAll, which will also delete the resulting binaries.

    5. you may try to install the package: the package should normally be installed in the EPICS extensions and the environment variables are pointing to them.

  5. running caQtDM: when the package has been successfully build into the directory ./caQtDM_Binaries, you can start caQtDM by using the script startDM_Local and the qt4-designer by the script qtdesigner (all located in the main directory where you expanded the tar file). These scripts will set some important environment variables in order to set the path, the plugin_path and to point to the test directory provided with the package (./caQtDM_Tests). In this directory also the stylesheets are located to be used for a nice rendering. You may call the test.ui file with the above mentioned scripts. In order to test the display some EPICS channels have to be defined. This can be done by running a soft-ioc shell called with run-epics also provided in the test directory.

  6. in case you have qwt 6.1 you will have to use in caQtDM_QtControls/src the files qwt_thermo_marker_61.* instead of qwt_thermo_marker.*

  7. in case you already use Qt5.1 with qwt6.1 the building should also be straight forward.

  8. Instructions for compiling caQtDM on Windows

    With caQtDM_Env.bat you can configure your system. All settings which are needed will be taken from here.

    The building can be started with the batchfile : caQtDM_BuildAll.bat

    The packaging is made with the batch file : caQtDM_Build_Package.bat

    This will generate a MSI installation file in the folder of caQtDM_Binaries.

    To clean the Folder you should use caQtDM_CleanAll.bat.

good luck and enjoy

in case of problems, please contact Anton Mezger at PSI (