Texas Instruments TIVA CPU Support Package

This package contains project templates and system files for the Texas Instruments TIVA.

CrossWorks Version 4 Installation Instructions

To install this support package

1. Click the Tools > Package Manager menu option to open the package manager window.
2. Right click on the Texas Instruments TIVA CPU Support Package entry and select Install Selected Packages.
3. Click Next to take you to the summary page.
4. Click Next to install the package.
5. Click Finish to close the package manager window.
6. Click the Tools > Show Installed Packages.
7. Click on the Texas Instruments TIVA CPU Support Package link to view the package and its contents.

To manually install this support package

1. If you have not done so already, follow the CMSIS 3 Support Package and CrossWorks Tasking Library Package installation instructions.
2. Download the file TIVA.hzq using your web browser.
3. Click the Tools > Manually Install Packages menu option.
4. Select the file you have just downloaded to install the package.
5. Click the Tools > Show Installed Packages.
6. Click on the Texas Instruments TIVA CPU Support Package link to view the package and its contents.

To install this support package using other versions

• CrossWorks Version 3 Installation Instructions

Release Notes

3.0

• Updated for CrossWorks V3.

1.3

• Added support for the latest TM4C129 devices.

1.2

• Fixed simulation startup for TM4C129 devices.

1.1

• Support for TM4C129 devices.
• Changed interrupt vector names to match the CMSIS naming conventions.

1.0

• Initial release.

Documentation

Creating TIVA Projects

To create a new TIVA project

• Select the File > New > New Project menu item.
• Select the appropriate Generic TIVA from the Categories list.
• Select the required project template type from the Templates list.
• Set the required project name and location directory.
• Click OK.

To build and debug an application the runs in Flash memory

• Select the project to work on by using the Project > Set Active Project menu option.
• Select the configuration you require by using the Build > Set Active Build Configuration menu option.
• Right click on the project node in the project explorer and select the Flash placement.
• Build the project by using the Build > Build Project menu option.
• Connect to the appropriate target in the target window.
• Download and start debugging the current project by using Debug > Start Debugging.

To make the application startup from reset

• Right click on the project node in the project explorer and select Properties...
• In the properties window scroll down to the Preprocessor Options section.
• Type STARTUP_FROM_RESET into the Preprocessor Definitions property editor.

TIVA Project Specifics

Target Processor

Once a project has been created you can select different target processors by right clicking on the project node in the project explorer and selecting the Target Processor entry.

Selecting the target processor will specify the memory map that is used for the build and debug. You can view the selected memory map by right clicking on the project node in the project explorer and selecting View Memory Map or View Memory Map (as text).

Section Placement

CrossStudio for ARM supports TIVA projects running applications in a number of different memory configurations. You can select the memory configuration you require by right clicking on the project node in the project explorer and selecting the Placement entry.

For TIVA projects the set of placements are:

• Flash application runs in Flash memory.
• Flash Vectors In RAM application runs in internal Flash memory but the exception vectors are copied toRAM.
• Flash Copy To RAM application starts in internal flash and copies itself to run RAM memory.
• RAM application runs internal RAM memory.

Stack and Heap Sizes

The stack and heap sizes are set to be 256 bytes by default when a project is created. This enables projects to run on the smallest of the TIVA processors. It is likely that you will need to change these values when developing applications to run on the larger of the TIVA processors.

Target Startup Code

The startup code TIVA_Startup.s is common to all TIVA processors. There are a set of preprocessor defines that configure the startup code and are documented in the startup file itself. The startup code calls out to a weak symbol SystemInit with the stack pointer set to the top of RAM. The SystemInit function can be used to set the CPU clock or configure any external memories prior to the C initialisation code as such it cannot access initialised static data.

The startup code declares weak symbols for each interrupt service routine for example the PWM_Fault_ISR function will be called when this interrupt occurs. If you are porting code that has application specific interrupt service routine names then you can use the preprocessor definitions to rename the symbol for example PWM_Fault_ISR=MyPWMFaultISR.

Target Reset Script

The reset script TIVA_Target.js is used by the debugger to reset the target board.

Memory Simulator

An TIVA memory simulator is provided that simulates the memories of the various TIVA devices. The memory simulation parameter (which is set by the Target Processor selection) specifies the size of the Flash and the RAM memories.

Header Files

TI TIVA CMSIS Header files are supplied. The TIVA project setup adds the appropriate directory to the User Include Directories project property.