Texas Instruments OMAP35 Series User manual

Literature Number: SPRUFZ8
Feb 2, 2009
OMAP35x Graphics SDK
Getting Started Guide

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
2
IMPORTANT NOTICE
Texas Instruments Incorporated and its subsidiaries (TI) reserve the right to make corrections, modifications,
enhancements, improvements, and other changes to its products and services at any time and to discontinue any
product or service without notice. Customers should obtain the latest relevant information before placing orders and
should verify that such information is current and complete. All products are sold subject to TI's terms and conditions
of sale supplied at the time of order acknowledgment.
TI warrants performance of its hardware products to the specifications applicable at the time of sale in accordance
with TI's standard warranty. Testing and other quality control techniques are used to the extent TI deems necessary
to support this warranty. Except where mandated by government requirements, testing of all parameters of each
product is not necessarily performed.
TI assumes no liability for applications assistance or customer product design. Customers are responsible for their
products and applications using TI components. To minimize the risks associated with customer products and
applications, customers should provide adequate design and operating safeguards.
TI does not warrant or represent that any license, either express or implied, is granted under any TI patent right,
copyright, mask work right, or other TI intellectual property right relating to any combination, machine, or process in
which TI products or services are used. Information published by TI regarding third-party products or services does
not constitute a license from TI to use such products or services or a warranty or endorsement thereof. Use of such
information may require a license from a third party under the patents or other intellectual property of the third party,
or a license from TI under the patents or other intellectual property of TI.
Reproduction of information in TI data books or data sheets is permissible only if reproduction is without alteration
and is accompanied by all associated warranties, conditions, limitations, and notices. Reproduction of this information
with alteration is an unfair and deceptive business practice. TI is not responsible or liable for such altered
documentation.
Resale of TI products or services with statements different from or beyond the parameters stated by TI for that
product or service voids all express and any implied warranties for the associated TI product or service and is an
unfair and deceptive business practice. TI is not responsible or liable for any such statements.
Following are URLs where you can obtain information on other Texas Instruments products and application
solutions:
Products Applications
Amplifiers amplifier.ti.com Audio www.ti.com/audio
Data Converters dataconverter.ti.com Automotive www.ti.com/automotive
DSP dsp.ti.com Broadband www.ti.com/broadband
Interface interface.ti.com Digital Control www.ti.com/digitalcontrol
Logic logic.ti.com Military www.ti.com/military
Power Mgmt power.ti.com Optical Networking www.ti.com/opticalnetwork
Microcontrollers microcontroller.ti.com Security www.ti.com/security
Low Power
Wireless
www.ti.com/lpw Telephony www.ti.com/telephony
Video & Imaging www.ti.com/video
Wireless www.ti.com/wireless

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
3
EVALUATION BOARD/KIT IMPORTANT NOTICE
Texas Instruments (TI) provides the enclosed product(s) under the following conditions:
This evaluation board/kit is intended for use for ENGINEERING DEVELOPMENT,
DEMONSTRATION, OR EVALUATION PURPOSES ONLY and is not considered by TI
to be a finished end-product fit for general consumer use. Persons handling the
product(s) must have electronics training and observe good engineering practice
standards. As such, the goods being provided are not intended to be complete in terms
of required design-, marketing-, and/or manufacturing-related protective considerations,
including product safety and environmental measures typically found in end products
that incorporate such semiconductor components or circuit boards. This evaluation
board/kit does not fall within the scope of the European Union directives regarding
electromagnetic compatibility, restricted substances (RoHS), recycling (WEEE), FCC,
CE or UL, and therefore may not meet the technical requirements of these directives or
other related directives.
Should this evaluation board/kit not meet the specifications indicated in the User's
Guide, the board/kit may be returned within 30 days from the date of delivery for a full
refund. THE FOREGOING WARRANTY IS THE EXCLUSIVE WARRANTY MADE BY
SELLER TO BUYER AND IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESSED,
IMPLIED, OR STATUTORY, INCLUDING ANY WARRANTY OF MERCHANTABILITY
OR FITNESS FOR ANY PARTICULAR PURPOSE.
The user assumes all responsibility and liability for proper and safe handling of the
goods. Further, the user indemnifies TI from all claims arising from the handling or use
of the goods. Due to the open construction of the product, it is the user's responsibility
to take any and all appropriate precautions with regard to electrostatic discharge.
EXCEPT TO THE EXTENT OF THE INDEMNITY SET FORTH ABOVE, NEITHER
PARTY SHALL BE LIABLE TO THE OTHER FOR ANY INDIRECT, SPECIAL,
INCIDENTAL, OR CONSEQUENTIAL DAMAGES.
TI currently deals with a variety of customers for products, and therefore our
arrangement with the user is not exclusive.
TI assumes no liability for applications assistance, customer product design,
software performance, or infringement of patents or services described herein.
Please read the User's Guide and, specifically, the Warnings and Restrictions notice in
the User's Guide prior to handling the product. This notice contains important safety
information about temperatures and voltages. For additional information on TI's
environmental and/or safety programs, please contact the TI application engineer or
visit www.ti.com/esh.

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
4
No license is granted under any patent right or other intellectual property right of TI
covering or relating to any machine, process, or combination in which such TI products
or services might be or are used.
Mailing Address: Texas Instruments Post Office Box 655303 Dallas, Texas 75265
Copyright © 2008, Texas Instruments Incorporated
FCC Warning
This evaluation board/kit is intended for use for ENGINEERING DEVELOPMENT,
DEMONSTRATION, OR EVALUATION PURPOSES ONLY and is not considered by TI
to be a finished end-product fit for general consumer use. It generates, uses, and can
radiate radio frequency energy and has not been tested for compliance with the limits of
computing devices pursuant to part 15 of FCC rules, which are designed to provide
reasonable protection against radio frequency interference. Operation of this equipment
in other environments may cause interference with radio communications, in which case
the user at his own expense will be required to take whatever measures may be
required to correct this interference.

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
5
Preface
About This Guide
The OMAP35x EVM is an evaluation platform that showcases the OMAP
architecture and lets users evaluate the power and performance of OMAP as
a flexible general purpose platform.
This guide gives you overview information about the board and the software
provided with the board. It is intended to be used as an introductory
document for the EVM. Other documents provide more in-depth information.
See the EVM documentation section of the release notes for a complete list
of documents that have been included with the product.
Notational Conventions
This document uses the following conventions:
Program listings, program examples, and interactive displays are shown in a mono-spaced
font. Examples use bold for emphasis, and interactive displays use bold to distinguish commands that
you enter from items that the system displays (such as prompts, command output, error messages, etc.).
Square brackets ( [ and ] ) identify an optional parameter. If you use an optional parameter, you
specify the information within the brackets. Unless the square brackets are in a bold typeface, do not
enter the brackets themselves.

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
6
Trademarks
The Texas Instruments logo and Texas Instruments are registered trademarks of Texas
Instruments. Trademarks of Texas Instruments include: TI, OMAP, the OMAP logo, XDS, Code
Composer, Code Composer Studio, Probe Point, Code Explorer, DSP/BIOS, RTDX, Online DSP
Lab, OMAP, TMS320, TMS320C54x, TMS320C55x, TMS320C62x, TMS320C64x, TMS320C67x,
TMS320C5000, and TMS320C6000.
MS-DOS, Windows, and Windows NT are trademarks of Microsoft Corporation.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a registered trademark of Linus Torvalds.
CodeSourcery and CodeSourcery’s Sourcery G++ are trademarks or registered trademarks of
CodeSourcery, Inc.
Solaris, SunOS, and Java are trademarks or registered trademarks of Sun Microsystems, Inc.
All other brand, product names, and service names are trademarks or registered trademarks of their
respective companies or organizations.

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
7
Revision History:
Rev No. Change Date
0.1 Initial Draft 18 Nov 2008
0.2 Updated for review comments 24 Nov 2008
0.3 Modified the wiki link and more information provided for
executing the Graphics driver tests 26 Nov 2008
1.0 Fixed the typo in section 3.4.1 28 Nov 2008
1.1
Source for graphics kernel modules included in the package
Updated the document for building the kernel modules
Updated the document for build the user developed
demonstrations
18 Dec 2008
1.2 Updated the document to include details on patches added to
Graphics SDK package 02 Feb 2009

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
8
Table of contents
1Overview .......................................................................................................................................................9
1.1 What’s in the SDK Package? .........................................................................................................9
1.2 What’s next? ................................................................................................................................. 10
1.3 Command Prompts in this Guide ................................................................................................ 10
1.4 Updates & Further information .................................................................................................... 10
2OMAP35x DVEVM Software Setup for Graphics SDK........................................................................... 11
2.1 Requirements ............................................................................................................................... 11
2.2 Preparing to Install ....................................................................................................................... 11
2.3 Installing the Software.................................................................................................................. 12
2.3.1 Installing the Target Linux Software ......................................................................................... 13
2.3.2 Installing the Graphics SDK Software ...................................................................................... 14
2.3.3 Installing the Toolchain.............................................................................................................. 14
2.4 Setting up the Build/Development Environment ........................................................................ 16
3Executing the Graphics SDK Demonstration Software .......................................................................... 17
3.1 Default Boot Parameter Settings................................................................................................. 17
3.1.1 Boot parameter settings for NAND Flash Target File System ................................................ 17
3.1.2 Boot parameter settings for NFS .............................................................................................. 17
3.2 Pre-Built NFS Target File System............................................................................................... 17
3.3 Running the Standalone Demos ................................................................................................. 18
3.4 Running the Demos from Command Line .................................................................................. 18
3.4.1 Running Graphics SDK Sample Applications .......................................................................... 19
3.4.2 Running Graphics SDK OpenGL ES1.x Demos...................................................................... 19
3.4.3 Running Graphics SDK OpenGL ES2.0 Demos...................................................................... 19
4Building the NFS Target File System with Graphics SDK Demos......................................................... 20
4.1 Building the NFS target file system ............................................................................................. 20
4.2 Modifying the init script to start the graphics SDK demos......................................................... 21
5Building the OMAP35x Graphics Demo Software .................................................................................. 22
5.1 Building the OMAP35x Graphics SDK Demos........................................................................... 22
5.2 Building and Executing Your Own Demos.................................................................................. 23
6Building the Graphics Kernel Modules..................................................................................................... 25

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
9
1 Overview
This chapter introduces the user to the OMAP35x Graphics SDK package along with the information on
how to get further software updates on the OMAP35x Graphics SDK.
1.1 What’s in the SDK Package?
The OMAP35x Graphics SDK package consists of the following folders
•GFX_Linux_SDK – This folder contains the OPENGL ES1.x, OPENGL ES2.0 and OPENVG
demos
•GFX_Linux_KM – This folder contains the source for graphics kernel modules
•gfx_dbg – This folder contains the debug version of graphics drivers
•gfx_rel – This folder contains the release version of graphics drivers
•targetfs – This folder contains the pre-built targetfs
•patches – This folder contains the patches that provides various additional functionalities as
explained below
opatches/argb_support_on_omap3503sdk_v102_patch – This folder contains patches that
adds support for the ARGB pixel format on graphics pipeline. For more information on
how to apply patches, refer to patch_readme.txt under the same folder.
opatches/gfx_ddk_23_10_kernel_2.6.27-rc13_patch - This folder contains patches that
modifies the OMAP35x Graphics SDK v3.00.00.06 kernel modules to work on open
source omap linux kernel version 2.6.27-rc13. For more information on how to apply
patches, refer to patch_readme.txt under the same folder.
•Getting Started Guide (This document)
•Rules.make (User modifications required to set the Graphics SDK install path)
•Makefile (Top level makefile used for building Graphics SDK demos and Installing in the NFS
target file system)
•readme.pdf – Contains the release information
The drivers included in the package are:
•OpenGL ES 1.1
•OpenGL ES 2.0
•OpenVG
•EGL

