Prerequisites

In order to build the examples or integrate the CosmicSDK into your own projects, ensure that you have the following prerequisites installed on the host system:

  • A C++17 compatible compiler.

  • CMake (minimum version 3.10) for building the SDK.

  • Binho Supernova or Pulsar host adapters.

Linux packages

On Linux, the SDK talks to the device through HIDAPI. The example programs included with the SDK build HIDAPI from source, which requires pkg-config together with the development packages for libudev and libusb-1.0. These are commonly missing from fresh installations, and their package names vary between distributions.

Debian / Ubuntu:

sudo apt-get update
sudo apt-get install -y pkg-config libudev-dev libusb-1.0-0-dev

Fedora / RHEL / CentOS:

sudo dnf install pkgconf-pkg-config systemd-devel libusbx-devel

Note

  • These development packages are needed to build the example programs, which compile HIDAPI from source. Simply running a program that links the prebuilt CosmicSDK libraries requires only the libusb-1.0 runtime library (libusb-1.0-0 on Debian/Ubuntu, libusbx on Fedora/RHEL); libudev ships with systemd and is already present on virtually all modern distributions.

  • Package names may differ on other distributions; look for the pkg-config, libudev (or systemd) development, and libusb-1.0 development packages.