Device hierarchy in the PCE view
The device hierarchy in the PCE view shows the devices on the platform.
In the PCE view, you can add or remove devices to configure the platform for how you want to debug it. This figure shows the device hierarchy of an example platform. Development Studio might not autodetect all the devices on the platform. To use these undetected devices in the debug session, you must add them to the device hierarchy and configure them.
Figure 14-4 Device hierarchy
If you do not need some of the autodetected devices, you can remove them from the device hierarchy. To remove a device, right click on the device and select Remove Device.
To access, either:
- In the Project Explorer, right-click on an SDF file, and select Open With > Platform Configuration Editor.
- Double-click an SDF file (where the SDF association has not been overridden).
- In the Project Explorer, right-click, and select File > New > Platform Configuration. After autodetection or manual configuration of a platform, the PCE view opens.
- Select File > New > Other... > Configuration Database > Platform Configuration. After autodetection or manual configuration of a platform, the PCE view opens.
- The hardware connection dialog provides the option to enter the Platform Configuration Editor (PCE) at the final stages of new connection creation: File > New > Hardware Connection. At the target selection step, click Add a new platform…. It can also be accessed at the end of the target selection flow for a CMSIS device; click Target Configuration.
The context menu for the device hierarchy contains:
Table 14-2 Device hierarchy view contents
|Toggle Devices Panel||Shows or hides the Devices Panel which lists the devices that you can add to the JTAG scan chain or device hierarchy.|
|Debug Adapter||Shows the configuration for your debug hardware unit, for example, a DSTREAM unit. For more information on the contents displayed, see Debug Adapter tabs in the PCE view.|
Shows the scan chain and device hierarchy of your platform. The device hierarchy usually consists of one or more Debug Access Ports (DAP). Each DAP consists of one or more Access Ports (AP). Each AP shows the devices that have been detected through that access port.
|Device||Shows the device name, along with device and configuration information. See Device configuration panel for more information.|
|Debug Activities||Shows the type of debug activities you can perform on the target. The debug activities are accessible from the Debug Configurations dialog box when you want to start a debug session.|
|Enumerate APs||Available for Debug Access Ports (DAP) on the device hierarchy. This enumerates the Access Ports under the DAP.|
|Read CoreSight™ ROM Tables||Reads the CoreSight ROM tables to obtain more information about the devices from the various access ports. This might cause certain devices on the platform to become unresponsive. If so, during autodetection and after selecting your debug hardware Probe, deselect Read CoreSight ROM Tables under the Autodetect tab in the Debug Adapter pane.|
|Add Custom JTAG Device||Adds a custom device to the JTAG scan chain.|
|Add core cluster components||Opens a dialog which you can use to add a cluster of cores and their associated devices (ETM/PTM, CTI, and PMU) in groups. If a base address is specified, then base addresses for all components are set, and topology links are added between all added components. If you select the option to add funnel connections, all ETM/PTM devices are linked to the funnel specified by the Funnel Base Address. If there is no device at this address, a new funnel is created.|
|Autodetect Component Connections||Starts the autodetection. It detects the connections between the various components on the platform.|
|Add Link From This Device||Adds a topology link between the selected device and another device. The selected device is the link master. If no links from the device can be created (for example, the device is already linked, or there are no devices to which a valid link can be made) then this menu item is not available.|
|Add Link To This Device||Adds a topology link between the selected device and another device. The selected device is the link slave. If no links to the device can be created (for example, the device is already linked, or there are no devices from which a valid link can be made) then this menu item is not available.|
|Remove Device||Removes the device from the device hierarchy.|
To add a device as a sibling or as a child, drag-and-drop from the Devices Panel to the appropriate place in the device hierarchy.
Figure 14-5 Devices Panel
Any device that you add or remove from the hierarchy changes the topology of the SoC. You must ensure that the topology is appropriate for your platform. After adding new devices, you can configure the devices in the right-hand pane in the PCE view.