Epson S5U1C17001C User manual

CMOS 16-BIT SINGLE CHIP MICROCOMPUTER
(C Compiler Package for S1C17 Family)
(Ver. 1.5.0)
S5U1C17001C Manual

NOTICE
No part of this material may be reproduced or duplicated in any form or by any means without the written permission
of Seiko Epson. Seiko Epson reserves the right to make changes to this material without notice. Seiko Epson does not
assume any liability of any kind arising out of any inaccuracies contained in this material or due to its application or
use in any product or circuit and, further, there is no representation that this material is applicable to products requir-
ing high level reliability, such as medical products. Moreover, no license to any intellectual property rights is granted by
implication or otherwise, and there is no representation or warranty that anything made in accordance with this mate-
rial will be free from any patent or copyright infringement of a third party. This material or portions thereof may contain
technology or the subject relating to strategic products under the control of the Foreign Exchange and Foreign Trade
Law of Japan and may require an export license from the Ministry of Economy, Trade and Industry or other approval
from another government agency.
Windows 2000, Windows XP, and Windows Vista are registered trademarks of Microsoft Corporation, U.S.A.
PC/AT and IBM are registered trademarks of International Business Machines Corporation, U.S.A.
All other product names mentioned herein are trademarks and/or registered trademarks of their respective owners.
© SEIKO EPSON CORPORATION 2009, All rights reserved.

S5U1C17001C Manual Revision History
Code No. Page Chapter/Section Description of revision
411086605 −Entire manual Version number changed from 1.4.0 to 1.5.0
−Entire manual Technical term changed
“implementation-dependent” →“implementation-
defined”
2-4 2.2 Installation Method Explanation added
xgcc_filt.exe: Kanji filter (same as egcc.exe)
3-55 3.5 Tutorial 3
(Importing an IDE Project)
Section deleted
•If execution of a build fails after importing a
project using Windows Vista
4-3 4.2.2 Library Functions and
Header Files
Explanation modified
Dummy functions were deleted from the table.
4-3 4.2.2 Library Functions and
Header Files
Explanation modified
Table (functions with prototype declarations only)
was added.
4-3 4.2.2 Library Functions and
Header Files
Technical term changed
“ANSI standard library” →“ANSI library”
4-3 4.2.2 Library Functions and
Header Files
Explanation added
Certain ANSI library functions ... include the
pertinent header file rather than declaring a
prototype before implementing the function.
4-15 4.4 Precautions for Creation of
Sources
Explanation modified
-O3 was added.
4-16 4.4 Precautions for Creation of
Sources
Explanation added
(10) Due to C language specifications, ...
substitution will not proceed correctly.
5-47 5.4.5 Importing an Existing
Project
Section deleted
•If execution of a build fails after importing a
project using Windows Vista
5-112 5.7.3 Setting Compiler Options Explanation modified
[Use Japanese Kanji filter]... (When the
checkbox is unselected, the -mno-sjis-filt
option is specified during compilation.)
5-113 5.7.3 Setting Compiler Options Explanation added
-O3: Optimizes code execution speed.
5-126 to
5-128
5.7.7 Generated Makefile Explanation modified
Example of generated makefile
5-155 5.7.9 Executing a Build Process Section deleted
•If execution of a build fails after importing a
project using Windows Vista
6-1 6.1 Functions Explanation modified
Of bugs detected during the evaluation, ... are
described in ...
6-3 to
6-4
6.3.2 Command-line Options Explanation added
-O3 was added.
6-6 6.3.2 Command-line Options Explanation added
-mno-sjis-filt
6-11 6.4.3 Method of Using Registers Explanation added
•First argument: long; second argument: pointer;
third argument: pointer
6-13 6.4.7 Compiler Implementation
Definition
Section added
6.4.7 Compiler Implementation Definition
6-14 6.5 Filter Function for Shift JIS
Code
Section added
6.5 Filter Function for Shift JIS Code

