Texas Instruments TMS320DM357 User manual

Printed on Recycled Paper
TMS320DM357 DVEVM v2.05
Getting Started Guide
Literature Number: SPRUGH0
December 2008

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
withTI'sstandardwarranty.TestingandotherqualitycontroltechniquesareusedtotheextentTIdeemsnecessary
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. Customersare 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 infor-
mation 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 solu-
tions:
Mailing Address: Texas Instruments
Post Office Box 655303 Dallas, Texas 75265
Copyright © 2008, Texas Instruments Incorporated
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

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-
STRATION, OR EVALUATION PURPOSES ONLY and is not considered by TI to be a finished
end-productfitforgeneralconsumeruse.Personshandlingtheproduct(s)musthaveelectronics
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-
relatedprotectiveconsiderations,includingproductsafetyandenvironmentalmeasurestypically
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
electromagneticcompatibility,restrictedsubstances(RoHS),recycling(WEEE),FCC,CEorUL,
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 FORE-
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 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.
PleasereadtheUser'sGuideand,specifically,theWarningsandRestrictionsnoticeintheUser'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 pro-
grams, please contact the TI application engineer or visit www.ti.com/esh.
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, DEMON-
STRATION, 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 interfer-
ence 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.

v
This is a draft version printed from file: pref.fm on 12/15/08
Preface
About This Guide
The DVEVM (Digital Video Evaluation Module) is an evaluation platform
that showcases the DaVinci architecture and lets users evaluate the
power and performance of DaVinci as a Multimedia engine.
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 DVEVM. Other documents provide more
in-depth information. See the DVEVM 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.

vi
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, 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.
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.
December 15, 2008

vii
This is a draft version printed from file: davinci_gsgTOC.fm on 12/15/08
Contents
1 DVEVM Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1
This chapter introduces the DVEVM (Digital Video Evaluation Module).
1.1 What’s in this Kit?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
1.2 What’s on the Board?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
1.3 What’s Next? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
2 EVM Hardware Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1
This chapter tells you how to set up the EVM hardware.
2.1 Setting Up the Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
2.2 Connecting to a Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
3 Running the Demonstration Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
This chapter explains how to run the software demos provided with the DVEVM kit.
3.1 Default Boot Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
3.2 Starting the Standalone Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
3.3 Running the Standalone Demos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5
3.3.1 Shutting Down the Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
3.3.2 About the Encode + Decode Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
3.3.3 About the Encode Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
3.3.4 About the Decode Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9
3.4 Running the Demos from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10
3.5 Running the Network Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-11
4 DVEVM Software Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
This chapter explains how to use the software provided with the DVEVM.
4.1 Software Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2
4.1.1 Command Prompts in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-3
4.1.2 Software Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-4
4.2 Preparing to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5
4.3 Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6
4.3.1 Installing the Target Linux Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6
4.3.2 Installing the DVSDK Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7
4.3.3 Installing the A/V Demo Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8
4.3.4 Exporting a Shared File System for Target Access . . . . . . . . . . . . . . . . . . . .4-8
4.3.5 Testing the Shared File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-10
4.3.6 Notes on Using Evaluation/Production Codecs . . . . . . . . . . . . . . . . . . . . . .4-11

