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

CONTENTS
S5U1C17001C MANUAL EPSON v
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
5.7.10 Clean and Rebuild .........................................................................................5-156
5.7.11 Using an Original Makefile.............................................................................5-158
5.8 Starting the Debugger....................................................................................................5-160
5.8.1 Generating a Parameter File............................................................................5-160
5.8.2 Setting the Debugger Startup Commands.......................................................5-167
5.8.3 Starting Up the Debugger ................................................................................5-170
5.9 Customizing the IDE (Preferences)................................................................................5-172
5.10 Additional Description on Dialog Boxes .......................................................................5-203
5.10.1 Properties for Project .....................................................................................5-203
5.10.2 Save Resources.............................................................................................5-235
5.10.3 Import > File system ......................................................................................5-236
5.10.4 Export > File system ......................................................................................5-238
5.10.5 Filters .............................................................................................................5-240
5.11 Files Generated in a Project by the IDE.......................................................................5-242
6 C Compiler ....................................................................................................................6-1
6.1 Functions..........................................................................................................................6-1
6.2 Input/Output Files.............................................................................................................6-1
6.2.1 Input File ............................................................................................................6-1
6.2.2 Output Files .......................................................................................................6-1
6.3 Starting Method................................................................................................................6-2
6.3.1 Startup Format...................................................................................................6-2
6.3.2 Command-line Options ......................................................................................6-2
6.4 Compiler Output ...............................................................................................................6-8
6.4.1 Output Contents ................................................................................................6-8
6.4.2 Data Representation..........................................................................................6-9
6.4.3 Method of Using Registers ...............................................................................6-11
6.4.4 Function Call.....................................................................................................6-12
6.4.5 Stack Frame......................................................................................................6-12
6.4.6 Grammar of C Source.......................................................................................6-13
6.4.7 Compiler Implementation Definition..................................................................6-13
6.5 Filter Function for Shift JIS Code ....................................................................................6-14
6.6 Functions of xgcc and Usage Precautions .....................................................................6-15
6.7 Known Issues..................................................................................................................6-16
7 Library ...........................................................................................................................7-1
7.1 Library Overview ..............................................................................................................7-1
7.1.1 Library Files .......................................................................................................7-1
7.1.2 Precautions to Be Taken When Adding a Library...............................................7-2
7.2 Emulation Library .............................................................................................................7-3
7.2.1 Overview............................................................................................................7-3
7.2.2 Floating-point Calculation Functions..................................................................7-4
7.2.3 Floating-point Number Processing Implementation Definition...........................7-6
7.2.4 Integral Calculation Functions............................................................................7-7
7.2.5 long long Type Calculation Functions............................................................7-7
7.2.6 Compatibility with Coprocessor Instructions ......................................................7-8
7.3 ANSI Library.....................................................................................................................7-9
7.3.1 Overview............................................................................................................7-9
7.3.2 ANSI Library Function List .................................................................................7-9
7.3.3 Declaring and Initializing Global Variables .......................................................7-15
7.3.4 Lower-level Functions .......................................................................................7-16
8 Assembler .....................................................................................................................8-1
8.1 Functions..........................................................................................................................8-1
8.2 Input/Output Files.............................................................................................................8-1
8.2.1 Input Files ..........................................................................................................8-1

