Epson S5U1C17001C User manual

Rev.1.0
CMOS 16-BIT SINGLE CHIP MICROCONTROLLER
(C Compiler Package for S1C17 Family) (Ver. 3.1)
S5U1C17001C
Manual

Evaluation board/kit and Development tool important notice
1. This evaluation board/kit or development tool is designed for use for engineering evaluation, demonstration,
or development purposes only. Do not use it for other purposes. It is not intended to meet the requirements of
design for finished products.
2. This evaluation board/kit or development tool is intended for use by an electronics engineer and is not a
consumer product. The user should use it properly and in a safe manner. Seiko Epson dose not assume any
responsibility or liability of any kind of damage and/or fire coursed by the use of it. The user should cease to
use it when any abnormal issue occurs even during proper and safe use.
3. The part used for this evaluation board/kit or development tool may be changed without any notice.
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 requiring 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 material will be free from any patent or copyright infringement of a third
party. When exporting the products or technology described in this material, you should comply with the
applicable export control laws and regulations and follow the procedures required by such laws and regulations.
You are requested not to use, to resell, to export and/or to otherwise dispose of the products (and any technical
information furnished, if any) for the development and/or manufacture of weapon of mass destruction or for other
military purposes.
All brands or product names mentioned herein are trademarks and/or registered trademarks of their respective
companies.
©SEIKO EPSON CORPORATION 2015, All rights reserved.

S5U1C17001C Manual Revision History
Code No.
Page
Chapter/Section
Description of revision
411086412
―
Entire manual
Version No. changed from 3.0 to 3.1
―
Entire manual
Description revised
"ICDmini3" changed to "ICDmini"
i
How to Read the Manual
Description revised
"Explains the functions and handling methods of the
ICDmini (S5U1C17001H)."
ii
Manual Notations
Description revised
"ICD: Indicates the ICDmini (S5U1C17001H)."
3-3
3.3.2 Creating a New Project
Description added
Step (5) added
"(If Program Type is Application)"
added after new step
(6)
3-5
3.3.4 Interrupt Vector and Boot
Processing Descriptions
Description revised
"Setting the stack pointer initial value" description
revised
3-6
3.3.5 Importing an Existing Project
Description revised
Details of step (4) revised
Step (6) added
3-7
3.3.6 Importing a GNU17 Version 2
Project
Description revised
Steps (3) and (4) added
Details of new steps (5) and (6) revised
3-8
3.4.1 Setting GNU17 Project Properties
Description added
Following items added to table:
Stack pointer initial value setting
Flash security setting
Flash protection setting
3-9
3.4.2 Setting Environment Variables
Description revised
Following items in table revised:
User library link
Model information
3-10
3.4.2 Setting Environment Variables
Description added
Following items added to table:
Flash security setting
Flash protection setting
Cygwin setting
3-11
3.4.4 Setting Compiler Options
Description revised
"Includes" description revised
[Include paths (-I)] (default: "${GCC17_INC}", ../inc)
3-11
3.4.4 Setting Compiler Options
Description revised
"Optimization" description revised
3-11
3.4.4 Setting Compiler Options
Description added
"Miscellaneous" added
3-12
3.4.5 Setting Linker Options
Description added
"General" added
3-12
3.4.5 Setting Linker Options
Description revised
"Libraries" and "Miscellaneous" descriptions revised
3-13
3.4.6 Setting Assembler Options
Description revised
"Note" and "General" details revised
3-14
3.5.1 Editing a Linker Script
Description revised
Entire description revised

