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;a=shortlog;h=refs/heads/p-ti-glsdk-3.8.y
32 ----------
33 Highlights
34 ----------
36 This is version 1.9.11 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.0.6 and X11
41 DDK dependencies: gcc 4.7.3, glibc 2.15, libdrm 2.4.41, libgbm 9.0.0, Wayland
42 1.0.6
44 -----------
45 Limitations
46 -----------
47 1. Spurious "deadlock" messages when loading omapdrm_pvr kernel module
48 2. Supports only DRM/KMS, Wayland and X11. No support for Null Window System
49 3. Kernel panic due to drm_kms_helper sometimes. Reset the board if it occurs
50 4. Wayland simple-egl example throws a gbm_import_bo error
51 5. Mmap error observed with Weston with cursor surfaces
53 ----------------
54 Package Contents
55 ----------------
57 targetfs/
58 ---------
60 The 'targetfs' folder contains the user mode modules of SGX DDK for OMAP5/DRA7xx.
63 *********************************************************************
64 * TARGET SETUP *
65 *********************************************************************
67 Consult the TI base system setup documentation for instructions on
68 setting up your target device including boot loader, kernel, and
69 Arago filesystem.
72 *********************************************************************
73 * INSTALL *
74 *********************************************************************
76 The procedure to install the DDK user mode libraries is given below.
77 Refer to the README in https://git.ti.com/graphics/omap5-sgx-ddk-linux
78 for building and installing the kernel mode driver.
80 Untar the package and run the following commands on the host with the
81 target filesystem mounted:
83 host $ export DISCIMAGE=<path_to_target_root_filesystem>
84 host $ cd <path_to_package>
85 host $ sudo -E make install
87 PVR EXA driver is copied into /usr/lib/xorg/modules/drivers of the target
88 filesystem. The SDK system integrator should copy the EXA driver into
89 the relevant X11 driver directory.
92 *********************************************************************
93 * LOAD *
94 *********************************************************************
96 The procedure to load the DDK kernel drivers is given below.
98 --------
99 OMAP DRM
100 --------
102 The omapdrm_pvr driver is expected to be loaded before an OpenGLES
103 application can be exercised. The pvrsrvinit handles the loading of the
104 necessary DRM driver. This step will not be required for X11 window
105 system with PVR EXA driver.
107 target $ pvrsrvinit
110 *********************************************************************
111 * TEST *
112 *********************************************************************
114 The DDK has been verified using the kmscube test application that has
115 been included with the SDK file system. This application uses DRM/KMS
116 and GBM to render a rotating cube on the screen.
118 Set the LD_LIBRARY_PATH to point to the user libraries and Wayland
119 libraries.
121 target $ kmscube
123 The DDK has been verified using Weston compositor that has been included
124 with the SDK file system. This application uses Wayland.
126 target $ weston --connector=4
128 The DDK has been verified with X11 server included in the SDK file system.
129 DRI2 support has been validated.
131 target $ export DISPLAY=:0
132 target $ xinit &
133 target $ xgles2test1
134 target $ xmultiegltest