Small library to control and read out lab equipment.

Getting code

If you want the external dependencies compiled internally, then make sure you clone recursive:

git clone --recursive <url>

Commiting code

Create new branch with your initials and short description, for example jd_mybranch. When creating merge request make sure to check the box with delete branch after merging.

Compile code

To start with:

mkdir build; cd build
cmake .. # On CentOS, use the cmake3 command
make -j4

New projects

You can add labRemote as a submodule and create a new project. All projects should be labRemote-apps Example project is: ExampleLabRemoteProject

Probe Station

The external dependencies listed below are for various pieces of functionality in the project.

Requirements for probe station controller:

• Qt 5.9.2 link
• OpenCV 3.3.1 Install in Linux
• gclib link

Requirements for FTDICom:

• libftdi - Generic FTDI library
• libmpsse - Library that implements common communication protocols (I2C, SPI) using the MPSSE framework on FTDI chips

Requirements for JSON (used by libPS and libEquipConf):

• nlohmann_json - header-only JSON for Modern C++

Python Bindings

Python bindings are built via the _labRemote target which is enabled by the cmake flag -DUSE_PYTHON=on. This will put a .so file in ${BUILD}/lib/ that can be directly used in python. As such, it requires the Python libraries to be findable (e.g. python3-devel is installed). For example, after building with make, while inside the build directory,

PYTHONPATH=lib/:$PYTHONPATH python3
Python 3.6.8 (default, Aug  7 2019, 17:28:10)
[GCC 4.8.5 20150623 (Red Hat 4.8.5-39)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import _labRemote

For now, the following libraries are supported:

• libCom
• libEquipConf
• libPS

Requirements/Installing

Note that in every shell, python needs to be able to find the built shared-object files to dynamically load the python bindings. Make sure you export the PYTHONPATH as shown below and/or described in the make output.

yum install python3-devel
cmake3 -DUSE_PYTHON=on
make
export PYTHONPATH=/home/<username>/<directoryToLabRemote>/build/lib:$PYTHONPATH
python3 -c "import _labRemote as labRemote"