User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 79/385
Create a workspace by wrapping an executable
You can create a workspace for an executable file (.abs, .elf, .hex, .s19) for debugging.
However, during debugging you will only have access to the disassembled code and not the
original source code.
1. To create your workspace, select the Wrap Executable icon and click on OK.
A browse window opens.
2. Highlight the executable file that you want to use to create your workspace and click on
Open.
The New Project window opens.
3. Here, enter a name for the project file (.stp) and the project’s location.
By default your project is named executable_filename.stp and its location is the
directory of the executable file.
4. Now, select your toolset from the list box and enter its path. Click on OK.
Your workspace is created and named executable_filename.stw. The new workspace
file appears in the Workspace window, typically on the left side of STVD’s main
window. Your workspace contains a project executable_filename.stp.
You can now identify your debug instrument and debug the application.
Create a workspace by wrapping a makefile
Early versions of STVD7 used a makefile (.mak) to define the build process for source files
and a specified toolset. Wrapping your makefile to create a new workspace allows you to
rapidly transition projects to STVD7 3.0 and later releases, with certain limitations.
However, if you follow this migration procedure you will not have access to the build options
in the Project Settings window. Any changes to options must, therefore be made manually
to the makefile. STVD will not automatically manage project dependencies either. You, must
instead use your makefile to specify dependencies and you must verify these dependencies
yourself. Finally, if you add files to the project to edit them, they are not automatically added
to the build. In order to be taken into account when building, you must manually update the
makefile to include the new files.
For information about migrating your project in a manner that preserves the full range of
STVD’s build features, refer to 7 steps to full migration on page 72.
To create your workspace by wrapping an existing makefile:
1. Highlight the Wrap Makefile icon and click on OK.
A browse window opens. By default it is set to display .mak makefiles.
2. Highlight the makefile that you want to use to create your workspace and click on
Open.
You will receive an information message, notifying you that STVD is going to wrap the
makefile in a workspace.
3. Click on OK to continue.
The New Project window opens.
4. Here, enter a name for the project file (.stp) and the project’s location. By default your
project is named makefile_name.stp and its location is the directory of the makefile.
Click on OK.
The MCU selection window appears.