Click the Code Coverage link to view to view the code coverage data.
The following diagram shows an example of the Code Coverage data.
Figure 1. Code Coverage viewer
The Code Coverage data displays the summarized data of a function in a tabular form. The columns are movable; you can drag and drop the columns to move them according to your requirements. It displays data into two views; the top view displays the summary of the functions, and the bottom view displays the statistics for all the instructions executed in a particular function. Click on a hyperlinked function in the top view of the Code Coverage viewer to view the corresponding statistics for the instructions executed in that function.
The below table explains the various fields of the Summary table.
| Field | Description |
|---|---|
| File/Function | Displays the name of the function that has executed. |
| Address | Displays the start address of the function. |
| Covered ASM % | Displays the percentage of number of assembly instructions executed from the total number of assembly instructions per function or per source file |
| Not Covered ASM % | Displays the percentage of number of assembly instructions not executed from the total number of assembly instructions per function or per source file. |
| Total ASM instructions | Displays the total number of assembly instructions per function and per source file. |
| ASM Decision Coverage % | Displays the decision coverage computed for direct and indirect conditional branches. It is the mean value of the individual decision coverages. So if a function has two conditional instructions, one with 100% and another with 50% decision coverage, the decision coverage would be (100 + 50) / 2 = 75%. It is calculated only for assembly instructions and not for C source code. |
| Time (Microsecond) | Displays the total number of clock cycles that the function takes |
| Size | Displays the number of bytes required by each function. |
The below table describes the fields of the statistics of the code coverage data.
| Field | Description |
|---|---|
| Line/Address | Displays either the line number for each instruction in the source code or the address for the assembly code. |
| Instruction | Displays all the instructions executed in the selected function. |
| Coverage % | For C source lines, displays the percentage of number of assembly instructions executed from the total number of assembly instructions corresponding to the source line. For assembly source lines, it shows if the instructions were executed or not. |
| ASM Decision Coverage | Displays the decision coverage computed for direct and indirect conditional branches. It is the mean value of the individual decision coverages. So if a function has two conditional instructions, one with 100% and another with 50% decision coverage, the decision coverage would be (100 + 50) / 2 = 75%. It is calculated only for assembly instructions and not for C source code. |
| ASM Count | Displays the number of times each instruction is executed. |
| Time (CPU Cycles) | Displays the total time taken by each instruction in the function. |
Note: In the Code Coverage viewer, all functions in all files associated with the project are displayed irrespective of coverage percentage. However, the 0% coverage functions do not appear in the Performance and Call Tree viewers because these functions are not considered to be computed and are not a part of caller-called pair.
When you double-click in Details table on an instruction, it opens (if available) the source file and highlights the instruction line. If the source is not available, you can Locate the file.
Click on the column header to sort the code coverage data by that column. However, you can only sort the code coverage data available on the top view. The icons available in the summary view of the Code Coverage tab allow you to perform the following actions:
- Previous function- Lets you view the details of the previous function that was selected in the Summary table before the currently selected function. Click it to view the details of the previous function.
- Next function- Lets you view the details of the next function that was selected in the
Summary table. Note: The Previous and Next buttons are contextual and go to previous/next function according to the history of selections. So if you select a single line in the view, these buttons will be disabled because there is no history.
- Export - Lets you export the code coverage data in a CSV or html format. Click the button to choose between Export to CSV or Export to HTML options. The Export to CSV option lets you export data of both Summary and Details tables. The exported html file contains the statistics for all the source files/functions from the Summary table along with the statistics of source, assembly or mixed instructions.
- Configure Table - Lets you show and hide column(s) of the code coverage data. Click and select the Configure Columns for Summary Table option to show/hide columns in the Summary table (top view) or the Configure Columns for Details table option to show/hide columns of the Details table (bottom view). The Drag and drop to order columns dialog appears in which you can check/uncheck the checkboxes corresponding to the available columns to show/hide them in the Code Coverage viewer. The option also allows you to set CPU frequency and set time in cycles, milliseconds, microseconds, and nanoseconds.
- Collapse/Expand all files - Lets you expand or collapse all files in the Summary table.
- Filter Files - Allows you to choose the list of files to be displayed in the Summary table.
- Switch to executable source lines statistics/Switch to ASM instructions statistics - Lets you switch between source lines or ASM instructions to be displayed in the Summary table.
You can perform the following actions on the Details table:
- Search - Lets you search for a particular text in the Details table. In the Search text box, type the data that you want to search and click the Search button.
- Graphics - Lets you display the histograms in two colors for the ASM Count and Time columns in the bottom view of the code coverage data. Click the button and select the Assembly/Source > ASM Count or Assembly/Source > Time option to display histograms in the ASM Count or Time column. The colors in these columns differentiate source code with the assembly code.
- Show code - Lets you display the assembly, source or mixed code in the statistics of the Code Coverage data.