# Hexagon profiler user interface
Use a web browser to view the report file that contains the profile information. The report file is in HTML format and presents an interactive document that allows you to select and display various types of profile information. This interactive document is called the *Hexagon profiler user interface*.
## User controls
At the top of the user interface are a menu button (on the left) and profile information tabs. Depending on which tab is selected, the page displays the corresponding profile information. The default view
is the [CORE Stalls tab](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-tab).
### Profile information tabs
The user interface displays several tabs:
| Tab | Profile Information |
| --- | --- |
| [CORE Stalls](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-tab) | Total number of cycles and stalls executed
Highest cycle or stall counts (by function or instruction packet)
Commit and stall statistics (by function or instruction packet) |
| [CORE Stalls](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-tab) | A [Search grid](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-search-grid-box) tab appears at the far right of the tabs |
| [Events](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-events-tab) | Event count statistics (by function or instruction package)
Disassembled listing of instruction packets |
| [Events](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-events-tab) | A [Search grid](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-search-grid-box) tab appears at the far right of the tabs |
| [PMU Events](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-pmu-events-tab) | PMU event counts |
| [Derived Stats](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-derived-stats-tab) | Commonly used PMU events calculations |
| [Instructions](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-instructions-tab) | Hexagon assembly instructions that were profiled, with counts |
| [Help](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-help-tab) | Basic information about what was profiled |
| | |
The following tab appears only if the Hexagon ELF file contained HVX instructions.
| Tab | Profile Information |
| --- | --- |
| [HVX Stalls](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-optional-hvx-stalls-tab) | Cycle counts and cycle count statistics for HVX packets |
### Menu of disassembly configuration options
The menu button displays a Disassembly Panel, which lists configuration options for disassembly information to be displayed on the CORE Stalls and Events tabs. The options vary according to each tab.
These options change the way the following profile information is displayed.
| **Option** | **Profile information** |
| --- | --- |
| Commits | Cycle counts and statistics showing how often an instruction packet executed without stalling (commit) versus how often it stalled during execution (stall). |
| Stalls | Cycle counts and statistics showing how often an instruction packet executed without stalling (commit) versus how often it stalled during execution (stall). |
| Stall Details | Same as Commits/Stalls but includes cycle counts and statistics for each stall type that occurred to an instruction packet. |
| Minor Stalls | Same as Stall Details but includes the stall types that caused less than one percent of the total instruction packet stalls (called *minor stalls*). |
| Events | Enables display of the count and type of each event that occurred with an instruction packet. |
| Filenames | Enables display of the source file name and line number for each line of disassembly, when available. |
| Selected Type Only | Limits the disassembly display to the currently-selected Event or Stall type. |
| Jump Target Names | Displays the symbol name after the jump-to address in the Disassembly column. |
| Packet Braces | Adds curly braces around instruction packets in the Disassembly column. |
| Leading Zeros | Adds leading zeros to address values in the Address column. |
| Hex Prefix 0x | Adds `0x` to the beginning of address values in the Address column. |
| Underline links | Underlines all hyperlinked addresses in the Disassembly column. |
| Highlight links | Yellow highlights all hyperlinked addresses in the Disassembly column. |
| Global Options | Might appear depending on your browser.
For example, the Override Chrome Magnifier option appears only for the Chrome browser. |
| | |
## CORE Stalls tab
When you open a profile report file in a web browser, the CORE Stalls tab displays by default.
This tab displays the cycle counts and cycle count statistics for instruction packets:
- The top left pane lists the total cycles and stall cycles for the program, followed by a list of the stall cycles categorized by stall type.
Clicking a hyperlinked item (Total, Stalls, Commits, or a stall type) in the top left pane changes the top right pane so it lists the instruction packets with the highest cycle counts for the selected item.
- The top right pane lists the highest cycle or stall counts (by function or instruction packet).
Clicking the PC address of an instruction packet changes the bottom pane to show a disassembled listing of the specified instruction packet and the packets that follow it.
- The bottom pane provides a disassembled listing of instruction packets along with detailed Commit/Stall cycle counts and statistics for each by function or instruction packet.
- A Search grid tab also appears. It allows you to quickly search for a function (symbol) (see [Search grid box](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-search-grid-box)).
The profile information displayed in these panes is controlled by the Disassembly Panel options and the hyperlinks that appear in the top and bottom panes.
### Display totals
In the top left pane:
- Click the **Total** item to change the top right pane to display the total number of both commits and stalls executed in the program (this is the default view).
- Click either the **Stalls** or **Commits** item to change the top right pane to display only the respective stalls/commit statistics.
In the top right pane:
- Select **Top Functions** or **Top Packets**. The cycle count, percentage, and cumulative percentage for each instruction packet listed are displayed. The packets are identified by their PC addresses, which are hyperlinked.
- Click the PC address to change the bottom pane to display a disassembled listing of the program code, starting at the specified instruction packet.
For example, the **0x62dc** address is the PC address of an instruction packet that was executed 2161322 times in the program, and it is contained in the compute\_fractal() function.
The bottom pane displays the PC address, which contains the function and cycle count for each disassembled instruction packet.
### Display commits and stalls
In the top left pane, clicking a stall type changes the top right pane to display cycle counts and cycle count statistics that indicate how often an instruction packet executed without stalling (commit) versus how often it stalled during execution (stall).
To view commits or stalls, click the Menu button and select **Commits** or **Stalls** (or both) on the Disassembly Panel (see [Menu of disassembly configuration options](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-menu-of-disassembly-configuration-options)).
The page works like the Total display (see [Display totals](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-display-totals)). Clicking on an item in the top left pane shows the corresponding information in the top right pane. Clicking an item in the top right pane shows the corresponding information in the bottom pane.
For example, clicking **PAUSE\_CYCLES** shows the single instruction packet it specifies in the top right pane. Clicking that instruction address displays the following information in the bottom pane: PC address, which contains the function, commit and stall percentages, and cycle count for each disassembled instruction packet.
The commit and stall percentages are represented graphically, with green lines indicating the commit percentages and red lines indicating the stall percentages.
### Display stall details
To view more stall details, click the Menu button and select **Stall Details** in the Disassembly Panel (see [Menu of disassembly configuration options](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-menu-of-disassembly-configuration-options)).
This page works like the commits/stalls display ([Display commits and stalls](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-display-commits-and-stalls)) but it also lists the separate cycle counts and statistics for each stall type that occurred to an instruction packet.
Note
Stall types with less than one percent of the total stalls are not listed; for more information see [Display minor stalls](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-display-minor-stalls).
For example, the instruction packet at address **0x62dc** lists both the total number of stall cycles for this instruction packet (1623455) and how many of these stall cycles belong to the various stall types (`CU_INTERLOCK_CYCLES`, `CU_FP_RX_NO_NTWK_CYCLES`, and so on).
The bottom pane displays the PC address, which contains the function, commit, and stall percentages (both total and by stall type), and the cycle count for each disassembled instruction packet.
The commit and stall percentages are represented graphically, with green lines indicating the commit percentages and red lines indicating the stall percentages.
### Display minor stalls
To view the stall types that caused less than one percent of the total stall cycles for an instruction packet (*minor stalls*), click the Menu button and select **Minor Stalls** in the Visible Lines portion of the Disassembly Panel (see [Menu of disassembly configuration options](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-menu-of-disassembly-configuration-options)).
This display works like the Stall Details display (see [Display stall details](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-display-stall-details)). For example, in the bottom pane, the instruction packet at address **0x62dc** includes the minor stall type, `CU_NO_DISPATCH_CYCLES`, which has a stall percentage of less than one percent.
Minor stalls are displayed in pink (rather than the usual red).
## Events tab
The Events tab displays information generated by the Hexagon performance management unit (PMU). The Hexagon processor architecture defines a PMU to support on-target performance tracking. (For more information, see the applicable *Qualcomm Hexagon Programmer’s Reference Manual*).
The Events tab works like the [CORE Stalls tab](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-core-stalls-tab). It displays information in three panes:
- The top left pane lists the name and event count for the PMU event types with the highest event counts.
- The top right pane displays the PMU event count, percentage, cumulative percentage, PC address, and containing function for each instruction packet listed.
- The bottom pane provides a disassembled listing of instruction packets along with detailed PMU event counts and statistics for each by function or instruction packet.
- A Search grid tab also appears. It allows you to quickly search for a function (symbol) (see [Search grid box](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html#hp-search-grid-box)).
For example, clicking the **L2\_ACCESS** item in the top left pane changes the top right pane to list the instruction packets with the highest PMU event counts for L2\_ACCESS. Clicking a PC address in the top right pane changes the bottom pane to display a disassembled listing of the program code, starting at the specified event.
## PMU Events tab
The PMU Events tab shows the performance monitor event counts.
## Derived Stats tab
The Derived Stats tab shows a set of calculated values based on collected PMU events.
Note
Derived Stats information is presented only for Hexagon V66 and later versions.
## Instructions tab
The Instructions tab shows the Hexagon assembly instructions that were executed, the syntax of each assembly instruction, the count of each instruction, and the percentage of each instruction.
The Hexagon assembly instructions are described in the *Qualcomm Hexagon Programmer’s Reference Manual*.
## Help tab
The Help tab shows information about the test parameters.
## Search grid box
The search grid box is present when the CORE Stalls or Events tab is active. As you type in the search grid, the profile display scrolls to the function (symbol) that matches what you type.
## Optional HVX Stalls tab
If the Hexagon ELF file contained HVX instructions, the HVX Stalls tab appears.
This tab displays the cycle counts and cycle count statistics for HVX instruction packets.
- The top left pane lists the total HVX cycles and HVX stall cycles for the program, followed by a list of the HVX stall cycles categorized by stall type.
- The top right pane initially contains a brief example that clarifies how HVX cycle commits and HVX stall cycles are defined.
Clicking a hyperlinked item in the top left pane changes the top right pane to lists the instruction packets with the highest cycle counts for the selected item. Clicking a PC address in the top right pane changes the bottom pane to display a disassembled listing of the program code, starting at the specified instruction.
If you select Commits/Stalls on the Disassembly Panel, the commit and stall percentages are represented graphically, with green lines indicating the commit percentages and red lines indicating the stall percentages.
Last Published: Oct 06, 2026
[Previous Topic
View the profile report file](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/profiler-ug-use-the-profiler.md) [Next Topic
gprof Profiler User Guide](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/index_80-n2040-29_gprof_profiler_user_guide.md)
Source: [https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html](https://docs.qualcomm.com/doc/80-N3040-23/topic/hexagon-profiler-user-interface.html)