IAR Embedded Workbench for Renesas

Using IAR Embedded Workbench for Synergy

This section describes how to use the IAR Embedded Workbench for Renesas Synergy (IAR EW for Synergy) in combination with the Renesas Synergy Standalone Configurator (SSC) to develop applications with the Renesas Synergy Software Package (SSP). The architecture of the SSP directly determines how you use the IAR EW for Synergy and SSC to develop a Synergy application. See the following documents for details on the SSP architecture included in this manual:

• SSP Architecture
• BSP Architecture

What is IAR EW for Synergy?

IAR Embedded Workbench is now completely integrated with the Renesas Synergy Platform. The new product IAR EW for Synergy provides add-on functionality to simplify and accelerate software development, and provide the best performance and smallest code size.

Just like e² studio, IAR EW for Synergy offers secure source-level visibility into the Synergy Software Package (SSP) as well as secure source-level debugging. The developer can see protected source code but not modify or save it. Once the application code is developed, IAR EW for Synergy includes IAR C-STAT® and C-RUN® analyzers, tools which help and guide to improve application code quality.

IAR EW Key Features

• Integrated development environment with project management tools and editor
• Highly optimizing C and C++ compiler and Linker for Renesas Synergy devices
• Integration support for Renesas Synergy Standalone Configurator (SSC)
• C-STAT and C-RUN code analysis tools included
• Extensive HW target system support
• Power debugging to visualize power consumption in correlation with source code
• C-SPY® Debugger with JTAG/SWD support and support for RTOS-aware debugging on hardware
• Support for ETM Trace
• Comprehensive user and reference guides and context-sensitive help function
• Compliant with ARM® Embedded Application Binary Interface (EABI) and ARM Cortex® Microcontroller Software Interface Standard (CMSIS)

For detailed instructions on how to download and install IAR EW for Synergy, see the IAR EW for Synergy Release Notes on the Synergy Gallery.

What is Synergy Standalone Configurator (SSC)?

The Synergy Standalone Configurator (SSC) is an Eclipse Rich Client Platform (RCP) application containing the Synergy Project Generator and the Synergy Project Editor as implemented in the Renesas e² studio ISDE. SSC includes configurators like the Clock Configurator, Pin Configurator, RTOS Configurator, SSP Module Selector/Configurator, and Interrupt Control Unit (ICU) Configurator for use with 3^rd party IDEs such as IAR EW for Synergy.

IAR EW for Synergy and SSC Functional Block Diagram

Since the functionality of the SSC is identical to the Synergy Project Generator and the Synergy Project Editor as implemented in the Renesas e² studio ISDE, refer to e2 studio ISDE User Guide for information on how to use it.

For detailed instructions on how to download and install the SSC and the SSP to use with IAR EW for Synergy, see the SSC Release Notes and the SSP Release notes on the Synergy Gallery.

Installing the Tools

To install the tools, follow the steps below:

1. Download and install the Renesas Synergy Standalone Configurator (SSC) from the Renesas Synergy Gallery. You can find it under Development Tools. The default installation directory is C:\Renesas\Synergy\SSC_<SSCversion>.
2. Download and install the Renesas Synergy Software Package (SSP) from the Renesas Synergy Gallery. During the installation you will be prompted to specify an installation directory for the SSP. Point the SSP installer to the directory where you just installed the SSC (for example C:\Renesas\Synergy\SSC_<SSCversion>).
3. Download and install IAR Embedded Workbench for Renesas Synergy from the Renesas Synergy Gallery. To install IAR Embedded Workbench:
   1. In your web browser, specify the URL https://synergygallery.renesas.com and download IAR Embedded Workbench for Renesas Synergy from the Renesas Synergy Gallery. You will also find information about how to obtain a license and get a license number.
   2. Execute the installer that is included in the downloaded file.

   3. Specify the license number when prompted for in the IAR License Manager.

      Note

      The IAR EW for Synergy license entitles you to use this specific edition of IAR Embedded Workbench, but not the Synergy Standalone Configurator for which separate licenses are required.

Creating a Renesas Synergy Project using IAR EW for Synergy and SSC

To create a Synergy Project using IAR EW for Synergy and SSC, follow the steps below:

1. In the IAR Embedded Workbench IDE, choose Project>Create New Project.

2. In the Create New Project dialog box, select Renesas Synergy Project and click OK.

   

   Creating a New Synergy Project using IAR EW for Synergy

3. In the Save As dialog box that appears, choose a suitable destination directory for your workspace (the container that holds your project), for example MyWorkspace, and click Save.

   Note

   Do not save your workspace in the root directory of your operating system (C:).

4. In the Renesas Synergy Setting dialog box that appears, specify the location of your installed Synergy Standalone Configurator (SSC), which by default is installed in C:\Renesas\Synergy\SSC_<SSCversion>.

   Note

   You do not need to specify a license file. You can click OK with the License file field empty. An SSP license file is not required and the source files are not encrypted for SSP v2.0.0 and later.

   

   Renesas Synergy Settings in IAR EW for Synergy
5. Click OK.

6. In the Save As dialog box that appears, specify the name of your project, for example MyProject.

   Note

   Do not save your project in the root directory of your operating system (C:).

7. The IAR Embedded Workbench IDE now connects with the Renesas Synergy Standalone Configurator (SSC). Specify the board support you require:

   

   SSC selection Dialog for SSP, Board, and MCU to be used

   Note

   The SSP versions available in the drop-down list correspond to the versions you have previously installed on your computer.

   Click Next.

8. The Synergy Software Packages come with several example projects, which include source code files, header files, and linker configuration files, adapted for your device. Select the example packages that you want to add to your project:

   

   Project Template Selection Dialog

   Click Finish.

9. In the Synergy Project Editor that opens up, you can now configure MCU pin function assignments, clock and peripheral settings, and interrupt source assignments. When finished configuring, click the Generate Project Content button. The source code is now generated.
   

   Generate Project Content Button

   Note

   You can always add or change the configuration of your Synergy project later on.

10. After a couple of seconds, your Renesas Synergy project is displayed in the IAR EW Workspace window:

    

    IAR EW for Synergy Workspace and Project Window
11. If you close the SSC, you can re-open it again by clicking the Synergy Configuration button
    
    in the toolbar, or by selecting Renesas Synergy > Configurator from the menu.
12. Whenever you switch back to the SSC to change configuration settings, click the Generate Project Content button when finished. The affected source code files are now re-generated.

13. You can now continue building and debugging according to the standard routines in the IAR Embedded Workbench IDE, see the IAR Embedded Workbench® IDE User Guide on the IAR web site.

    As the SSC works just like the Synergy Project Editor in e² studio, refer to e2 studio ISDE User Guide for more details on how to use it.

    Note that the Synergy Project is by default configured for the J-Link debugging probe.

    If you have another debugging probe, for example I-jet or I-jet Trace, choose Project>Options>Debugger in the IDE and select I-jet/JTAGjet from the Driver drop-down list.