CONTENTS
vi EPSON S5U1C17001C MANUAL
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
8.2.2 Output File .........................................................................................................8-2
8.3 Starting Method................................................................................................................8-3
8.3.1 Startup Format...................................................................................................8-3
8.3.2 Command-line Options ......................................................................................8-3
8.4 Scope ...............................................................................................................................8-4
8.5 Assembler Directives........................................................................................................8-5
8.5.1 Text Section Defining Directive (.text) ............................................................8-5
8.5.2 Data Section Defining Directives (.rodata, .data) ........................................8-6
8.5.3 Bss Section Defining Directive (.bss)...............................................................8-7
8.5.4 Data Defining Directives (.long, .short, .byte, .ascii, .space).............8-8
8.5.5 Area Securing Directive (.zero).......................................................................8-9
8.5.6 Alignment Directive (.align)...........................................................................8-10
8.5.7 Global Declaring Directive (.global)..............................................................8-11
8.5.8 Symbol Defining Directive (.set).....................................................................8-12
8.6 Extended Instructions......................................................................................................8-13
8.6.1 Arithmetic Operation Instructions......................................................................8-13
8.6.2 Comparison Instructions ...................................................................................8-15
8.6.3 Logic Operation Instructions .............................................................................8-16
8.6.4 Data Transfer Instructions (between Stack and Register) .................................8-17
8.6.5 Data Transfer Instructions (between Memory and Register).............................8-18
8.6.6 Immediate Data Load Instructions ....................................................................8-19
8.6.7 Branch Instructions ...........................................................................................8-21
8.6.8 Coprocessor Instructions ..................................................................................8-24
8.6.9 Xext Instructions ...............................................................................................8-25
8.7 Optimization of Extended Instructions.............................................................................8-26
8.8 Error/Warning Messages ................................................................................................8-30
8.9 Precautions .....................................................................................................................8-31
9 Linker.............................................................................................................................9-1
9.1 Functions..........................................................................................................................9-1
9.2 Input/Output Files.............................................................................................................9-1
9.2.1 Input Files ..........................................................................................................9-1
9.2.2 Output Files .......................................................................................................9-2
9.3 Starting Method................................................................................................................9-2
9.3.1 Startup Format...................................................................................................9-2
9.3.2 Command-line Options ......................................................................................9-2
9.4 Linkage.............................................................................................................................9-3
9.4.1 Default Linker Script...........................................................................................9-3
9.4.2 Examples of Linkage .........................................................................................9-4
9.5 Error Messages................................................................................................................9-6
9.6 Precautions ......................................................................................................................9-7
10 Debugger....................................................................................................................10-1
10.1 Features ........................................................................................................................10-1
10.2 Input/Output Files..........................................................................................................10-1
10.2.1 Input Files .......................................................................................................10-1
10.2.2 Output Files ....................................................................................................10-3
10.3 Starting the Debugger...................................................................................................10-5
10.3.1 Startup Format ...............................................................................................10-5
10.3.2 Startup Options...............................................................................................10-5
10.3.3 Quitting the Debugger.....................................................................................10-6
10.4 Windows........................................................................................................................10-7
10.4.1 Basic Window Configuration ...........................................................................10-7
10.4.2 [Source] Window.............................................................................................10-8
10.4.3 [Console] Window ..........................................................................................10-20
10.4.4 [Registers] Window ........................................................................................10-21

