Enable texture2D operation for EGLImage based textures
[graphics/omap5-sgx-ddk-um-linux.git] / README
1 *********************************************************************
2 *                         TABLE OF CONTENTS                         *
3 *********************************************************************
5 INTRODUCTION
6    Highlights
7    Limitations
8    Package Contents
9 TARGET SETUP
10 INSTALL
11 LOAD
12 TEST
15 *********************************************************************
16 *                            INTRODUCTION                           *
17 *********************************************************************
19 This is the Texas Instruments Inc (TI) Driver Development Kit (DDK)
20 for the SGX graphics cores on Linux OMAP platforms. 
22 This package contains the user mode libraries and binaries for SGX. These
23 user mode libraries are developed by Imagination Technologies (IMG). TI 
24 provides additional enhancements and integration for Linux OMAP.
26 The kernel mode drivers for SGX are available at:
27 https://git.ti.com/graphics/omap5-sgx-ddk-linux
29 The OMAP 5430 kernel drivers follow TI's kernel tree hosted at:
30 http://omapzoom.org/?p=kernel/omap.git
32 ----------
33 Highlights
34 ----------
36 This is version 1.9 of the TI DDK. It is based on IMG's
37 1.9 DDK post-beta engineering drop (ED2253347) delivery to TI.
39 This release supports Wayland 1.3.0 and DRM/KMS.
41 DDK dependencies: gcc 4.7.3, glibc 2.15, libdrm 2.4.41, libgbm 9.0.0, Wayland
42 1.3.0
44 -----------
45 Limitations
46 -----------
47 1. Supports only DRM/KMS and Wayland. No support for Null Window System
48 2. Killing Wayland simple-egl example leads to a SGX HW recovery
49 3. Killing Weston when OpenGL application is running leads to kernel crash
50 4. Tearing artifacts observed with high render load
52 ----------------
53 Package Contents
54 ----------------
56 targetfs/
57 ---------
59 The 'targetfs' folder contains the user mode modules of SGX DDK for OMAP5/DRA7xx.
62 *********************************************************************
63 *                         TARGET SETUP                              *
64 *********************************************************************
66 Consult the TI base system setup documentation for instructions on
67 setting up your target device including boot loader, kernel, and
68 Arago filesystem. 
71 *********************************************************************
72 *                         INSTALL                                   *
73 *********************************************************************
75 The procedure to install the DDK user mode libraries is given below.
76 Refer to the README in https://git.ti.com/graphics/omap5-sgx-ddk-linux
77 for building and installing the kernel mode driver.
79 Untar the package and run the following commands on the host with the 
80 target filesystem mounted:
82 host $ export DISCIMAGE=<path_to_target_root_filesystem>
83 host $ cd <path_to_package>
84 host $ sudo -E make install
86 *********************************************************************
87 *                         LOAD                                      *
88 *********************************************************************
90 The procedure to load the DDK kernel drivers is given below. 
92 --------
93 OMAP DRM
94 --------
96 The omapdrm_pvr driver is expected to be loaded before an OpenGLES 
97 application can be exercised. The pvrsrvinit handles the loading of the 
98 necessary DRM driver.
100 target $ pvrsrvinit
103 *********************************************************************
104 *                         TEST                                      *
105 *********************************************************************
107 The DDK has been verified using the kmscube test application that has 
108 been included with the SDK file system. This application uses DRM/KMS
109 and GBM to render a rotating cube on the screen.
111 Set the LD_LIBRARY_PATH to point to the user libraries and Wayland 
112 libraries.
114 target $ kmscube
116 The DDK has been verified using Weston compositor that has been included
117 with the SDK file system. This application uses Wayland.
119 target $ weston --connector=4 --tty=1