This code allows the pGRAMS DAQ to be controlled by direct TCP connections from the DAQ processes.

This depends on two repositories,

• networking for TCP server connections to the DAQ processes and decoding the eGRAMS packets.
• PGramsCommCodec for decoding the word array into a python dictionary.

It is recommened to create a virtual environment to install the dependancies. You can use either conda or venv with conda or pip package managers, respectively. The dependancies can be installed and environment created using conda (the pip version is on the todo list),

conda env create -f environment.yml

This will create a virtual environemnt pgrams_tpc_metrics and install all the dependancies. Additionally the python bindings in networking and PGramsCodec must be compiled and installed in your virtual environment.

• networking: cd extern && pip install .
• PGramsCodec: pip install .

Running

After the environment has been set up and the dependancies installed, the program can be run,

python daq_control.py

Link & Database Credentials

To operate the program uses an MQTT link to receive metrics and optionally send commands. Additionally, if running in hub_emulator mode (aka fake_hub) the IP address of the host machine must be specified. A template script temp_setup_credentials.sh is provided in the root directory, a copy can be made and the relevant details added. Thereafter `source <your_script_name.sh> will then provide the credentails for all the connections.

The low-bandwidth metrics can be saved to a MySQL database for storage and display by Grafana. The password for the database can also be set in the credential script.