Migrating from CubeSuite+ to Eclipse RL78 Family

Migrating from CubeSuite+ to Eclipse RL78 Family LAB PROCEDURE Description: This hands-on lab covers how to convert CubeSuite+ project to Renesas new Eclipsebased IDE, e 2 studio using Free GNU compiler for RL78 devices. This lab will step through the key difference in Interrupt declarations, SFR access, and intrinsic functions in the Cubesuite+ and e 2 studio project, then quickly modify the CubeSuite+ project that can compile/build/debug in the e 2 studio environment. Lab Objectives 1. Port RL78 CubeSuite+ project to e 2 studio 2. Edit/build/run the project in e 2 studio Lab Materials Please verify you have the following materials at your lab station. Laptop PC with e 2 studio GNU compiler version 12.01 or later CubeSuite+ V1.02 or later RL78/G14 RDK board This lab sheet Skill Level 1. Experience with CubeSuite+ and RL78 Time to Complete Lab 2 hours Lab Sections 1 Create a CubeSuite+ Project... 2 2 Bring Cubesuite+ Project to e 2 studio... 8 3 Map IO Register and Intrinsic function... 14 4 Map Interrupt Declaration... 17 5 RUN the Project on the Target board... 18 Migrating from CubeSuite+ to Eclipse Page 1 of 21

1 Create a CubeSuite+ Project LAB PROCEDURE This lab section will create a simple CubeSuite+ project using CubeSuite+ code generator. We will create a simple project that blinks LED15 every 100 ms on timer interrupt. The project uses RL78G14 family device, R5F104PJAFB, the device used on the RL78/G14 RDK board. Procedural Steps Step 1.1 Start the CubeSuite+ development environment by clicking Start All Programs Renesas Electronics CubeSuite+ CubeSuite+ or by clicking the CubeSuite+ icon from the Windows Desktop. CubeSuite+ Start window presents several choices to choose from. These are typical of any development environment and include Learn about CubeSuite+, Create New Project, Open Existing Project, Open Existing CubeSuite/High performance embedded workbench, PM+ project, and Open Sample Project. Step 1.2 Select Create New Project or File->New-> Create New Project. This will start a new project workspace using the integrated project wizards built into the CubeSuite+. Migrating from CubeSuite+ to Eclipse Page 2 of 21

Step 1.3 Enter the options below to configure project environment for RL78 microcontroller. Microcontroller : RL78. Using microcontroller: R5F104PJAFB under RL78/G14 (ROM: 256KB) Ensure that Kind of project = Application (CA78K0R). Specify Project name = myrl78project. Specify Place = Any directory of your choice such as c: \ Click Create to make project framework. CubeSuite+ provides options for Kind of project. A short summary of the project options are: Application CA(78K0R): Project shell and folders are created. No startup files are created Debug Only: Third party tools that output Renesas compatible debug format files can be used here Library project: Creates Library project Step 1.4 The project, myrl78project, will be created. The panel contains project information. Step 1.5 In the Project Tree window, under Code Generator (Design Tool), double click on Clock Generator.Click on Fix Setting. This setting can only be done once per project. Migrating from CubeSuite+ to Eclipse Page 3 of 21

Step 1.6 Click Clock Setting tab. Leave the setting at its default. RL78 device provides option to use internal High speed oscillator or External crystal. We will use the internal oscillator for our lab. Step 1.7 Select the On-chip Debug tab and Make these settings: Migrating from CubeSuite+ to Eclipse Page 4 of 21

On-Chip Debug: Used Security ID: 0x00000000000000000000 (Default) Erase Flash Memory Data: Checked Step 1.8 Confirming Reset Source and Safety functions tab can be left as default. Step 1.9 Select the Port tab from project tree. Select Port 4 and set bit 1 as an output, with level at 1. This is for driving the on-board LED15. All other port pins should be left as unused. Step 1.10 The Interrupt, ADC, and Serial Converter, D/A converter are not used in this example, so we can skip those. Step 1.11 Select the Timer tab next.on TAU0 tab, select Channel 0 as Interval Timer. Migrating from CubeSuite+ to Eclipse Page 5 of 21

Step 1.12 Click on the Channel 0 and make the setting as below for 100 ms interval. Step 1.13 Select the Watch Dog Timer from the project tree, and set the Watch Dog Timer as unused. Step 1.14 The RTC (Real Time Clock), Interval timer, Clock output/buzzer, Data Transfer Controller, Event link controller, and Voltage Detector are not used in this example, so we can skip those. Step 1.15 Click the Generate Code button, and note the messages below. It should report that the generating file was successful. Migrating from CubeSuite+ to Eclipse Page 6 of 21

