manualshive.com logo in svg

Texas Instruments TMS320DM6437, Getting Started Manual, Page: 36 / 64

Share
Download
Texas Instruments TMS320DM6437 Getting Started Manual Download Page 36

Software Overview

4-2

4.1

Software Overview

The DaVinci software approach provides interoperable, optimized,
production-ready video and audio codecs that leverage DSP and
integrated accelerators. These codecs are built into configurable
frameworks, and are presented via published APIs within popular
operating systems (such as Linux) for rapid software implementation.

4.1.1

Software Components

The software included with the TMS320DM6437 DVDP is the Digital
Video Software Development Kit (DVSDK). 

The heart of this software is the Codec Engine programming model.
Related components include the DSP/BIOS target operating system,
drivers, a networking stack (evaluation version). Customers can use the
provided Codec Engine or choose individual components for their own
video application development.

For the TMS320DM6437 DVDP, which is a DSP-only kit, the DVSDK
includes Microsoft Windows host software.

For more information about the software components used in these
applications see www.ti.com and the PDF files included with the
installation.

Summary of Contents for TMS320DM6437

Page 1: ...TMS320DM6437 DVDP Getting Started Guide Literature Number SPRUEV6 July 2007 ...

Page 2: ...vice and is an unfair and deceptive business practice TI is not responsible or liable 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 expected to cause severe personal injury or death unless officers of the parties have executed an agreement specifically governing such use Buye...

Page 3: ...ATUTORY 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 ...

Page 4: ...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 mea...

Page 5: ...o be used as the initial getting to know you document for the DVDP Other documents provide more in depth information See the DVDP documentation index for a complete list of documents that have been included with the product Additional Documents and Resources You can use the following sources to supplement this user s guide TMS320DM6437 Digital Video Development Platform DVDP http www ti com dm6437...

Page 6: ...rademarks 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 ...

Page 7: ...vided with the DVDP 3 1 Overview of the Demo Software 3 2 3 2 Running the Demos in Standalone Mode 3 2 3 3 Running the Demos with the PC Host Application 3 4 3 3 1 Preview Mode Capture Display 3 11 3 3 2 Enc Dec Loopback Mode 3 11 3 3 3 Decode from File Mode 3 11 3 3 4 Encode to File Mode 3 11 3 4 About Buttons and Switches 3 12 3 4 1 PAL NTSC Switch 3 12 3 4 2 Demo Mode Switches 3 12 3 4 3 Reset ...

Page 8: ... This appendix describes optional procedures you may use depending on your setup and specific needs A 1 Using the Bootloader A 2 A 2 Replacing the Demo Codec Combinations A 2 A 3 Using the FlashBurn Utility A 3 A 4 Rebuilding the Demo Host Software A 6 ...

Page 9: ... 1 TMS320DM6437 DVDP Overview This chapter introduces the TMS320DM6437 DVDP Digital Video Development Platform 1 1 Welcome 1 2 1 2 What s in this Kit 1 3 1 3 What s on the Board 1 4 1 4 What s Next 1 4 Topic Page ...

Page 10: ...f the DaVinci software and development infrastructure by allowing designers to focus on the application functionality Developers can implement video audio voice and speech technology through simple calls to the DaVinci application programming interface API that manages the implementation of codec engines and matching screen resolutions The DM6437 EVM board looks like this The intended audience is ...

Page 11: ...and G 711 encoder decoder Also contains documentation drivers Chip Support Library CSL Digital Video Test Bench and an evaluation version of Network Developer s Kit NDK CD 2 of 2 Contains sample AV files DM643x SoC Analyzer case CD 1 of 1 Contains Windows installer for SoC Analyzer VirtualLogix VLX for Digital Media 22 CD ROMs The VirtualLogix DVD case contains royalty free VirtualLogix Linux Virt...

Page 12: ...DM643x 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 DM643x architecture see the following TMS320DM6437 Digital Video Development Platform DVDP http www ti com dm6437dvdp DM6437 EVM at Spectrum Digital http c6000 spectrumdi...

