X-Keys SDK for Linux PI Engineering Signal 11 Software Build instructions: ==================== Prerequisites -------------- The SDK requires libusb-1.0 in order to build. The GUI test application requires Qt 4. The build system is CMake. To install all of these on an Ubuntu system, run the following from the command line: sudo apt-get install build-essential libqt4-dev libusb-1.0-0-dev cmake Based on your version of Ubuntu, these packages may have slightly different names. Use Bash's tab-completion to find the exact name for these packages on your system. On different distribution of Linux, install a compiler, Qt, libusb-1.0, and cmake using your distribution's package system or install them manually from source. Build ------ run ./configure from this directory. This will configure the CMake build system and create a build/ directory which will contain all the binaries. Run ./configure --help to see a list of common options which can be passed to the configure script. All options passed to ./configure are passed directly to the CMake. Running "make" in this directory after ./configure will build the software Running -------- The binaries are located in the build/ directory and can be run directly from this directory using the following: build/testgui/pietestgui (the GUI test application) build/test/piehidtest (the console test application). build/pedalgui/pedalgui (the GUI application for the VEC Pedal) Installation ------------- Running "make install" from this directory after the software has been built will install the library. By default it installs the PieHid32.h header and the shared and static library files into /usr/local/. The install directory can be set from the configure script. Running ./configure -D CMAKE_INSTALL_PREFIX=/usr will cause the installed programs to be installed into /usr instead of /usr/local/. Usage ====== In order for /dev entries for X-Keys products to be readable by non-root users, a udev rule will need to be placed in /etc/udev/rules.d . A sample udev rule file is located in the udev folder. Simply copy this file to /etc/udev/rules.d using sudo cp udev/90-xkeys.rules /etc/udev/rules.d/ from this folder.