Texas Instruments TMS320DM644 Series User manual

TMS320DM644x DVEVM Windows CE v5.0BSP DSP/BIOS LINK
User's Guide
Literature Number: SPRUEW0
March 2007

2 SPRUEW0 – March 2007Submit Documentation Feedback

Contents
Trademarks ................................................................................................................ 5Preface ............................................................................................................................... 6
1 Distribution ............................................................................................................... 81.1 Distribution Contents .................................................................................................. 81.2 Contents of DSP/BIOS™ LINK ..................................................................................... 9
2 Mininum System Requirements .................................................................................. 102.1 Hardware .................................................................................................................. 102.1.1 Development/Debug Host Machine ......................................................................... 102.2 Software .................................................................................................................. 102.2.1 Generic Software Requirement ............................................................................... 102.2.2 Platform Specific Software Requirements for DaVinci EVM .............................................. 10
3 DSP/BIOS Link Usage ............................................................................................... 113.1 WinCE Platform Configurations for DSP/BIOS LINK ...................................................... 113.1.1 Config.bib ........................................................................................................ 113.1.2 Platform.bib ...................................................................................................... 113.1.3 Platform.reg ..................................................................................................... 12
4 Sample Applications ................................................................................................. 134.1 Loop Sample ............................................................................................................ 134.1.1 Invoking the Application ....................................................................................... 134.2 Message Sample ....................................................................................................... 144.2.1 Invoking the Application ....................................................................................... 154.3 Scale Sample ............................................................................................................ 154.3.1 Invoking the Application ....................................................................................... 164.4 READWRITE Sample ................................................................................................. 164.4.1 Invoking the Application ....................................................................................... 17
SPRUEW0 – March 2007 Table of Contents 3Submit Documentation Feedback

List of Figures
1-1 DSP/BIOS LINK Distribution Folder ....................................................................................... 84-1 Data Flow in the Sample Application – LOOP.......................................................................... 134-2 Execution of Loop.exe in Platform Builder .............................................................................. 144-3 Message Flow in the Sample Application - MESSAGE ............................................................... 154-4 Data and Message Flow in the Sample Application – SCALE ....................................................... 164-5 Data and Message Flow in the Sample Application – READWRITE ................................................ 174-6 Execution of Readwritegpp.exe From the Platform Builder ........................................................... 18
List of Tables
1 Terms, Acronyms, and Descriptions ...................................................................................... 61-1 Distribution Tree ............................................................................................................. 9
4List of Figures SPRUEW0 – March 2007Submit Documentation Feedback

Trademarks
DaVinci, DSP/BIOS are trademarks of Texas Instruments.
Windows, Microsoft are registered trademarks of Microsoft Corporation in the United States and/or othercountries.
SPRUEW0 – March 2007 List of Tables 5Submit Documentation Feedback

PrefaceSPRUEW0 – March 2007
Read This First
About This Manual
This document accompanies the release of Windows
®
CE 5.0 BSP for DaVinci™ evaluation module(EVM) board.
Purpose and ScopeThis document describes the usage of the DSP/BIOS™ LINK binaries provided along with the WindowsCE 5.00 BSP for the DaVinci EVM platform, information on the DSP LINK binaries released, and theprocedure to integrate them in a given Windows CE image.
Notational Conventions
This document uses the following conventions.•Backward slashes are used as pathname delimiters for filenames.•Catalog->Third Party refers to the Catalog Window Tree Items in the Platform Builder IDE.•All the shell commands are in courier new font.•Menu commands are depicted using the following notation menu name > menu command.
Terms, Abbreviations, and Descriptions
Table 1. Terms, Acronyms, and Descriptions
Number Term Description
1 BIB Binary Image Builder2 BSP Board Support Package3 CHIRP Channel I/O Request Packets4 CHNL Channel5 EVM Evaluation Module6 GIO General Input Output7 GPP General Purpose Processor8 LDRV Link Driver9 OSAL OS Abstraction Layer10 PCPY Processor Copy Driver11 PROC Processor12 SHMIPS Shared Memory Inter-processor Signaling13 SIO Streaming Input Output14 SMA Shared Memory Allocator15 SWI Software Interrupt16 TSK Task17 ZCPY Zero Copy Driver
Preface6 SPRUEW0 – March 2007Submit Documentation Feedback

