summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorpetreeftime <[email protected]>2015-11-27 16:26:11 +0200
committerpetreeftime <[email protected]>2015-11-27 16:26:11 +0200
commit9ae41ae279b1ea015025c671c2ee06ce5ee4984d (patch)
tree5b40849c6b02d476a65c95cd81ad61b659744a23
parent8bd02d2a96c31eac64fb4144cf928462c74f4623 (diff)
Update README.md
Building and dependency information.
-rw-r--r--README.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/README.md b/README.md
index 9e630271..ad109916 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,51 @@
Tiny Bluetooth Library
+=============
This project aims to create Bluetooth GATT bindings for C++, Java and other
languages, using BlueZ over DBus. Most of the code is automatically
generated using gdbus-codegen, including a few additions to the default
behaviour, such that it also generates the C++ classes, which wrap the functions
normally generated by gdbus-codegen.
+
+Using TinyB
+============
+
+TinyB requires CMake 3.1+ for building and requires GLib/GIO. It also requires BlueZ with GATT profile activated, which is currently experimental, so you might have to run bluetoothd with the -E flag.
+
+~~~~~~~~~~~~~{.sh}
+mkdir build
+cd build
+cmake ..
+make
+make install
+~~~~~~~~~~~~~
+
+The last command will create the include/ and lib/ directories with a copy of
+the headers and library objects respectively in your build location. Note that
+doing an out-of-source build may cause issues when rebuilding later on.
+
+Our cmake configure has a number of options, *cmake-gui* or *ccmake* can show
+you all the options. The interesting ones are detailed below:
+
+Changing install path from /usr/local to /usr
+~~~~~~~~~~~~~
+-DCMAKE_INSTALL_PREFIX:PATH=/usr
+~~~~~~~~~~~~~
+Building debug build:
+~~~~~~~~~~~~~
+-DCMAKE_BUILD_TYPE=DEBUG
+~~~~~~~~~~~~~
+Using clang instead of gcc:
+~~~~~~~~~~~~~
+-DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++
+~~~~~~~~~~~~~
+Cross-compiling on a different system:
+~~~~~~~~~~~~~
+-DCMAKE_CXX_FLAGS:STRING=-m32 -march=i586
+-DCMAKE_C_FLAGS:STRING=-m32 -march=i586
+~~~~~~~~~~~~~
+
+To build documentation run
+~~~~~~~~~~~~~
+doxygen Doxyfile
+~~~~~~~~~~~~~