Texas Instruments OMAP-L137 EVM User Manual

OMAP-L137 EVM PSP User’s Guide

Literature Number: SPRUGI8

February 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 so ld subject to TI's terms and conditions of sale supp l ie d at the tim e 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 cont ro l techniques are used to the extent TI de em s necessary to support this warra nt y. Except
where mandated by government requirements, testing of all para m et er s of each product is not necessarily perfor med.

TI assumes no liab ility for ap plications assistan ce or cus tomer prod uct desi gn. Cust omers ar e respo nsible fo r their prod ucts and
applications using TI com ponents. To minimize the risks associated with cus tomer products and app lications, custom ers should
provide adequate design and operating safeguards.

TI does not warran t or rep resen t that any lic ense, either expr ess or impl ied, is gr ante d unde r any T I paten t right, copyr ight, mask
work right, or other TI intel lectua l proper ty righ t relati ng to an y comb ination, mac hine, or proce ss in whi ch TI pro duc ts or services
are used. Information publish ed b y TI regar ding thir d-party pr oducts or se rvic es does not con stitu te a licens e 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 wa rranties, con ditions, limitations , and notices . Reproducti on of this inform ation with al teration is an unf air an d
deceptive business practice. TI is not responsible or liable for such altered documentation. Information of third parties may be subj ect
to additional restrictions.

Resale of TI p ro duc ts o r services with statements different from or beyond the paramet er s s tated 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 liab le for any such statements.

TI products are not authorized for use in safety-critical applications (such as life support) where a failure of the TI product would
reasonably be exp ected to cause severe perso nal injury or death, unless officers o f the parties have executed an agr eement
specifically governing such use. Buyers represent that they have all necessary expertise in the safety and regulatory ramifications
of their applications, and acknowledge and agree that they are solely responsible for all legal, regulatory and safety-related requ ire­ments concerning thei r pr oducts and any use of TI p roduc ts in such safe ty-crit ical a pplica tion s, notwi ths tanding an y app lica tions­related information o r sup po rt that m ay b e p rovided by TI . Fu rther, Buyers must ful ly in demn ify TI an d its rep resen tatives against
any damages arising out of the use of TI products in such safety-critical applications.

TI products are neither designed nor intended for use in military/aerospace applications or environments unless the TI products are
specifically designated by TI as military-grade or "enhanced plastic." Only product s designated by TI as military-grade meet military
specifications. Buyer s acknow ledge and a gree tha t any such use of TI prod ucts which TI ha s not design ated as m ilitary-grad e is
solely at the Buyer's risk, and that they are solely responsible for compliance with all legal and regulatory requirements in connection
with such use.

TI products are neither des igned nor int ended for us e in automo tive ap plications or environme nts unless th e specific TI products
are designated by TI as compliant with I SO/TS 16949 require ments. Buyers ackno wledge and agree th at, if they use any non­designated produ cts in autom otive applications, TI will not be respon si bl e f or any fail ur e t o m eet such requirements.

Following are URLs w he re you can obtain information on other Texas Instruments products and applicati on solutions:

Products Applications

Amplifiers amplifier.ti.com Audio www.ti.com/audio
Data Converters dataconverter.ti.com Automotive www.ti.com/automotive
DLP® Products www.dlp.com Broadband www.ti.com/broadband
DSP dsp.ti.com Digital Control www.ti.com/digitalcontrol
Clocks and Timers www.ti.com/clocks Medical www.ti.com/medical
Interface interface.ti.com Military www.ti.com/military
Logic logic.ti.com Optical Networking www.ti.com/opticalnetwork
Power Mgmt power.ti.com Security www.ti.com/security
Microcontrollers microcontroller.ti.com Telephony www.ti.com/telephony
RFID ww w.ti-rfid.com Video & Imaging www.ti.com/video
RF/IF and ZigBee® Solutions www.ti.com/lprf Wireless www.ti.com/wireless

Mailing Address: Texas Instruments, Post Office Box 655303 Dal las, Texas 75265
Copyright © 2009, Texas Instruments Incorporated

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, DEMON-

