NOTICE: The Processors Wiki will End-of-Life in December of 2020. It is recommended to download any files or other content you may need that are hosted on The site is now set to read only.

How to Build the Matrix GUI

From Texas Instruments Wiki
Jump to: navigation, search

Getting Started Building the Matrix Gui

The following instructions will help you to Build the Matrix GUI project using CCSv5.

  • This article assumes you have already installed the AM SDK on your Linux Ubuntu Host.

If not see this link to install the Sitara SDK: Installing_the_Sitara_SDK

Starting CCSv5

Refer to How to Start CCSv5 to start Code Composer Studio v5.

Select the Build Configuration

Click on the matrix_gui project under the Project tab to select the project.  R-Click on the matrix_gui project and select Properties from the context menu.

Select C/C++ Make Project.  Initially the make Builder tab will be active but the displayed page is empty.  Click on another tab then click on the Make Builder

tab to see the dialog box as shown below.  You can set the default build configuration by typing "debug" or "release".  Click OK to close the dialog box.

Matrix gui select build.png

Clean the Project

Click the matrix_gui project if not already selected.  Click the Project -> Clean menu item.  Select

"Clean projects selected below".  Leave matrix_gui selected.  Uncheck "Start a build immediately".

Click OK.  This will clean both the debug and release builds.

Matrix gui clean.png

Build the Project

Click on the matrix_gui project if not already selected.  Click the Project -> Build Project menu item.  A progress

indicator dialog will be displayed during the build.

Matrix gui building.png

Below is example build console output for the matrix_gui debug build configuration.

Matrix gui build output.png

Install the Project

The next step is to copy the built executable to the target file system so that it can be run on the EVM.  Note that the matrix_gui Qt application

uses the same executable file for the debug and release build configurations.  The commands below to install the debug version or install the

release version assume that the last build which updated the executable file was performed using the required build configuration.

Using the Ubuntu Linux Host Command Line

The SDK top-level Makefile provides separate install targets for the debug and release build configurations.

Both of these copy the executable and all associated data files to the target file system.  First change

directory to the SDK install directory.  (Substitute your SDK install directory name.)

cd ~/ti-sdk-am181x-evm-

To install the matrix_gui release version:

make matrix_gui_install

To install the matrix_gui debug version:

make matrix_gui_install_debug

Using Remote System Explorer

The Remote System Explorer plug-in can be used to transfers files to the target file system.

(See How_to_Setup_and_Use_the_Remote_System_Explorer_Eclipse_Plug-in to setup the RSE plug-in.)

Under the Remote Systems tab, expand the Local Files node and browse to the location of the matrix_gui
executable.  R-Click on the matrix_gui file and select Copy from the context menu.

Matrix gui local files.png

Expand the node with your target board connection.  Browse to the /usr/bin folder.  R-Click on the /usr/bin folder and select Paste from the context

Matrix gui paste.png

Since the executable on the target board is named matrix_guiE, the new executable needs to be renamed.  Scroll down to the existing file

named matrix_guiE.  R-Click on matrix_guiE and select Delete from the context menu.  Click OK on the Delete Confirmation dialog box.

Matrix gui delete.png

R-Click on the matrix_gui file and select Rename from the context menu.  In the Rename Resource

dialog box, change the name to matrix_guiE and click OK.

Matrix gui rename.png

R-Click on the matrix_guiE file and select Properties from the context menu.  Click
on Permissions.  Check Execute for User, Group and Others and click OK.

Matrix gui permissions.png