diff options
| author | Tomi Valkeinen <tomi.valkeinen@ti.com> | 2015-10-01 11:40:36 +0300 |
|---|---|---|
| committer | Tomi Valkeinen <tomi.valkeinen@iki.fi> | 2015-10-01 19:40:22 +0300 |
| commit | 6b04b303b7cc4a5eba912d4b67349bae7b8e88b6 (patch) | |
| tree | bc515e4bce60450129b1fb629aec8e963a2e9bb0 | |
| parent | ba853e936dd33f32291b2958c13530d5796b575c (diff) | |
add README
| -rw-r--r-- | README.md | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..ea3cd24 --- /dev/null +++ b/README.md @@ -0,0 +1,54 @@ +# libkms++ - C++ library for kernel mode setting + +libkms++ is a C++11 library for kernel mode setting. + +Also included are simple test tools for KMS and python and lua wrappers for libkms++. + +## Dependencies: + +- libdrm +- SWIG 3.x (for python & lua bindings) +- Python 3.x (for python bindings) +- Lua 5.x (for lua bindings) + +## Build instructions: + +``` +$ mkdir build +$ cd build +$ cmake .. +$ make -j4 +``` + +## Cross compiling instructions: + +Directions for cross compiling depend on your environment. These are for mine (buildroot): + +As above, but specify `-DCMAKE_TOOLCHAIN_FILE=<path>/your-toolchain.cmake` for cmake, where your-toolchain.cmake is something similar to: + +``` +SET(CMAKE_SYSTEM_NAME Linux) + +SET(BROOT "<buildroot>/output/") + +# specify the cross compiler +SET(CMAKE_C_COMPILER ${BROOT}/host/usr/bin/arm-buildroot-linux-gnueabihf-gcc) +SET(CMAKE_CXX_COMPILER ${BROOT}/host/usr/bin/arm-buildroot-linux-gnueabihf-g++) + +# where is the target environment +SET(CMAKE_FIND_ROOT_PATH ${BROOT}/target ${BROOT}/host) + +SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM ONLY) +SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) +SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) +``` + +## Build options + +You can use the following cmake flags to control the build. Use `-DFLAG=VALUE` to set them. + +Option name | Values | Default +-------------------- | ------------- | -------- +CMAKE_BUILD_TYPE | Release/Debug | Release +LIBKMS_ENABLE_PYTHON | ON/OFF | ON +LIBKMS_ENABLE_LUA | ON/OFF | ON |