aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 2dc0e69e1452150f10a726fec29d488170ee59da (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
*********************************************************************
*                         TABLE OF CONTENTS                         *
*********************************************************************

INTRODUCTION
   Highlights
   Limitations
   Package Contents
TARGET SETUP
INSTALL
LOAD
TEST


*********************************************************************
*                            INTRODUCTION                           *
*********************************************************************

This is the Texas Instruments Inc (TI) Driver Development Kit (DDK)
for the SGX graphics cores X11 image on TI Linux platforms. 

This package contains the user mode libraries and binaries for SGX. These
user mode libraries are developed by Imagination Technologies (IMG). TI 
provides additional enhancements and integration for Linux OMAP.

The kernel mode drivers for SGX are available at:
https://git.ti.com/graphics/omap5-xsgx-ddk-linux

----------
Highlights
----------

This is version 1.15 of the TI DDK based on IMG's RTM4564147 delivery to TI.

This release supports X11 TBD

DDK dependencies: TBD: libdrm 2.4.66, libgbm 10.0.0, Wayland 1.9

-----------
Limitations
-----------

----------------
Package Contents
----------------

targetfs/
---------

The 'targetfs' folder contains the user mode modules of SGX DDK for TI
platforms.


*********************************************************************
*                         TARGET SETUP                              *
*********************************************************************

Consult the TI base system setup documentation for instructions on
setting up your target device including boot loader, kernel, and
Arago filesystem. 


*********************************************************************
*                         INSTALL                                   *
*********************************************************************

The procedure to install the DDK user mode libraries is given below.
Refer to the README in https://git.ti.com/graphics/omap5-xsgx-ddk-linux
for building and installing the kernel mode driver.

Untar the package and run the following commands on the host with the 
target filesystem mounted:

host $ export DISCIMAGE=<path_to_target_root_filesystem>
host $ export TARGET_PRODUCT=<SoC value>
       # allowed values are: 
       # ti335x = All AM33x derivatives
       # ti437x = All AM43x derivatives
       # jacinto6evm = All DRA7xx / AM57x derivatives
host $ cd <path_to_package>
host $ sudo -E make install

*********************************************************************
*                         LOAD                                      *
*********************************************************************

The procedure to load the DDK kernel drivers is given below. 

--------
OMAP DRM
--------

The pvrsrvkm driver is expected to be loaded before an OpenGLES 
application can be exercised. The rc.pvr handles the loading of the 
necessary DRM driver.

target $ /etc/init.d/rc.pvr start


*********************************************************************
*                         TEST                                      *
*********************************************************************

The DDK has been verified using the kmscube test application that has 
been included with the SDK file system. This application uses DRM/KMS
and GBM to render a rotating cube on the screen.

Set the LD_LIBRARY_PATH to point to the X11 libraries such as /usr/local/XSGX/lib

target $ gles2test1 -f 500