Code No. Page Chapter/Section Description of revision
411086605 6-16 to
6-18
6.7 Known Issues Section added
6.7 Known Issues
7-6 7.2.3 Floating-point Number
Processing Implementation
Definition
Section added
7.2.3 Floating-point Number Processing
Implementation Definition
7-9 7.3.1 Overview Explanation modified
Certain ANSI library functions ... See the table
in Section 4.2.2, “Library Functions and Header
Files” for a discussion of ANSI library functions
with prototype declarations only.
7-9 to
7-12
7.3.2 ANSI Library Function List Explanation modified
Explanation of dummy functions and descriptions
pertaining to dummy functions have been
deleted.
7-15 7.3.3 Declaring and Initializing
Global Variables
Explanation modified
Descriptions pertaining to dummy functions have
been deleted.
10-26 10.4.5 [Memory] Window Explanation modified
Memory Preferences dialog box
10-26 10.4.5 [Memory] Window Explanation added
Default Start Dump Address
10-63 10.7.1 List of Commands “Table 10.7.1.1 List of commands” revised
10-112 10.7.8 Break Setup Commands Section added
commands (setting a command to execute after
a break)
11-3 11.1.4 Makefiles Explanation modified
Example of generated makefile
11-55 11.11.5.1 Menus Explanation modified
About LcdUtil message box
11-64 11.11.8 Warning Messages and
Error Messages
“Table 11.11.8.1 List of warning messages” revised
QR-13 Quick Reference Explanation modified
-O3 was added.
QR-13 Quick Reference Explanation added
-mno-sjis-filt
QR-22 Quick Reference Explanation added
commands
QR-27 Quick Reference Explanation modified
Explanation of dummy functions and descriptions
pertaining to dummy functions have been
deleted.

S5U1C17001C Manual
General
Install
SoftDev
SrcFiles
IDE
Compiler
Library
Assemblr
Linker
Debugger
Tools
Reference
1 General
2 Installation
3 Software Development Procedures
4 Source Files
5 GNU17 IDE
6 C Compiler
7 Library
8 Assembler
9 Linker
10 Debugger
11 Other Tools
Quick Reference

INTRODUCTION
S5U1C17001C MANUAL EPSON i
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
Introduction
This document describes the development procedure from compiling C source files to debugging and creating
the mask data which is finally submitted to Seiko Epson. It also explains how to use each development tool of the
S1C17 Family C Compiler Package common to all the models of the S1C17 Family.
How To Read the Manual
This manual was edited particularly for those who are engaged in program development. Therefore, it assumes that
the reader already possesses the following fundamental knowledge:
•Knowledge about C language (based on ANSI C) and C source creation methods
•Knowledge about the gnu C, binutils, gnu make and the linker script for the gnu linker (ld)
•Basic knowledge about assembler language
•Basic knowledge about the general concept of program development by a C compiler and an assembler
•Basic operating methods for Windows 2000 or Windows XP.
Please refer to manuals or general documents which describe ANSI C, gnu tools and Windows‚ for the above con-
tents.
Before installation
See Chapter 1. Chapter 1 describes the composition of this package, and provides a general outline of each tool.
Installation
Install the tools following the installation procedure described in Chapter 2.
To understand the flow of program development and the operating procedure
See the Tutorial described in Chapter 3. This will give you an overview of program development using the C
compiler to the debugger and how to make the mask data.
For coding
See the necessary parts in Chapter 4. Chapter 4 describes notes on creating source files and the grammar for the
assembler language. Also refer to the following manuals when coding:
S1C17xxx Technical Manual
Covers device specifications, and the operation and control method of the peripheral circuits.
S1C17 Core Manual
Has the instructions and details the functions and operation of the Core CPU.
For debugging
Chapter 10 explains details of the debugger. Sections 10.1 to 10.6 give an overview of the functions of the de-
bugger. See Section 10.7 for details of the debug commands. Also refer to the following manuals to understand
operations of the debugging tools:
S1C17 Family In-Circuit Debugger Manual
Explains the functions and handling methods of the ICD Mini (S5U1C17001H).
For details of each tool
Refer to Chapters 5 to 11 and gnu tool manuals for details.

