RN 4 08 00 01

From Texas Instruments Wiki
Jump to: navigation, search

Release Notes for release 4.08.00.01

Introduction

This release includes the Linux graphics drivers for the SGX530 family of chipsets AM35x/37xx, AM335x, 387x(TI814x)/389x(TI816x).The Graphics SDK contains documentation, demo programs and tools.

Validation information

NOTE - This release has been tested on AM parts only. This release is build tested only for 387x(TI814x) & 389x(TI816x) & DM parts.


Installation and Usage

Please look for detailed installation and usage instructions at below link-
http://processors.wiki.ti.com/index.php/Graphics_SDK_Quick_installation_and_user_guide


Features in this release

  • NEW - Based on the IMG Linux 1.9 RC2 latest DDK release (1.9 RC2 2139099)
  • NEW - Supports Xorg X Server 1.10.1
  • NEW - hardfp separate package having hardfloat SGX libraries for all devices
  • NEW - A new reduced installer with minimal demos(2 OpenGL ES1.1 & 2 OpenGL ES 2.0 demos)
  • NEW - Supports passing additional compiler/linker flags if required by user (See Rules.make).
  • PowerVR SDK 2.10.863987.



Pre-requisites

Kernel(Linux PSP) versions supported or used for validation

Please note that this release has been tested only on AM devices. No testing has been done on the DM parts. Only the following devices have been tested & details below -

  • AM35xx/AM37xx - 2.6.37 kernel
    • Linux PSP Release : 04.02.00.07.
    • Display drivers with DSS2 support ie, CONFIG_OMAP2_DSS=y


Toolchain

  • Arago Dynamic toolchain based on GCC 4.5.3 for all devices (supplied with AMSDK releases).
  • Linaro 4.6.3 hardfp toolchain(arm-linux-gnueabihf-) was used for creating the hardfp package.

What is supported

Khronos API support

  • OpenGL ES 1.1
  • OpenGL ES 2.0
  • EGL
  • Limited 2D acceleration via PVR2D API

Window Systems

The following Window Systems are supported, on Linux:

  • Null Window System (with Pixmap support)
  • X11 support(DRI/DRM Xorg driver)

Buffer Swap modes

The following modes of buffer swapping are supported,

  • Front (1 buffer), Flip (chained buffers)

Selection of these modes is done via entries in /etc/powervr.ini. Please refer to http://processors.wiki.ti.com/index.php/SGXDbg#WindowSystem

Extensions

  • IMG propreitary Bufferclass texture streaming enabled by default.
  • eglimage is supported & can be enabled by passing EGLIMAGE=1 during make install.



What is not supported

  • Power Management features are not fully validated. Active power management support available on OMAP35x/37x platforms only.
  • Kernel (for OMAP35x/AM35x/37xx) configured without DSS2 framework support will not work with the current display class driver.
  • PIXMAP - Fbdev dependancy removal is not supported in FLIP buffer swapping mode.
  • X11 window system has been validated with the Xorg file system available as part of the graphics SDK installation(targetfs/XSGX folder). The Xorg server version that has been used/validated as part of this graphics SDK release is 1.10.1 and it has been validated with enlightenment window manager only.
  • Xorg DRI driver supports full screen mode with vsync synchronization without VRFB only on OMAP35xx/AM35xx/37xx devices. Also the Xorg DRI driver supports Vsync synchronization in full screen mode only on all devices.
  • Debug build is meant for debug/testing purposes only & should not be used for measuring performance.

Additional Packages

Demonstration packages for Texture streaming extension are available at the below link,

Benchmarking packages for SGX functionalities and APIs are available at,

GPU Compositing solution at,

Multi channel video streaming solution at,


Debugging SGX driver related issues

For debugging issues with SGX driver and frequently asked questions, please go through
http://processors.wiki.ti.com/index.php/SGXDbg


Fixed in this Release

  • [SDOCM00096154] Cleanup of Rules.make,Makefiles.

Limitations/ Known Issues

  • [SDOCM00061522] FrontEGL mode of swapping buffers may show artifacts (ex, lines at the top), when operating with DVI output.
  • [SDOCM00061276] Texturing via glTexImage2D will result in CPU utilisation depending on size of texture.Using OpenVG will result in CPU utilisation depending on complexity of Vector Graphics operations.
  • [SDOCM00085671] Some openVG test applications and demos may lead to kernel lockup. This behaviour is highly random.
  • [SDOCM00063807] All SDK demos should be exited by pressing 'q'. Ctrl-C can result in unknown behaviour after the closure.
  • [SDOCM00068272],[SDOCM00068322] Blue line on top of DVI display for PolyBump demo, thin line on top for sgx_render_flip_test demo
  • hardfp package has been only sanity tested. (NOTE-To use this package, all dependant components must be built with hard float option (-mfloat-abi=hard))



Contents

The folders in the installed package contain binaries for several family of devices containing the SGX530 core. Brief description of these folders is below.


Graphics SDK folder contents
Folder Name Description Used by
2 gfx_dbg_es3.x / gfx_rel_es3.x Debug/Release binaries for platforms having SGX core revision 1.2.1 (AM35xx) How to check?
3 gfx_dbg_es5.x / gfx_rel_es5.x Debug/Release binaries for platforms having SGX core revision 1.2.5 (AM37xx) How to check?
4 gfx_dbg_es6.x / gfx_rel_es6.x Debug/Release binaries for 38xx(387x,389x) devices (SGX core revision 1.2.5) 38xx How to check?
4 gfx_dbg_es8.x / gfx_rel_es8.x Debug/Release binaries for 335x devices (SGX core revision 1.2.5) AM335x EVM
5 GFX_Linux_KM Source for Graphics Kernel Modules Contains kernel dependent code, changes depending on Linux kernel used
6 GFX_Linux_SDK Demos, Training courses, PVR Tools,classes and header files Used for building new applications (Available only in the SDK package, not in the BIN package)
7 include Contains updated header file for GL extensions, specifically the buffer class streaming extension Useful for video texturing applications involving bufferclass driver
8 tools Contains devmem2, and other packages Useful for running/debugging/benchmarking of Graphics SDK