Page 13: ...2 1 Chapter 2 DVDP Hardware and Software Setup This chapter tells you how to set up the DVDP hardware and software 2 1 Setting Up the Hardware 2 2 2 2 Installing the Software 2 6 Topic Page ...

Page 14: ...D safe do not plug in the power cord of peripheral devices such as audio and video input and output devices until the later step that instructs you to do so 2 Verify that the board jumper JP1 is set to the correct display format either NTSC or PAL as shown in the following diagram 3 Verify that the board jumpers and switches are set as shown in the following diagram so that the boot mode is EMIF b...

Page 15: ... the kit See Section 2 2 Installing the Software for more details 5 Connect a composite video cable from an NTSC or PAL video camera or some other video input device to the EVM board s Video In RCA jack J5 as shown below 6 Connect a composite video cable from a video display to the EVM board s DAC D Video Out RCA jack J4 ...

Page 16: ... Line Out Connector 3 5 mm stereo jack P13 9 Use the provided USB cable to connect the EVM s USB connector to a PC You may want to connect through a USB hub for safety The USB connection enables debugging via Code Composer Studio 10 Use the provided Ethernet cable to connect the EVM s Ethernet connector to the same PC workstation to enable the host side part of the demo application Audio Input Aud...

Page 17: ...o source should display on the video output device Live audio should be played if SW4 3 is set to the down position You can switch the demo mode using the Video Mode Switch SW7 See Section 3 2 Running the Demos in Standalone Mode 15 If you have used the USB cable to connect the board to your PC you will see the Windows Add New Hardware Wizard If you are using Windows XP the USB driver files should...

Page 18: ...aths_evmDM6437 dat file located in the top level directory to modify the path set for dvsdkInstallDir so that it points to the actual installation location c The DVSDK installer automatically launches the DSP BIOS installer dsp_bios_setupwin32_5_xx_xx_xx exe to update your Code Composer Studio directory with a newer release of DSP BIOS where xx indicates the version and build numbers You will also...

Page 19: ... utility framework_components_1_20 Components for use with xDAIS ndk_1_92_xx_xx_eval Network Developer s Kit evaluation PSP_1_xx_xx_xx Product Support Package xdais_5_20 The xDAIS interface standard and xDM extensions xdc_2_xx_xx Packaging and configuration tools 6 Some components require extra configuration to be able to build and run the examples For details you should see the release notes of i...

Page 20: ...2 8 ...

Page 21: ... chapter explains how to run the software demos provided with the DVDP 3 1 Overview of the Demo Software 3 2 3 2 Running the Demos in Standalone Mode 3 2 3 3 Running the Demos with the PC Host Application 3 4 3 4 About Buttons and Switches 3 12 Topic Page ...

Page 22: ... Flash memory You should see the following actions The EVM board boots up and starts executing the demo application in standalone mode from flash Live video from the input video device for example a camera displays on the video output device By default the standalone demo runs in Preview Capture Display mode In this mode audio and video are captured by the input devices and sent directly to the ou...

Page 23: ...g PAL CIF has a resolution of 352 x 288 pixels and a frame rate of about 25 frames per second The demo also reads the SW4 3 switch the rightmost switch when looking at the board edge on at startup and enables audio output if the switch is in the DOWN position To restart the demo you can press the Reset button SW6 which resets the DSP chip Note Avoid using SW5 In contrast to SW6 the nPOR power on r...

Page 24: ...ect to the DM6437 by choosing Debug Connect Alt C 3 Reset the CPU by choosing Debug Reset CPU Ctrl R 4 Within CCStudio choose File Load Program and select the dm643x_demo out file in the Debug subdirectory This loads the target program onto the DM6437 EVM 5 Use CCStudio to run the program on the target If you like you can run the target program on more than one DM6437 EVM if they are connected to ...

Page 25: ...omponent of the demo application follow these steps 1 To start the host side demo application run the run bat file in the C dvsdk_1_xx_xx_xx dm6437_demo_x_xx_xx hostapp directory You can run this file from a DOS prompt or double click on the file in Windows Explorer You will see a window that looks like this ...