Code No.
Page
Chapter/Section
Description of revision
411086412
3-15
3.5.2 Executing a Build Process
Description revised
Build process description revised
3-17
3.6 Debugging the Program
Description revised
"Starting the Debugger" changed to "Debugging the
Program"
Entire description revised
3-18
3.6.2 Setting Standard Output
Description revised
"Example" description revised
3-19
3.6.3 Using the Debugger
Description revised
"Launching the Debugger" changed to "Using the
Debugger"
Entire description revised
3-20
3.6.4 Setting the Debug Configuration
Description added
New description added
3-21
3.7 Files Generated in a Project by the
IDE
Description revised
Details of "Table 3.7.1 List of files generated by the
IDE" revised
4-4
4.3.2 Command-line Options
Description revised
Option feature descriptions revised
4-5
4.3.2 Command-line Options
Description added
The following option added:
-mrelax
（
gcc4 only
）
4-12
4.4.3 Method of Using Registers
Description revised
"Registers for passing arguments (%r0 to %r3)"
description revised
5-3
5.2.3 Stack Pointer Initial Values
Description revised
Entire description revised
5-4
5.2.4 Startup Processing
Description added
The following added:
The following table gives an overview of the
operations defined. For specific mounting details,
refer to the source code utility/lib_src/crt0/crt0.c
bundled with this package.
7-1
7.1 Functions
Description revised
Revised to the following:
This linker is based on the gnu linker (ld). For details
about the ld linker or method for describing linker
script, refer to the documents for the gnu linker.
7-1
7.2 Input/Output Files
Description revised
"Linker symbol file" added to flowchart
7-2
7.2.1 Input Files
Description added
"Linker symbol file" added
7-3
7.3.2 Command-line Options
Description added
Following options added:
-R <linker symbol file name>
--relax (gcc4 ld only)
8-1
8.1 Features
Description revised
Revised to the following:
In addition to debugging programs using the ICDmini
(S5U1C17001H), the debugger incorporates a
software simulator function for debugging programs
on a personal computer.
8-3
8.3.1 Startup Format
Description revised
"Selecting connect mode" description revised
8-5
8.3.3 Executing Command Files
Description revised
"Loading/executing a command file" execution
methods corrected from two ways to three ways

Code No.
Page
Chapter/Section
Description of revision
411086412
8-10
8.5.1 List of Commands
Description added
The following added to "Other" in the l
ist of commands:
c17 cpu
8-56
8.5.13 Other Commands
Description added
The following added:
c17 cpu (set CPU type)
8-59
8.5.13 Other Commands
Description revised
"Example 1" description revised
8-61
8.5.13 Other Commands
Description revised
"ICD Mini" changed to "ICD Mini / SIM"
8-62
8.5.13 Other Commands
Description revised
"ICD Mini" changed to "ICD Mini / SIM"
8-65
8.7 Peripheral Circuit Simulator
(ES-Sim17)
Description added
New description added
10-13
10.6 gpdata.exe
Description added
New description added
10-14
10.7 ptd.exe
Description added
New description added
10-16
10.8 LCDUtil17 (LCD Panel
Customizing Tool)
Description added
New description added
QR-2
Software Development Flowchart
Description revised
Flowchart diagram revised
QR-3
C Compiler xgcc
Description revised
"Major Command-line Options" table revised
QR-6
Linker ld (1)
Description revised
"Major Command-line Options" table revised
QR-10
Debugger gdb (3)
Description revised
"Debug Commands" table revised

Configuration of product number
●Devices
S1 C 17xxx F 00E1
●Development tools
S5U1 C 17000 Y2 1
00
■Packing specifications
00 : Besides tape & reel
0A : TCP BL 2 directions
0B : Tape & reel BACK
0C : TCP BR 2 directions
0D : TCP BT 2 directions
0E : TCP BD 2 directions
0F : Tape & reel FRONT
0G : TCP BT 4 directions
0H : TCP BD 4 directions
0J : TCP SL 2 directions
0K : TCP SR 2 directions
0L : Tape & reel LEFT
0M : TCP ST 2 directions
0N : TCP SD 2 directions
0P : TCP ST 4 directions
0Q : TCP SD 4 directions
0R : Tape & reel RIGHT
99 : Specs not fixed
■Specification
■Package
D: die form; F: QFP, B: BGA
■Model number
■Model name
C: microcomputer, digital products
■Product classification
S1: semiconductor
00
■Packing specifications
00 : standard packing
■Version
1: Version 1
■Tool type
Hx : ICE
Dx : Evaluation board
Ex : ROM emulation board
Mx : Emulation memory for external ROM
Tx : A socket for mounting
Cx : Compiler package
Sx : Middleware package
Yx : Writer software
■Corresponding model number
17xxx: for S1C17xxx
■Tool classification
C: microcomputer use
■Product classification
S5U1: development tool for semiconductor products