STRA TION, OR EV ALUATION PURPOSES ONL Y and is not considered by TI to be a finishe d
end-product fit for g eneral consumer use. Perso ns handling the product(s) m ust have electronics
training and observe good engineering practice standards. As such, the goods being provided
are not intended to be complete in terms of re quired desi gn-, market ing-, and/or man ufacturing ­related protective c onsiderations, including produ ct safety and environmental measures typically
found in end produc t s t hat i nc orpo r ate su ch sem ic on duc tor c omponents or circuit boards. T his
evaluation board/kit does not fall within the scope of the European Union directives regarding
electromagnetic compa tibility , restricted substances (RoHS), recyc ling (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 re turned within 30 day s from the d ate of deliv ery fo r a ful l refund. T HE FOR E­GOING WARRANTY IS THE EXCLUSIVE WARRANTY MADE BY SELLER TO BUYER AND
IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESSED, IMPLIED, OR STATUTORY, IN­CLUDING 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 CON­SEQUENTIAL DAMAGES.

TI currently deals wi th a v ari ety of c ustom ers for pro du ct s , an d the r efo re ou r arra nge ment 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 Use r's Guide and, specifically , the W arnings and Restrictio ns notice in the User's
Guide prior to handling the product. This notice contains important safety information about
temperatures and vo lt ag es . Fo r ad ditional information on TI 's en vi ronm en tal and/or safety pro­grams, please contact the TI application engineer or visit www.ti.com/esh.

No license is granted un der any p aten t right or other intel lectual pro per ty right of TI co verin g 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 7526 5

Copyright © 2009, Texas Instruments Incorporated

FCC Warning

This evaluation board/kit is intended for use for ENGINEERING DEVELOPMENT, DEMON­STRA TION, OR EV ALUATION PURPOSES ONLY and is not consid ered by TI to be a finis hed

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 interfere nce . Op era tion of this equipment in other enviro nm ent s ma y c aus e in terfe r ­ence with radio co mm unications, in which case the user at his own expense w il l be req uire d to
take whatever measures may be required to correct this interference.

About This Guide

Intended Audience

Preface

This document descri bes how to install and get started with TI's Linux
Platform Support Product (PSP) 02.20 package for the OMAP-L137
Evaluation Module (EVM).

This document describes the f ollowing:

❏ Installing the PSP package
❏ Building the PSP package
❏ Running U-Boot and Linux kernel on the EVM

This document is intended for system engineers who want to get started
using the Linux PSP package for OMAP-L137 EVM board.

This document assumes yo u have knowledge of the OM AP-L137 EVM
platform and have bas ic knowledge abou t installing and us ing software
on embedded Linux platforms.

Notational Conventions

This document uses the following conventions:

❏ Program listings, program examples, and interactive displays are

❏ Square brackets ( [ and ] ) identify an option al paramete r. If you use

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.).

an optional parameter, you specify the information within the
brackets. Unless t he sq uar e brac k ets a re in a bold typeface, do not
enter the brackets themselves.

v

Trademarks

Trademarks

The Texas Instruments logo and Texas Instruments are registered
trademarks of Texas Instruments. Trademarks of Texas Instruments
include: TI, DaVinci, the DaVinci logo, XDS, Code Composer, Code
Composer Studio, Probe Point, Code Explorer , DSP/BIOS, RTDX, Online
DSP Lab, DaVinci, eXpressDSP, TMS320, TMS320C6000,
TMS320C64x, TMS320DM644x, and TMS320C64x+.

MS-DOS, Windows, and Windows NT are trademarks of Microsoft
Corporation.

UNIX is a registered trad emark of The O pen Grou p in the Un ited States
and other countries.

Linux is a registered trademark of Linus Torvalds.
Solaris, SunOS, and Java are trademarks or re gistered trademarks of

Sun Microsystems, Inc.
All other brand, product na mes, and service names are trademark s or

registered trademarks of their respective companies or organizations.

February 13, 2009

vi

Contents

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1

This chapter introduces the OMAP-L137 EVM PSP.

1.1 What is a Platform Support Product (PSP) Package? . . . . . . . . . . . . . . . . . . . . . . . . . .1-2

1.2 About this User Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2

2 Installing the Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1

This chapter describes the installation procedure for OMAP-L137 EVM Linux PSP package.

2.1 Downloading the Release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2

2.2 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2

2.3 Running the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3

3 Installing MontaVista Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1

This chapter explains how to set up the demonstration version of the MontaVista Pro 5.0 software
provided with the kit.

3.1 Software Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2

3.2 Preparing to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

3.3 Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

3.3.1 Installing the Target Linux Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

3.3.2 Exporting a Shared File System for Target Access . . . . . . . . . . . . . . . . . . . .3-5

3.3.3 Testing the Shared File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.4 Setting Up the Build/Development Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7

3.4.1 Writing a Simple Program and Running it on the EVM . . . . . . . . . . . . . . . . .3-7

4 Building PSP Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1

This chapter explains how to build various components of the PSP.

4.1 Building U-Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2

4.2 Building a New Linux Kernel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2

4.3 Building the SPI Flash User Boot Loader (UBL). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-3

4.4 Building Flash Writers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-3

4.4.1 Building an SPI Flash Writer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-3

5 Booting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1

This chapter describes how to run the target content that is provided as a part of the PSP package.

5.1 Booting from SPI Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-2

5.2 Driver Configuration in the Linux Kernel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

5.2.1 USB 2.0 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

vii

Contents

5.2.2 USB 1.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

5.2.3 Audio Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

5.2.4 Graphical LCD Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

5.2.5 Character LCD Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6

5.2.6 NAND Flash Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

5.2.7 NOR Flash Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

5.2.8 MMC/SD Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

5.3 Building and Loading Kernel Modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

5.3.1 Loading USB 2.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

5.4 Booting the Linux Kernel Using U-Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

5.4.1 Booting from SDRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11

5.4.2 Booting from SPI Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11

5.4.3 Booting from USB Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

