INTRODUCTION The Tracelink is a powerful development interface capable of capturing external trace data on Freescale microcontrollers. The Tracelink is designed to help developers find and diagnose software bugs quickly and efficiently. While a microcontroller is running, the Tracelink is constantly recording trace information into its internal memory buffer, which can later be used by supporting software to provide program flow charts and profiling statistics.
Page 5
• Multiple Freescale Architecture Support • ColdFire V2-4 • Kinetis • S12Z (coming soon) • External Trace Capture • Supports trace port speeds up to 250 MHz • 128MB of trace storage • Multiple Voltage Operation • Automatically detects and caters to target voltages ranging from 1.8V to 5V •...
QUICK START GUIDE Step 1. Install Software The accompanying software includes all necessary drivers and configuration utilities needed for the Tracelink. After installation is complete, make sure the PC is rebooted before moving on to the configuration step. Step 2. Power On Tracelink Power up the Tracelink by connecting the included 9V power supply.
TRACELINK HARDWARE This chapter provides more in-depth technical detail about the features and interfaces of the Tracelink unit. Tracelink Power Supply The Tracelink requires a regulated 9V DC center positive power supply with a 2.5/ 5.5mm female plug. The power supply plugs into the power jack located on the top of the unit.
USB Connector The Tracelink provides a USB connector for Universal Serial Bus communications with the host PC. The Tracelink is a USB 1.1 compliant device. Figure 3-3: USB Connector Target Debug Connectors The different families of Freescale microcontrollers are supported via the multiple debug headers located on the Tracelink.
Page 9
Figure 3-4: Tracelink Headers, Pin 1 Highlighted Note: For signals requiring pull-up or pull-down resistors, please note that most microprocessors implement internal resistors to meet these requirements. Otherwise, an external resistor must be used. Tracelink User Manual...
Page 10
3.4.1 PORT A: Kinetis (Mini-10) Figure 3-5: Port A Pinout Table C-1. Kinetis Mini-10 Signals (PORT A) Signal Direction Description TVCC Input Target reference voltage. Needs to be con- nected to the microprocessor’s operating volt- age (1.8V to 5V) and is used by the Tracelink to determine the correct voltage level to use on output signals.
Page 11
3.4.2 PORT B: Kinetis (Mini-20) Figure 3-6: Port B Pinout Table C-1. Kinetis Mini-20 Signals (PORT B) Signal Direction Description TVCC Input Target reference voltage. Needs to be con- nected to the microprocessor’s operating voltage (1.8V to 5V) and is used by the Tracelink to determine the correct voltage level to use on output signals.
Page 12
Table C-1. Kinetis Mini-20 Signals (PORT B) Signal Direction Description Input Debug communication signal. Pull-up resistor recommended. Recommended. Output Debug communication signal. Pull-up resistor required. Recommended. RESET Microprocessor reset signal. This signal is driven low during initial debug mode entry. Pull-up resistor required.
Page 13
3.4.3 PORT C: ColdFire V2/3/4 Figure 3-7: Port C Pinout Table C-1. ColdFire V2/3/4 Signals (PORT C) Signal Direction Description BKPT Output Debug communication signal. Pull-up resistor required. Required. Input Ground signal. Connect to the digital ground signal of the microprocessor. Required. DSCLK Output Debug communication signal.
Page 14
Table C-1. ColdFire V2/3/4 Signals (PORT C) Signal Direction Description Output Debug communication signal. Pull-up resistor required. This signal is currently only used by P&E when unsecuring ColdFire processors with internal flash. Recommended. RESET Microprocessor reset signal. This signal is driven low during initial debug mode entry.
Page 15
3.4.4 PORT D: Kinetis Figure 3-8: Port D Pinout Table C-1. Kinetis Signals (Port D) Signals Direction Description TVCC Input Target reference voltage. Needs to be connected to the microprocessor’s operating voltage (1.8V to 5V) and is used by the Tracelink to determine the correct voltage level to use on output signals.
Table C-1. Kinetis Signals (Port D) Signals Direction Description TMS/ Debug communication signal. Pull-up resistor SWD_DIO required. Required. TCK/ Output Debug communication signal. Pull-down resistor SWD_CLK required. Required. Input Debug communication signal. Pull-up resistor recommended. Recommended. RESET Microprocessor reset signal. This signal is driven low during initial debug mode entry.
Page 17
Figure 3-9: J2 Jumper There is additional configuration needed on the PC software to turn on the target voltage and to specify target voltage value (2V, 3V, or 5V). Refer to the software documentation for more details. Tracelink User Manual...
EXTERNAL TRACE OVERVIEW This section provides an introduction to the vocabulary and methodologies of debugging with external trace. Also discussed are general board and layout guidelines to help improve signal integrity for the high-speed trace signals. How External Trace Works Below is a simple diagram of the trace process.
Generally there are two categories of trace data being generated by the processor: instruction trace and data trace. Instruction trace provides “change of flow” information and is mostly concerned with branch and jump type instructions. Instruction trace packets will tell the developer whether a branch was taken and also the destination address of the branch.
Page 20
4.4.1 Avoid impedance discontinuities Stubs are printed circuit board tracks that branch off from the main track and are usually formed when placing test points or connecting multiple components to the same net. Stubs should be avoided at all costs as even short stubs can cause serious signal integrity issues.
ETHERNET CONFIGURATION This section describes the mechanism used by the Tracelink device to transact data over an Ethernet network. It primarily focuses on the User Datagram Protocol (UDP), which is a popular method for sending data over a network when the speed of a data transaction is of more concern than the guarantee of its delivery.
Switches The aforementioned type of process, where the data is simply replicated onto every available port, quickly becomes inefficient for larger sized networks. For this reason, a larger sized LAN employs the usage of Switches instead of Hubs. A Switch is essentially a smart Hub, in that it limits the input and output of data to the two transacting computers.
Internet Protocol Once the network has been established, and the IP numbers have been assigned, data can be transacted over a network with one of several protocols. By far the most prevalent protocol is the Transmission Control Protocol (TCP), which runs on top of the Internet Protocol in what is collectively known as the TCP/IP protocol.
Page 24
modification of a basic theme, which is that of connecting one or more PCs through a Hub to one or more Tracelinks. In order to connect these devices to the Hub, you will need to use the provided straight-through Ethernet cable. The straight-through cable, which is the “standard” Ethernet cable, is used to connect devices of different types together, such as a PC to a Hub, or a Hub to a Tracelink.
Assuming the desktop’s IP number to be 192.168.100.1, this is an example of the three IP numbers that would need to be programmed into the Tracelink: IP Number Gateway IP Subnet Mask 192.168.100.1 none 255.255.255.0 Tracelink 192.168.100.2 192.168.100.1 255.255.255.0 For more information on programming these IP numbers into the Tracelink device, please see the following section.
Page 26
(1) Drop-down Box 1 There are two options available in this drop-down box: "Ethernet Port" and "USB Port". Changing to any one of these Ports will list the devices which are found over that specific Port. (2) Drop-down Box 2 Once one of the communication interfaces (USB or Ethernet) has been selected in the first drop-down box, a list of all available Tracelink devices over that interface will be displayed for selection.
(11) Firmware Version A read-only field which returns information pertaining to the build date and firmware version of the Tracelink device. (12) Program Tracelink Parameters This button saves the information as it appears in the "Reconfigure IP Numbers" area onto the Tracelink device. (13) Specify IP Button If the Tracelink cannot be automatically detected over the network, this button allows the user to manually specify the Tracelink IP address.
Page 28
Figure 5-2: Tracelink IP Setup Utility - Initial Screen 2. Click “Open” to get a dialog box similar to the following: Figure 5-3: Tracelink IP Setup Utility - Continue Setup Tracelink User Manual...
Page 29
3. The Tracelink now needs to be programmed with IP numbers for the network on which it will operate. The Tracelink IP Number field must contain a unique IP number. Tracelink User Manual...
USB CONFIGURATION Standard USB cables may be used for Tracelink USB port configuration. The user may use network hubs as necessary. Tracelink User Manual...
CODEWARRIOR 10.x CONFIGURATION This section provides a walkthrough of the configuration steps required to begin using the Tracelink in Freescale’s CodeWarrior 10.x development suite. CodeWarrior 10.2 or higher (with all available updates installed) is required. Before following these steps, the Tracelink should already be connected to the target board and both should be powered up.
Page 32
Select the “P&E TraceLink USB” and/or “P&E TraceLink Ethernet” option. Continue with the remaining steps in the wizard to finalize the project. Step 2. Add Initialization Code If necessary, add any device specific initialization code to configure the microprocessor for trace generation. For example, the trace pins may be configured as general purpose input/output by default and you may need to add a few lines of code to initialize them for trace output.
Page 33
option. This controls the size of the Tracelink’s internal buffer. By default, this is set to the lowest value (128KB). As this capacity is increased, the Tracelink can store more trace data, but PC download and processing times are also increased. P&E recommends using one of the center values such as 2MB and increasing it as necessary.
Page 34
Figure 7-4: CodeWarrior: Enable Trace and Profile Step 4. Run the project When the microprocessor halts (eg. after a single-step, run/breakpoint, or run/user halt), CodeWarrior will query the Tracelink for trace data. This data is automatically downloaded and parsed by the CodeWarrior software analysis engine. The results are displayed in the “Software Analysis”...
Page 35
Figure 7-5: CodeWarrior: Display Trace Data Tracelink User Manual...
PRODUCTION PROGRAMMING Once you have accomplished the development stage of your project, you may need a hardware tool to allow you to easily execute low- or high-volume production programming. P&E’s Cyclone MAX and Cyclone PRO are versatile and robust programming tools with advanced features and production capabilities. Each supports a different set of Freescale architectures.
• In-Circuit Debugging, Programming, and Testing • Compatible with many Freescale microcontroller families: Cyclone MAX ® • ColdFire V2/V3/V4 ® • Power MPC5xx/8xx ® • Qorivva MPC55xx/56xx ® • Kinetis ® • Power Architecture PX Series • DSC (MC56F80xx, MC56F82xx, MC56F83xx, and MC56F84xx) •...
Page 38
(MAX) or 3Mbytes (PRO) of non-volatile memory, which allows for the onboard storage of multiple programming images. When connected to a PC for programming or loading it can communicate via the ethernet, USB, or serial interfaces. 8.2.1 Software The Cyclone comes with intuitive configuration software and interactive programming software, as well as easy to use automated control software.
Need help?
Do you have a question about the P&E Tracelink and is the answer not in the manual?
Questions and answers