S5U1C17001C Manual
1 General
2
Source Files
3 GNU17
IDE
4 C Compiler
5 Library
6
Assembler
7 Linker
8 Debugger
9
Creating Data to Be Submitted
1
0 Other Tools
Quick Reference

INTRODUCTION
S5U1C17001C Manual Seiko Epson Corporation i
(Rev. 1.0)
Introduction
This document describes the development procedure from compiling C source files to debugging and creating the PA file (Data to
be submitted) 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
•Basic operating procedures for Eclipse IDE for C/C++ Developers Package
•Knowledge about the gnu C, binutils, 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
Please refer to the general documents that describe ANSI C and Eclipse IDE for C/C++ Developers Package and the manuals that
describe gnu tools and Windows, for the above contents.
Before installation
See readmeVxxx.txt. This file describes the composition of this package, and provides a general outline of each tool.
Installation
Install the tools as described in readmeVxxx.txt.
For coding
See the necessary parts in Chapter 2. This chapter 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 8 explains details of the debugger.
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 ICDmini (S5U1C17001H).
For details of each tool
Refer to Chapters 3 to 10 and gnu tool manuals for details.

ii Seiko Epson Corporation S5U1C17001C Manual
(Rev. 1.0)
Manual Notations
This manual was prepared by following the notation rules detailed below:
Samples
The sample screens shown in the manual may appear slightly different, depending on the specific system or system fonts.
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 characters 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 ICDmini (S5U1C17001H).

Contents
S5U1C17001C Manual Seiko Epson Corporation iii
(Rev. 1.0)
－
Contents
－
1General.....................................................................................................................................................1-1
1.1 Features ............................................................................................................................................... 1-1
1.2 Outline of Software Tools...................................................................................................................... 1-2
2Source Files.............................................................................................................................................2-1
2.1 File Format and File Name ................................................................................................................... 2-1
2.2 Grammar of C Source .......................................................................................................................... 2-2
2.2.1 Data Type ............................................................................................................................. 2-2
2.2.2 Library Functions and Header Files ...................................................................................... 2-3
2.2.3 In-line Assemble ................................................................................................................... 2-4
2.2.4 Prototype Declarations.......................................................................................................... 2-4
2.3 Grammar of Assembly Source.............................................................................................................. 2-5
2.3.1 Statements............................................................................................................................ 2-5
2.3.2 Notations of Operands.......................................................................................................... 2-9
2.3.3 Extended Instructions ......................................................................................................... 2-11
2.3.4 Preprocessor Directives...................................................................................................... 2-12
2.4 Precautions for Creation of Sources................................................................................................... 2-13
3GNU17 IDE ............................................................................................................................................... 3-1
3.1 Overview............................................................................................................................................... 3-1
3.1.1 Features................................................................................................................................ 3-1
3.1.2 Some Notes on Use of the IDE............................................................................................. 3-1
3.2 Starting and Quitting the IDE ................................................................................................................ 3-2
3.2.1 Starting the IDE..................................................................................................................... 3-2
3.2.2 Quitting the IDE..................................................................................................................... 3-2
3.3 Projects................................................................................................................................................. 3-3
3.3.1 What Is a Project?................................................................................................................. 3-3
3.3.2 Creating a New Project......................................................................................................... 3-3
3.3.3 Creating and Adding a Source File ....................................................................................... 3-4
3.3.4 Interrupt Vector and Boot Processing Descriptions............................................................... 3-5
3.3.5 Importing an Existing Project ................................................................................................ 3-6
3.3.6 Importing a GNU17 Version 2 Project................................................................................... 3-7
3.4 Setting Project Properties..................................................................................................................... 3-8
3.4.1 Setting GNU17 Project Properties ........................................................................................ 3-8
3.4.2 Setting Environment Variables.............................................................................................. 3-9
3.4.3 Setting Compiler Path......................................................................................................... 3-11
3.4.4 Setting Compiler Options.................................................................................................... 3-11
3.4.5 Setting Linker Options......................................................................................................... 3-12
3.4.6 Setting Assembler Options ................................................................................................. 3-13
3.5 Building a Program ............................................................................................................................. 3-14
3.5.1 Editing a Linker Script......................................................................................................... 3-14
3.5.2 Executing a Build Process .................................................................................................. 3-15
3.5.3 Clean and Rebuild .............................................................................................................. 3-15
3.6 Debugging the Program...................................................................................................................... 3-17
3.6.1 GDB Command File............................................................................................................ 3-17
3.6.2 Setting Standard Output ..................................................................................................... 3-18
3.6.3 Using the Debugger............................................................................................................ 3-19
3.6.4 Setting the Debug Configuration......................................................................................... 3-20
3.7 Files Generated in a Project by the IDE.............................................................................................. 3-21