CONTENTS
S5U1C17001C MANUAL EPSON vii
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
10.4.5 [Memory] Window ..........................................................................................10-24
10.4.6 [Breakpoints] Window ....................................................................................10-27
10.4.7 [Watch Expressions] Window.........................................................................10-29
10.4.8 [Local Variables] Window ...............................................................................10-32
10.4.9 [Simulated I/O] Window..................................................................................10-34
10.4.10 [Trace] Window.............................................................................................10-35
10.5 Method of Executing Commands .................................................................................10-36
10.5.1 Entering Commands From the Keyboard.......................................................10-36
10.5.2 Parameter Input Format.................................................................................10-37
10.5.3 Using Menus and Toolbar To Execute Commands .......................................10-38
10.5.4 Using a Command File To Execute Commands ...........................................10-40
10.5.5 Log Files ........................................................................................................10-41
10.6 Debugging Functions ...................................................................................................10-42
10.6.1 Connect Modes..............................................................................................10-42
10.6.2 Loading a File ................................................................................................10-43
10.6.3 Source-Level Debugging Function.................................................................10-44
10.6.4 Manipulating Memory, Variables, and Registers............................................10-45
10.6.5 Executing the Program ..................................................................................10-48
10.6.6 Break Functions.............................................................................................10-52
10.6.7 Trace Functions..............................................................................................10-56
10.6.8 Simulated I/O .................................................................................................10-57
10.6.9 Flash Memory Operation ...............................................................................10-59
10.6.10 Support for Big Endian.................................................................................10-62
10.7 Command Reference ...................................................................................................10-63
10.7.1 List of Commands..........................................................................................10-63
10.7.2 Detailed Description of Commands ...............................................................10-64
Command name (operation of command)[Supported modes] ................10-64
10.7.3 Memory Manipulation Commands .................................................................10-65
c17 fb (fill area, in bytes) .........................................................................10-65
c17 fh (fill area, in 16 bits) .......................................................................10-65
c17 fw (fill area, in 32 bits)[ICD Mini / SIM] .............................................10-65
x(memory dump)[ICD Mini / SIM] ...........................................................10-67
set { } (data input)[ICD Mini / SIM]..........................................................10-69
c17 mvb (copy area, in bytes) .................................................................10-70
c17 mvh (copy area, in 16 bits)...............................................................10-70
c17 mvw (copy area, in 32 bits)[ICD Mini / SIM] .....................................10-70
c17 df (save memory contents)[ICD Mini / SIM].....................................10-72
c17 readmd (memory read mode)[ICD Mini] .........................................10-74
10.7.4 Register Manipulation Commands.................................................................10-75
info reg (display register)[ICD Mini / SIM] ..............................................10-75
set $ (modify register)[ICD Mini / SIM]....................................................10-76
10.7.5 Program Execution Commands .....................................................................10-77
continue (execute continuously)[ICD Mini / SIM]....................................10-77
until (execute continuously with temporary break) [ICD Mini / SIM]........10-79
step (single-step, every line).....................................................................10-81
stepi (single-step, every mnemonic)[ICD Mini / SIM] ...............................10-81
next (single-step with skip, every line)......................................................10-83
nexti (single-step with skip, every mnemonic)[ICD Mini / SIM].................10-83
finish (finish function)[ICD Mini / SIM].....................................................10-85
c17 callmd (set user function call mode)[ICD Mini / SIM] ......................10-86
c17 call (call user function)[ICD Mini / SIM] ...........................................10-87
10.7.6 CPU Reset Commands..................................................................................10-89
c17 rst (reset)[ICD Mini / SIM]................................................................10-89
c17 rstt (reset target)[ICD Mini]..............................................................10-90
10.7.7 Interrupt Commands ......................................................................................10-91
c17 int (interrupt)[SIM] ...........................................................................10-91
c17 intclear (clear interrupt)[SIM] ..........................................................10-92