Page 26: ...he application is probably already running in its automatic startup mode 4 You can see dynamically updated information about the application s status in the Target Application area Tabs provide General Info application and component versions Codec Stats frame rates bit rates and frame counts for encoders and decoders in use and System Stats used and free memory and buffer information are provided ...

Page 27: ... window This makes the Control area active 7 In the Mode area select the mode in which you want to run the demo Then go to the section indicated in this book for information on choosing files for the mode you selected and running the demo Preview also called Capture Display mode See Section 3 3 1 Enc Dec Loopback also called Encode Decode mode See Section 3 3 2 Decode from File See Step 9 and Sect...

Page 28: ... running a decode or encode operation Note It is possible to choose settings that result in sub optimal video quality or that overrun the available MHz of the processor There are no automatic checks against non optimal parameter settings so you should carefully choose settings and examine the resulting video output quality and DSP performance load against the design requirements For example it is ...

Page 29: ...n 10 If you select Decode from File mode you can select a file to decode in the Decode from File tab To select a video input file click the button next to the Video field Browse to a H 264 or MPEG4 file and click Open For sample data files browse to the C dvsdk_1_xx_xx_xx data video folder To select an audio file click the button next to the Audio field Browse to a G 711 file and click Open For sa...

Page 30: ... output file click the button next to the Audio field Browse to the location where you want the file stored The C dvsdk_1_xx_xx_xx data sounds folder is the default Type a filename and click Save No file extension is added automatically You might want to use g711 Note that the output video and audio files generated are raw files These do not contain header information just raw H 264 MPEG4 and G 71...

Page 31: ...e and sends it to the speaker The H 264 algorithm is used internally to encode and decode the video The G 711 algorithm is used internally to encode and decode the audio 3 3 3 Decode from File Mode Decode from File mode requires a video input file If audio is enabled it also requires an audio input file It decodes the input files and sends the output signals to the display and to the speaker if au...

Page 32: ...put devices No encoding and decoding is performed You can switch the demo mode using the Video Mode Switch SW7 The Capture Display mode uses D1 format for video display D1 has a resolution of 720 486 pixels if you are using NTSC and 720 576 pixels if you are using PAL The Encode Decode Loopback mode also captures audio and video from the input devices and send it to the output devices The signals ...

Page 33: ...oking at the board edge on at startup and enables audio output if the switch is in the DOWN position 3 4 3 Reset Buttons To restart the demo you can press the Reset button SW6 which resets the DSP chip Note Avoid using SW5 In contrast to SW6 the nPOR power on reset button SW5 resets everything on the board including the on board emulator resulting in a need to restart Code Composer Studio if you w...

Page 34: ...3 14 ...

Page 35: ...4 1 Chapter 4 Rebuilding DVDP Software This chapter explains how to rebuild the software provided with the DVDP 4 1 Software Overview 4 2 4 2 Rebuilding the Demo Target Software 4 3 Topic Page ...

Page 36: ...th the TMS320DM6437 DVDP is the Digital Video Software Development Kit DVSDK The heart of this software is the Codec Engine programming model Related components include the DSP BIOS target operating system drivers a networking stack evaluation version Customers can use the provided Codec Engine or choose individual components for their own video application development For the TMS320DM6437 DVDP wh...

Page 37: ...roject Open and browse to the directory for the example you want to rebuild For example C dvsdk_1_xx_xx_xx examples example_name Select the example_name pjt file Then choose Project Rebuild All 3 Alternately to build from the command line follow these substeps Change directory to the location of the example to rebuild for example C dvsdk_1_xx_xx_xx examples example_name Type the following command ...

Page 38: ...eal time from framework instrumentation and is transported over TCP IP for analysis and visualization Using a TCPI IP transport has the advantage of enabling local or remote data collection The SoC Analyzer provides advanced user interface features to allow easy correlation of system activities isolation of unexpected behavior and measurement of performance For details please see the SoC Analyzer ...

Page 39: ...ect the Instrumented option 2 Rebuild the demo application 3 Use CCStudio to load and run the dm6437_demo_x_xx_xx Debug dm6437_demo out file 4 Launch the SoC Analyzer by selecting Start All Programs Texas Instruments SoC Analyzer 1 0 SoC Analyzer 5 In the SoC Analyzer Control Panel enter the IP address that was displayed in the CCStudio stdout window 6 In the SoC Analyzer Control Panel enter the p...

