From 55a7173d1807b56e0498494cf823f82329303077 Mon Sep 17 00:00:00 2001 From: Zhigang Gong Date: Mon, 19 Jan 2015 01:35:14 -0800 Subject: update for new 1.0.1. --- Software/Beignet/NEWS.mdwn | 15 +++++---- Software/Beignet/howto/oldgcc-howto.mdwn | 58 ++++++++++++++++++++++++++++++++ 2 files changed, 67 insertions(+), 6 deletions(-) create mode 100644 Software/Beignet/howto/oldgcc-howto.mdwn (limited to 'Software/Beignet') 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 -- cgit v1.2.3