summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGowtham Tammana2015-12-16 10:23:30 -0600
committerGowtham Tammana2015-12-18 02:21:25 -0600
commit75a7daecbe3fb9af91f4dc9e0995bd4840f46fa8 (patch)
tree186b35d84cbc66497848b3bb7197a49f26dc27f6
parent47d888d00cd742aa65c1423bf7eb46a429948869 (diff)
downloadti-gc320-driver-ti-p7-rel.tar.gz
ti-gc320-driver-ti-p7-rel.tar.xz
ti-gc320-driver-ti-p7-rel.zip
Build instructions in Readme.ti-p7-rel
Signed-off-by: Gowtham Tammana <g-tammana@ti.com>
-rw-r--r--LICENSE53
-rw-r--r--Readme57
2 files changed, 99 insertions, 11 deletions
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..3be69f6
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,53 @@
1/****************************************************************************
2*
3* The MIT License (MIT)
4*
5* Copyright (c) 2014 Vivante Corporation
6*
7* Permission is hereby granted, free of charge, to any person obtaining a
8* copy of this software and associated documentation files (the "Software"),
9* to deal in the Software without restriction, including without limitation
10* the rights to use, copy, modify, merge, publish, distribute, sublicense,
11* and/or sell copies of the Software, and to permit persons to whom the
12* Software is furnished to do so, subject to the following conditions:
13*
14* The above copyright notice and this permission notice shall be included in
15* all copies or substantial portions of the Software.
16*
17* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
23* DEALINGS IN THE SOFTWARE.
24*
25*****************************************************************************
26*
27* The GPL License (GPL)
28*
29* Copyright (C) 2014 Vivante Corporation
30*
31* This program is free software; you can redistribute it and/or
32* modify it under the terms of the GNU General Public License
33* as published by the Free Software Foundation; either version 2
34* of the License, or (at your option) any later version.
35*
36* This program is distributed in the hope that it will be useful,
37* but WITHOUT ANY WARRANTY; without even the implied warranty of
38* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
39* GNU General Public License for more details.
40*
41* You should have received a copy of the GNU General Public License
42* along with this program; if not, write to the Free Software Foundation,
43* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
44*
45*****************************************************************************
46*
47* Note: This software is released under dual MIT and GPL licenses. A
48* recipient may use this file under the terms of either the MIT license or
49* GPL License. If you wish to use only one license not the other, you can
50* indicate your decision by deleting one of the above license notices in your
51* version of this file.
52*
53*****************************************************************************/
diff --git a/Readme b/Readme
index 111b33c..c4da3b4 100644
--- a/Readme
+++ b/Readme
@@ -1,16 +1,51 @@
1# Building GC320 2D accelerator kernel module
2 1
3A sample build script `driver_build_j6_glsdk.sh` is included for aid in building 2This Readme file provides brief instructions on building the GC320 kernel
4the kernel module for GLSDK releases. Modify the following environment variables 3driver against TI GLSDK and Android SDK releases for DRA7xx platforms.
5to reflect the setup on which the build is being performed.
6 4
7 - ROOTDIR=<top-level-directory-of-this-repo> 5## Building against GLSDK
8 - KERNEL_DIR=<GLSDK-root-directory>/board-support/linux
9 - TOOLCHAIN=<path-to-linaro-4.7-2013.04-20130313-toolchain>
10 6
11Run the script to build the `galcore.ko` module 7Make sure that the GLSDK is setup on the host environment and the kernel is
8built before building the GC320 driver. For GLSDK release, the kernel can be
9built with (see GLSDK instructions on setting the appropriate environment
10variables and PATH entries)
12 11
13 $ ./driver_build_j6_glsdk.sh 12 [host]$ cd $GLSDK & make linux
14 13
15The resulting kernel module will be installed in `$ROOTDIR/build/sdk/drivers` 14Set the following environment variables for building `ti-gc320-driver` to
16location. 15reflect host setup.
16
17 $ export ROOTDIR=<path to root directory of this package>
18 $ export KERNEL_DIR=$GLSDK/board-support/linux
19 $ export TOOLCHAIN=<path to Linaro cross-compile toolchain topdir>
20
21A build script, `driver_build_j6_glsdk.sh` is provided, run the script to
22build the kernel driver.
23
24 [host]$ ./driver_build_j6_glsdk.sh
25
26## Building against Android SDK
27
28Make sure that the Android SDK is setup on the host environment and the kernel
29and AFS are built prior to building GC320 driver. Follow TI Android SDK
30instructions on the Android setup and build instructions.
31
32Set the above three environment variables for `ti-gc320-driver` to suit the
33host Android setup. In Android the GC320 driver is built by using the Android
34build infrastructure.
35
36 [host]$ cd <this package>
37 [host]$ export ROOTDIR=<pwd>
38 [host]$ export KERNEL_DIR=<path to kernel dir>
39 [host]$ export TOOLCHAIN=<path to android arm-eabi toolchain>
40 [host]$ cd <6AL1.x mydroid location>
41 [host]$ . build/envsetup.sh
42 [host]$ lunch full_jacinto6evm-userdebug
43 [host]$ mmm <this package/src>
44
45## Installing the kernel module
46
47The above script should build the kernel module `galcore.ko` and will be placed
48in `$ROOTDIR/build/sdk/drivers` folder. Install the kernel module on the DRA7xx
49target as below
50
51 [dra7xx]$ insmod galcore.ko physSize=0xc0000000