A Additional Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

This appendix describes optional procedures you may use depending on your setup and specific
needs.

A.1 Loading the DSP User Bootloader into SPI-Flash Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

A.2 Building the SPI DSP AIS Binary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

A.3 Setting Up a TFTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4

A.4 Connecting to a Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

viii

Introduction

This chapter introduces the OMAP-L137 EVM PSP.

Chapter 1

Topic Page

1.1 What is a Platform Support Product (PSP) Package? . . . . . . . . . . . 1–2

1.2 About this User Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2

1-1

What is a Platform Support Product (PSP) Package?

1.1 What is a Platform Support Product (PSP) Package?

This document descri bes how to install and get started with TI's Linux
Platform Support Product (PSP) 02.20 package for the OMAP-L137
Evaluation Module (EVM).

This PSP package suppor ts the OMAP-L137 EVM. This PS P package
includes the following components:

❏ Demonstration version of MontaVista (MV) Linux Pro 5.0 (Kernel

Version 2.6.18) ported for OMAP-L137 EVM. Th e kernel is compiled
with MV Pro 5.0 ToolChain based on GCC 4.2.0.

❏ U-Boot version 1.3.3 ported for OMAP-L137 EVM. The U-Boot is

compiled with MV Pro 5.0 ToolChain based on GCC 4.2.0.

❏ SPI and NAND Flash writers. These are Cod e Composer Studio

(CCStudio) based utilities. CCStudio v3.3 is supported on the OMAP­L137 EVM. (The NAND Flash writer is not applicable to OMAP-L137
EVM.)

1.2 About this User Guide

❏ Chapter 2, "Installing the Package", describes the installation

procedure for OMAP-L137 EVM Linux PSP package.

❏ Chapter 4, "Building PSP Components", describes the build

procedure for U-Boot and Linux kernel.

❏ Chapter 5, "Booting", describes how to run U-Bo ot and Lin ux kernel

on the OMAP-L137 EVM

Note: Please see the release notes included in the package before starting
to use the package. The release notes contain important information about
feature support, issues, and compatibility information for a particular
release.

1-2

Chapter 2

Installing the Package

This chapter describe s the installation procedure fo r OMAP-L137 EVM
Linux PSP package.

Topic Page

2.1 Downloading the Release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–2

2.2 System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–2

2.3 Running the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–3

2-1

Downloading the Release

2.1 Downloading the Release

Please contact your local FAE for release package and updates.

2.2 System Requirements

The Linux EVM Driver is suppor ted on platforms characterized by the
following requirements:

Hardware

❏ Host machine. Host machine requirements are driven by

MontaVista Pro 5.0 and CCStudio installations. The PSP is verified
using MontaVista Pro 5.0 installed on RedHat Enterprise Linux WS
release 4 and CCStudio v3.3 installed on Microsoft Windows XP
Service Pack 2.

❏ Target Board. OMAP-L137 EVM
❏ Emulation Setup. Onboard emulation on OMAP-L137 EVM

Only the OMAP-L137 EVM is required.

Software

❏ Code Composer Studio 3.3.38
❏ MontaVista Pro 5.0 for ARM v5t

2-2

2.3 Running the Installation

Follow these steps to perform the necessary installations:

1) To install the PSP package, extract the release package with the
following command (r eplace # in these comm ands with the releas e
version number of your release package):

tar -xzf REL_LSP_02_20_#_#.tgz

The following files and directories are extracted:

REL_LSP_02_20_#_#

Running the Installation

mvl_5_0_0_demo_lsp_setuplinux_02_20_#_#.bin

PSP_02_20_#_#

examples

docs

board_utilities

u-boot-1.3.3.tar.gz

flash_writers

tools

armubl

dspubl

bin

lsp_psp_02_20_#_#_release_notes.html

2) Move (cd command) to the REL_LSP_02_20_#_# directory that was
extracted.

Installing the Package 2-3

Running the Installation

3) To install the Linux kernel, run
mvl_5_0_0_demo_lsp_setuplinux_02_20_#_#.bin on the Linux host.
This is a self-installing executable which installs a tar ball named
LSP_02_20_#_#.tar.gz at the chosen location.

4) Untar the LSP_02_20_#_#.tar.gz tar ball to obtain the kernel
sources.

5) Untar the PSP_02_20_#_#/board_utilities/u-boot-1.3.3.tar.gz file to
obtain the U-Boot sources.

6) Flash writer sources and CCStudio projects are provided in the
PSP_02_20_#_#/board_utilities/flash_writers directory.

7) Pre-compiled binaries for U-Boot, Linux kernel and Flash writers are
provided in the PSP_02_20_#_#/bin directory.

2-4

Chapter 3

Installing MontaVista Tools

This chapter explains how to set up the demonstration version of the
MontaVista Pro 5.0 software provided with the kit.

Topic Page

3.1 Software Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2

3.2 Preparing to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–3

3.3 Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–3

3.4 Setting Up the Build/Development Environment . . . . . . . . . . . . . . . 3–7

3-1