Multi-Core Debugging Commands. NXP CodeWarrior Development Studio

Multi-Core Debugging Commands

13.

With core 0 still selected, click the Step Over button several times until you reach the printf()

statement.

Debugger executes the current statement, the following statements, and halts at the printf()

statement.

14. Switch to the other debug window.

15. Select the main()

thread for core 1 by clicking it. Notice that the program counter icon in the Source view did not move. The debugger controls the execution of each core individually.

16.

In the Debug view, click the Resume button.

Core 1 enters an infinite loop. The status of the program changes to (

Running

).

17.

In the Debug view, click the main()

thread for core 0 and click the Resume button.

Core 0 enters an infinite loop and core 1 continues to execute in its loop.

18.

Select main()

thread from core 1 and click the Suspend button.

The debugger halts core 1 at the current statement and the status of the program changes to (

Halted

). Core 0 continues to execute.

19. Select Run > Multicore Terminate.

The debugger terminates the active debug session. The threads associated with each core in the Debug view disappear.

9.3 Multi-Core Debugging Commands

This section describes the multi-core commands available in the Run menu of

CodeWarrior IDE and in the Debugger Shell.

If you are debugging a multi-core project, you can use single and multi-core debugging commands to debug parts of each core project.

•

Multi-Core Commands in CodeWarrior IDE

•

Multi-Core Commands in Debugger Shell

CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,

11/2015

272 Freescale Semiconductor, Inc.

9.3.1 Multi-Core Commands in CodeWarrior IDE

Chapter 9 Multi-Core Debugging

This section describes the multi-core commands in the CodeWarrior IDE.

When you start a multi-core debug session, multi-core commands are enabled on the

CodeWarrior IDE Run menu. These commands, when issued, affect all cores simultaneously. The table below describes each menu choice. For detailed information on these commands, see CodeWarrior Development Studio Common Features Guide.

Command

Multicore Resume

Table 9-2. Multi-Core Debugging Commands

Icon Description

Starts all cores of a multi-core system running simultaneously.

Multicore Suspend

Multicore Restart

Multicore Terminate

Multicore Groups

Stops execution of all cores of a multi-core system simultaneously.

Restarts all the debug sessions for all cores of a multi-core system simultaneously.

Kills all the debug sessions for all cores of a multi-core system simultaneously.

Use All Cores: If the selected debug context is a multi-core system, then all cores are used for multi-core operations.

Disable Halt Groups: Disables breakpoint halt groups. For more information on halt groups, see "Multicore Breakpoint Halt Groups" in

CodeWarrior Development Studio Common Features Guide.

Limit new breakpoints to current group: If selected, all new breakpoints set during a debug session are reproduced only on cores belonging to the group of the core on which the breakpoint is set.

Edit Target Types: Opens Target Types dialog box that lets you add and remove system types.

Edit Multicore Groups: Opens the Multicore Groups dialog box to create multi-core groups. You can also use this option to modify the existing multi-core groups.

NOTE

For more information about creating/modifying multi-core groups, or editing target type, see "Multicore Groups" in

CodeWarrior Development Studio Common Features Guide

.

To use the multi-core commands from the Debug perspective, follow these steps:

1. Start a debugging session by selecting the appropriately configured launch configuration.

2. If necessary, expand the desired core's list of active threads by clicking on the tree control in the Debug view.

3. Click the thread you want to use with multi-core operations.

CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,

11/2015

Freescale Semiconductor, Inc.

273

Multi-Core Debugging Commands

4. From the Run menu, specify the multi-core operation to perform on the thread.

NOTE

The keyboard shortcut for the Multicore Resume operation is Alt+Shift+F8.

9.3.2 Multi-Core Commands in Debugger Shell

This section describes the multi-core commands in debugger shell.

In addition to the multicore-specific toolbar buttons and menu commands available in the

Debug view, the Debugger Shell has multi-core specific commands that can control the operation of one or more processor cores at the same time. Like the menu commands, the multi-core debugger shell commands allow you to select, start, and stop a specific core.

You can also restart or kill sessions executing on a particular core. The table below lists and defines the affect of each multi-core debugging command.

Command

mc::config mc::go mc::group mc::c mc::g

Table 9-3. Multi-Core Debugging Commands

mc::gr

Shortcut Description

List or edit multicore group options.

Syntax

mc::config

Resume multiple cores

Syntax

mc::go

Examples

mc::go

Resumes the selected cores associated with the current thread context.

Display or edit multicore groups

Syntax

group group new <type-name> [<name>] group rename

<name>|<group-index> <new-name>group remove <name>|

<group-index> ... group removeall group enable|disable

<index> ...|all

Examples

mc::group

Shows the defined groups, including indices for use in the mc::group rename|enable|remove set of commands.

mc::group new 8572

Table continues on the next page...

CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,

11/2015

274 Freescale Semiconductor, Inc.

mc::kill

Command

mc::reset mc::restart mc::stop mc::type

Chapter 9 Multi-Core Debugging

Table 9-3. Multi-Core Debugging Commands (continued)

mc::kill mc::t

Shortcut

mc::reset mc::restart mc::stop

Description

Creates a new group for system type 8572. The group name will be based on the system name and will be unique. The enablement of the group elements will be all non-cores enabled, all cores disabled.

mc::group rename 0 "My Group Name"

Renames the group at index 0 to "My Group Name".

mc::group enable 0 0.0

Enables the group at index 0 and the element at index 0.0 of the mc::group command.

mc::group remove "My Group Name"

Removes the group named "My Group Name".

mc::group removeall

Removes all groups.

Terminates the debug session for selected cores associated with the current thread context.

Syntax

mc::kill

Examples

mc::kill

Terminates multiple cores.

Resets multiple cores.

Syntax

mc::reset

Restarts the debug session for selected cores associated with the current thread context.

Syntax

mc::restart

Examples

mc::restart

Restarts multiple cores.

Stops the selected cores associated with the current thread context.

Syntax

mc::stop

Examples

mc::stop

Suspends multiple cores.

Shows the system types available for multicore debugging as well as type indices for use by the mc::type remove and mc::group new commands.

Syntax

CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,

11/2015

Freescale Semiconductor, Inc.

275

Multi-Core Debugging Commands

Table 9-3. Multi-Core Debugging Commands

Command Shortcut Description

type type import <filename> type remove <filename>|

<type-index> ... type removeall

Examples

mc::type

Display or edit system types.

mc::type import 8572_jtag.txt

Creates a new type from the JTAG configuration file.

mc::type remove 8572_jtag.txt

Removes the type imported from the specified file.

mc::type removeall

Removes all imported types.

CodeWarrior Development Studio for StarCore 3900FP DSP Architectures Targeting Manual, Rev. 10.9.0,

11/2015

276 Freescale Semiconductor, Inc.