Contents
viii
4.4 Setting Up the Build/Development Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
4.4.1 Writing a Simple Program and Running it on the EVM. . . . . . . . . . . . . . . . 4-12
4.5 Building a New Linux Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
4.6 Rebuilding the DVEVM Software for the Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
4.7 Building with DSPLink. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
4.8 Booting the New Linux Kernel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
4.9 Using the Digital Video Test Bench (DVTB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
A Additional Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
This appendix describes optional procedures you may use depending on your setup and specific
needs.
A.1 Changing the Video Input/Output Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
A.2 Putting Demo Applications in the Third-Party Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
A.3 Setting Up a TFTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5
A.4 Alternate Boot Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6
A.5 Updating/Restoring the Bootloaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
A.6 Restoring the NAND Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-12

1-1
Chapter 1
DVEVM Overview
This chapter introduces the DVEVM (Digital Video Evaluation Module).
1.1 What’s in this Kit? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
1.2 What’s on the Board? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
1.3 What’s Next? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4
Topic Page

What’s in this Kit?
1-2
1.1 What’s in this Kit?
Your TMS230DM357 DVEVM kit contains the following hardware items.
Section 2.1, Setting Up the Hardware tells how to connect these
components.
❏EVM Board This board contains a DaVinci TMS320DM357 Digital
Media System-on-Chip.
❏Universal Power Supply. Both U.S. and European power are
supported.
❏Cables. Serial and Ethernet cables are included to allow for host
development.
❏IR Remote Control (Phillips). This universal remote control is
included to provide a user interface to the demo applications.
The DVEVM kit also comes with the following software disks. Information
about how to use the software components is provided in Chapter 4.
❏DaVinci Digital Software Developer’s Kit, including TI DaVinci
Demonstration Version of MontaVista Linux Pro v5.0. (2 DVDs)
❏Spectrum Digital EVM Tools

What’s on the Board?
DVEVM Overview 1-3
1.2 What’s on the Board?
The EVM comes loaded with peripherals your multimedia applications
may need to make use of. The following block diagram shows the major
hardware components.
Figure 1–1 DM357 Hardware Block Diagram
For more information about the hardware, see the Spectrum Digital
website at http://support.spectrumdigital.com/boards/evmdm357.
The DaVinci EVM incorporates a battery holder to provide backup power
to the MSP430’s real-time clock when the power is not applied to the
board. The battery is not included in the kit. See the Spectrum Digital
DaVinci EVM Technical Reference for suggested battery part numbers.
IR PWR
SW
S3
Config
DC3 DC2
3V
BAT
SD/
MMC
TI JTAG MSP430
JTAG
SVHS
IN
USB
VIDEO
IN
AUDIO
IN
HP OUT
AUDIO
OUT
S/PDIF
Optical
S/PDIF
Analog
UART
+5V
MSP430
User LEDs
DC7
DC6
S1 Storage
NAND
1.2V CPU Core Voltage
1.8V I/O Voltage
3.3V Board Supply Voltage
AIC33
I2C
GPIO
I2C
GPIO
I2C
GPIO I2C
EEPROM
DC4 (VIDEO IN)
TVP
5146 S/PDIF
Drivers
COMP
OUT
DC5 (VIDEO OUT)
EMIF
Video Ports
DDR
I2C
CPLD
Serial Media
ENET
PHY
EMAC
CPLD
PGM
DDR
DDR
10/100
ENET
DC1 (EMIF)
TMS320
DM357
ARM JTAG
Boot
NAND
Diagram provided courtesy of Spectrum Digital Inc.

What’s Next?
1-4
1.3 What’s Next?
To get started evaluating the DVEVM kit and developing applications for
the DM357, begin by using this Getting Started guide. It will step you
through connecting the hardware, testing the software, and beginning to
develop applications.
When you are ready for more information about DaVinci Technology and
the DM357 architecture, see the following:
❏Spectrum Digital website:
http://support.spectrumdigital.com/boards/evmdm357
❏TI DaVinci Software Updates: http://www.ti.com/dvevmupdates
❏TI Linux Community for DaVinci Processors:
http://linux.davincidsp.com
❏Codec Engine Application Developer's Guide (SPRUE67)
❏TI DaVinci Technology Developers Wiki: http://wiki.davincidsp.com
❏Other PDF documents on the DVDs included with the DVEVM kit

2-1
Chapter 2
EVM Hardware Setup
This chapter tells you how to set up the EVM hardware.
2.1 Setting Up the Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–2
2.2 Connecting to a Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–6
Topic Page

Setting Up the Hardware
2-2
2.1 Setting Up the Hardware
To set up the hardware provided with the DVEVM kit, use the steps that
follow. You may skip steps if you do not need to access a particular
peripheral. For example, if you do not need to use the serial cable, skip
that step.
For reference, the numbers in the following photo of the DM357 EVM
target board correspond to the steps in the procedure.
Important: The EVM board is sensitive to static
discharges. Use a grounding strap or other device to
prevent damaging the board. Be sure to connect
communication cables before applying power to any
equipment.
1
2
3456 7
8
1
2
3456 7
8

Setting Up the Hardware
EVM Hardware Setup 2-3
1) On the S3 mini-dip switch, verify that positions 1 through 4 are
configured to boot from on-board NAND as in the following figure,
where the black rectangle is the switch location.
Also on the S3 mini-dip switch, verify that position 10 selects the
correct video format—NTSC or PAL. The following diagram shows
the switch in the NTSC setting.
2) Connect an audio speaker to Stereo Line Out (P5) and an audio
source to Stereo Line In (P3).
1
2
3
4
5
6
7
8
9
10
Audio In (P3) Audio Out (P5)