Page 40: ...4 6 ...

Page 41: ...x describes optional procedures you may use depending on your setup and specific needs A 1 Using the Bootloader A 2 A 2 Replacing the Demo Codec Combinations A 2 A 3 Using the FlashBurn Utility A 3 A 4 Rebuilding the Demo Host Software A 6 Topic Page ...

Page 42: ...2C DSP as master SPI DSP as master UART DSP as slave For information about which pins to use and details about the various boot modes see the Using the TMS320DM643x Bootloader SPRAAG0 application note A 2 Replacing the Demo Codec Combinations The codecs used by the demo application are packaged as combinations in C dvsdk_1_xx_xx_xx codec_combos_1_00 ti sdo apps For information about combining othe...

Page 43: ...ry there is a directory called flashburn_files which contains all the needed files referenced in these instructions To flash the DM6437 EVM for booting in NOR FastBoot AIS mode follow these steps 1 Connect the EVM to the PC via the supplied USB cable to use the board s embedded emulation support Then plug in the EVM 2 Start DM6437 EVM CCStudio v3 3 Use the desktop icon to start CCStudio since this...

Page 44: ...r writing 12 Prepare the application to be flashed to the EVM The file should be in hexadecimal format Motorola S record or ASCII hex You can convert a CCStudio COFF file a out file to a proper hex format using the provided hexAIS tool which is located in the DM6437_install_dir flashburn_files hexAIS directory For example the hexAIS a out command produces the file a hex which can be flashed to the...

Page 45: ...6 When you are finished close FlashBurn press Alt C to disconnect CCStudio from the board and power off the board You may save the FlashBurn configuration file if you wish 17 Set the SW1 and SW2 switches as follows 18 Turn the board on Your application should start Note that the AIS image format can only initialize the DDR memory and the associated PLL2 the system PLL PLL1 the AEMIF interface and ...

Page 46: ...n the program in a graphical debugger edit the bat file itself and comment out the appropriate line A 4 1 JavaScript Misconceptions There are some common misconceptions about JavaScript The core JavaScript language which is used for this program has nothing to do with Web pages it is a general purpose scripting language like Perl or Python Also JavaScript is not Java However it does let developers...

Page 47: ...brary classes Modifying these statements requires knowing the APIs of the libraries in question However using Java classes from JavaScript is much easier than writing Java programs in Java A 4 2 Structure of the Host Side Application The host side application is split into four modules GUI control Main js Target control RPC Dm6437evm Rpc js File I O Dm6437evm Fileio js Networking communicates with...

Page 48: ...ates the current running mode The Fileio js script has an even simpler API fileio connect ipAddr port Connects to the target s fileio port fileio recvCmd Receives File I O commands from the target fileio dispatchCmd Runs received File server commands such as read The target sends commands like open file xyz or read N bytes from the file to the host The GUI script does not care what the commands ar...

Page 49: ...some message to the target such as connect or start playback In more detail and you may also want to refer to the code Main js flows like this 1 First Main js loads the two scripts Rpc js and Fileio js that implement communication with the target by sending messages to it over the network They let us create target communication objects later on in main 2 Then Main js defines global variables used ...

Page 50: ...n the scope it does not have to be defined before it is referenced The main function first creates an Rpc object from the Rpc js module After the rpc variable is initialized any function in the script can connect or send a message to the target like rpc connect 168 123 012 99 or rpc controlPlay The main function creates a similar fileio variable for a fileio object from the Fileio js module For de...

Page 51: ...objects call layoutWidgets call setEventListeners loop till the user closes application main place all controls buttons text boxes control groups on screen layoutWidgets specify functions to be called for each button and control setEventListeners connect to the target read target state variables set widget state based on target state start the FileIo thread eventFxnBtnConnect disconnect from the t...

