Renesas H8S2215R User Manual

To our customers,

Old Company Name in Catalogs and Other Documents

On April 1st, 2010, NEC Electronics Corporation merged with Renesas Technology Corporation, and Renesas Electronics Corporation took over all the business of both companies. Therefore, although the old company name remains in this document, it is a valid Renesas Electronics document. We appreciate your understanding.

Renesas Electronics website: http://www.renesas.com

April 1 Renesas Electronics Corporation

Issued by: Renesas Electronics Corporation (http://www.renesas.com)

, 2010

Send any inquiries to http://www.renesas.com/inquiry

Notice

1. All information included in this document is current as of the date this document is issued. Such information, however, is

subject to change without any prior notice. Before purchasing or using any Renesas Electronics products listed herein, please confirm the latest product information with a Renesas Electronics sales office. Also, please pay regular and careful attention to additional and different information to be disclosed by Renesas Electronics such as that disclosed through our website.

2. Renesas Electronics does not assume any liability for infringement of patents, copyrights, or other intellectual property rights

of third parties by or arising from the use of Renesas Electronics products or technical information described in this document. No license, express, implied or otherwise, is granted hereby under any patents, copyrights or other intellectual property rights of Renesas Electronics or others.

3. You should not alter, modify, copy, or otherwise misappropriate any Renesas Electronics product, whether in whole or in part.

4. Descriptions of circuits, software and other related information in this document are provided only to illustrate the operation of

semiconductor products and application examples. You are fully responsible for the incorporation of these circuits, software, and information in the design of your equipment. Renesas Electronics assumes no responsibility for any losses incurred by you or third parties arising from the use of these circuits, software, or information.

5. When exporting the products or technology described in this document, you should comply with the applicable export control

laws and regulations and follow the procedures required by such laws and regulations. You should not use Renesas Electronics products or the technology described in this document for any purpose relating to military applications or use by the military, including but not limited to the development of weapons of mass destruction. Renesas Electronics products and technology may not be used for or incorporated into any products or systems whose manufacture, use, or sale is prohibited under any applicable domestic or foreign laws or regulations.

6. Renesas Electronics has used reasonable care in preparing the information included in this document, but Renesas Electronics

does not warrant that such informatio n is error free. Renesas Electronics assumes no liability whatsoever for any damages incurred by you resulting from errors in or omissions from the information included herein.

7. Renesas Electronics products are classified according to the following three quality grades: “Standard”, “High Quality”, and

“Specific”. The recommended applications for each Renesas Electronics product depends on the product’s quality grade, as indicated below. You must check the quality grade of each Renesas Electronics product before using it in a particular application. You may not use any Renesas Electronics product for any application categorized as “Specific” without the prior written consent of Renesas Electronics. Further, you may not use any Renesas Electronics product for any application for which it is not intended without the prior written consent of Renesas Electronics. Renesas Electronics shall not be in any way liable for any damages or losses incurred by you or third parties arising from the use of any Renesas Electronics product for an application categorized as “Specific” or for which the product is not intended where you have failed to obtain the prior written consent of Renesas Electronics. The quality grade of each Renesas Electronics product is “Standard” unless otherwise expressly specified in a Ren esas E lectronics data sheets or dat a books, etc.

“Standard”: Computers; office equipment; communications equipment; test and measurement equipment; audio and visual

equipment; home electron ic appliances; machine tools; personal electronic equipment; and industrial robots.

“High Quality”: Transportation equipment (automobiles, trains, ships, etc.); traffic control systems; anti-disaster systems; anti-

crime systems; safety equipment; and medical equipment not specifically designed for life support.

“Specific”: Aircraft; aerospace equipment; submersible repeaters; nuclear reactor control systems; medical equipment or

systems for life support (e.g. artificial life support devices or systems), surgical implantations, or healthcare intervention (e.g. excision, etc.), and any other appl i cations or purposes that pose a d irect threat to human life.

8. You should use the Renesas Electronics products described in this document within the range specified by Renesas Electronics,

especially with respect to the maximum rating, operating supply voltage range, movement power voltage range, heat radiation characteristics, installation and other product characteristics. Renesas Electronics shall have no liability for malfunctions or damages arising out of the use of Renesas Electronics products beyond such specified ranges.

9. Although Renesas Electronics endeavors to improve the quality and reliability of its products, semiconductor products have

specific characteristics such as t he occu rrence o f failure at a certai n rate an d malfunct io ns under cert ain u se con dition s. Further, Renesas Electronics prod ucts are not subject to radiation resistance design. Please be sure to implement safety measures to guard them against the possibility of physical injury, and injury or damage caused by fire in the event of the failure of a Renesas Electronics product, such as safety design for hardware and software including but not limited to redundancy, fire control and malfunction prevention, appropriate treatment for aging degradation or any other appropriate measures. Because the evaluation of microcomputer software alone is very difficult, please evaluate the safety of the final products or system manufactured by you.

10. Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental

compatibility of each Renesas Electronics product. Please use Renesas Electronics products in compliance with all applicable laws and regulations that regulate the inclusion or use of controlled substances, including without limitation, the EU RoHS Directive. Renesas Electronics assumes no liability for damages or losses occurring as a result of your noncompliance with applicable laws and regulations.

11. This document may not be reproduced or duplicated, in any form, in whole or in part, without prior written consent of Renesas

Electronics.

12. Please contact a Renesas Electronics sales office if you have any questions regarding the information contained in this

document or Renesas Electronics products, or if you have any other inquiries.

(Note 1) “Renesas Electronics” as used in this document means Renesas Electronics Corporation an d also includes its majority-

owned subsidiaries.

(Note 2) “Renesas Electronics product(s)” means any product developed or manufactured by or for Renesas Electronics.

User’s Manual

Renesas Starter Kit

RSK H8S2215R Tutorial Manual

RENESAS SINGLE-CHIP MICROCOMPUTER

Rev.1.00 2007.01

Table of Contents

Chapter 1. Preface..................................................................................................................................................3

Chapter 2. Introduction............................................................................................................................................4

Chapter 3. Tutorial Project W orkspace ...................................................................................................................5

Chapter 4. Project Workspace................................................................................................................................6

4.1. Introduction...................................................................................................................................................6

4.2. Creating a new Project Workspace..............................................................................................................6

4.3. Build Configurations and Debug Sessions...................................................................................................7

4.3.1. Build Configuration ................................................................................................................................7

4.3.2. Debug Session.......................................................................................................................................7

Chapter 5. Building the Tutorial Project ..................................................................................................................8

5.1. Building Code...............................................................................................................................................8

5.2. Connecting the debugger.............................................................................................................................9

5.3. Connecting to the target with E8Direct & HMon...........................................................................................9

5.3.1. Connecting To HMon ...........................................................................................................................13

Chapter 6. Downloading and Running the Tutorial...............................................................................................16

Chapter 7. Project Files.........................................................................................................................................21

7.1. Standard Project Files ................................................................................................................................21

7.1.1. Initialisation code (Resetprg.c / resetprg.h).........................................................................................21

7.1.2. Board initialisation code (Hwsetup.c / hwsetup.h)...............................................................................22

7.1.3. Main Tutorial Code (main.c / main.h)...................................................................................................23

Chapter 8. Additional Information..........................................................................................................................24

Chapter 1. Preface

Cautions

This document may be, wholly or partially, subject to change without notice. All rights reserved. No one is permitted to reproduce or duplicate, in any form, a part or this entire document without the written

permission of Renesas Technology Europe Limited.

Trademarks

All brand or product names used in this manual are trademarks or registered trademarks of their respective companies or organisations.

Glossary

ADC Anaglog to Digital Conversion HMON Embedded Monitor RSK Renesas Starter Kit RSO Renesas Solutions Organisation. HEW High performance Embedded Workshop CPU Central Processing Unit IRQ Interrupt ReQuest

http://www.renesas.com/

NMI Non-Maskable Interrupt LED Light Emitting Diode LCD Liquid Crystal Display USB Universal Serial Bus FDT Flash Development Toolkit RTC Real Time Clock

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:

• How do I compile, link, download, and run a simple program on the RSK?

• How do I build an embedded application?

• How do I use Renesas’ tools?

The project generator will create a tutorial project with two selectable build configurations

• ‘Debug’ is a project built with the debugger support included.

• ‘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 exam ples 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 or the compiler tool-chains – 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 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 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 source files.

Maintaining only one set of project files means that projects are more controllable. The HMON monitor code is provided in a pre-compiled library for inclusion in the user code. This library must be included in the tool chain

linker settings. There are some configuration options provided to the user. These are provided in the following files hmonserialconfiguser.c, hmonconfiguser.c, hmonconfiguser.h and hmonserialconfiguser.h. For more detailed information on this please refer to HMon User Manual.

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 software installation for the RSK product.

To begin using the RSK, 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 (i.e. Start Menu > Programs > Renesas > High-performance Embedded Workshop > High-performance Embedded Workshop) or from its icon:

Open a new tutorial workspace from the [File -> New Workspace…] menu or select ‘Create a new project workspace’ when presented with the ‘Welcome!’ dialog.

The example above shows the New Project Workspace dialog with the RSKH8S2215R selected.

• Select the ‘H8S,H8/300’ CPU family and ‘Hitachi H8S,H8/300 Standard’ Tool chain for the RSK

• Select the ‘RSKH8S2215R’ Project type for the RSK from the project list.

• Enter a name for the workspace; all your files will be stored under a directory with this name.

• 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.

• 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 of the device. The final option is for an application 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.

• Select ‘Tutorial’ as the type of project to generate and then click <Next>.

• Click <Finish> to create the project

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 the HEW Workspace window.

• 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 Users Manual.

4.3.1. Build Configuration

The build configurations are selected from the left hand drop down list on the tool bar. 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 optimisation settings. With Optimisation turned on the Debugger may seem to execute code in an unexpected order. To assist in debugging it is often helpful to turn off the optimisation when the code being debugged.

• Select the Debug Build Configuration.

4.3.2. Debug Session

The debug sessions are selected from the right hand drop down list on the tool bar. The options may vary between RSKs however one will always start Debug and include the type of debug interface. The alternate selection will be ‘DefaultSession’. This purpose of the debug session is to allow the use of different debugger targets or different debugger settings on the same project.

• Select the ‘Session_H8S_2215R_HMon’ debug session.

+ 19 hidden pages