CONTENTS
viii EPSON S5U1C17001C MANUAL
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
c17 int_load (load interrupt event file)[SIM] ...........................................10-93
10.7.8 Break Setup Commands................................................................................10-94
break(set software PC break)...................................................................10-94
tbreak(set temporary software PC break)[ICD Mini / SIM].......................10-94
hbreak(set hardware PC break)...............................................................10-97
thbreak(set temporary hardware PC break)[ICD Mini / SIM] ...................10-97
delete (clear break by break number)[ICD Mini / SIM] ...........................10-100
clear (clear break by break position)[ICD Mini / SIM] .............................10-102
enable(enable breakpoint).......................................................................10-104
disable(disable breakpoint)[ICD Mini / SIM]............................................10-104
ignore (disable breakpoint with ignore counts)[ICD Mini / SIM] .............10-106
info breakpoints (display breakpoint list)[ICD Mini / SIM] ....................10-107
c17 timebrk (set lapse of time break)[ICD Mini].....................................10-108
c17 hbreakmd (change mouse left-click break setting mode)
[ICD Mini/Sim]...................................................................................................10-109
c17 savebreak (save set breakpoints)[ICD Mini/Sim] .............................10-110
c17 loadbreak (restore saved breakpoints)[ICD Mini/Sim] .....................10-111
commands (setting a command to execute after break)
[ICD Mini/Sim]..........................................................................................10-112
10.7.9 Symbol Information Display Commands.......................................................10-113
info locals(display local symbol)............................................................10-113
info var(display global symbol)[ICD Mini / SIM] .....................................10-113
print (alter symbol value)[ICD Mini / SIM] ..............................................10-114
10.7.10 File Loading Commands.............................................................................10-115
file (load debugging information)[ICD Mini / SIM]...................................10-115
load (load program)[ICD Mini / SIM].......................................................10-116
c17 loadmd (set program load mode)[ICD Mini]...................................10-117
10.7.11 Map Information Commands.......................................................................10-118
c17 rpf (set map information)[SIM]........................................................10-118
c17 map (display map information)[SIM]...............................................10-119
10.7.12 Flash Memory Manipulation Commands ....................................................10-120
c17 fls (set flash memory)[ICD Mini] .....................................................10-120
c17 fle (erase flash memory)[ICD Mini].................................................10-121
10.7.13 Trace Command..........................................................................................10-122
c17 tm (set trace mode)[SIM]................................................................10-122
10.7.14 Simulated I/O Commands...........................................................................10-125
c17 stdin (data input simulation)[ICD Mini / SIM]..................................10-125
c17 stdout (data output simulation)[ICD Mini / SIM] .............................10-126
10.7.15 Flash Writer Commands .............................................................................10-126
c17 fwe (erase program/data)[ICD Mini] ...............................................10-126
c17 fwlp (load program)[ICD Mini] ........................................................10-127
c17 fwld (load data)[ICD Mini]...............................................................10-128
c17 fwdc (copy target memory)[ICD Mini].............................................10-129
c17 fwd (display flash writer information)[ICD Mini] ..............................10-130
10.7.16 Profiler and Coverage Commands..............................................................10-131
c17 profilemd (profile/coverage mode setting)[SIM]...............................10-131
c17 profile (launching of profiler window)[SIM].......................................10-132
c17 coverage (launching of coverage window)[SIM] ..............................10-133
10.7.17 Other Commands .......................................................................................10-134
set output-radix (change of variable display format)[ICD Mini/SIM].......10-134
c17 log (logging)[ICD Mini / SIM] ..........................................................10-135
source (execute command file)[ICD Mini / SIM].....................................10-136
c17 clockmd(set execution counter mode) ............................................10-137
c17 clock(display execution counter)[ICD Mini / SIM]............................10-137
target (connect target)[ICD Mini / SIM]...................................................10-139
detach (disconnect target)[ICD Mini / SIM] ............................................10-140
pwd (display current directory) ................................................................10-141

CONTENTS
S5U1C17001C MANUAL EPSON ix
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
cd (changecurrent directory)[ICD Mini / SIM] ..........................................10-141
c17 firmupdate (update firmware)[ICD Mini] ........................................10-142
c17 ttbr (set TTBR)[SIM] .......................................................................10-143
c17 help (help)[ICD Mini / SIM] .............................................................10-144
c17 savewatch (store symbols registered in Watch Window)
[ICD Mini /Sim]........................................................................................10-146
c17 loadwatch (re-register stored symbols in Watch Window)
[ICD Mini /Sim].........................................................................................10-147
quit (quit debugger)[ICD Mini / SIM].......................................................10-148
10.8 Profiler and Coverage Functions.............................................................................10-149
10.8.1 Overview of Functions ..................................................................................10-149
10.8.2 List of Functions............................................................................................10-150
10.8.3 Detailed Description of Functions .................................................................10-151
10.9 Parameter Files ...........................................................................................................10-159
10.10 Status and Error Messages.......................................................................................10-162
10.10.1 Status Messages ........................................................................................10-162
10.10.2 Error Messages ..........................................................................................10-162
10.11 Embedded System Simulator (ES-Sim17) ................................................................10-164
10.11.1 Input/Output Files .......................................................................................10-165
10.11.2 Starting and Terminating ES-Sim17............................................................10-167
10.11.3 Menus .........................................................................................................10-168
10.11.4 Simulating I/O Ports ....................................................................................10-169
10.11.5 Simulating SVD...........................................................................................10-171
10.11.6 Simulating an LCD Panel............................................................................10-172
10.11.7 ES-Sim17 Error Massages .........................................................................10-173
10.11.8 Restrictions .................................................................................................10-173
11 Other Tools .................................................................................................................11-1
11.1 make.exe .......................................................................................................................11-1
11.1.1 Functional Outline...........................................................................................11-1
11.1.2 Input File ........................................................................................................11-1
11.1.3 Starting Method ..............................................................................................11-2
11.1.4 make Files ......................................................................................................11-3
11.1.5 Macro Definition and Reference ....................................................................11-7
11.1.6 Dependency List .............................................................................................11-8
11.1.7 Suffix Definitions ............................................................................................11-11
11.1.8 clean ..............................................................................................................11-13
11.1.9 Invocation by sh.exe.......................................................................................11-13
11.1.10 Messages ....................................................................................................11-14
11.1.11 Precautions..................................................................................................11-14
11.2 ccap.exe .......................................................................................................................11-15
11.2.1 Function .........................................................................................................11-15
11.2.2 Output File ....................................................................................................11-15
11.2.3 Method for Using ccap...................................................................................11-15
11.2.4 Error Messages .............................................................................................11-16
11.3 objdump.exe .................................................................................................................11-17
11.3.1 Function .........................................................................................................11-17
11.3.2 Input Files .....................................................................................................11-17
11.3.3 Method for Using objdump.............................................................................11-17
11.3.4 Dump Format ................................................................................................11-18
11.3.5 Error Message ...............................................................................................11-21
11.3.6 Precautions....................................................................................................11-21
11.4 objcopy.exe...................................................................................................................11-22
11.4.1 Function .........................................................................................................11-22
11.4.2 Input/Output Files ..........................................................................................11-22
11.4.3 Method for Using objcopy ..............................................................................11-23

