GettingStartedWithTMS320C28XDigitalSignalControllers Spraam0a
GettingStartedWithTMS320C28XDigitalSignalControllers Spraam0a
ABSTRACT
This guide is organized by development flow and functional areas to make your design
effort as seamless as possible. Tips on getting started with TMS320C28x™ DSP
software and hardware development are provided to aid in your initial design and
debug efforts. Each section includes pointers to valuable information including technical
documentation, software, and tools for use in each phase of design.
Contents
Trademarks .......................................................................................... 1
1 Development Quick Start Overview ............................................................. 2
2 Getting Started ...................................................................................... 3
3 Running Your First C28x Application on an eZdsp ............................................ 5
4 Reference Designs ................................................................................. 9
5 Technical Publication Descriptions ............................................................... 9
List of Figures
1 Spectrum Digital C2000 Development Tools Website ......................................... 6
2 Boot to SARAM Switch 1 Configuration on eZdspF2808 ..................................... 6
3 Code Composer Studio File View Window ...................................................... 7
4 280x CPU Timer Example Watch Window ...................................................... 7
5 Adding Variables to the Watch Window ......................................................... 8
6 Real-time Mode Option in the Debug Menu .................................................... 9
Trademarks
TMS320C28x, Code Composer Studio, C28x are trademarks of Texas Instruments.
eZdsp is a trademark of Spectrum Digital.
All other trademarks are the property of their respective owners.
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 1
Submit Documentation Feedback
www.ti.com
2 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
Getting Started
2 Getting Started
This section expands on the topics mentioned in Section 1 and lists online resources to help you in the
early stages of application development.
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 3
Submit Documentation Feedback
www.ti.com
Getting Started
2.3 Development Tools
Acquire an eZdsp kit for initial development, or when developing on your own hardware, purchase Code
Composer Studio for software development, and a JTAG emulation tool to get started on your project.
eZdsp Development Board Kits: The eZdsp kits provide all of the hardware and software tools required
during initial development (including on-board emulation via USB or parallel port and Code Composer
Studio IDE).
• TMDXEZ28335 - F28335, F28334, F28332
• TMDSEZS2808 - F2809, F2808, F2806, F2802, F2801, F28016, F28015
• TMDSEZS28044 - F28044
• TMDSEZD2812 - F2812, F2811, and F2810
To get started with the eZdsp kit, visit http://c2000.spectrumdigital.com and select the appropriate eZdsp
for schematics and quick start guides.
Debugger and Emulation Tools: If developing on your own hardware, you will need a robust software
development studio and an emulator that supports real-time JTAG emulation.
• Code Composer Studio IDE for C2000
– Run Update Advisor periodically, or with the release of each new device to ensure the highest level
of support. It is especially important to update Code Composer Studio when a device moves from
TMX to TMS status.
– The differences between Code Composer Studio service release updates can be found in the
/docs/releasenotes/ directory in the Code Composer Studio install directory (default is
C:/CCStudio_vx.y/, where x.y is the installed version of Code Composer Studio). The differences
between Code Generation Tools (compiler) versions can be found in the release notes in the
/c2000/cgtools/ directory in the Code Composer Studio install directory.
– The 2833x generation of devices requires Code Composer Studio 3.3+ with Code Generation Tools
5.0+ for floating-point support. All previous device generations are compatible with Code Composer
Studio 3.0+.
• A standalone JTAG emulator
– From TI: Visit the TI e-Store
– From one of TI's third parties: For emulators from companies such as Signum Systems, Blackhawk,
or Spectrum Digital, go to the Third Party Products and Services website and type the company
name in the “Search by Name” textbox under “Company Search
Development Tool Drivers: For Code Composer Studio IDE to interface with the eZdsp and/or other
emulation tools, software drivers may be required. See your vendor's website for drivers specific to your
emulator. Code Composer Studio includes emulation drivers only for TI JTAG emulators.
4 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 5
Submit Documentation Feedback
www.ti.com
Step 4. See the Quick Start guide corresponding to your device (eZdspF2808 Quick Start Guide for
the F280x devices) for step-by-step instructions from Spectrum Digital on how to set up Code
Composer Studio, configure the appropriate drivers, and power up the eZdsp board. The
Quick Start Guide can also be found on the eZdsp CD-ROM included in the eZdsp kit.
Step 5. Download the eZdsp board schematic (eZdspF2808 Schematic for F280x devices) for future
reference. The board schematic can also be found on the eZdsp CD-ROM included in the
eZdsp kit.
Step 6. Code Composer Studio should now be running on the powered eZdsp board (This step
assumes that Code Composer Studio is properly configured according to the instructions in
Step 4 above). If not, then click on the F2808 EzDSP Code Composer icon to start Code
Composer again.
Step 7. Configure the Boot Mode pins on the eZdsp board (SW1 positions 1-3 on eZdspF2808) for
“Boot to SARAM” mode (factory default for eZdspF2808). Figure 2 demonstrates the Boot
Mode pin configuration for “Boot to SARAM” mode on the eZdspF2808.
SW1
1 GPIO34
2 1
GPIO29
3 1
GPIO18
4
5
6
Step 8. In Code Composer Studio, go to the Debug menu-> Connect in order to connect the
debugger to the device. A balloon with the statement, “The Target is now connected”, should
appear in the lower left corner of the window.
Step 9. Continue with the steps in either Section 3.2 or Section 3.3.
6 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
Step 7. To monitor variables of interest in the project, Go to the GEL menu-> DSP280x
CpuTimerExample-> Load Setup_WatchWindow. The Watch Window will appear in the lower
right-hand corner of the Code Composer Studio window with some CPU Timer variable
names as shown in Figure 4. This can also be accomplished by highlighting any variable
name in the source code, right-clicking on it, and selecting “Add to Watch Window”.
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 7
Submit Documentation Feedback
www.ti.com
3.3 Setting up the Application in Code Composer Without Using a GEL file
The steps below replace the steps in Section 3.2, and set up the application without using a GEL file.
1. Go to Project menu -> Open… and navigate to the folder where the header files were extracted in Step
2 of Section 3.1.
2. Open the DSP280x_examples folder (or the examples folder corresponding to your device). By default,
this should be C:\tidcs\c28\DSP280x\vxyz\DSP280x_examples\.
3. Click on the cpu_timer folder, and inside the folder, open the Example_280xCpuTimer.pjt file.
4. Go to Project menu-> Build.
5. Then when the build completes, go to File menu->Load program
6. Browse to the cpu_timer folder, click on the Debug folder, and select the Example_280xCpuTimer.out
file. Files with the extension .out are generated by the linker and contain the data that is loaded into the
C28x device SARAM.
7. Now set up the Watch window by highlighting the variable or register to be observed
(CpuTimer0.InterruptCount), right-clicking, and selecting "Add to Watch Window" as shown in Figure 5.
Another option is to type the register name or variable directly into the Watch Window.
8 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
Reference Designs
Step 2. Reset the CPU by going to Debug menu -> Reset CPU
Step 3. Run the program by clicking on the blue running man icon on the Debug Toolbar, or by going
to Debug->Run. The CPU Timer example sets up a CPU Timer to interrupt once every 1
second. Observe in the Watch Window as CpuTimerx.InterruptCount (where x = 0, 1, or 2)
increments once per second.
Step 4. Expand CpuTimerx and/or CpuTimerxRegs to see the CPU Timer registers and related
variables change as the program runs.
Step 5. When you want to halt the program, click on the blue man icon with the red X on the Debug
Toolbar or by going to Debug->Halt.
Step 6. If you want to change the frequency of the interrupts, expand the source folder in the File
View and click on Example_280xCpuTimer.c. Scroll down to the Configcputimer() function.
replace 1000000 with your desired period in microseconds. Then go back to Section 3.2 or
Section 3.3 to rebuild and run your application.
Congratulations! You have finished running your first C28x application on an eZdsp. To further understand
the general flow of C28x application software setup, it is recommended to read through the example
and/or header file comments. The device initialization flow is the same in all the examples.
4 Reference Designs
This section includes reference designs available for the C2000 device families.
The TMS320F2833x reference design is available for download as (SPRC541).
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 9
Submit Documentation Feedback
www.ti.com
10 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 11
Submit Documentation Feedback
www.ti.com
12 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 13
Submit Documentation Feedback
www.ti.com
14 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
www.ti.com
SPRAAM0A – May 2007 – Revised October 2007 Getting Started With TMS320C28x Digital Signal Controllers 15
Submit Documentation Feedback
www.ti.com
16 Getting Started With TMS320C28x Digital Signal Controllers SPRAAM0A – May 2007 – Revised October 2007
Submit Documentation Feedback
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, 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 TI 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. Information of third parties
may be subject to additional restrictions.
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.
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. 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
requirements concerning their products and any use of TI products in such safety-critical applications, notwithstanding any
applications-related information or support that may be provided by TI. Further, Buyers must fully indemnify TI and its
representatives 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 products designated by TI as military-grade meet military
specifications. Buyers acknowledge and agree that any such use of TI products which TI has not designated as military-grade 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 designed nor intended for use in automotive applications or environments unless the specific TI products
are designated by TI as compliant with ISO/TS 16949 requirements. Buyers acknowledge and agree that, if they use any
non-designated products in automotive applications, TI will not be responsible for any failure to meet such requirements.
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
RFID www.ti-rfid.com Telephony www.ti.com/telephony
Low Power www.ti.com/lpw Video & Imaging www.ti.com/video
Wireless
Wireless www.ti.com/wireless
Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265
Copyright © 2007, Texas Instruments Incorporated