summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorYang Rong <rong.r.yang@intel.com>2017-01-20 17:40:28 +0800
committerYang Rong <rong.r.yang@intel.com>2017-01-20 18:36:09 +0800
commitbe0ae741a9064cebf5b5c9a277ae895086bdbddd (patch)
tree1ce7879517d2a68b7fbaa6fb3fc07b2130c5150e /docs
parentbf15ed438ff255ed4cd56cc9c585f1a2afbcc018 (diff)
Doc: add android build howto.
Signed-off-by: Yang Rong <rong.r.yang@intel.com> Reviewed-by: Ruiling Song <ruiling.song@intel.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/Beignet.mdwn1
-rw-r--r--docs/howto/android-build-howto.mdwn64
2 files changed, 65 insertions, 0 deletions
diff --git a/docs/Beignet.mdwn b/docs/Beignet.mdwn
index aafdcb49..5c62b4ca 100644
--- a/docs/Beignet.mdwn
+++ b/docs/Beignet.mdwn
@@ -285,6 +285,7 @@ Documents for OpenCL application developers
- [[V4l2 Buffer Sharing|Beignet/howto/v4l2-buffer-sharing-howto]]
- [[Video Motion Estimation|Beignet/howto/video-motion-estimation-howto]]
- [[Stand Alone Unit Test|Beignet/howto/stand-alone-utest-howto]]
+- [[Android build|Beignet/android-build-howto]]
The wiki URL is as below:
[http://www.freedesktop.org/wiki/Software/Beignet/](http://www.freedesktop.org/wiki/Software/Beignet/)
diff --git a/docs/howto/android-build-howto.mdwn b/docs/howto/android-build-howto.mdwn
new file mode 100644
index 00000000..be4d6a0d
--- /dev/null
+++ b/docs/howto/android-build-howto.mdwn
@@ -0,0 +1,64 @@
+Android build HowTo
+===================
+
+Beignet supports android system, but there are several android versions, Beignet
+only provide the android 5.1.1 (lollipop)'s build files. This document describes
+how to build and install the Beignet driver and utests to android devices.
+Please notice that, Beignet disable PCH in the android, so the kernel's compiling is very
+slow, we recommend used cross-compiler and OpenCL's binary program in android.
+
+Prerequisite
+-------------
+You must have the android's source code and have built the android system successfully.
+
+Build Beignet
+-------------
+
+Beignet is just similar as other android native libraries, the steps are as below.
+
+- Add the Beignet to android source code tree.
+ Put Beignet's source code to the appropriate directory under android source code,
+ such as vendor/intel/ufo or external.
+
+- Set up android's environment and choose a target
+ Run `source build/envsetup.sh` and `lunch`.
+
+- Build clang target library.
+ Android only build clang for host, Beignet depends on target libclang.so. Beignet provide
+ lollipop's patch for clang (version 3.5) to build target libclang.so, you can download the patch
+ from [this patch](https://01.org/sites/default/files/enable-clang-device-build-for-beignet.patch).
+ Change directory to external/clang, run `git apply` to apply the patch, and run `mm` to build
+ libclang.so.
+
+- Change to Beignet's directory, and make.
+ Run `mm -B`, if failed first time, run `mm -B` again. When finish, the Beignet libraries and
+ utests binary would be generated in the out/target/product/<target>/system/
+
+Install Beignet to target device
+--------------------------------
+To install Beignet, you need `adb push` all Beignet and clang libraries to the device's correspondent
+directory, include following files:
+out/target/product/<target>/system/lib64/libclang.so to /system/lib64/
+out/target/product/<target>/system/lib64/libcl.so to /system/lib64/
+out/target/product/<target>/system/lib64/libgbeinterp.so to /system/lib64/
+out/target/product/<target>/system/lib64/libgbe.so to /system/lib64/
+out/target/product/<target>/system/lib/libclang.so to /system/lib/
+out/target/product/<target>/system/lib/libcl.so to /system/lib/
+out/target/product/<target>/system/lib/libgbeinterp.so to /system/lib/
+out/target/product/<target>/system/lib/libgbe.so to /system/lib/
+
+Additionally, the bitcode file and ocl head file also need copy to device, as following:
+out/target/product/<target>/gen/SHARED_LIBRARIES/libgbe_intermediates/beignet.bc to /system/lib/ocl/
+out/target/product/<target>/gen/SHARED_LIBRARIES/libgbe_intermediates/libocl/include/ to /system/lib/ocl/include/
+
+If your application is linked to libOpenCL.so, you also need create a soft link `ln -s libcl.so libOpenCL.so`.
+
+If you want to run utests in the device, you all need copy the utests files:
+out/target/product/<target>/system/bin/utest_run-x86 to /system/bin/utest_run-x86
+out/target/product/<target>/system/bin/utest_run-x86_64 to /system/bin/utest_run-x86_64
+out/target/product/<target>/system/lib64/libutests.so to /system/lib64/
+out/target/product/<target>/system/lib/libcl.so to /system/lib/
+
+You also need copy the utests' kernels to the device:
+<Beignet path>/kernels/ to /system/lib/ocl/
+and set the environment variable "OCL_KERNEL_PATH=/system/lib/ocl/kernels/"before run utests.