Renesas Starter Kit for R8C/38C Tutorial Manual
Contents
1. position of the PC E a The code will stop in the interrupt routine It is now possible to step through the interrupt function e Remove the breakpoint in the interrupt by double clicking again before exiting the function e Press Go to run the code from the current I it t position of the PC E a 12 rate by adjusting the potentiometer on the board Click Halt icon available on Debug toolbar The code will now run to the infinite loop at the end of main function The user LEDs should now be flashing You can modify the flashing Press CTRL B to open the breakpoint window e Select Remove All Breakpoints Press lt OK gt Open the file main c Insert a breakpoint at Statics_Test function flash to RAM The Statics_Test is used to demonstrate that the initialisation routine has successfully copied all the initialised variables from storage in e Press lt Reset Go gt on the Debug Toolbar The code will stop at the breakpoint Press a button to bypass the flashing LED test el or Press lt Step In gt on the Debug Toolbar FP It is possible to monitor variables while debugging the code To set up a watch on a variable place the mouse over the variable If the variable is available in the current context a tool tip will be displayed with the current value of the variable Watch Hover the mouse over the ucStr variable to see the tooltip value Then2. The project generator wizard will display a confirmation dialog Press OK to create the project and insert the necessary files A tree showing all the files in this project will appear in HEW e To view the file main c double click on the file in the Workspace window A new window will open showing the code 4 3 Build Configurations and Debug Sessions The workspace that has been created contains two build configurations and two debug sessions The build configuration allows the same project to be built but with different compiler options The options available to the user are described fully in the HEW User s Manual 4 3 1 Build Configuration The build configurations are selected from the left hand drop down list on the toolbar The options available are Debug and Release The Debug build is configured for use with the debugger The Release build is configured for final ROM able code A common difference between the two builds may be the optimization settings With the optimization turned on the debugger may seem to execute code in an unexpected order To assist in debugging it is often helpful to turn off optimization on the code being debugged SessionRBC E8a SYST e Select the Debug build Configuration 4 3 2 Debug Session The Debug sessions are selected from the right hand drop down list on the toolbar The options vary between RSK however one will always start Debug and in
3. Step In on the Debug Toolbar PF P The code window will open main c and show the new position of the program counter su FUNO COMMENT A tee eee eee NK o o ee e S e e i i o CC e e e e S C CR E E s c S e Outline main Description Hain program This function calls timer ADO LCD initialisation functions The weer LEDs flashes until the user presses a switch on the RSE Argument none Return value none Kk FINC COMMENT END FF ASAE AREA AREER ERE EEA AE REAR EERE KOKOKOKOKOKOK OK ERAS oid mainivoid DOS EO 1 Reset the LCD module 5 0gs Ba Display Renesas Splash Screen 055B4 Displaystring LCD LINEI Eenesas j 08504 DisplayString LCD LINE2 NICKNAME f4 Flash the user LEDs for some time or until a push button is pressed O85D5 FlashLEDs fo Flash the user LEDS at a rate set by the user potentiometer LDC using interrupts O85D9 TimerADCi Demonstration of initialised variables Use this function with the debugger ny DASD statics Testi This function must not exit DSSEO whileilil OS5E4 ee KOK KOKOK KON KOKON KOR KOKOK KON KOKOR KOK KOKOK OKON KOKOR 020 RARA NARRA RARA NARRA KOKON KOK End of function main KORKON KOR KOKOK KON ROKON KOR KOKOK KOK ROKON KOR RARA RARA KOR TATA ROKON KOR KOKOK KON KOKON KOR AAA TATA AAA KOKON a a e Inserta breakpoint on the call to the TimerADC function 11 e Right click on the FlashLEDs
4. Right click on the variable name and select Instant A dialog will open showing the variable and allowing further details to be explored e Press lt Add gt The dialog will close and a new pane will open in the workspace containing the variable It is possible to see that the string has been successfully initialised to STATIC position Set a breakpoint on the call to DisplayString inside the for loop Press Go to run the code from the current PC When the program stops you can see the modified string displayed on the second line of the LCD replacement string Inspection of the watch pane will show that the first character of the variable string has been replaced with the first character of the constant Remove the breakpoint e Right click on the DisplayString function call after the loop and select Go to cursor 13 This shows that the variable was initialised at program start up and can be overwritten with TESTTEST You have now run the tutorial code and used many of the common features of the debugger We suggest that you review the rest of the tutorial code as many functions have important information on the operation of the code the compiler directives and comments on when they should or must be used Please refer to Chapter 7 for more information on the project files 14 Chapter 7 Project Files 1 Standard Project Files The RSK tutorials are configured so that it is possible to provide
5. debug monitor within the Debug build and its exclusion in the Release build Contents of common C files are controlled with defines set up in the build configuration options and ifdef statements within the same files Maintaining only one set of project files means that projects are more controllable Chapter 4 Project Workspace 4 1 Introduction HEW is an integrated development tool that allows the user to write compile program and debug a software project on any of the Renesas Microcontrollers HEW will have been installed during the installation of the software support for the RSK product This manual will describe the stages required to create and debug the supplied tutorial code 4 2 Creating a new Project Workspace To look at the program start High performance Embedded Workshop from the Windows Start Menu Open a new tutorial workspace from the File gt New Workspace menu or select Create a new project workspace when presented with the Welcome dialog Mew Project Workspace Projects Workspace Mame Project Types gal En4 RS5KRBC23 ASKASC3BE_ Tutorial a EBA RSKROLAS Project Marne im d cid RSKR BL38L Tutorial WE ESA RSKRBCZD mi Empty Application Directory Z Import Makefile CAwforkSpaceNRSKRBC3BC Tutorial Browse Library ga RSKRBCZF CPU family Ml ASKRBCIGA misc im gal RSERSCL3AC Tool chain Fe Debugger only MTBC EB Renesas M1B5C Standard Fe Debugge
6. none 7 FINC COMMENT ENDS Pee eee h hook A hc koh ch oh hh hock ch ch hc k ch hock ch hock ch hook ch hok A void mainivoidi i Reset the LCD module InitialiseDisplayi l Display Renesas Splash Screen DisplavyStringiLCD LINEI Renesas DisplavStringiLCD LINEZ NICKNAME Flash the user LEDs for some time or until a push button is pressed FlashLEDs i f Flash the user LEDS at a rate set hy the user potentiometer ARDO using interrupts TimerADCi Demonstration of initialised variables Use this function with the debugger statics Testi This function must not exit whilerl Rote ba ik oo eba ka afe o ik oi RAR okok ok kok ak Gk Kk GR ROKON ROK OR ROKON GR KOKON KOKON ROKOKOR KOKON RARA KOKON EAA KOK KOKON ROKOKO ROKON ROKOKO KOK OR ROKON End of function main KOR KOKON Ch A CN ACA A RARA RANA RARA ARA RARA RRA RAR RARA KOKOKOKOKOKN KOKOKOKOKOK ON a KOKON ACC KC RN CR S NC CN KKK 1 Chapter 8 Additional Information For details on how to use High performance Embedded Workshop HEW refer to the HEW manual available on the CD or from the web site Further information available for this product can be found on the Renesas website at http www renesas com renesas starter kits General information on Renesas Microcontrollers can be found at the following website Global http www renesas com Regional English language sites can be accessed from the Global site o
7. s address intbh OxOOU asm lde H topof vector EOFFFFh INTEL Initialize each sections 5 initsct Hir HEAPSIZE 0 Initialize heap heap init fendit if STANDARD IO 0 Initialize standard I O initi fendit Initialize FB register for debugger fh DU Set up the hardware Hardware2etupi l f Call maini routine maini Call exit exiti l i Fai ROKOKO a a a a a a a a ARA a a a a RA RARA NARA NARA NARA NARA NARA NARRAN h ch koh ROKOKO ROK End of function start FHSAA KEARSE SAAS AAS AAAS EASE KOH Ch Ch KOH Ch Ch KOH EERE h ch KCh kh AREER EERE EAE 10 We will now skip over the initialisation code and proceed to the main tutorial e Open the file called resetprg c by double clicking it in the project navigator e Place a breakpoint at the call to main Breakpoints can be set by double clicking in the column containing the PC arrow next to the line to break at or selecting the line and pressing F9 or right click on the line and select Toggle breakpoint Alternatively set an eventpoint by clicking in the column to the left of the breakpoint column Maximum eight eventpoints can be set at a time Eventpoints do not require programming the flash memory and thus are faster to use l The code will execute to the breakpoint At this point all the device initialisation will have been completed e Press Go on the Debug Toolbar e Press
8. the same tutorial code on multiple RSK products This allows the evaluation of the different processor cores using equivalent code To achieve this the following files are common between all device cores and Tool chains Each of the tutorial files has detailed comment text describing the function of each code entry Please refer to the source code for greater detail on the purpose and operation of the compiler specific details 7 1 1 Initialisation code resetprg c resetprg h This is the entry point of the main tutorial code f FINC COMMENT Fee FREER EERE o E C e UE oc o oc RA RARA CE EE Our Line Start Description Power on reset function This function executes following to power on reset IE first calls hardware initialisation function amp then main function Argument none Return value 1 none FUME COMMENT END hok ko koh oh hk ON NR e ON C e RON C e e UN NC A CN ON C e KCN NC e ON ON c RANAS void startivoidi 1 Set interrupt stack pointer isn o amp istack top Change protect mode register prer OxO02U Set processor mode register pro OxOO OU Change protect mode register PECE xu nu Set flag register flg o F value Hif STACKSIZE D Set user stack pointer Sp amp Stack ton fenditf Setting 400H Do not change sh Ox4000 Set variable vector s address intbh x DTU asmi lde fitopof vect
9. REJ10J2129 0100 LE NI ESAS Renesas Starter Kit for R8C 38C Tutorial Manual RENESAS SINGLE CHIP MICROCOMPUTER R8C FAMILY R8C 3X SERIES Rev 1 00 Renesas Electronics Europe Ltd Revision date 01 APR 2010 www renesas com Table of Contents Gare MM dicic e OE mmo o LEER 1 Ghapter 2 lg kelo roii alg t DIL m 2 Ghaptero Tutorial Project WOIKSDSOD lactosa 3 Gnapler4 Pro ect WORKS pa CE usna a E N ci 4 o edu ddl 0 A o a E TAT EAA E A AS 4 4 2 Creating a new Project Workspace sa a E AL A o LS 4 4 3 Build Configurations and Debug SesslONs sssssss ssessssssssssccsssssssssssssscsnnnssnnnsssscsnnsssnnanssssstnntes 5 AB N SUNG OMG UNUM 3 idas 5 43 2 DEbU SESS ION 33530 o a ka oko a a a A SS AS 5 Ghapter 5 Building the Tutorial Projech x2 ooo desee a daa DO rul ka 6 lt GOE RENE REEL 6 9 2 Gonnecung Me GED GCM ass a ra di KLG 6 5 9 Connecting to Ihe target with Tie E 8a ses aca o taa e ect tient da o la raa enda seula n kola sk 7 Chapter 6 Downloading and Running the Tutorial oooocconcccccccoonncnnnnccnononannnonnnnnonononannnnnnnnnononannnnnnnnnnnnnnnnos 9 GNapter io eku TF ee ee ee ee eee ee eee eee TT 15 PA o tandarra Project FIS idilio 15 7 1 1 Initialisation code resetprg c resetprg h ccccccconnccnccccconnonnccnnnnconnnononnnncnonancnnnnnonancnnnnnnnnnrnnnnnnnancnnnns 15 7 1 2 Board initialisation code hwsetup c DWSetup h cccccoonncnncccconncnnncononnnnnnnononnononona
10. clude the type of debug interface The alternate selection will be DefaultSession The purpose of the Debug session is to allow the use of different debugger tools or different debugger settings on the same project Select SessionR8C E8a SYSTEM debug session ac 0 SVST Session Chapter 5 Building the Tutorial Project The tutorial project build settings have been pre configured in the tool chain options To view the tool chain options select the Build Menu item and the relevant tool chain This should be the first option s on the drop down menu The dialog that is displayed will be specific to the tool chain selected The configuration pane on the left hand side will exist on all the EE AI alaj i i P Configurati E i ibrari 4 gt tool chain options It is important when changing any setting to be uw Hes Kart ca io ee Debug Category Source aware of the current configuration that is being modified If you JE CETT Show Entries For Include file directories y i f E C source file 1 Specifies the directory containing the file s specified in Hinclude wish to modify multiple or all build configurations this is possible by H B Assembly source fie YOU can specify up lo 50 drectories Add selecting All or Multiple from the Configuration drop down list e Review the options on each of the tabs and NH Category dropdown lists to be aware of the op
11. ect Power Target from Emulator and choose Do not show this dialog box again the 5 0V option Otherwise connect a 5V centre Emulator Setting positive supply Emulator mode Firmware Location Communication Baud Rate e Choose User Flash Area in Firmware Please select Firmware location Location tab d Enable advanced setting e Choose 500000bps in Communication Baud Rate tab Click OK Cancel Do not show this dialog box again e The flash memory write program is then downloaded to the microcontroller e The Output window in HEW will state Emulator Setting Connected Emulator made Firmware Location Communication Baud Rate Please select communication baud rate between Emulator and MEU Note The connection to the target will activate the debugger buttons on the HEW toolbar Cancel Do not show this dialog box again Now is a good time to save the HEW session e Select File Save Session If you have changed any workspace settings now is a good time to save the workspace e Select File Save Workspace Chapter 6 Downloading and Running the Tutorial Once the code has been built in HEW it needs to be downloaded to the RSK There will now be an additional category in the workspace view for Download Modules 2 Timer amp DC c Text Files RFE Header tsl 3 Download modules FEET e Right click on the download
12. etailed instructions on how to connect the E8a to the host computer The following assumes that the steps in the Quick Start Guide have been followed and the E8a drivers have been installed e Fitthe LCD module to the connector marked LCD on the RSK so that it lies above U3 Ensure all the pins of the connector are correctly inserted in the socket e Connect the E8a debugger to the USB port on your computer e Connect the E8a debugger to the target hardware ensuring that it is plugged into the connector marked E8A on the RSK 5 9 Connecting to the target with the E8a This section will take you through the process of connecting to the device programming the Flash and executing the code e Select the SessionR8C_E8a_SYSTEM debug Emulator Setting session Emulator mode Firmware Location Communication Baud Aate MCU Group RaC 38C Group e Click the Connect button on the debug toolbar Device IREF 1 aoLEC am Mode Erase Flash and Connect t Keep Flash and Connect e Select the correct MCU Group type R8C 38C Group illustrated Debugging of CPU rewrite made la t Program Flash e Select the correct device type R5F2138CC as illustrated odes Iv Power Target from Emulator MA dODm8 OOOO BADO SEIO OCIDOCIOCIDOFIOCIDOLO IDEFIGFIOCIOBOCFOFOFOBOOOEDIOOOGOOOOGOOOOBOGOOGODOOGOGCOGA e Select Erase Flash and Connect e fthe E8a is to provide power to the CPU board sel
13. function and select Toggle Breakpoint Fa Go to cursor Define Column Format Columns Turn Header On OF ko To Cursor Set PC Here Display PC The code will execute to the selected line and stop An automatic breakpoint was inserted in the code and then removed after calling the break m The code will run and flash the LEDs 200 times The debugger will not exit until all 200 flashes have completed or a switch is pressed on the RSK e Press Step Over on the Debug Toolbar e If the LEDs are still flashing press any user switch on the RSK to exit the FlashLEDs function The code will run to the breakpoint we previously set on the TimerADC function The TimerADC function initialises an interrupt on an available internal timer On overflow of the timer module an interrupt is generated In the TimerADC code version the interrupt reads the last ADC conversion for the external potentiometer and uses the result to set the next overflow value The ADC conversion is then re started The interrupt initialisation is completed as part of the hardware setup This is contained in the file interrupts c e Open the file interrupts c by double clicking on the file in the workspace view e Review this file and find the interrupt function that changes the LED pins timer rc e Seta breakpoint on the line where the LED pins are modified e Press Go or F5 to run the code from the TIR l I it
14. module listed and select Download Dependencies EEES E cstartdef h Download Debug Data Only E FlashLEDs h B hwsetup h initact h Download 4 Mew Module interrupts h Remove ISl Icdh On completion the debugger and code are ready to be executed To start debugging we need to reset the debugger and target e Press Reset CPU on the Debug Toolbar Reset CPL The File window should open the Tutorial code at the entry point An arrow marks the current position of the program counter OS680 OOO 006b4 05bB5 OSbBE OSEBE Bizia OS6C6 OS66C a OSETE 05bDz OGGDO OOODA OOGGDE OOOEd OOGES fer UNC COMMENT 5988 UA TTA TTT TATA C I C UU S UU aaa Outline atart Description Power on reset function This function executes following to power on reset IE first calls hardware initialisation w function amp then main function Argument none Return value none 7 FINMC COMMENT END Ct5kkkck ek n eee eee ee eee eee TAA TAT ck KON EAT EEA TRAE EAT EAE EAE TY oid start void mn Set interrupt stack pointer Change protect mode register PECE OxOZO f5 Set processor mode register pmo OxOOU f Change protect mode register PECE OxOOO Set flag register fld Fo value Hif STACKSIZE O f5 Set user stack pointer Sp amp stack top fendit Setting 400H Do not change sh Ox400T Set variable vector
15. ncnnnnnnnnnrnnnnnnnanennnoss 16 Zo MalnTulorlalCOde Mancia said Lois ask an do 17 Shaplere Additional INIOMMIallON 1 seco neler ck ates en a ri abu duse iot duelas do uas la cU seats 18 Chapter 1 Preface Cautions This document may be wholly or partially subject to change without notice All rights reserved Duplication of this document either in whole or part is prohibited without the written permission of Renesas Electronics Europe Limited Trademarks All brand or product names used in this manual are trademarks or registered trademarks of their respective companies or organisations Copyright O 2010 Renesas Electronics Europe Ltd All rights reserved O 2010 Renesas Electronics Corporation All rights reserved O 2010 Renesas Solutions Corporation All rights reserved Website http www eu renesas com Glossary CD Compact Disc MCU Microcontroller Unit CPU Central Processing Unit PC Program Counter E8a E8a On chip debugger module RAM Random Access Memory HEW High performance Embedded Workshop ROM Read Only Memory LCD Liquid Crystal Display RSK Renesas Starter Kit LED Light Emitting Diode USB Universal Serial Bus Chapter 2 Introduction This manual is designed to answer in tutorial form the most common questions asked about using a Renesas Starter Kit RSK The tutorials help explain the following e How dol compile link download and run a simple program on the RSK e How dol build an embedded application e H
16. or sOFFFFh INTEL Initlalize each sections 5 initscti l if HEAPSIZE 0 Initialize heap heap initi Hendif if STANDARD IO D Initialize standard I O init tendif Initialize FB register for debugger ft fb DU Set up the hardware HardwareZzetupril f Call maini routine maini Call exit 5 exitil ORR KOKON KOK KOKON OK KOK CA Ch a A WCNCACh Ch A CN OK OKOKOKOKON KOK OKOKOKOK RK KOKOKOKON KOK OKOKOK KOR KOKOKOK OK KOK KOKON KOK Ch RARA NARRAR End of function start AORChCACKCKCKCh RARA HK h ch h ck CK hh hk ck okok ok h hc kCKCK h hk EERE EEE RARE REAR hh kh ck KCKCh hc h k KCK hoch k ck CK kh hc h kCK KOK a 15 Initialisation of the variables used in the C compilers and initialisation of stack pointers are completed in the INITSCT function for the H8 and SH compilers The call to hardwaresetup will initialise the device hardware and peripherals ready for the tutorial software The call to main will start the main demonstration code 7 1 2 Board initialisation code hwsetup c hwsetup h There are four common stages to the configuration of the microcontroller device The code to demonstrate this is therefore split into four functions Each function is written specifically for the device supported The function calls are shown below eR TNC COMMENT Fee eee eee eee TTT TTT TTT ATTA A UN Cutline Hardwaresetup Description sets
17. ow dol use Renesas tools The project generator will create a tutorial project with two selectable build configurations e Debug is a project built with the debugger support included e Release build demonstrating code suitable for release in a product Files referred to in this manual are installed using the project generator as you work through the tutorials The tutorial examples in this manual assume that installation procedures described in the RSK Quick Start Guide have been completed Please refer to the Quick Start Guide for details of preparing the configuration NOTE These tutorials are designed to show you how to use the RSK and are not intended as a comprehensive introduction to the High performance Embedded Workshop HEW debugger the compiler tool chains or the E8a Emulator please consult the relevant user manuals for more in depth information Chapter 3 Tutorial Project Workspace The workspace includes all of the files for two build configurations The tutorial code is common to both the Debug and the Release build configurations The tutorial is designed to show how code can be written debugged and then downloaded without the debug monitor in a Release situation The build configuration menu in High performance Embedded Workshop HEW allows the project to be configured such that certain files may be excluded from each of the build configurations This allows the inclusion of the
18. r directly by going to Europe http renesas eu America http america renesas com Asia http sg renesas com Renesas Starter Kit for R8C 38C Tutorial Manual Publication Date Rev 1 00 01 APR 2010 Published by Renesas Electronics Europe Ltd Dukes Meadow Millboard Road Bourne End Buckinghamshire SL8 5FH UK 02010 Renesas Electronics Europe and Renesas Solutions Corp All Rights Reserved Renesas Starter Kit for R8C 38C Tutorial Manual LENESAS Renesas Electronics Europe Ltd Dukes Meadow Millboard Road Bourne End Buckinghamshire SL8 5FH UK
19. r only MIEC Sim Fe Debugger only REC EBa Properties The example above shows the New Project Workspace dialog with the RSKR8C38C selected e Select CPU family as M16C and Tool chain as Renesas M16C Standard R8C is supported by the same compiler as M16C e Select the RSKR8C38C Project type from the project list for the RSK e Enter a name for the workspace all your files will be stored under a directory with this name e The project name field will be pre filled to match the workspace name above this name may be changed Note HEW allows you to add multiple projects to a workspace You may add the sample code projects later so you may wish to choose a suitable name for the Tutorial project now e Click OK to start the RSK Project Generator wizard The next dialog presents the example projects available Choose the Tutorial code which will be explained later in this manual There is also an option for Sample code which provides examples for using various peripherals This will open a new dialog allowing the selection of many code examples for the peripheral modules on the device The final option is for an application code build where the debugger is configured but there is no program code This project is suitable for the user to add code without having to configure the debugger e Select Tutorial as the type of project to generate and then click Next e Click Finish to create the project
20. tions available Options C When complete close the dialog box by clicking OK D__UARTO__ c into di S CONFIGDIA Wall silent RBCE E Cancel 5 1 Building Code There are three shortcuts available for building the project 1 Select the Build All toolbar button This will build everything in the project that has not been excluded from the build This includes the standard library 2 Select the Build toolbar button This will build all files that have changed since the last build The standard library will not be built unless an option has been changed 3 Press F7 This is equivalent to pressing the Build button described above Build the project now by pressing F7 or pressing one of the build icons as shown above During the build each stage will be reported in the Output Window The build will complete with an indication of errors and warnings encountered during the build 5 2 Connecting the debugger For this tutorial it is not necessary to provide an external power supply to the board The power will be obtained from the USB port Please be aware that if you have too many devices connected to your USB port it may be shut down by Windows If this happens remove some devices and try again Alternatively an external 5V power source can be connected at PWR connector taking care to ensure the correct polarity and voltage The Quick Start Guide provided with the RSK board gives d
21. up the hardware ii This function calls the hardware initialization functions to Li configure the CPU operating frequency port pins amp required Li on chip modules in order to setup the RSE for the main application Argument gt none Return value none FIMC COMMENT END kk ek hok ok A ok hn ck ch ck hk hh AAA RAR RARA RARA kku ch hok hh hok d o f void Hardwaresetup void i f Configures CPU clock ConfigureoperatindgFredguencyil f Configures port pins ConfigurePortPins Enables required on chip peripherals EnablePeripheralModulesas f Configures interrupts y Configurelnterruptsa l Pia i i ar a a a aa a aa a a a a a a a a a a a a a r a i a a a aa a a a a a a a a a a a E r E EE End of function Hardwaresetup KOROKOKOKKOKOROKOKROKOK a a a a a a a a a a EAA A 16 7 1 3 Main tutorial code main c main h The main tutorial code is common to all tutorial projects The display initialisation and string display functions operate on the LCD display module Check compatibility with ks0066u controller and pin connection on the schematic before connecting a LCD module not supplied by Renesas FIUNO COMMENT UU o TT TATA ROK i OR KOR KKKKRRRRRRR KKK a Outline main Description Hain program This function calls timer ADO amp LCD initialisation functions The user LEDs flashes until the user presses a switch on the ESE Arcpument none Return value
Download Pdf Manuals
Related Search