Embedded Target for Texas Instruments C6000 DSPs

Targeting Your C6701 EVM

Texas Instruments markets a complete set of tools for use with the C6701 EVM. These tools are primarily intended for rapid prototyping of control systems and hardware-in-the-loop applications. This section provides a brief example of how to use TI development tools with Real-Time Workshop and the C6701 EVM block library.

Executing code generated from the Real-Time Workshop on a particular target in real-time requires target-specific code. Target-specific code includes I/O device drivers and an interrupt service routine. Other components, such as a communication link with Simulink, are required if you need the ability to download parameters on-the-fly to your target hardware. Since these components are specific to particular hardware targets (in this case, the C6701 EVM), you must ensure that the target-specific components are compatible with the target hardware. To allow you to build an executable, the Embedded Target for TI C6000 DSP provides a target makefile specific to the evaluation module. This target makefile invokes the optimizing compiler, provided as part of TI Code Composer Studio.

Used in combination with the Real-Time Workshop, TI products provide an integrated development environment that, once installed, needs no additional coding.

After you install the C6701 EVM development board and supporting TI products on your PC, launch MATLAB. At the MATLAB command prompt, type c6701evmlib. This opens a Simulink block library, c6701evmlib, that includes a set of blocks for C6701 EVM I/O devices

• C6701 EVM ADC (configure the analog to digital converter)
• C6701 EVM DAC (configure the digital to analog converter)
• C6701 EVM LED (control the user status light emitting diodes (LED) on the C6701 EVM)
• C6701 EVM Reset (reset the processor on the C6701 EVM)

These blocks are associated with your C6701 EVM board. As needed, add the devices to your model. .

With your model open, select Simulation -> Simulation Parameters. From this dialog, click the Real-Time Workshop tab. You must specify the appropriate versions of the system target file and template makefile. For the C6701 EVM, in the Real-Time Workshop pane, specify:

• System target file--ti_c6000.tlc
• Template makefile--ti_c6ooo.tmf

With this configuration, you can generate a real-time executable and download it to the TI C6701 evaluation board. Do this by clicking Build on the Real-Time Workshop pane. The Real-Time Workshop automatically generates C code and inserts the I/O device drivers as specified in your block diagram. These device drivers are inserted in the generated C code as inline S-functions. Inlined S-functions offer speed advantages and simplify the generated code. For more information about inlining S-functions, refer to Target Language Compiler Reference Guide. For a complete discussion of S-functions, refer to Writing S-Functions.

During the same build operation, the template makefile and block parameter dialog entries are combined to form the target makefile for your TI evaluation module. This makefile invokes the TI compiler to build an executable file. When you select the Build_and_execute option, Real-Time Workshop automatically downloads the executable via the peripheral component interface (PCI) bus to the TI evaluation board. After downloading the executable file to the C6701 EVM, the build process runs the file on the processor.

Starting and Stopping DSP Applications on the C6701 EVM

When you create, build, and download a Simulink model to the C6701 EVM, you are not running a simulation of your DSP application. You are running actual machine code corresponding to the block diagram you built in Simulink. To start running your DSP application on the evaluation module, you must open your Simulink model and rebuild the machine executable by clicking Build on the Real-Time Workshop pane. To start the application on the C6701 EVM, you use Real-Time Workshop to rebuild the executable from the Simulink model and download the code to the board.

Your model runs until it encounters one of the following actions:

• You select Debug -> Halt in CCS.
• You shut down the host PC.
• The running application encounters an error condition that stops the process.

If you included a C6701 EVM Reset block in your model, clicking the C6701 EVM Reset block stops the running application and restores the digital signal processor to its initial state.

Note    When you build and execute a model on the C6701 EVM, the Real-Time Workshop build process resets the evaluation module automatically. You do not need to reset the board before building models. Use Reset C6701 EVM to stop processes that are running on the evaluation module, or to return the board to a known state for any reason.

Embedded Target for TI C6000 DSP Default Project Configuration--custom_MW

Configuring Your C6701 EVM