Document OMAP35x Graphics SDK Getting Started Guide Rev 1.2
Document Number SPRUFZ8 Date Feb 2, 2009
10
1.2 What’s next?
To get started on evaluating the OMAP35x Graphics capabilities and developing applications using the
SGX accelerator for OMAP35x EVM, begin by using this Getting Started guide. It is suggested that the
user follow the sequence described in the document. The sequence is outlined below.
•OMAP35x DVEVM Software Setup for Graphics SDK
•Executing the Graphics SDK Demonstration Software
•Building the NFS Target File System with Graphics SDK Demos
•Building the OMAP35x Graphics Demo Software
•Building the Graphics Kernel Modules
1.3 Command Prompts in this Guide
In this guide, commands are preceded by prompts that indicate the environment where the command is
to be typed. For example:
•host $
Indicates command to be typed into the shell window of the host Linux workstation.
•OMAP3EVM #
Indicates commands to be typed into the U-Boot shell in a console window connected to the EVM
board's serial port.
•target $
Indicates commands to be typed into the Linux shell in the terminal window connected to the
EVM board's serial port.
1.4 Updates & Further information
Please be sure to register your EVM at:
www.ti.com/omapregistration
Once registered you will be able to find software and documentation updates at:
www.ti.com/omapsoftwareupdates
A wiki based information site is available. User contributions are encouraged.
http://wiki.davincidsp.com/index.php?title=Main_Page