Step 1.16 Observe the File folder in the Project Tree window. The code generated by the code generator has been added under the File Code Generator. Step 1.17 Double-click on r_main.c to open the file in the editor window. Add the following Highlighted code in main() function to start the timer. Make sure the code is written under the user code area marked to avoid overwriting the code when re-generated. void main(void) { /* Start user code. Do not edit comment generated here */ R_TAU0_Channel0_Start(); // Add this line of the code while (1U) { ; } /* End user code. Do not edit comment generated here */ } Step 1.18 Open the r_cg_timer_user.c.add the following Highlighted lines in the interrupt static void r_tau0_channel0_interrupt () function to blink the LED15: _interrupt static void r_tau0_channel0_interrupt(void) { /* Start user code. Do not edit comment generated here */ P4.1++; //Add this line of the code /* End user code. Do not edit comment generated here */ } Step 1.19 Save this project, File-> Save Project. Questions: 1) What operating voltage range is selected for the project in code generator? Migrating from CubeSuite+ to Eclipse Page 7 of 21

2 Bring Cubesuite+ Project to e 2 studio LAB PROCEDURE This section creates RL78 project template using e 2 studio project wizard and bring the Cubesuite+ project files to e 2 studio.. Procedural Steps Step 2.1 Start -> All Programs -> Renesas Electronics e 2 studio -> Renesas e 2 studio. Step 2.2 In the Workspace Launcher, select C:\Workspace or any other directory where you want to create the project. Step 2.3 A window similar to the one will appear. Close the Welcome window. Migrating from CubeSuite+ to Eclipse Page 8 of 21

Step 2.4 Click File New C Project, a below window will open. Enter the below information and click Next> button. Project name: myproject Project type: Executable (Renesas) -> Sample Project Toolchains: KPIT GNURL78-ELF Toolchain Migrating from CubeSuite+ to Eclipse Page 9 of 21

Several Project Types choices can be seen here depending on what tools are installed and registered in the e 2 studio environment. The project type will determine the toolchain and tabs that CDT (C/C++ Development Tooling) uses. A short summary of Project types are: Executable (Renesas): Create a Renesas project template which includes IO register, startup file, and basic project setup files. Debug- Only Project: Mainly used when Third party tools are used. Makefile project: Creates an empty project. This selection is useful for importing and modifying existing make-file based projects. Step 2.5 Make the following selection in the window and click Next> button: Toolchain Version v12.01. Debug Hardware E1 (RL78) Select Target R5F104PJ Select Configurations from List Below Use Default setting (Check mark on Hardware debug and Release (no debug)) If there are many version of the same tools chain installed in the PC, e 2 studio will show option for all the Toolchain Versions. The default selection is the latest version. Migrating from CubeSuite+ to Eclipse Page 10 of 21

Step 2.6 Select additional CPU option. Leave this window to its default options and Click Next> button. Step 2.7 The next window selects the library. Leave this window to its default options. The Library source selection: Newlib : Complete ISO C library supporting C/C++ code. Optimized: Subset of ISO C library, size-optimised, does not fully support C++ code but sufficient for most of the application. Migrating from CubeSuite+ to Eclipse Page 11 of 21

Step 2.8 Click Finish. The following summary window will open. Click OK to generate the project. Step 2.9 Your project workspace should now look like this: Step 2.10 Now the CubeSuite+ project files will be imported to e 2 studio s project. Right click on the src folder in the Project Explorer window and click Import. Select an import source as General->File system and click Next> button. Migrating from CubeSuite+ to Eclipse Page 12 of 21

Step 2.11 In the next window, From directory" textbox near the top, click the "Browse" button to go to the directory where you generated the CubeSuite+ project: Step 2.12 Select all the *.c and *.h file ONLY from the list. Click Finish button. Migrating from CubeSuite+ to Eclipse Page 13 of 21

Step 2.13 The files will be added in the src folder in the Project Explorer window. The window will look like this: 3 Map IO Register and Intrinsic function This section modifies the IO register, compiler intrinsic functions, and application code to compile on the GNU compiler. Procedural Steps Step 3.1 Open myproject.c file. Rename the main function as main_old() function to avoid the redundant main() function from the CubeSuite+ project. int main_old(void) { // TODO: add application code here } while (1) { } return 0; Migrating from CubeSuite+ to Eclipse Page 14 of 21

Step 3.2 Build the project, Project Build All without making modification. You will see that IO registers used in the CubeSuite+ project files are not recognized by the GNU compiler and generates compile errors. Step 3.3 Open the r_main.c file. Add code line as below to include iodefine.h and iodefine_ext.h files which define the IO register to the line 47, to clear the undeclared registers errors showed in the previous Step 3.2. /* Start user code for include. Do not edit comment generated here */ #include "iodefine.h" #include "iodefine_ext.h" /* End user code. Do not edit comment generated here */ Step 3.4 Open r_cg_cgc.c file and r_cg_cgc_user.c. Add code line as below to include iodefine.h and iodefine_ext.h files to the line no. 46. /* Start user code for include. Do not edit comment generated here */ #include "iodefine.h" #include "iodefine_ext.h" /* End user code. Do not edit comment generated here */ Step 3.5 Open the r_cg_port.c and r_cg_port_user.c file. Add code line as below to include iodefine.h and iodefine_ext.h files to the line 46.. /* Start user code for include. Do not edit comment generated here */ #include "iodefine.h" #include "iodefine_ext.h" /* End user code. Do not edit comment generated here */ Step 3.6 Open the r_systeminit.c. Add code line as below to include iodefine.h and iodefine_ext.h files to the line 48.. Migrating from CubeSuite+ to Eclipse Page 15 of 21

/* Start user code for include. Do not edit comment generated here */ #include "iodefine.h" #include "iodefine_ext.h" /* End user code. Do not edit comment generated here */ Step 3.7 Open the r_cg_timer.c. Add code line as below to include iodefine.h, iodefine_ext.h to the line 46 as below. /* Start user code for include. Do not edit comment generated here */ #include "iodefine.h" #include "iodefine_ext.h" /* End user code. Do not edit comment generated here */ Step 3.8 Open the hardware_setup.c file. Add the below code inside the HardwareSetup() function. void HardwareSetup(void) { hdwinit(); //Add this line } Step 3.9 Go to r_systeminit.c and change the hdwinit() function by changing the EI(); and DI(); to asm("ei"); and asm("di"); respectively. //Cubesuite+ project function void hdwinit(void) { DI(); R_Systeminit(); EI(); } //Change the function as below void hdwinit(void) { asm("di"); R_Systeminit(); asm("ei"); } Migrating from CubeSuite+ to Eclipse Page 16 of 21

4 Map Interrupt Declaration LAB PROCEDURE This section modifies the interrupt definition, interrupt handler function, and application code to compile on the GNU compiler. Procedural Steps Step 4.1 Open the r_cg_timer_user.c. Include iodefine.h, iodefine_ext.h, and interrupt_handlers.h files to the line 46 as below. /* Start user code for include. Do not edit comment generated here */ #include "iodefine.h" #include "iodefine_ext.h" #include "interrupt_handlers.h" /* End user code. Do not edit comment generated here */ Step 4.2 Go to r_cg_timer_user.c and scroll down to the bottom, Line no. 65 and find the function called r_taru0_channel10_interrupt. Comment the interrupt static void r_tau0_channel0_interrupt(void) and pragma vector = INTTM00_vect lines. Add the void INT_TM00 (void) as new interrupt handler function as below. //comment below two line // interrupt static void r_tau0_channel0_interrupt(void) //#pragma vector = INTTM00_vect //Change the function name as below void INT_TM00 (void) { /* Start user code. Do not edit comment generated here */ P4.1++; /* End user code. Do not edit comment generated here */; } Step 4.3 Comment the line no. 70, P4.1++ and add new line of code as P4_bit.no1^=1; as below: void INT_TM00 (void) { /* Start user code. Do not edit comment generated here */ //P4.1++; //comment this line P4_bit.no1^=1; //Add this line of code /* End user code. Do not edit comment generated here */ } CubeSuite+ IO port access structure is different than the GNU compiler. Migrating from CubeSuite+ to Eclipse Page 17 of 21

Step 4.4 Go to interrupt_handler.c and comment the default Timer interrupt handler created by the project template at line 124. //void INT_TM00 (void) { } //comment this line Step 4.5 Step 4.6 Save the project. Build the project, Project Build All. The Console window will show the below output. 5 RUN the Project on the Target board Overview: This section describes how to launch the TK debugger from e 2 studio and run the program on the target board. Procedural Steps Step 5.1 Connect the RDK board to PC via USB cable. Make sure RDK board has DIP switch SW5 setting as below: 1: ON, 2: OFF, 3:ON, 4: ON Migrating from CubeSuite+ to Eclipse Page 18 of 21

Step 5.2 Go to Run Debug Configuration.Click on myproject under Renesas GDB Hardware Debugging. Step 5.3 Click on the Startup tab and put a check mark on the Halt. Migrating from CubeSuite+ to Eclipse Page 19 of 21

Step 5.4 Step 5.5 Click Debug button to start the TK debugger. Click Yes, to confirm the perspective switch from C/C++ to Renesas Debug perspective. Step 5.6 Click Resume button to run the program. First the program will break at main() function. Step 5.7 Go to r_cg_timer_user.c, line 71 (Approx) and put a break in the following line of code. Step 5.8 Click Resume button again to run the program. The program will break at Interval timer interrupt function. Step 5.9 Remove the break point. Step 5.10 Click Resume button to run the program and observe LED15 on the RDK board. Migrating from CubeSuite+ to Eclipse Page 20 of 21

Questions: 2) List the main differences in the CubeSuite+ compiler and GNU compiler? 3) List the similarities in the CubeSuite+ compiler and GNU compiler? LAB PROCEDURE Migrating from CubeSuite+ to Eclipse Page 21 of 21