Environment¶

If you would like to use J-Link for debugging, please refer to Exporting to e2studio (J-Link debug).

Setup Procedure¶

Install Windows serial driver¶

Install latest Windows Serial Port Driver to setup CMSIS-DAP from the link below:
https://mbed.org/handbook/Windows-serial-configuration

Install e²studio¶

Please download e²studio 5.0.0 or lator, and install

Install OpenOCD¶

Please download exe file of OpenOCD v0.10.0-201601101000-dev, and install.

Associate GR-PEACH config with OpenOCD¶

Please copy renesas_gr-peach.cfg to scripts\board directory included in the OpenOCD installed location. By default, it should be located as follows:

• In case of using 32-bit windows:
  C:\Program Files\GNU ARM Eclipse\OpenOCD\0.10.0-201601101000-dev\scripts\board
• In case of using 64-bit windows:
  C:\Program Files (x86)\GNU ARM Eclipse\OpenOCD\0.10.0-201601101000-dev\scripts\board

Install OpenOCD add-in to e²studio¶

1. Launch e²studio.
2. Select[Help]menu→[Install new software...]
3. Input http://gnuarmeclipse.sourceforge.net/updates to [work with] box, and push [Add] button.
   
4. Check [GNU ARM C/C++ OpenOCD Debugging] and push [Next >] button.
   
5. Install and restart e²studio.

Configure OpenOCD on e²studio¶

1. Select [Window] -> [Preferences].
   
2. Select [Run/Debug] - [OpenOCD].
   
3. Check if the directory and executable are filled with OpenOCD installation folder and openocd.ex respectively. If not, please input OpenOCD installation folder and openocd.exe there and click [OK]. Note that the default OpenOCD installation folder should be as follows:

• In case of using 32-bit windows:
  C:/Program Files/GNU ARM Eclipse/OpenOCD/0.10.0-201601101000-dev/bin
• In case of using 64-bit windows:
  C:/Program Files (x86)/GNU ARM Eclipse/OpenOCD/0.10.0-201601101000-dev/bin

Build of e²studio environment¶

Exporting to e²studio¶

1. Go to Mbed compiler.
2. Right click at the program you want to export.
3. Select "Export Program"
   
4. Select "Renesas GR-PEACH" for Export Target
   Select "e2studio" for Export Toolchain
   Push "Export"
   
   
5. Expand zip file.

import project to e²studio¶

1. Launch e²studio.
2. Specify workspace directory. Workspace directory must be placed in the upper directory of the directory that includes .project file.
   In this document, project file is placed in C:\WorkSpace\GR-PEACH_blinky_e2studio_rz_a1h\GR-PEACH_blinky, and the workspace is placed in C:\WorkSpace\GR-PEACH_blinky_e2studio_rz_a1h.
   
3. If Toolchain Integration dialog appared, select [GCC ARM embedded version 4.9.3.20150529] and click [Register].
   
4. After e²studio window opens, click [go to workbench].
   
5. Select [File]menu-[import].
   
6. Select [General]-[Existing Projects into Workspace], and click [Next>]
   
7. Click [Browse].
   
8. Click [OK].
   
9. Click [Finish].
   

Build Process¶

1. Launch e²studio.
   
2. Select the [Window] menu -> [Show View] -> [Project Explorer].
3. Select the project to build.
4. Click build icon.

  e.g.) The folder structure when making the work folder "C:\Workspase". Export project is GR-PEACH_blinky.
    C:
    +-- Workspace
        +-- GR-PEACH_blinky_e2studio_rz_a1h
            +-- .metadata
            +-- GR-PEACH_blinky
                |   .cproject
                |   .gdbinit
                |   .hgignore
                |   .project
                |   exporter.yaml
                |   GettingStarted.htm
                |   GR-PEACH_blinky OpenOCD.launch
                |   main.cpp
                |   mbed.bld
                |   SoftPWM.lib
                +-- .hg
                +-- .settings
                +-- Debug <- When clicking [Build Project], ".bin" and ".elf" file will be created here.
                +-- mbed
                +-- SoftPWM

The way to debug¶

Debug¶

1. Connect USB cable
2. Copy ".bin" file to Mbed drive
3. Reconnect USB cable
4. Select project to debug.
5. From menu in C/C++ perspective or debug perspective , select [Run] [Debug Configurations...]
   
6. Select [<project-name> OpenOCD] in [GDB OpenOCD Debugging]
   
7. Click "Debug".

• If you want to reset :
  please enter the following command to "arm-none-eabi-gdb.exe" screen in "console" view.
  When you drop down from the console view toolbar buttons, you can switch the screen.
  

monitor reset init

Support features¶

These features are supported. Generic views which uses the features below would be useable.

1. Software breakpoint will be replaced with Hardware breakpoint. 6 points are available in total.
   
2. Downloading from e2 studio to serial flash memory is not supported. But you can download the program by copying the bin file to the drive which is generated when you connect the board to PC, because GR-PEACH is Mbed device. Before you download the program by the manner of Mbed, please disconnect the debugger from the board.
   
3. Reading or writing memory while program is running are not supported. And writing is supported only for RAM.
   
4. .gdbinit is required to stepping the program which uses interrupt.
   
5. The button for reset in Debug View doesn't work, but the command to reset is available. Please enter "monitor reset init" to reset the program in the console for GDB (arm-none-eabi-gdb).
   Although the display is not changed, but the program would be reset. The button for restart will work once. Please don't use it.
   

e² studio has the special views for Renesas. The supported status are below.