INTRODUCTION
ii EPSON S5U1C17001C MANUAL
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
Manual Notations
This manual was prepared by following the notation rules detailed below:
Samples
The sample screens provided in the manual are all examples of displays under Windows 2000/XP. These dis-
plays may vary according to the system or fonts used.
Names of each part
The names or designations of the windows, menus and menu commands, buttons, dialog boxes, and keys are
annotated in brackets [ ]. Examples: [Command] window, [File] menu, [Stop] button, [q] key, etc.
Names of instructions and commands
The CPU instructions and the debugger commands that can be written in either uppercase or lowercase charac-
ters are annotated in lowercase characters in this manual, except for user-specified symbols. A fixed-width
font is used to describe these words.
Notation of numeric values
Numeric values are described as follows:
Decimal numbers: Not accompanied by any prefix or suffix (e.g., 123, 1000).
Hexadecimal numbers: Accompanied by the prefix "0x" (e.g., 0x0110, 0xffff).
Binary numbers: Accompanied by the prefix "0b" (e.g., 0b0001, 0b10).
However, please note that some sample displays may indicate hexadecimal or binary numbers not accompanied
by any symbol.
Mouse operations
To click: The operation of pressing the left mouse button once, with the cursor (pointer) placed in the
intended location, is expressed as "to click". The clicking operation of the right mouse button
is expressed as "to right-click".
To double-click: Operations of pressing the left mouse button twice in a row, with the cursor (pointer) placed
in the intended location, are all expressed as "to double-click".
To drag: The operation of clicking on a file (icon) with the left mouse button and holding it down
while moving the icon to another location on the screen is expressed as "to drag".
To select: The operation of selecting a menu command by clicking is expressed as "to select".
Key operations
The operation of pressing a specific key is expressed as "to enter a key" or "to press a key".
A combination of keys using "+", such as [Ctrl]+[C] keys, denotes the operation of pressing the [C] key while
the [Ctrl] key is held down. Sample entries through the keyboard are not indicated in [ ].
In this manual, all the operations that can be executed with the mouse are described only as mouse operations.
For operating procedures executed through the keyboard, refer to the Windows manual or help screens.
General forms of commands, startup options, and messages
Items given in [ ] are those to be selected by the user, and they will work without any key entry involved.
An annotation enclosed in < > indicates that a specific name should be placed here. For example, <filename>
needs to be replaced with an actual file name.
Development tool name
ICD: Indicates the ICD Mini (S5U1C17001H) or the ICD board.

CONTENTS
S5U1C17001C MANUAL EPSON iii
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
– Contents –
1 General ..........................................................................................................................1-1
1.1 Features ...........................................................................................................................1-1
1.2 Outline of Software Tools .................................................................................................1-2
2 Installation.....................................................................................................................2-1
2.1 Working Environment .......................................................................................................2-1
2.2 Installation Method ...........................................................................................................2-2
3 Software Development Procedures ............................................................................3-1
3.1 Software Development Flow.............................................................................................3-1
3.2 Software Development Using the IDE..............................................................................3-4
3.3 Tutorial 1 (Basic Operations, from Project Creation to ROM mask Data).........................3-8
3.3.1 Starting the IDE .................................................................................................3-8
3.3.2 Creating a Project .............................................................................................3-10
3.3.3 Creating, Adding, and Editing a Source File.....................................................3-14
3.3.4 Editing the Build Options and the Linker Script.................................................3-20
3.3.5 Building a Program ...........................................................................................3-28
3.3.6 Debugging a Program.......................................................................................3-29
3.3.7 Creating ROM Data ..........................................................................................3-43
3.4 Tutorial 2 (Using the User Makefiles) ..............................................................................3-45
3.4.1 Creating a Project .............................................................................................3-45
3.4.2 Importing Source Files......................................................................................3-47
3.4.3 Disabling the GNU17 File Builder .....................................................................3-49
3.4.4 Setting and Correcting the Makefile..................................................................3-50
3.4.5 Building a Project..............................................................................................3-51
3.4.6 Starting the Debugger.......................................................................................3-51
3.5 Tutorial 3 (Importing an IDE Project) ...............................................................................3-53
3.6 Tutorial 4 (How to Use ES-Sim17) ..................................................................................3-56
3.6.1 Settings Required for Launching ES-Sim17 .....................................................3-56
3.6.2 How to Launch ES-Sim17 in the Existing Project .............................................3-59
3.7 Debugging Environment..................................................................................................3-66
3.8 Sections and Linkage......................................................................................................3-67
4 Source Files ..................................................................................................................4-1
4.1 File Format and File Name...............................................................................................4-1
4.2 Grammar of C Source ......................................................................................................4-2
4.2.1 Data Type...........................................................................................................4-2
4.2.2 Library Functions and Header Files...................................................................4-3
4.2.3 In-line Assemble ................................................................................................4-4
4.2.4 Prototype Declarations.......................................................................................4-4
4.3 Grammar of Assembly Source .........................................................................................4-5
4.3.1 Statements.........................................................................................................4-5
4.3.2 Notations of Operands.......................................................................................4-9
4.3.3 Extended Instructions .......................................................................................4-11
4.3.4 Preprocessor Directives....................................................................................4-12
4.4 Precautions for Creation of Sources ...............................................................................4-13
5 GNU17 IDE.....................................................................................................................5-1
5.1 Overview ..........................................................................................................................5-1
5.1.1 Features.............................................................................................................5-1
5.1.2 Some Notes on Use of the IDE..........................................................................5-1
5.2 Starting and Quitting the IDE ...........................................................................................5-2
5.2.1 Starting the IDE .................................................................................................5-2