Contents
iv Seiko Epson Corporation S5U1C17001C Manual
(Rev. 1.0)
4C Compiler ............................................................................................................................................... 4-1
4.1 Functions.............................................................................................................................................. 4-1
4.2 Input/Output File................................................................................................................................... 4-1
4.2.1 Input File............................................................................................................................... 4-1
4.2.2 Output Files .......................................................................................................................... 4-1
4.3 Starting Method .................................................................................................................................... 4-2
4.3.1 Startup Format...................................................................................................................... 4-2
4.3.2 Command-line Options ......................................................................................................... 4-2
4.4 Compiler Output ................................................................................................................................... 4-8
4.4.1 Output Contents.................................................................................................................... 4-8
4.4.2 Data Representation............................................................................................................. 4-9
4.4.3 Method of Using Registers.................................................................................................. 4-12
4.4.4 Function Call....................................................................................................................... 4-13
4.4.5 Stack Frame ....................................................................................................................... 4-14
4.4.6 Grammar of C Source......................................................................................................... 4-15
4.4.7 Compiler Implementation Definition .................................................................................... 4-15
4.5 Filter Function for Shift JIS Code........................................................................................................ 4-16
4.6 Functions of xgcc and Usage Precautions.......................................................................................... 4-17
5Library...................................................................................................................................................... 5-1
5.1 Library Overview................................................................................................................................... 5-1
5.1.1 Library Files .......................................................................................................................... 5-1
5.1.2 Precautions to Be Taken When Adding a Library ................................................................. 5-2
5.2 Startup Processing Library.................................................................................................................... 5-3
5.2.1 Overview............................................................................................................................... 5-3
5.2.2 Vector Tables........................................................................................................................ 5-3
5.2.3 Stack Pointer Initial Values ................................................................................................... 5-3
5.2.4 Startup Processing................................................................................................................ 5-4
5.3 Emulation Library.................................................................................................................................. 5-5
5.3.1 Overview............................................................................................................................... 5-5
5.3.2 Floating-point Calculation Functions..................................................................................... 5-6
5.3.3 Floating-point Number Processing Implementation Definition .............................................. 5-8
5.3.4 Integral Calculation Functions............................................................................................... 5-9
5.3.5 long long Type Calculation Functions ............................................................................ 5-10
5.3.6 Compatibility with Coprocessor Instructions ....................................................................... 5-11
5.4 ANSI Library ....................................................................................................................................... 5-12
5.4.1 Overview............................................................................................................................. 5-12
5.4.2 ANSI Library Function List .................................................................................................. 5-12
5.4.3 Declaring and Initializing Global Variables.......................................................................... 5-18
5.4.4 Lower-level Functions......................................................................................................... 5-19
6Assembler................................................................................................................................................6-1
6.1 Functions.............................................................................................................................................. 6-1
6.2 Input/Output Files ................................................................................................................................. 6-1
6.2.1Input File............................................................................................................................... 6-2
6.2.2 Output File ............................................................................................................................ 6-2
6.3 Starting Method .................................................................................................................................... 6-3
6.3.1 Startup Format...................................................................................................................... 6-3
6.3.2 Command-line Options ......................................................................................................... 6-3
6.4 Scope ................................................................................................................................................... 6-4

