Introduction to HEW

This section deals with the concepts and functionalities associated with the High- performance Embedded Workshop V.4.08 (HEW).

Overview:HEW organizes your work with the concepts of workspaces and projects.

䡲 Workspace: This is the largest unit which contains programs written in the HEW workshop. It can have several projects. A project is automatically created when we create the workspace.

䡲 Project: The project is where you write your program. In fact, creating a new proj- ect is making a new program. You can also make hierarchical levels between sev- eral modules. It, along with other projects, will be included in the workspace.

A simple diagram below shows the relationship between a project and the workspace.

project project project workspace file file Figure 4.2 Relationship between a project and the workspace.

Creating or Opening a Project in HEW-IDE

To launch HEW, open the start menu, select program, select Renesas, select HEW, and then select the shortcut of the High-performance Embedded Workshop.

Figure 4.3 Launching of HEW.Source: RX62N RDK Renesas toolchain quick start guide.

Look for the dialog box just like this:

Figure 4.4 Welcome dialog box in HEW.Source: HEW User Manual V.4.08, page 15.

To create a new workspace:

䡲 Select the Create a new project workspace option from the Welcome! dialog box, and click the OK button or select [File V New Workspace]. The New Project Workspace dialog box will be displayed.

䡲 Enter the name of the new workspace into the Workspace Name field. To select the directory in which you would like to create the workspace, use the Browse but- ton or type the directory into the Directory field manually.

䡲 Select the CPU family and Tool chain upon which you would like to base the workspace.

䡲 When a new workspace is created, the HEW will also automatically create a proj- ect and place it inside the new workspace. From the project types list, select the type of project that you want to create from this list. The project types are of mainly three types: tool chain-only, debug-only, and a full project generator that contains both the debugger and tool chain aspect of the HEW.

䡲 Click the OK button to create. This then launches the HEW window.

To open a new workspace:

䡲 Select Browse to another project workspace option from the dialog box shown in Figure 4.4 and then click the OK button or select [File V Open Work-

space].The Open Workspace dialog box will be displayed. Select the workspace

file (“.HWS” file) that you want to open.

䡲 Click the Select button to open the Properties dialog box to open the workspace. Click the Cancel button to stop opening the workspace.

To open a recently used workspace:

䡲 Select Open a recent project workspace in the dialog box: select the name of the workspace from the dropdown list, and then click the OK button.

Windows in HEW

There are three main windows in HEW:

Workspace Window: Shows the projects and files that are currently in the workspace. It

has four tabs: Projects, Templates, Navigation, and Test.

Figure 4.6 Workspace window in HEW.Source: HEW User Manual V.4.08, page 6.

Output Window: Shows the results of a various processes (e.g., build). By default, it

has seven tabs (Build, Debug, Find in Files 1, Find in Files 2, Macro, Test, and Version Control) on display.

Editor Window: Provides file viewing and editing facilities. It is in this window where you will edit files of your project. It allows you to have many files open at one time, so you can switch between them. You can edit them in whichever order you want. Each file has a separate tab associated with it, and you can navigate easily to any tab you want.

Figure 4.8 Editor window in HEW.Source: HEW User Manual V.4.08, page 9.

Figure 4.9 Configuration and session selection in HEW.Source: HEW User Manual V.4.08, page 20.

Concept of Configuration and Session

By looking at the Standard toolbar you will know your current configuration and session. You can also select your session and configuration by looking into the drop-down list box. For instance, Figure 4.9 shows that the selected debugger is “SH-4 Simulator” which works along with Renesas SuperH Standard toolchain.

Configuration

After selecting a toolchain, you will create a project. Once the project is created, the HEW will automatically create configurations “Debug” and “Release.” As shown in Figure 4.9, configurations “SimDebug_SH-4,” “Debug,” and “Release” are available. At the time of the creation of the project, if you have selected a target debugger HEW will automatically create a configuration best suited for that debugger. For in- stance, if you have selected “SH-4 Simulator” in the Target tab while creating a proj- ect, configuration “SimDebug_SH-4” is created. Configurations are the settings that have to be set before the building process starts. It can also be referred to as “build configuration.”

Session

Sessions are the units basically used to manage various settings. For instance, they may refer to the settings associated with debugging options of a specific debugger and data values on the memory and register windows. The term “session” is also referred as “de- bugger session.” If you look at the figure of the Standard toolbar (Figure 4.9), sessions “SimSessionSH-4” and “Default Session” are available. Information on each session is saved in an individual file in the HEW project. Just like a configuration is created as you create a project after selection of the toolchain, a session called “Default Session” is also created. Also, if you select a target debugger at the creation of project, a session is created for connecting the debugger. For example, if you have selected “SH-4 Simu- lator” in “Target” at the creation of a project, session “SimSessionSH-4” is automati- cally created.