CONTENTS
xEPSON S5U1C17001C MANUAL
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
11.4.4 Creating HEX Files ........................................................................................11-24
11.5 ar.exe............................................................................................................................11-25
11.5.1 Function .........................................................................................................11-25
11.5.2 Input/Output Files ..........................................................................................11-25
11.5.3 Method for Using ar .......................................................................................11-26
11.6 moto2ff.exe...................................................................................................................11-28
11.6.1 Function .........................................................................................................11-28
11.6.2 Input/Output Files ..........................................................................................11-28
11.6.3 Startup Format...............................................................................................11-28
11.6.4 Error/Warning Messages ...............................................................................11-29
11.6.5 Creating ROM Area Data ..............................................................................11-29
11.7 sconv32.exe .................................................................................................................11-30
11.7.1 Function .........................................................................................................11-30
11.7.2 Input/Output Files ..........................................................................................11-30
11.7.3 Startup Format...............................................................................................11-30
11.7.4 Error Messages .............................................................................................11-30
11.8 Outline of the Development Tools.................................................................................11-31
11.9 winfog17.exe ................................................................................................................11-32
11.9.1 Outline of winfog17 ........................................................................................11-32
11.9.2 Input/Output Files ..........................................................................................11-32
11.9.3 Starting Up.....................................................................................................11-33
11.9.4 Window ..........................................................................................................11-35
11.9.5 Menus and Toolbar Buttons ...........................................................................11-36
11.9.6 Operation Procedure......................................................................................11-37
11.9.7 Error/Warning Messages ...............................................................................11-40
11.9.8 Sample Output File ........................................................................................11-41
11.10 winmdc17.exe ............................................................................................................11-42
11.10.1 Outline of winmdc17 ....................................................................................11-42
11.10.2 Input/Output Files ........................................................................................11-42
11.10.3 Starting Up...................................................................................................11-44
11.10.4 Menus and Toolbar Buttons .........................................................................11-45
11.10.5 Operation Procedure....................................................................................11-46
11.10.6 Error Messages ...........................................................................................11-49
11.10.7 Sample Output File ......................................................................................11-50
11.11 LcdUtil17 (LCD Panel Customizing Tool) ...................................................................11-51
11.11.1 Overview......................................................................................................11-51
11.11.2 Input/Output Files ........................................................................................11-51
11.11.3 Starting and Closing LcdUtil17 ....................................................................11-52
11.11.4 Window ........................................................................................................11-52
11.11.5 Menus and Toolbar.......................................................................................11-53
11.11.6 Producing an LCD File.................................................................................11-56
11.11.7 Shortcut Key List..........................................................................................11-63
11.11.8 Warning Messages and Error Messages.....................................................11-64
11.12 Stand-Alone Flash Writer ...........................................................................................11-66
11.12.1 Overview......................................................................................................11-66
11.12.2 Procedures for Stand-Alone Flash Write......................................................11-66