Contents
S5U1C17001C Manual Seiko Epson Corporation v
(Rev. 1.0)
6.5 Assembler Directives ............................................................................................................................ 6-5
6.5.1 Text Section Defining Directive （.text）......................................................................... 6-5
6.5.2 Data Section Defining Directives（.rodata, .data）....................................................... 6-6
6.5.3 Bss Section Defining Directive （.bss）............................................................................ 6-7
6.5.4 Data Defining Directives （.long, .short, .byte, .ascii, .space）........................... 6-8
6.5.5 Area Securing Directive （.zero）..................................................................................... 6-9
6.5.6 Alignment Directive （.align）....................................................................................... 6-10
6.5.7 Global Declaring Directive （.global）.......................................................................... 6-11
6.5.8 Symbol Defining Directive（.set）................................................................................... 6-12
6.6 Extended Instructions ......................................................................................................................... 6-13
6.6.1 Arithmetic Operation Instructions........................................................................................ 6-13
6.6.2 Comparison Instructions ..................................................................................................... 6-15
6.6.3 Logic Operation Instructions ............................................................................................... 6-16
6.6.4 Data Transfer Instructions (between Stack and Register)................................................... 6-17
6.6.5 Data Transfer Instructions (between Memory and Register)............................................... 6-18
6.6.6 Immediate Data Load Instructions ...................................................................................... 6-19
6.6.7 Branch Instructions ............................................................................................................. 6-21
6.6.8 Coprocessor Instructions .................................................................................................... 6-25
6.6.9 Xext Instructions ................................................................................................................. 6-26
6.7 Error/Warning Messages .................................................................................................................... 6-27
6.8 Precautions......................................................................................................................................... 6-28
7Linker ....................................................................................................................................................... 7-1
7.1 Functions.............................................................................................................................................. 7-1
7.2 Input/Output Files ................................................................................................................................. 7-1
7.2.1 Input Files ............................................................................................................................. 7-2
7.2.2 Output Files .......................................................................................................................... 7-2
7.3 Starting Method .................................................................................................................................... 7-3
7.3.1 Startup Format...................................................................................................................... 7-3
7.3.2 Command-line Options ......................................................................................................... 7-3
7.4 Linkage................................................................................................................................................. 7-4
7.4.1 Default Linker Script.............................................................................................................. 7-4
7.4.2 Examples of Linkage............................................................................................................. 7-6
7.4.3 Link Maps ............................................................................................................................. 7-8
7.5 Error/Warning Messages .....................................................................................................................7-11
7.6 Precautions......................................................................................................................................... 7-12
8Debugger .................................................................................................................................................8-1
8.1 Features ............................................................................................................................................... 8-1
8.2 Input/Output Files ................................................................................................................................. 8-1
8.2.1Input Files ............................................................................................................................. 8-1
8.2.2 Output File ............................................................................................................................ 8-2
8.3 Starting the Debugger........................................................................................................................... 8-3
8.3.1 Startup Format...................................................................................................................... 8-3
8.3.2 Startup Options..................................................................................................................... 8-4
8.3.3 Executing Command Files.................................................................................................... 8-5
8.3.4 Quitting the Debugger........................................................................................................... 8-6
8.4 Method of Executing Commands.......................................................................................................... 8-7
8.4.1 Entering Commands From the Keyboard.............................................................................. 8-7
8.4.2 Parameter Input Format........................................................................................................ 8-8

