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

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,

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

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

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

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

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

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

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

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

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

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

Other manuals for OMAP35 Series

Table of contents

Other Texas Instruments Microcontroller manuals

Texas Instruments

Texas Instruments MSP430F67681 User manual

Texas Instruments

Texas Instruments TMS320F2837 D Series User manual

Texas Instruments

Texas Instruments DEV-RF002 User manual

Texas Instruments

Texas Instruments MSPM0G350 Series User manual

Texas Instruments

Texas Instruments Chipcon Products CC2400DK Programming manual

Texas Instruments

Texas Instruments Chipcon Products CC2420 User manual

Texas Instruments

Texas Instruments Tiva TM4C123GH6PM User manual

Texas Instruments

Texas Instruments CC2531 Installation manual

Texas Instruments

Texas Instruments MSP430F6723 User manual

Texas Instruments

Texas Instruments Chipcon Products CC1110DK Programming manual

Texas Instruments

Texas Instruments AFE79 Series User manual

Texas Instruments

Texas Instruments MSP430F6767 User manual

Texas Instruments

Texas Instruments TMS570LS User manual

Texas Instruments

Texas Instruments TMS320F2807 Series User manual

Texas Instruments

Texas Instruments SimpleLink CC3200 Wi-Fi User manual

Texas Instruments

Texas Instruments AM571 Series User manual

Texas Instruments

Texas Instruments CC2540 User manual

Texas Instruments

Texas Instruments MSP43 series User manual

Texas Instruments

Texas Instruments MSP430F663x User manual

Texas Instruments

Texas Instruments LaunchPad LAUNCXL-CC2650 User manual

Texas Instruments

Texas Instruments DRV8251/AEVM User manual

Texas Instruments

Texas Instruments LP-MSPM0L1306 User manual

Texas Instruments

Texas Instruments TMDX654IDKEVM User manual

Texas Instruments

Texas Instruments Serial Programming Adapter MSP430 User manual

Popular Microcontroller manuals by other brands

AMS

AMS AS7261 Demo Kit user guide

Novatek

Novatek NT6861 manual

Espressif Systems

Espressif Systems ESP8266 SDK AT Instruction Set

Nuvoton

Nuvoton ISD61S00 ChipCorder Design guide

STMicrolectronics

STMicrolectronics ST7 Assembler Linker user manual

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM user guide

NEC

NEC 78GK0S/K 1+ Series Application note

Mikroe

Mikroe SEMITECH N-PLC Click Application note

Intel

Intel Agilex user guide

Cypress

Cypress CY4607 HX2VL quick start guide

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE manual

CYPRES

CYPRES CY14NVSRAMKIT-001 user guide

Espressif Systems

Espressif Systems ESP8266EX Programming guide

Abov

Abov AC33M8128L user manual

Laird

Laird BL654PA user guide

Silicon Laboratories

Silicon Laboratories C8051F800 user guide

Energy micro

Energy micro EFM32 Giant Gecko Starter Kit user manual

Mikroe

Mikroe click Proximity 2 manual