1
General
S5U1C17001C Manual
1 General

S5U1C17001C MANUAL EPSON 1-1
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
1 GENERAL
1
General
1 General
1.1 Features
The S1C17 Family C Compiler Package contains software development tools for compiling C source files,
assembling assembly source files, linking object files, debugging executable files, making mask data and other
utilities. The tools are common to all the models of the S1C17 Family.
Its principal features are as follows:
Powerful optimizing function
The C Compiler is designed to suit to the S1C17 architecture, it makes it possible to deliver minimized codes.
The high-optimize ability does not lose most of the debugging information, and it enables C source level
debugging.
Useful extended instructions are provided
The extended instructions allow the programmer to describe assembly source simply without the need of
knowing the data size. The immediate data extension using the "ext" instruction and some useful functions
that need multiple basic instructions are described with an extended instruction.
C and assembly source level debugger with a simulator function
The debugger supports C source level debugging and assembly source level debugging. By using an ICD, the
program can be debugged even when the target board is operating. It also provides a simulator function that
allows debugging on a personal computer without using hardware tools.
Integrated development environment for Windows
Designed to run under Microsoft Windows 2000 Professional, Windows XP, and Windows Vista, the GNU17
IDE is a seamless integrated development environment suitable for a wide range of development tasks, from
source creation to debugging.

1-2 EPSON S5U1C17001C MANUAL
(C COMPILER PACKAGE FOR S1C17 FAMILY) (Ver. 1.5.0)
1 GENERAL
1.2 Outline of Software Tools
The following shows the outlines of the principle tools included in the package.
(1) C Compiler (xgcc.exe)
This tool is made based on GNU C Compiler and is compatible with ANSI C. This tool invokes cpp.exe and
cc1.exe sequentially to compile C source files to the assembly source files for the S1C17 Family. It has a
powerful optimizing ability that can generate minimized assembly codes. The xgcc.exe can also invoke the
as.exe assembler to generate object files.
(2) Assembler (as.exe)
This tool assembles assembly source files output by the C compiler and converts the mnemonics of the
source files into object codes (machine language) of the S1C17 Core. The as.exe allows the user to invoke the
assembler through xgcc.exe, this makes it possible to include preprocessor directives into assembly source files.
The results are output in an object file that can be linked or added to a library.
(3) Linker (ld.exe)
The linker defines the memory locations of object codes created by the C compiler and assembler, and creates
executable object codes. This tool puts together multiple objects and library files into one file.
(4) Debugger (gdb.exe)
This debugger serves to perform source-level debugging by controlling an ICD. It also comes with a simulator
function that allows debugging on a personal computer.
The gdb.exe supports Windows GUI. Commands that are used frequently, such as break and step, are registered
on the tool bar, minimizing the necessary keyboard operations. Moreover, various data can be displayed in
multi windows, with a resultant increased efficiency in the debugging tasks.
(5) Librarian (ar.exe)
This tool is used to edit libraries. The ar.exe can register object modules created by the C compiler and
assembler to libraries, delete object modules in libraries and restore library modules to the original object files.
(6) Make (make.exe)
This tool automatically executes from compile to link according to the command lines described in the make
file. The basic make file can be created by the IDE.
(7) GNU17 IDE (eclipse.exe)
The development workbench provides an integrated development environment for a wide range of development
tasks, from source creation to debugging.
This package contains other gnu tools, sample programs and several utility programs. For details on those
programs, please refer to "readmeVxx.txt" (xx indicates version) on the disk.
Note: Only the command options for each tool described in the respective section are guaranteed to
work. If other options are required, they should only be used at the user's own risk.