Contents
vi Seiko Epson Corporation S5U1C17001C Manual
(Rev. 1.0)
8.5 Command Reference ........................................................................................................................... 8-9
8.5.1 List of Commands ................................................................................................................. 8-9
8.5.2 Detailed Description of Commands..................................................................................... 8-10
Command name (operation of command) [Supported modes] ...................................... 8-10
8.5.3 Command Details ............................................................................................................... 8-11
8.5.4 Memory Manipulation Commands ...................................................................................... 8-11
c17 fb (fill area, in bytes)................................................................................................. 8-11
c17 fh (fill area, in 16 bits)............................................................................................... 8-11
c17 fw (fill area, in 32 bits) [ICD Mini / SIM] .................................................................... 8-11
X (memory dump) [ICD Mini / SIM].................................................................................. 8-13
set { } (data input) [ICD Mini / SIM] ................................................................................. 8-15
c17 mvb (copy area, in bytes)......................................................................................... 8-16
c17 mvh (copy area, in 16 bits)....................................................................................... 8-16
c17 mvw (copy area, in 32 bits) [ICD Mini / SIM] ............................................................ 8-16
c17 df (save memory contents) [ICD Mini / SIM]............................................................. 8-17
8.5.5 Register Manipulation Commands...................................................................................... 8-19
info reg (display register) [ICD Mini / SIM]...................................................................... 8-19
set $ (modify register) [ICD Mini / SIM] ........................................................................... 8-20
8.5.6 Program Execution Commands .......................................................................................... 8-21
continue (execute continuously) [ICD Mini / SIM]........................................................... 8-21
until (execute continuously with temporary break) [ICD Mini / SIM]................................ 8-22
step (single-step, every line) ........................................................................................... 8-24
stepi (single-step, every mnemonic) [ICD Mini / SIM] ..................................................... 8-24
next (single-step with skip, every line) ............................................................................ 8-25
nexti (single-step with skip, every mnemonic) [ICD Mini / SIM] ...................................... 8-25
finish (finish function) [ICD Mini / SIM] ........................................................................... 8-26
8.5.7 CPU Reset Commands....................................................................................................... 8-27
c17 rst (reset) [ICD Mini / SIM] ....................................................................................... 8-27
c17 rstt (reset target) [ICD Mini] ..................................................................................... 8-28
8.5.8 Interrupt Commands ........................................................................................................... 8-29
c17 int (interrupt) [SIM] ................................................................................................... 8-29
c17 intclear (clear interrupt) [SIM] .................................................................................. 8-30
8.5.9 Break Setup Commands..................................................................................................... 8-31
break (set software PC break) ........................................................................................ 8-31
tbreak (set temporary software PC break) [ICD Mini / SIM]............................................ 8-31
hbreak (set hardware PC break)..................................................................................... 8-34
thbreak (set temporary hardware PC break) [ICD Mini / SIM] ........................................ 8-34
delete (clear break by break number) [ICD Mini / SIM] ................................................... 8-36
clear (clear break by break position) [ICD Mini / SIM]..................................................... 8-37
enable (enable breakpoint) ............................................................................................. 8-38
disable (disable breakpoint) [ICD Mini / SIM].................................................................. 8-38
ignore (disable breakpoint with ignore counts) [ICD Mini / SIM] ..................................... 8-39
info breakpoints (display breakpoint list) [ICD Mini / SIM]............................................. 8-40
commands (setting a command to execute after break) [ICD Mini / SIM] ...................... 8-41
8.5.10 Symbol Information Display Commands............................................................................. 8-42
info locals (display local symbol).................................................................................... 8-42
info var (display global symbol) [ICD Mini / SIM] ............................................................ 8-42
print (alter symbol value) [ICD Mini / SIM] ...................................................................... 8-43
8.5.11 File Loading Commands..................................................................................................... 8-44
file (load debugging information) [ICD Mini / SIM]........................................................... 8-44
load (load program) [ICD Mini / SIM] .............................................................................. 8-45
8.5.12 Trace Command ................................................................................................................. 8-46
c17 tm (set trace mode) [SIM]......................................................................................... 8-46

