README

   1 *********************************************************************
   2 *                         TABLE OF CONTENTS                         *
   3 *********************************************************************
   4
   5 INTRODUCTION
   6    Highlights
   7    Limitations
   8    Package Contents
   9 TARGET SETUP
  10 INSTALL
  11 LOAD
  12 TEST
  13
  14
  15 *********************************************************************
  16 *                            INTRODUCTION                           *
  17 *********************************************************************
  18
  19 This is the Texas Instruments Inc (TI) Driver Development Kit (DDK)
  20 for the SGX graphics cores on Linux OMAP platforms.
  21
  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.
  25
  26 The kernel mode drivers for SGX are available at:
  27 https://git.ti.com/graphics/omap5-sgx-ddk-linux
  28
  29 The OMAP 5430 kernel drivers follow TI's kernel tree hosted at:
  30 http://omapzoom.org/?p=kernel/omap.git
  31
  32 ----------
  33 Highlights
  34 ----------
  35
  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.
  38
  39 This release supports Wayland 1.3.0 and DRM/KMS.
  40
  41 DDK dependencies: gcc 4.7.3, glibc 2.15, libdrm 2.4.41, libgbm 9.0.0, Wayland
  42 1.3.0
  43
  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
  51
  52 ----------------
  53 Package Contents
  54 ----------------
  55
  56 targetfs/
  57 ---------
  58
  59 The 'targetfs' folder contains the user mode modules of SGX DDK for OMAP5/DRA7xx.
  60
  61
  62 *********************************************************************
  63 *                         TARGET SETUP                              *
  64 *********************************************************************
  65
  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.
  69
  70
  71 *********************************************************************
  72 *                         INSTALL                                   *
  73 *********************************************************************
  74
  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.
  78
  79 Untar the package and run the following commands on the host with the
  80 target filesystem mounted:
  81
  82 host $ export DISCIMAGE=<path_to_target_root_filesystem>
  83 host $ cd <path_to_package>
  84 host $ sudo -E make install
  85
  86 *********************************************************************
  87 *                         LOAD                                      *
  88 *********************************************************************
  89
  90 The procedure to load the DDK kernel drivers is given below.
  91
  92 --------
  93 OMAP DRM
  94 --------
  95
  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.
  99
 100 target $ pvrsrvinit
 101
 102
 103 *********************************************************************
 104 *                         TEST                                      *
 105 *********************************************************************
 106
 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.
 110
 111 Set the LD_LIBRARY_PATH to point to the user libraries and Wayland
 112 libraries.
 113
 114 target $ kmscube
 115
 116 The DDK has been verified using Weston compositor that has been included
 117 with the SDK file system. This application uses Wayland.
 118
 119 target $ weston --connector=4 --tty=1