*********************************************************************
*                         TABLE OF CONTENTS                         *
*********************************************************************

INTRODUCTION
   Features
   Package Contents
TARGET SETUP
INSTALL
LOAD
TEST


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

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

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

----------
Features
----------

This release supports OpenGLES 1.x and OpenGLES 2.x.

DDK dependencies: libdrm


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

targetfs/
---------

The 'targetfs' folder contains the user mode modules of Rogue 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.

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:
       # j721e_linux = All Jacinto7 derivatives
host $ export BUILD=<build configuration>
       # allowed values are:
       # release = Release mode binaries
host $ cd <path_to_package>
host $ sudo -E make install

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

-----------------
DDK Kernel module
-----------------

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 gles1test1 and gles2test1 test 
applications that has been included with the SDK file system. The 
applications use OpenGLES 1.x and OpenGLES 2.x to render a triangle 
on nulldisp offscreen display.

target $ gles1test1

target $ gles2test1