Contents
S5U1C17001C Manual Seiko Epson Corporation vii
(Rev. 1.0)
8.5.13 Other Commands................................................................................................................ 8-49
set output-radix (change of variable display format) [ICD Mini / SIM] ........................... 8-49
set logging (log output setting) [ICD Mini / SIM]............................................................. 8-50
source (execute command file) [ICD Mini / SIM] ............................................................ 8-51
target (connect target) [ICD Mini / SIM] .......................................................................... 8-52
detach (disconnect target) [ICD Mini / SIM] .................................................................... 8-53
pwd (display current directory)........................................................................................ 8-54
cd (change current directory) [ICD Mini / SIM] ................................................................ 8-54
c17 ttbr (set TTBR) [SIM] ............................................................................................... 8-55
c17 cpu (set CPU type) [SIM] ......................................................................................... 8-56
c17 chgclkmd (DCLK change mode) [ICD Mini] ............................................................ 8-57
c17 pwul (unlock flash security password) [ICD Mini]..................................................... 8-58
c17 help (help) [ICD Mini / SIM]...................................................................................... 8-59
c17 model_path (model-specific information file directory setting) [ICD Mini / SIM]....... 8-61
c17 model (MCU model name setting) [ICD Mini / SIM] ................................................. 8-62
quit (quit debugger) [ICD Mini / SIM] .............................................................................. 8-63
8.6 Status and Error Messages ................................................................................................................ 8-64
8.6.1 Status Messages ................................................................................................................ 8-64
8.6.2Error Messages................................................................................................................... 8-64
8.7 Peripheral Circuit Simulator (ES-Sim17) ............................................................................................ 8-65
8.7.1 Input/Output files................................................................................................................. 8-66
8.7.2 Starting and Terminating ES-Sim17.................................................................................... 8-68
8.7.3 Menus ................................................................................................................................. 8-69
8.7.4 Simulating I/O Ports............................................................................................................ 8-70
8.7.5 Simulating SVD................................................................................................................... 8-72
8.7.6 Simulating an LCD Panel.................................................................................................... 8-73
8.7.7 ES-Sim17 Error Massages ................................................................................................. 8-74
8.7.8 Restrictions ......................................................................................................................... 8-74
9Creating Data to Be Submitted.............................................................................................................. 9-1
9.1 Outline of Tools for Creating Data to Be Submitted .............................................................................. 9-1
9.2 Procedure for Creating Data to Be Submitted ...................................................................................... 9-2
9.2.1 Creating FDC Files (Function Option Documents) Using winfog17 ...................................... 9-2
9.2.2 Creating PSA Files (ROM Data) ........................................................................................... 9-5
9.2.3 Creating PA Files (Data to Be Submitted) Using windmc17 ................................................. 9-5
9.2.4 PA File (Data to Be Submitted) Separation Procedure ......................................................... 9-6
9.3 Error Messages for Submitted Data Creation Tools.............................................................................. 9-9
9.3.1 winfog17 Error Messages ..................................................................................................... 9-9
9.3.2 winmdc17 Error Messages ................................................................................................. 9-10
9.4 Sample Output for Submitted Data Creation Tools ..............................................................................9-11
10 Other Tools............................................................................................................................................10-1
10.1 objdump.exe ....................................................................................................................................... 10-1
10.1.1 Function.............................................................................................................................. 10-1
10.1.2 Input Files ........................................................................................................................... 10-1
10.1.3 Method for Using objdump.................................................................................................. 10-1
10.1.4 Error Message .................................................................................................................... 10-2
10.1.5 Precautions......................................................................................................................... 10-2
10.2 objcopy.exe......................................................................................................................................... 10-3
10.2.1 Function.............................................................................................................................. 10-3
10.2.2 Input/Output Files................................................................................................................ 10-3
10.2.3 Method for Using objcopy ................................................................................................... 10-4
10.2.4 Creating SA Files (ROM Data)............................................................................................ 10-5