Page 52: ...visible frames Another thing to know about containers is that a grid layout specify how widgets inside them are laid out Grids are matrices including matrices with only one row or column in which each grid cell contains a widget including container widgets Each grid cell can be aligned left right or centered A cell s width or height can also be controlled but we usually don t have to If we set the...

Page 53: ...s into an invisible Composite container and put that composite in the second cell of the second row Then as far as the Connection group is concerned it sees only two elements in each row The following figure shows how the widgets in the Connection frame are grouped into containers and cells Let s look at the script code that does this layout We define two handy functions WID and END almost like ma...

Page 54: ...he containing widget With our macro like functions it is always w The second argument to a widget usually defines some attribute s such as whether it has a border or how is its text justified We then add a label Status and create a text box to contain the connection status The connection status text could be placed in another label like Status because we can change the text of any widget dynamical...

Page 55: ... SWT NONE w setText END w txtIP2 WID widgets Text w SWT BORDER SWT CENTER w setLayoutData GD 20 SWT DEFAULT END WID widgets Label w SWT NONE w setText END etc for IP3 and IP4 END w btnDiscover WID widgets Button w SWT PUSH w setText Discove r END w cmbDiscover WID widgets Combo w SWT READ_ONLY w setLayoutData GD 158 SWT DEFAULT END w btnConnect WID widgets Button w SWT PUSH w setText Connect END w...

Page 56: ...t Take this one for example w btnInVideoBrowse addListener SWT Selection function event var dialog new widgets FileDialog shell var fileName dialog open if fileName null w cmbInVideo add fileName 0 w cmbInVideo select 0 w txtInVideoSizeKB setText Math floor new java io File fileName length 1024 This is a function for the Browse for Input Video file button It opens a new file dialog and if the user...

Page 57: ...freshed dispatching any events and exiting when the window is closed Each of our widget event functions called by the SWT GUI system runs in the context of that main thread So the main application thread is in charge of the GUI Another thread is the FileIO thread When the main thread connects to the target it soon starts a separate thread that connects to the target on a different port This new th...

Page 58: ...alse This variable is set to true by the main function when it exits Threads whose run functions are defined inline as in the Hello world example above have access to all the variables in the scope of the function that defined them That lets us define quick short thread functions without having to define separate functions and pass on piles of variables The only exception to this idyllic picture c...

Page 59: ...f its local variable myTextContents knowing that it has been set to reflect the contents of the widgets that it couldn t access directly We use display asyncExec a couple places in Main js One such example is the fileio thread The main thread in Main js spawns a new thread to be a fileio server upon connection to the target The new thread calls fileio recvCmd and fileio dispatchCmd cmd methods in ...

Page 60: ... both carry dangers Incorrect functions can be constructed and you won t know until you run them Also typos can set a wrong field or value in a hash table without any error Traditional languages have compilers to prevent some of these errors A third powerful feature is the integration of Java classes and ability to use them easily Since Java classes could be made to access native code like driver ...

Page 61: ...contents of kit 1 3 D D1 format 3 12 DaVinci technology 1 2 Decode from File mode 3 9 3 11 demo 3 2 modes 3 2 running host application 3 4 running standalone 3 2 Demo Mode switch 3 12 directories 2 7 drivers 2 6 DVDP 1 2 DVSDK software 2 6 E ECMAScript A 6 electrostatic precautions 2 2 Enc Dec Loopback mode 3 11 Encode to File mode 3 10 3 11 ESD precautions 2 2 Ethernet cable 2 4 examples 3 2 F Fl...

Page 62: ...iew mode 3 11 R reset button 3 13 resolution 3 13 S SoC Analyzer 4 3 software 4 2 components 1 3 installing 2 3 software installation 2 6 Spectrum Digital case 1 3 website 1 4 standalone mode 3 2 static precautions 2 2 statistics 3 6 SW1 switch 2 2 A 5 SW2 switch 2 2 A 5 SW4 switch 3 13 SW5 button 3 3 3 13 SW6 button 3 3 3 13 SW7 switch 3 2 3 12 System Stats 3 6 T target demo 4 3 TMS320DM6446 1 3 ...

Page 63: ......

Page 64: ...Spectrum Digital Inc 509108 0001B ...

Reviews:

No comments