CONTENTS
iv EPSON S5U1C17001C MANUAL
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
5.2.2 Quitting the IDE .................................................................................................5-3
5.3 IDE Window......................................................................................................................5-4
5.3.1 Menu Bar ...........................................................................................................5-5
5.3.2 Window Toolbar.................................................................................................5-13
5.3.3 Editor Area........................................................................................................5-14
5.3.4 [C/C++ Projects] View.......................................................................................5-17
5.3.5 [Navigator] View ................................................................................................5-20
5.3.6 [Outline] View....................................................................................................5-23
5.3.7 [Console] View ..................................................................................................5-25
5.3.8 [Problems] View ................................................................................................5-26
5.3.9 [Properties] View...............................................................................................5-27
5.3.10 [Make Targets] View ........................................................................................5-28
5.3.11 [Search] View..................................................................................................5-29
5.3.12 [Bookmarks] View ...........................................................................................5-32
5.3.13 [Tasks] View ....................................................................................................5-33
5.3.14 View Manipulation...........................................................................................5-35
5.3.15 Perspectives....................................................................................................5-38
5.4 Projects ...........................................................................................................................5-39
5.4.1 What Is a Project?.............................................................................................5-39
5.4.2 Creating a New Project.....................................................................................5-39
5.4.3 Opening and Closing a Project .........................................................................5-42
5.4.4 Switching Workspaces......................................................................................5-43
5.4.5 Importing an Existing Project ............................................................................5-44
5.4.6 Deleting a Project .............................................................................................5-48
5.4.7 Changing the Project Name..............................................................................5-49
5.4.8 Resource Manipulation in a Project ..................................................................5-50
5.4.9 File Filter ...........................................................................................................5-68
5.4.10 Working Set ....................................................................................................5-69
5.4.11 Project Properties ...........................................................................................5-73
5.5 The Editor and Editing Source Files................................................................................5-75
5.5.1 Starting the Editor .............................................................................................5-75
5.5.2 Basic Editing Facilities ......................................................................................5-77
5.5.3 Editing Functions for C Source Files.................................................................5-78
5.5.4 [Outline] View....................................................................................................5-85
5.5.5 Navigation History.............................................................................................5-86
5.5.6 Bookmarks........................................................................................................5-87
5.5.7 Tasks.................................................................................................................5-92
5.5.8 Customizing the Editor......................................................................................5-98
5.5.9 Using an External Editor ..................................................................................5-100
5.6 Search............................................................................................................................5-102
5.6.1 Text Search ......................................................................................................5-102
5.6.2 File Search.......................................................................................................5-102
5.6.3 C Search..........................................................................................................5-104
5.6.4 C Search from Context Menu ..........................................................................5-105
5.6.5 Canceling a Search .........................................................................................5-105
5.6.6 Search Results ................................................................................................5-106
5.7 Building a Program.........................................................................................................5-108
5.7.1 Setting the Memory Model...............................................................................5-108
5.7.2 Setting the Build Goal ......................................................................................5-110
5.7.3 Setting Compiler Options.................................................................................5-111
5.7.4 Setting Assembler Options ..............................................................................5-118
5.7.5 Setting Linker Options......................................................................................5-120
5.7.6 Setting the Vector Checker..............................................................................5-124
5.7.7 Generated Makefile..........................................................................................5-126
5.7.8 Editing a Linker Script......................................................................................5-130
5.7.9 Executing a Build Process ...............................................................................5-154