Contents
viii Seiko Epson Corporation S5U1C17001C Manual
(Rev. 1.0)
10.3 ar.exe.................................................................................................................................................. 10-6
10.3.1 Function.............................................................................................................................. 10-6
10.3.2 Input/Output Files................................................................................................................ 10-6
10.3.3 Method for Using ar ............................................................................................................ 10-7
10.4 moto2ff.exe......................................................................................................................................... 10-9
10.4.1 Function.............................................................................................................................. 10-9
10.4.2 Input/Output Files................................................................................................................ 10-9
10.4.3 Startup Format.................................................................................................................... 10-9
10.4.4 Error/Warning Messages .................................................................................................. 10-10
10.4.5 Creating SAF File (ROM Data) ......................................................................................... 10-10
10.5 sconv32.exe ......................................................................................................................................10-11
10.5.1 Function............................................................................................................................ 10-11
10.5.2 Input/Output Files.............................................................................................................. 10-11
10.5.3 Startup Format.................................................................................................................. 10-11
10.5.4 Error Messages................................................................................................................. 10-12
10.6 gpdata.exe........................................................................................................................................ 10-13
10.6.1 Function............................................................................................................................ 10-13
10.6.2 Input/Output Files.............................................................................................................. 10-13
10.6.3 Method for Using gpdata................................................................................................... 10-13
10.7 ptd.exe.............................................................................................................................................. 10-14
10.7.1 Function............................................................................................................................ 10-14
10.7.2 Input/Output Files.............................................................................................................. 10-14
10.7.3 Method for Using ptd.exe.................................................................................................. 10-14
10.7.4 Error Messages................................................................................................................. 10-15
10.7.5 Method for Setting Flash Protection.................................................................................. 10-15
10.8 LCDUtil17 (LCD Panel Customizing Tool) ........................................................................................ 10-16
10.8.1 Overview........................................................................................................................... 10-16
10.8.2 Input/Output files............................................................................................................... 10-16
10.8.3 Starting and Closing LCDUtil17 ........................................................................................ 10-17
10.8.4 Window ............................................................................................................................. 10-17
10.8.5 Menus and Toolbar........................................................................................................... 10-18
10.8.6 Producing an LCD file....................................................................................................... 10-21
10.8.7 Shortcut Key list................................................................................................................ 10-28
10.8.8 Warning Messages and Error Messages.......................................................................... 10-29

S5U1C17001C Manual
1 General

1 General
S5U1C17001C Manual Seiko Epson Corporation 1-1
(Rev. 1.0)
1General
1.1 Features
The S1C17 Family C Compiler Package contains software development tools and utilities for compiling C source programs and
assembling and debugging assembly source programs, as well as creating PSA files (ROM data) and PA files (Data to be
submitted).
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 allows use of the S1C17MCU core simulator.

 Integrated development environment for Windows
Designed to run under Microsoft Windows, the GNU17 IDE is a seamless integrated development environment suitable for a
wide range of development tasks, from source creation to debugging.

1General
1-2 Seiko Epson Corporation S5U1C17001C Manual
(Rev. 1.0)
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.
(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) 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
"readmeVxxx.txt" (xxx 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.