TASKING VX-toolset for ARM User Guide

Chapter 17. Debug Target Configuration FilesDTC files (Debug Target Configuration files) define all possible configurations for a debug target. A debugtarget can be target hardware such as an evaluation board or a simulator. The DTC files are used byEclipse to configure the project and the debugger. The information is used by the Target BoardConfiguration wizard and the debug configuration. DTC files are located in the etc directory of the installedproduct and use .dtc as filename suffix.Based on the DTC files, the Target Board Configuration wizard adjust the project's LSL file and createsa debug launch configuration.17.1. Custom Board SupportWhen you need support for a custom board and the board requires a different configuration than thosethat are in the product, it is necessary to create a dedicated DTC file.To add a custom board1. From the etc directory of the product, make a copy of a .dtc file and put it in your project directory(in the current workspace).In Eclipse, the DTC file should now be visible as part of your project.2. Edit the file and give it a name that reflects the custom board.The Import Board Configuration wizard in Eclipse adds DTC files that are present in your current projectto the list of available target boards.Syntax of a DTC fileDTC files are XML files and use the XML Schema file dtc.xsd, also present in the etc directory of theinstalled product.Inspect the DTC XML schema file dtc.xsd for a description of the allowed elements and the availableattributes. Use a delivered .dtc file as a starting point for creating a custom board specification.Basically a DTC file consists of the definition of the debug target (debugTarget element) which embodiesone or more configurations (configuration element) and one or more communication methods(communicationMethod element).The Import Board Configuration wizard in Eclipse reflects the structureof the DTC file. The elements that determine the settings that are applied by the wizard, can be found atany level in the DTC file. The wizard will apply all elements that are within the path to the selectedconfiguration. This is best explained by an example of a DTC file with the following basic layout:debugTarget: STMicroelectronics STM3210B-Eval boardlslconfiguration: DefaultlslcommunicationMethod: J-Link over USB (JTAG)847