e2Studio – Getting Started _LabProcedures

LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 1 of 15 Renesas e 2 RL78 Family Eclipse Labs studio Getting Started Description: e2studio introduction Lab Sections 1 Setup 2 2 Hello World with GDB Simulator 6 3 Working with the RDKRL78G14 8 4 e 2 studio Views 11 5 e 2 studio Project Archives 12 Lab Objectives 1. Project Generator (RL78) 2. Hello World Creation 3. Renesas GDB Simulator 4. The RDK78G14 board and Hardware Debug Skill Level 1. This is so easy anyone can do it Time to Complete Lab 90 Minutes Lab Materials Please verify you have the following materials at your lab station. • Renesas e 2 studio (1.1.0.25 or later) • GNU RL78 12.02 Compiler or later • This Handout • RDKRL78G14 Board and USB Cable LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 2 of 15 1 Setup Overview: Getting Started Procedural Steps Step 1.1 On the RDK, ensure the switch SW5 is set to debug mode (ON, OFF, ON, ON). Step 1.2 Open e 2 studio by using the Shortcut on the Desktop: Step 1.3 When it gives you the option of choosing a Workspace directory, choose: C:\Workspace Step 1.4 Once e 2 studio is open at the Welcome page, click on the Workbench Arrow. LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 3 of 15 Step 1.5 Click File > New and create a new C Project Step 1.6 Give it a name and select the GNURL78 Toolchain Step 1.7 Select the most recent version of GNU Toolchain, choose E1(RL78) for the debugger and choose RL78-G14 and R5F104PJ. Click Next. LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 4 of 15 Step 1.8 Default Additional CPU option. Click Next. Step 1.9 Use the default settings for basic optimization and library options. Click Finish and Ok remaining dialog box(s) LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 5 of 15 Step 1.10 Your Workspace should now look like this LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 6 of 15 2 Hello World with GDB Simulator Overview: Get your blank project to do something useful. Procedural Steps Step 2.1 Your Workspace should now look like this: Expand out lab1 in the Project Explorer and look under the “src” directory for lab1.c – open it by double clicking. Feel free to have a look around at the other files and directories; they were created with the standard project generator. Step 2.2 Launch the New Source File wizard (File > New > Source File) to create a new C source file from the default template, name it incr.c in the src folder and add the following function to your new file: unsigned int incr(unsigned int i) { return i + 1; } Step 2.3 Launch the New Header File wizard (File > New > Header File) to create a new C header file named incr.h in the src folder and add the following function prototype: unsigned int incr(unsigned int i); LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 7 of 15 Step 2.4 Edit the existing project file named lab1.c and replace all the existing code to introduce a local unsigned integer variable, increment it in a loop using incr(): #include "incr.h" int main(void) { unsigned int n = 0; while (1) { n = incr(n); } return 0; } Step 2.5 Build (Project > Build All) Step 2.6 Highlight the Project in the Project Explorer window by clicking on it. Step 2.7 Click Run > Debug As > Renesas GDB Simulator Debug to connect to the Simulator Step 2.8 Agree to the Perspective Switch – this is an important part of how to view screens in Eclipse Step 2.9 If everything went well, you should be able to click the Restart button and then Step through your code watching the local variables in the watch window as they come into scope in each function. Step 2.10 Use the Resume (Not Run!) , Pause Step Into and Restart buttons to get a feel for basic debugging Step 2.11 When you are finished use the Terminate button to end the session. LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 8 of 15 3 Working with the RDKRL78G14 Overview: Work with e 2 studio to modify a project Procedural Steps Step 3.1 Switch back to the C/C++ perspective. (Window > Open Perspective > C/C++) Step 3.2 Right Click lab1 and Close Project. This way it won’t build everytime you “Build All” as Build All builds all open projects in the Workspace. Step 3.3 Create a new C project using the same settings as before, name it anything you like (lab 2 might make sense). Step 3.4 Open the C source file with the main function. Step 3.5 Create a flashing LED with a delay using this code or your own interpretation. #include "iodefine.h" #define LED01 P6_bit.no5 // for use with iodefine.h v1.10 unsigned int i,j = 0; int main(void) { // TODO: add application code here PM6_bit.no5 = 0x00; // make output without using #define while (1) { while(j<200){ do { i++; } while (i<10000); i =0; j++; } LED01 = ~LED01; // toggle LED j=0; i=0; } return 0; } Step 3.6 Build LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 9 of 15 Step 3.7 Click the arrow next to the Bug on the toolbar and select “Debug Configurations” Then click the Debugger Tab and change the setting for Erase Flash ROM when Starting” to YES. – This ensures that any demo code still on the MCU won’t get in the way of connecting to the debugger. Step 3.8 Click Debug and connect to the RDK G14 board. Step 3.9 Once in Debug mode click Restart and use the Resume , Pause buttons as before to check your code is operating correctly. LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 10 of 15 Step 3.10 Modify which LEDs are flashing and their frequency (you choose how): P42 GLED1 (P42) to R88-680 and LED4; Output 1 P43/SCK01/SCL01 GLED2 (P43) to R90-680 and LED6; Output 1 P44/SI01/SDA01 GLED3 (P44) to R92-680 and LED8; Output 1 P45/SO01 GLED4 (P45) to R94-680 and LED10; Output 1 P62/SSI00/SCLA1 RLED1 (P62) to R87-680 and LED3; Output 1 P63/SDAA1 RLED2 (P63) to R89-680 and LED5; Output 1 P64/TI10/TO10 RLED3 (P64) to R91-680 and LED7; Output 1 P65/TI11/TO11 RLED4 (P65) to R93-680 and LED9; Output 1 P66/TI12/TO12 RLED5 (P66) to R95-680 and LED11; Output 1 P67/TI13/TO13 RLED6 (P67) to R97-680 and LED13; Output 1 Step 3.11 Check your code changes using the Renesas GDB Hardware Debug. [...]... e2studio environment 2 e studio Getting Started Lab – RL78 Page 11 of 15 LAB PROCEDURE 5 e2studio Project Archives Overview: How to archive send and import projects Procedural Steps Step 5.1 Switch to the C/C++ perspective and highlight the active project in the Project Explorer window Step 5.2 Right click on the project and select Export Step 5.3 Expand General and choose Archive File 2 e studio Getting. .. convenient under C:\Workspace: 2 2 2 e studio Getting Started Lab – RL78 Page 13 of 15 LAB PROCEDURE Step 5.8 Once it’s open, Right Click in the blank Project Explorer area and choose Import Step 5.9 Important: Choose “Existing Project into Workspace” (not Archive File) and pull in the zip file you created earlier in the lab 2 e studio Getting Started Lab – RL78 Page 14 of 15 LAB PROCEDURE Step 5.10... General and choose Archive File 2 e studio Getting Started Lab – RL78 Page 12 of 15 LAB PROCEDURE Step 5.4 Click Next and create a zip file using the “To archive file” dialog that you can email or store for later use Step 5.5 Click Finish Step 5.6 Close e studio Step 5.7 Reopen e studio, click Browse in the Workspace dialog to create a new workspace folder – this path is relative to my PC, you can choose... – RL78 Page 14 of 15 LAB PROCEDURE Step 5.10 Click Finish Step 5.11 Select E1(RL78) and choose the R5F104PJ device Step 5.12 Check the project operates in correctly Step 5.13 END 2 e studio Getting Started Lab – RL78 Page 15 of 15 ...LAB PROCEDURE 4 e2studio Views Overview: 2 Using e studio to debug Procedural Steps Step 4.1 Using the working application you created in the previous lab, set a breakpoint by doubleclicking in the blue gutter to the . LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 1 of 15 Renesas e 2 RL78 Family Eclipse Labs studio Getting Started Description: e2studio introduction . PROCEDURE e 2 studio Getting Started Lab – RL78 Page 5 of 15 Step 1.10 Your Workspace should now look like this LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 6 of 15 2. • RDKRL78G14 Board and USB Cable LAB PROCEDURE e 2 studio Getting Started Lab – RL78 Page 2 of 15 1 Setup Overview: Getting Started Procedural Steps Step 1.1 On the RDK, ensure the