Setting Up the Hardware
2-4
3) Connect your video display to the composite video-out RCA
connector (J8).
4) Connect a video source (such as a camera or DVD player) to the
composite video-in RCA connector (J12). Then power on your video
input and output devices.
Composite
Video Out (J8)
Composite
Video In (J12)

Setting Up the Hardware
EVM Hardware Setup 2-5
5) (Optional) If you plan to use the UART port for a console window,
connect the provided RS-232 null modem cable to the EVM UART
port (P6) and to a COM port on your host Linux workstation.
6) (Optional) If you will be using an Ethernet connection, connect the
provided Ethernet cable to the Ethernet port (P2) on the EVM board
and to an Ethernet network port.
Note: If you do not connect the board’s Ethernet controller to a
computer running a DHCP server, booting the board may take
several additional minutes.
7) Connect the provided power cable to the DVEVM power jack (J14)
on the board. To be ESD safe, plug in the other end of the cable only
after you have connected the power cord to the board.
8) Power on the EVM board by flipping the power switch (SW1).
10/100
Ethernet (P2) UART (P6) Power (J14)

Connecting to a Console Window
2-6
9) You should see the initial screen of the demo software on your video
display. Use the IR remote to run the software as described in
Chapter 3.
2.2 Connecting to a Console Window
You can open a console window that allows you to watch and interrupt
EVM boot messages by following these steps:
1) Connect a serial cable between the serial port on the EVM and the
serial port (for example, COM1) on a PC.
2) Run a terminal session (such as Minicom on Linux or HyperTerminal
on Windows) on the workstation and configure it to connect to that
serial port with the following characteristics:
■Bits per Second: 115200
■Data Bits: 8
■Parity: None
■Stop Bits: 1
■Flow Control: None
3) When you power on the EVM, you will see boot sequence messages.
You can press a key to interrupt the boot sequence and type
commands in the U-Boot command shell. In this guide, commands to
be typed in the U-Boot shell are indicated by an
EVM # prompt.

3-1
Chapter 3
Running the Demonstration Software
This chapter explains how to run the software demos provided with the
DVEVM kit.
3.1 Default Boot Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2
3.2 Starting the Standalone Demos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2
3.3 Running the Standalone Demos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–5
3.4 Running the Demos from the Command Line . . . . . . . . . . . . . . . . 3–10
3.5 Running the Network Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–11
Topic Page

Default Boot Configuration
3-2
3.1 Default Boot Configuration
Out of the box, the EVM boots from flash and starts the demos
automatically after a few seconds when you power up the board. It does
not require an NFS mount or a TFTP server to run the standard demos.
Note: The default U-Boot bootargs definition sets "ip=off", which disables
the Ethernet connection.
The out-of-the-box boot parameters are listed in Section A.4.1. The
following are alternate ways you may want to boot the board:
❏TFTP boot with NAND flash file system (Section A.4.2)
❏Flash boot with NFS file system (Section A.4.3)
❏TFTP boot with NFS file system (Section A.4.4)
❏PAL video mode vs. NTSC video mode (Section 2.1)
To abort the standard boot, press any key in the console window (see
Section 2.2). Also see Section A.4, Alternate Boot Methods if you want to
change the boot configuration.
Note: It is best to power down the board cleanly in order to reboot,
rather than using the reset button or power switch. We recommend
that you use the shutdown command to shut down the operating
system and unmount the file system before removing power from
the board. This will help prevent corruption of the flash-based root
file system.
3.2 Starting the Standalone Demos
When you connect the EVM hardware, the pre-loaded examples run
automatically on your video display. These examples encode and
decode audio, video, and speech. There are two ways to use the demos:
❏Standalone. This is the default power-on mode. The demos run
automatically with no connection to a workstation in the default boot
configuration. This is the mode documented in the rest of this
chapter.
The standalone demo was set up by the DVSDK, which copies the
file /examples/dvevmdemo to the directory /etc/rc.d/init.d (the central
repository for startup scripts). This file is symbolically linked to
/etc/rc.d/rc3id/S88demo. When the board boots up and enters
runlevel 3, this file is executed to start the demo web server and the
demo interface.