Repository for developing server side of RFSoC fpga boards Qibosoq is a server for integrating Qick in the Qibolab ecosystem for executing arbitrary pulses sequences on QPUs.

The complete documentation can be found at:

• qibo.science/qibosoq/stable
• qibo.science/qibosoq/latest

Please refer to the documentation for installation instructions.

In configuration.py some default qibosoq parameters are hardcoded. They can be changed using environment variables (see documentation).

• IP of the server
• Port of the server
• Paths of log files
• Name of python loggers
• Path of bitstream
• Type of readout (multiplexed or not, depending on the loaded bitstream)

The simplest way of executing the server is:

sudo -E python -m qibosoq

and the server can be closed with Ctrl-C.
Note that with this command the script will close as soon as the terminal where it's running is closed. To run the server in detached mode you can use:

nohup sudo -E python -m qibosoq &

And the server can be closed with sudo kill <PID> (PID will be saved in log).

QICK is an evolving project, and as such, Qibosoq frequently adapts to its changes to ensure ongoing support. The table below provides a brief overview of the supported QICK versions corresponding to specific Qibosoq releases.

With TII boards the server can also be executed using the alias server-run-bkg.

Also, two additional command are added in .bashrc: serverinfo and serverclose. serverinfo will print the PID if the server is running, otherwise will print "No running server". serverclose will close the server, if it is running.

All these commands require sudo privileges.

Contributions, issues and feature requests are welcome! Feel free to check

If you use the package please refer to the documentation for citation instructions