summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZhigang Gong <gongzg@freedesktop.org>2015-01-19 01:35:14 -0800
committerZhigang Gong <gongzg@freedesktop.org>2015-01-19 01:35:39 -0800
commit55a7173d1807b56e0498494cf823f82329303077 (patch)
tree47a377f2af270d94aa5cb14cbab9709357f8f256
parent7ab4f2bdd06ce85c06e6c18a67c128b191a12ff5 (diff)
update for new 1.0.1.
-rw-r--r--Software/Beignet.mdwn1
-rw-r--r--Software/Beignet/NEWS.mdwn15
-rw-r--r--Software/Beignet/howto/oldgcc-howto.mdwn58
3 files changed, 68 insertions, 6 deletions
diff --git a/Software/Beignet.mdwn b/Software/Beignet.mdwn
index 489fced3..36079a45 100644
--- a/Software/Beignet.mdwn
+++ b/Software/Beignet.mdwn
@@ -234,6 +234,7 @@ by running the beignet's unit test.
Documents for OpenCL application developers
--------------------------------------
- [[Cross compile|Beignet/howto/cross-compiler-howto]]
+- [[Work with old system without c++11|Beignet/howto/oldgcc-howto.mdwn]]
- [[Kernel Optimization Guide|Beignet/optimization-guide]]
The wiki URL is as below:
diff --git a/Software/Beignet/NEWS.mdwn b/Software/Beignet/NEWS.mdwn
index 15eff9d8..9196b480 100644
--- a/Software/Beignet/NEWS.mdwn
+++ b/Software/Beignet/NEWS.mdwn
@@ -1,19 +1,22 @@
# News
+## Jan 19, 2015
+[Beignet 1.0.1](https://01.org/beignet/downloads/beignet-1.0.1-2015-01-19) is released. This is a bug-fix release.
+
## Nov 14, 2014
-[Beignet 1.0.0](http://lists.freedesktop.org/archives/beignet/2014-November/004486.html) is released. This is a major release. Please see the release notes for more information.
+[Beignet 1.0.0](https://01.org/downloads/beignet-1.0.0-2014-11-14) is released. This is a major release. Please see the release notes for more information.
## Sep 15, 2014
-[Beignet 0.9.3](http://lists.freedesktop.org/archives/beignet/2014-September/003952.html) is released. This is a bug-fix release.
+[Beignet 0.9.3](https://01.org/zh/beignet/downloads/beignet-0.9.3-2014-09-15-0) is released. This is a bug-fix release.
## July 17, 2014
-[Beignet 0.9.2](http://lists.freedesktop.org/archives/beignet/2014-July/003596.html) is released. This is a bug-fix release.
+[Beignet 0.9.2](https://01.org/zh/beignet/downloads/beignet-0.9.2-2014-07-17) is released. This is a bug-fix release.
## July 4, 2014
-[Beignet 0.9.1](http://lists.freedesktop.org/archives/beignet/2014-July/003533.html) is released. This is a bug-fix release.
+[Beignet 0.9.1](https://01.org/zh/beignet/downloads/beignet-0.9.1-2014-07-04) is released. This is a bug-fix release.
## June 26, 2014
-[Beignet 0.9.0](http://lists.freedesktop.org/archives/beignet/2014-June/003492.html) is released. This is a major release. Please see the release notes for more information.
+[Beignet 0.9.0](https://01.org/zh/beignet/downloads/beignet-0.9-2014-06-26) is released. This is a major release. Please see the release notes for more information.
## Feb 12, 2014
-[Beignet 0.8.0](http://lists.freedesktop.org/archives/beignet/2014-February/002495.html) is released. This is a major release. Please see the release notes for more information.
+[Beignet 0.8.0](https://01.org/zh/beignet/downloads/2014/beignet-0.8.0-2014-02-12) is released. This is a major release. Please see the release notes for more information.
diff --git a/Software/Beignet/howto/oldgcc-howto.mdwn b/Software/Beignet/howto/oldgcc-howto.mdwn
new file mode 100644
index 00000000..72e35374
--- /dev/null
+++ b/Software/Beignet/howto/oldgcc-howto.mdwn
@@ -0,0 +1,58 @@
+Old Gcc Support HowTo
+====================
+
+Beignet GBE compiler requires C++11 features, while some platforms does not provide
+such with an old gcc version. The solution is to build a standalone GBE compiler in
+a feasible system, and then build Beignet with the pre-built standalone compiler.
+The standalone compiler is also needed during OpenCL application development. Here
+are the brief steps.
+
+Build standalone GBE compiler in a system supporting C++11 features
+-------------------------------------------------------------------
+
+The build process is as usual except to add a CMake option "-DBUILD_STANDALONE_GBE_COMPILER=true".
+After build finishes, there is a tar ball at your_build_dir/backend/src/libocl/usr/local/lib/beignet/gbecompiler.tgz,
+this is the standalone compiler package that will be used next.
+
+
+Distribute the package to your target system without C++11 features
+-------------------------------------------------------------------
+
+Copy gbecompiler.tgz into your target system, the preference location is /usr/local/lib/beignet,
+and unzip it.
+tar zxvf gbecompiler.tgz
+
+Please check there are following files and directory at /usr/local/lib/beignet/ after unzip:
+beignet.bc beignet.pch gbe_bin_generater include
+
+
+Build Beignet on your target system with the standalone compiler
+-------------------------------------------------------------------
+
+The build process is as usual except to add a CMake option "-DUSE_STANDALONE_GBE_COMPILER=true",
+
+If your_path_for_compiler is not /usr/local/lib/beignet, just need to add another CMake option
+"-DSTANDALONE_GBE_COMPILER_DIR=/your_path_for_compiler/".
+
+
+Develop OpenCL applications on your target machine
+--------------------------------------------------
+
+Firstly, write OpenCL kernel source code, secondly, compile the kernel source code to
+kernel binary with the standalone compiler gbe_bin_generater (see the usage below), finally,
+invoke clCreateProgramWithBinary to load the kernel binary and execute it. The utest case
+load_program_from_bin_file demos the whole procedure.
+
+gbe_bin_generater INFILE [-pbuild_parameter] -oOUTFILE -tGEN_PCI_ID
+
+For example, the following command builds OpenCL source kernel from file 'mykernel.cl'
+for Ivybridge with pci_id 0x0162, and write the result (executable binary kernel)
+into file 'mykernel.bin'.
+
+gbe_bin_generater mykernel.cl -omykernel.bin -t0x0162
+
+If the standalone compiler is not located at /usr/local/lib/beignet, need to set the below
+environment to execute gbe_bin_generater.
+OCL_BITCODE_LIB_PATH=/your_path_for_compiler/beignet.bc
+OCL_HEADER_FILE_DIR=/your_path_for_compiler/include
+OCL_PCH_PATH=/your_path_for_compiler/beignet.pch