www.ti.com
Related Documentation from Texas Instruments
Related Documentation from Texas InstrumentsThe following documents describe the DVEVM Windows CE v5.0 BSP.
SPRUEV9 — TMS320DM644x DVEVM Windows CE v5.0 BSP Codec Engine Users Guide.Provides information about the release contents of Windows CE 5.0 BSP for DaVinci-basedDVEVM. The document illustrates various components that are part of this release, the procedureto install this release on to the host system, and the limitations of the release.
SPRUEW1 — TMS320DM644x DVEVM Windows CE v5.0 BSP Bootloader Users Guide.Provides information about the Windows CE 5.0 bootloader for DaVinci EVM. The documentillustrates various features and the build and flash procedures.
SPRUEW0 — TMS320DM644x DVEVM Windows CE v5.0 BSP DSP/BIOS Link Users Guide.Describes the usage of the DSP/BIOS Link binaries provided along with the Windows CE 5.00 BSPfor the Davinci EVM platform and the integration procedures in a given Windows CE image.
SPRUEV8 — TMS320DM644x DVEVM Windows CE v5.0 Codec Engine Binary Users GuideProvides information on the build procedure for the codec engine samples on Windows CE 5.0platform.
SPRS283 — TMS320DM6446 Digital Media System-on-Chip Data Manual (SPRS283)The TMS320DM6446 (also referenced as DM6446) leverages TI’s DaVinci™ technology to meetthe networked media encode and decode application processing needs of next-generationembedded devices.
SPRUEW0 – March 2007 Read This First 7Submit Documentation Feedback

1.1 Distribution Contents
SPRUEW0 – March 2007
Distribution
DSP/BIOS™ LINK is foundation software for inter-processor communication across theGPP DSP boundary. It provides a generic API that abstracts the characteristics of thephysical link connecting GPP and DSP from the applications. This release contains thebinaries of the DSP/BIOS LINK drivers and samples showing the usage of DSP/BIOSLINK APIs.
The DSP/BIOS LINK binaries are bundled along with the Davinci EVM Windows CE 5.00 BSP. The layoutof the DSP/BIOS LINK distribution is shown in Figure 1-1
Figure 1-1. DSP/BIOS LINK Distribution Folder
8Distribution SPRUEW0 – March 2007Submit Documentation Feedback

www.ti.com
1.2 Contents of DSP/BIOS™ LINK
Contents of DSP/BIOS™ LINK
Table 1-1. Distribution Tree
PATH FILES
DSP/BIOSLINK\CE\BIN\ARMV4I\ dspbioslink.dll[DEBUG | RETAIL] dspbioslink.expDEBUG and RETAIL versions of the DSP/BIOS LINK DLLs are dspbioslink.libplaced in this folder. dspbioslink.relDSP/BIOSLINK\SAMPLES\DSP loop.outThe DSP side samples are copied into this folder message.out
readwrite.out
scale.outDSPBIOSLINK\SAMPLES\DSP\LOOP Contains the LOOP Sample DSP source codeDSPBIOSLINK\SAMPLES\DSP\MESSAGE Contains the MESSAGE Sample DSP source codeDSPBIOSLINK\SAMPLES\DSP\READWRITE Contains the READWRITE Sample DSP source codeDSPBIOSLINK\SAMPLES\DSP\SCALE Contains the SCALE Sample DSP source codeDSPBIOSLINK\SAMPLES\GPP\LOOP Contains the LOOP Sample GPP source codeDSPBIOSLINK\SAMPLES\GPP\MESSAGE Contains the MESSAGE Sample GPP source codeDSPBIOSLINK\SAMPLES\GPP\READWRITE Contains the READWRITE Sample GPP source codeDSPBIOSLINK\SAMPLES\GPP\SCALE Contains the SCALE Sample GPP source codeDSPBIOSLINK Contains the Windows CE Registry Entries for the selectedDSPLINK Configuration specific to DaVinci
The binary release of DSP/BIOS™ software kernel foundation LINK contains the following:•Binary DLLs for DSP/BIOS LINK PMGR and DSP/BIOS LINK API modules•Sample program to test the CHNL, PROC and MSGQ APIs provided by DSP/BIOS LINK.•DSP Image executables used by the DSPLINK sample programs.
SPRUEW0 – March 2007 Distribution 9Submit Documentation Feedback

2.1 Hardware
2.1.1 Development/Debug Host Machine
2.2 Software
2.2.1 Generic Software Requirement
2.2.2 Platform Specific Software Requirements for DaVinci EVM
SPRUEW0 – March 2007
Mininum System Requirements
This section includes the system requirements for integrating LINK binaries andexecuting the LINK samples.
The following are the target requirements to test and run this software:•DaVinci EVM board, Rev-D•Standard RS232 serial port for loader communications.•Any Ethernet adapter for the host platform to support Ethernet download/debug/retail connectivity(optional). A local area network (LAN) hub is recommended.•Serial cable•Ethernet cable
The following are the requirements for the DSPLINK for Windows CE. All requirements are for the hostmachine unless otherwise noted.•500MHz Pentium II processor or higher; 1GHz recommended.•Microsoft
®
Windows
®
2000 Professional with Service Pack 2 (SP2) or Windows XP Professional.•256MB of RAM•Microsoft Windows CE 5.0 Platform Builder•250MB of free disk space•At least 300MB of additional disk space to build the image
•Platform Builder for Windows CE 5.0 with all the patches installed•Tera Term (or any other serial port emulation program)
•Windows CE 5.0 BSP for the DaVinci EVM board containing the DSPLINK binaries.•CCS 3.2 IDE (if DSP-side development/debugging is required)
10 Mininum System Requirements SPRUEW0 – March 2007Submit Documentation Feedback