This project provides an easy way to install the uHAL Python API from the IPbus software via PyPI. This vastly simplies the installation, which is notoriously hard to get right especially with virtual environments.
The uHAL component can be installed via:
pip install uhalBinary releases are available for Linux. Other platforms are not supported by IPbus.
While this project focuses on the install of the uHAL Python API, building the ControlHub is another challenge itself. However, since the uHAL part is now not required anymore, the installation can be done in an Erlang container.
First, the IPbus software repository needs to be cloned:
git clone --depth=1 -b v2.8.22 https://github.com/ipbus/ipbus-software.gitThen an Erlang container with the IPbus software mounted needs to be started via docker or podman:
docker run -v $(pwd)/ipbus-software:/ipbus-software -it erlang:26 /bin/bashInside the container, a build of the ControlHub can be achieved with the Set variable:
cd ipbus-software
make Set=controlhubFinally after exiting the container, the ControlHub can be installed on the host:
cd ipbus-software
sudo make Set=controlhub installSince uHAL is a C++ library at its core, binaries for each Python version need to compiled separately.
Thus if a new Python version is released, a new upload to PyPI is required.
For this reason, and additional number is added to the IPbus version in meson.build which allows to create a new tag without needing a new IPbus version.
The new Python version needs to be added in pyproject.toml and .github/workflows/wheels.yml.
Once a corresponding tag is created in the repository, a new version is uploaded to PyPI automatically.
When updating the IPbus software, the version needs to updated manually in the following places:
- everything in
ipbus-software.wrap - the project version in
meson.build - the project version in
subprojects/packagefiles/ipbus-software/meson.build - the git tag mentioned in the README
Additionally it is worth checking if:
- any of the other subprojects have a new version released
- a newer Erlang version can be used to compile ControlHub