How do I configure RVD_3.1/RVI_3.2.1 to capture ETM Trace using RVT on the PB1176?
Applies to: PB1176, RealView Development Suite (RVDS), RealView ICE and Trace (RVI / RVT)
The ARM1176JZF-S Development Chip integrated on the PB1176 can be configured as a traditional or a CoreSight JTAG system based design. To capture ETM trace on the PB1176, the system must be configured as a CoreSight system by placing a jumper on J1.
This Knowledge Article explains how to configure RealView Debugger v3.1 (RVD v3.1) and RealView ICE v3.2.1 (RVI v3.2.1) for external trace on the PB1176 using the Trace Port Interface Unit (TPIU).
In this case, a RealView Trace (RVT) unit is required.
The following software must be installed in order to perform trace on the PB1176:
RealView Development Suite (RVDS) v3.1 or RVDS v3.1 Pro
RVDS v3.1 Installer Patch (just for RVDS v3.1)
RVDS v3.1 Patch (for RVDS v3.1 and RVDS v3.1 Pro)
RVI v3.2.1 Firmware 3.2.1 build 860 or later
To obtain the Installer Patch and the Patch for RVDS v3.1, please visit the ARM technical support web pages:
To obtain the Patch for RVDS v3.1 Pro, please visit the ARM technical support web pages:
It is important to do this installation in the following order:
- RVDS v3.1 or RVDS v3.1 Pro
- RVDS v3.1 Installer Patch
- RVDS v3.1 Patch or RVDS v3.1 Pro Patch
- RVI v3.2.1
The following steps are needed to configure the RVD 3.1/RVI 3.2.1 interface to the PB1176 development board:
- Connect the RVI unit to the "JTAG ICE" port (J12 on the PB1176) and the RVT probe to "Trace A" (J2 on the PB1176).
- Power up the PB1176 and the RVI unit.
- Start RVD. Select Target → Connect to Target from the Menu. This opens the RVD connection control window.
- In the RVD connection control window, click on the "Add" button next to "RealView ICE". This opens the "RVConfig" window.
- In "RVConfig" select your RVI unit from the list displayed and click the "Connect" button.
- Click "Autoconfigure Scan Chain" to autodetect the Coresight system. It will result in the ARMCS-DP device being found. This device represents the Debug Access Port (DAP) in a CoreSight system.
- To find the debuggable devices connected to the DAP, right click on the ARMCS-DP device and select "Read CoreSight ROM table".
- The previous step will result in the scan chain shown in Figure 1 being found but with the CoreSight components in a slightly different order.
Reorder the displayed items by using the "Move Left" and "Move Right" buttons so that they match Figure 1. This is necessary as the order of the components must match the Associations File discussed in the next step.
Add an Associations File to describe the connections between the devices. The Associations File is available from here:
- Save this file in a local directory.
- To add the Associations File, in the "RVConfig" window click "Set Associations" button and select your Associations File.
- In the "RVConfig" window select the File tab, Save and Exit.
The RVD configuration steps can be gathered in a script to be loaded in RVD. This script contains the RVD commands that perform the connection to the CoreSight components and the configuration for the ETM and the TPIU.
An example of an RVD configuration script file which configures the PB1176 for 16-bit trace is available here:
- Save this file in a local directory.
- To load the Commands script file in RVD: from the main Menu navigate to Tools → Include Commands from File and browse to the location of the file.
- Click View → Analysis Window to open the Analysis window. Click the Edit tab and select the "Connect/Disconnect Analyzer" option.
- Finally load an image and run it. You should get trace output in the Analysis window.
Alternatively, you can manually configure RVD using the following steps:
- The RVD connection control window should now show all of the devices you have configured, except for the ARMCS-DP.
- Double click on ARM1176JZF-JTAG-AP to connect. Do the same for the ETM and TPIU.
Next we will set up the registers for the ETM and TPIU:
- Open a Registers window by selecting View → Registers from the Menu. To see the registers for each of the components, use the "Cycle Connections" button from the Menu.
- Select the ETM and in the Registers window set the "ETM CS TRACE ID" register to a small non-zero value, for instance 0x55.
- Now select the TPIU. In the Registers window set the "CSTPIU CURPORTSIZE" to the required Port Width to the required Port Width - 0x8000 for 16-bit trace, 0x80 for 8-bit trace or 0x8 for 4-bit trace.
- In the RVD window, click the "Cycle Connections" button to select the ARM1176 core. Click View → Analysis Window to open the Analysis window. Click the Edit tab and select the "Connect/Disconnect Analyzer" option.
- Load an image and run it. You should get trace output in the Analysis window. Note that to be able to see the trace output on the Analysis window you should stop the target or disable trace.
Note: For any information regarding the CoreSight components configuration please refer to the CoreSight Components Technical Reference Manual available at the ARM Website:
Attachments: scanchain_3.2,1.JPG , PB1176TraceTPIU_associations.txt , Trace_PB1176JZF-S.inc
Article last edited on: 2009-04-14 15:27:51
Rate this article
Disagree? Move your mouse over the bar and click