Summary of the content on the page No. 1
REJ10J1558-0200
Renesas Starter Kit for 38D5
Tutorial Manual (for M3T-ICC740)
RENESAS SINGLE-CHIP 8-BIT CMOS MICROCOMPUTER
740 FAMILY
Rev.2.00 Renesas Solutions Corp.
Revision date: Aug.10,2007 www.renesas.com
Summary of the content on the page No. 2
Table of Contents Chapter 1. Preface..................................................................................................................................................1 Chapter 2. Introduction............................................................................................................................................2 Chapter 3. Tutorial Project Workspace ............................................................................................................
Summary of the content on the page No. 3
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 Solutions Corporation. Trademarks All brand or product names used in this manual are trademarks or registered trademarks of their respective companies or organisations. Copyright © Renesas Solutions Corporation. 2007. All rights reserved. © Renesas Te
Summary of the content on the page No. 4
Chapter 2. Introduction This manual is designed to answer, in tutorial form, the most common questions asked about using the Renesas Starter Kit: The tutorials help explain the following: • How do I compile, link, download, and run a simple program on the Renesas Starter Kit? • How do I build an embedded application? • How do I use Renesas’s development tools? The project generator will create a tutorial project with two selectable build configurations: • ‘Debug’ is a project built with
Summary of the content on the page No. 5
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 then downloaded in a ‘Debug’ situation. The build configuration menu in High-performance Embedded Workshop allows the project to be configured such that certain files may be excluded from each of the build configurations. This allows t
Summary of the content on the page No. 6
Chapter 4. Project Workspace 4.1. Introduction High-performance Embedded Workshop is an integrated development tool that allows the user to write, compile, program and debug a software project on any of the Renesas Microcontrollers. High-performance Embedded Workshop will have been installed during the installation of the software support for the Renesas Starter Kit product. This manual will describe the stages required to create and debug the supplied tutorial code. 4.2. Creating a new
Summary of the content on the page No. 7
The next dialog presents the three types of example project available: 1. Tutorial: This is the one of interest at this time; the code is explained later in this manual. 2. Sample code: this provides examples for using various peripherals. If you select this and click it will open a new dialog allowing the selection of many code examples for the peripheral modules of the device. 3. Application: where the debugger is configured but there is no program code. This project is suitable
Summary of the content on the page No. 8
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 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 tool-chain options. It is important when changing any setting to be aware of
Summary of the content on the page No. 9
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 provide an external power source taking care to ensure the correct polarity and voltage. The Quick Start Guide provided with the Renesas Starter Kit board gi
Summary of the content on the page No. 10
• The Flash Memory write program will be downloaded to the target. • The Output window in High-performance Embedded Workshop will show ‘Connected’ Note: The connection to the target will activate the debugger buttons on the High-performance Embedded Workshop toolbar. Now is a good time to save the High-performance Embedded Workshop session. • Select ‘File’ | ‘Save Session’. If you have changed any workspace settings now is a good time to save the workspace. • Select ‘File’ | ‘S
Summary of the content on the page No. 11
Chapter 6. Downloading and Running the Tutorial Once the code has been built in High-performance Embedded Workshop it needs to be downloaded to the Renesas Starter Kit itself. There will now be an additional category in the workspace view for ‘Download Modules’ • Right click on the download module listed and select ‘Download’. Note: The output display will show “Flash memory write end” to confirm the completion of the download. On completion of the download the debugger is ready for
Summary of the content on the page No. 12
• Place a breakpoint at the call to main(); Breakpoints can only be set when the E8a is connected to the target and the module is downloaded. Breakpoints can be set by double-clicking in the grey 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 double-clicking in the column to the left of the breakpoint column. Up to 2 eventpoints can be set. Eve
Summary of the content on the page No. 13
• Right click on the FlashLEDs(); function and select ‘Go To Cursor’ as illustrated. 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. • Press ‘Step Over’ on the debug toolbar. The code will run and flash the LEDs 200 times. The debugger will not exit until all 200 flashes have completed or a button is pressed on the Renesas Starter Kit. • To stop the LEDs flashing press the SW1 button on t
Summary of the content on the page No. 14
• Press ‘CTRL-B’ to open the breakpoint window. This dialog is not available if user debugged using eventpoints as suggested at top of page 10. ‘CTRL-E’ will open the eventpoint window. Eventpoints can be viewed in Breakcondition tab of event window. • Press . • Press . • Open the file ‘main.c’ • Insert a breakpoint on Statics_Test();. The statics test is used to demonstrate that the initialisation has successfully copied all initialised variables from storage in fla
Summary of the content on the page No. 15
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 ‘. • Set a breakpoint on the call to DisplayString(); inside the for loop. • Press ‘Go’ to run the code from the current PC position. • Press ‘Step Over’ on the debug toolbar. When the program stops you can see the modified string displayed on the second line of the LCD. Inspection of the watch pane will show th
Summary of the content on the page No. 16
Chapter 7. Project Files 7.1. Standard Project Files The Renesas Starter Kit tutorials are configured so that it is possible to provide the same tutorial code on multiple Renesas Starter Kit 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 Toolchains. Each of the tutorial files has detailed comment text describing the function of each code entry. Please refer to the sou
Summary of the content on the page No. 17
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. 15
Summary of the content on the page No. 18
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 an LCD module not supplied by Renesas. 16
Summary of the content on the page No. 19
Chapter 8. Additional Information For details on how to use High-performance Embedded Workshop, refer to the High-performance Embedded Workshop 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 websites. Global: http://www.renesas.com/ Regional (English language) sites can be accesse
Summary of the content on the page No. 20
Renesas Starter Kit for 38D5 Tutorial Manual (for M3T-ICC740) Publication Date Rev.2.00 Aug.10,2007 Published by: Renesas Solutions Corp. 4-1-6, Miyahara, Yodogawa-ku, Osaka City, 532-0003, Japan ©2007 Renesas Solutions Corp., Renesas Technology Europe Ltd. and Renesas Technology Corp., All Rights Reserved.
