Epson S5U1C17001C User manual

Rev.1.0
CMOS 16-BIT SINGLE CHIP MICROCONTROLLER
(C Compiler Package for S1C17 Family) (Ver. 3.2)
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 2019,All rights reserved.

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
10 Other Tools
11 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.

INTRODUCTION
S5U1C17001C Manual Seiko Epson Corporation ii
(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-12
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.5.4 Static Stack Usage Analysis Function................................................................................. 3-16
3.6 Debugging the Program...................................................................................................................... 3-17
3.6.1 GDB Command File............................................................................................................ 3-17
3.6.2 Setting Standard Input/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
4C Compiler...............................................................................................................................................4-1

Contents
S5U1C17001C Manual Seiko Epson Corporation iv
(Rev. 1.0)
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-7
4.4.1 Output Contents.................................................................................................................... 4-7
4.4.2 Data Representation............................................................................................................. 4-8
4.4.3 Method of Using Registers.................................................................................................. 4-10
4.4.4 Function Call ..................................................................................................................... 4-11
4.4.5 Stack Frame ..................................................................................................................... 4-12
4.4.6 Grammar of C Source......................................................................................................... 4-13
4.4.7 Compiler Implementation Definition.................................................................................... 4-13
4.5 Correspond to Shift JIS Code............................................................................................................. 4-14
4.6 Functions of xgcc and Usage Precautions.......................................................................................... 4-15
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-9
5.3.6 Compatibility with Coprocessor Instructions ....................................................................... 5-10
5.4 ANSI Library........................................................................................................................................5-11
5.4.1 Overview ..................................................................................................................... 5-11
5.4.2 ANSI Library Function List.................................................................................................. 5-11
5.4.3 Declaring and Initializing Global Variables.......................................................................... 5-17
5.4.4 Lower-level Functions......................................................................................................... 5-18
6Assembler................................................................................................................................................6-1
6.1 Functions.............................................................................................................................................. 6-1
6.2 Input/Output Files ................................................................................................................................. 6-1
6.2.1 Input 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
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

Contents
S5U1C17001C Manual Seiko Epson Corporation v
(Rev. 1.0)
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 Linker Script Generation Wizard......................................................................................................... 7-12
7.6.1 Output File ..................................................................................................................... 7-12
7.6.2 Starting and Terminating the Linker Script Generation Wizard........................................... 7-12
7.6.3 Menu ..................................................................................................................... 7-13
7.7 Precautions......................................................................................................................................... 7-15
8Debugger .................................................................................................................................................8-1
8.1 Features .............................................................................................................................................. 8-1
8.2 Input/Output Files ................................................................................................................................. 8-1
8.2.1 Input 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
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 Memory Manipulation Commands ...................................................................................... 8-11

Contents
S5U1C17001C Manual Seiko Epson Corporation vi
(Rev. 1.0)
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.4 Register Manipulation Commands...................................................................................... 8-19
info reg (display register) [ICD Mini / SIM]................................................................... 8-19
set $ (modify register) [ICD Mini / SIM] ........................................................................ 8-20
8.5.5 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.6 CPU Reset Commands....................................................................................................... 8-27
c17 rst (reset) [ICD Mini / SIM] .................................................................................... 8-27
c17 rstt (reset target) [ICD Mini] .................................................................................. 8-28
8.5.7 Interrupt Commands........................................................................................................... 8-29
c17 int (interrupt) [SIM]................................................................................................ 8-29
c17 intclear (clear interrupt) [SIM]............................................................................... 8-30
8.5.8 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.9 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.10 File Loading Commands..................................................................................................... 8-44
file (load debugging information) [ICD Mini / SIM]........................................................ 8-44
load (load program) [ICD Mini / SIM] ........................................................................... 8-45
8.5.11 Trace Command................................................................................................................. 8-46
c17 tm (set trace mode) [SIM]...................................................................................... 8-46
8.5.12 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 MCU) [ICD Mini / SIM].............................................................. 8-52
detach (disconnect target MCU) [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

Contents
S5U1C17001C Manual Seiko Epson Corporation vii
(Rev. 1.0)
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
c17 flv (flash programming power setting) [ICD Mini].................................................. 8-64
c17 flvs (flash programming power setting cancellation) [ICD Mini] ............................ 8-65
c17 stdin (input of data using input/output functions) [ICD Mini / SIM]........................ 8-66
c17 stdout (output of data using input/output functions) [ICD Mini / SIM].................... 8-67
c17 lcdsim (LCD panel simulator setting/cancellation) [ICD Mini]............................... 8-68
quit (quit debugger) [ICD Mini / SIM] ........................................................................... 8-69
8.6 Status and Error Messages ................................................................................................................ 8-70
8.6.1 Status Messages ................................................................................................................ 8-70
8.6.2 Error Messages................................................................................................................... 8-70
8.7 Run Time Measurement ..................................................................................................................... 8-71
8.7.1 Display Method................................................................................................................... 8-71
8.7.2 Restrictions ..................................................................................................................... 8-71
8.8 Peripheral Circuit Simulator (ES-Sim17) ............................................................................................ 8-72
8.8.1 Input/Output files................................................................................................................. 8-73
8.8.2 Starting and Terminating ES-Sim17.................................................................................... 8-74
8.8.3 Menus ..................................................................................................................... 8-75
8.8.4 Simulating I/O Ports............................................................................................................ 8-76
8.8.5 Simulating SVD................................................................................................................... 8-78
8.8.6 Simulating an LCD Driver ................................................................................................... 8-79
8.8.7 ES-Sim17 Error Massages ................................................................................................. 8-80
8.8.8 Restrictions ..................................................................................................................... 8-80
8.9 LCD Panel Simulator.......................................................................................................................... 8-81
8.9.1 Input Files ..................................................................................................................... 8-82
8.9.2 Starting and Terminating the LCD Panel Simulator ............................................................ 8-83
8.9.3 Procedure for Modifying the Program................................................................................. 8-84
8.9.4 Restrictions ..................................................................................................................... 8-85
8.10 Profiler Coverage................................................................................................................................ 8-86
8.10.1 Input/Output Files................................................................................................................ 8-86
8.10.2 Starting and Terminating the Profiler Coverage.................................................................. 8-87
8.10.3 Preparation ..................................................................................................................... 8-88
8.10.4 Coverage Function.............................................................................................................. 8-89
8.10.5 Profiler Function.................................................................................................................. 8-90
8.10.6 Restrictions ..................................................................................................................... 8-90
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

Contents
S5U1C17001C Manual Seiko Epson Corporation viii
(Rev. 1.0)
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
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
11 Quick Reference....................................................................................................................................11-1

1General
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 the ICDmini (S5U1C17001H)
emulator, the program can be debugged while the target board is running. 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
S5U1C17001C Manual Seiko Epson Corporation 1-2
(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 ICDmini. 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.

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-1
(Rev. 1.0)
2Source Files
This chapter explains the rules and grammar involved with the creation of source files.
2.1 File Format and File Name
Use the GNU17 IDE editor or a general-purpose editor to create source files.


File format
Save data in a standard text file.


File name
C source file <filename>.c
Assembly source file <filename>.s
Specify the <filename> with not more than 32 alphanumeric characters shown as follows:
a–z, A–Z, 0–9 and _
This rule applies to file names for all the S1C17 tools.


Directory name
Only alphanumeric characters can be used for directory names just as for file names. Do not use spaces or other symbols. Up to
64 characters can be used for a path name including directory and file names.


Global variables/static variables
Up to 200 characters can be used to name global and static variables.
A total of 32,000 global and static variables can be accepted.


File size
The following shows the guide about the upper limit of the C source file size:
In the case of a source file that contains only variables, constants and arrays, up to 100,000 lines can be accepted.
In the case of a source file that contains only executable codes (not including arrays and variables), up to 20,000 lines can be
accepted. However, the number of acceptable lines varies depending on the source density.
Consider these two conditions above as reference for sources in which variables, constants, arrays and executable codes are
mixed.
The number of lines shown above varies depending on compile environment conditions. Moreover, the compiler may be
forcibly terminated due to insufficient resources. In this case, build the program under a resource-rich environment or divide
the source file into multiple files before compiling. (Resources described here depend on the OS used rather than the RAM
capacity of the PC.)
Up to 512 characters can be used per line in C source files.
In the case of assembly source files, up to 30,000 lines can be accepted.


Tab setting
The recommended tab stop is every 4 characters. This is the default tab setting when the IDE displays sources.


EOF
Make sure that each statement starts on a new line and that EOF is entered after line feed (so that EOF will stand independent at
the file end).

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-2
(Rev. 1.0)
2.2 Grammar of C Source
The xgcc C compiler included in this package is the GNU C Compiler under ANSI C standards.
Make sure C sources are created according to ANSI C standards. If you want information about the syntax, please refer to ANSI C
textbooks generally available on the market.
2.2.1 Data Type
The xgcc C compiler supports all data types under ANSI C. The size of each data type (in bytes) and the effective range of values
that can be expressed are listed in Table 2.2.1.1.
Table 2.2.1.1 Data type and size
Data type
Size
Effective range of a number
char
1
-128 to 127
unsigned char
1
0 to 255
short
2
-32768 to 32767
unsigned short
2
0 to 65535
int
2
-32768 to 32767
unsigned int
2
0 to 65535
long
4
-2147483648 to 2147483647
unsigned long
4
0 to 4294967295
pointer
4
0 to 16777215
float
4
1.175e-38 to 3.403e+38 (normalized number)
double
8
2.225e-308 to 1.798e+308 (normalized number)
long long
8
-9223372036854775808 to 9223372036854775807
unsigned long long
8
0 to 18446744073709551615
wchar_t
2
0 to 65535
The float and double types conform to the IEEE standard format.
Handling of long long-type constants requires the suffix LL or ll (long long type) or ULL or ull (unsigned long long
type). If this suffix is not present, a warning is generated, since the compiler may not be able to recognize long long-type
constants as such.
Example: long long ll_val;
ll_val = 0x1234567812345678;
→warning:integer constant is too large for “long”type
Ll_val = 0x1234567812345678LL;
→OK
Type wchar_t is the data type needed to handle wide characters. This data type is defined in stdlib.h/stddef.h as the type
unsigned short.

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-3
(Rev. 1.0)
2.2.2 Library Functions and Header Files
This package contains an ANSI library and an emulation library for calculating floating-point numbers and the remainders of
divided integral numbers. The header files in the "include" directory contain library function declarations and macro definitions.
When using a library function, include the header file that contains its declaration by using the #include instruction.
Certain ANSI library functions not supported by this package are not included in the ANSI library. The client assumes responsibility
for function implementation and prototype declarations when using ANSI library functions not supported by this package. For some
ANSI library functions not supported by this package, the header files include only prototype declarations. In these cases, include
the pertinent header file rather than declaring a prototype before implementing the function.
The following table shows the relationship between the types of library files and header files.
Table 2.2.2.1 List of library files and functions
ANSI library
File name
Functions/macros
Corresponding header file
libc.a
perror, getchar, fgetc, getc, gets, fgets, fscanf, scanf, sscanf, fread,
putchar, fputc, putc, puts, fputs, ungetc, fprintf, printf, sprintf, vfprintf,
vprintf, vsprintf, fwrite
stdio.h
abort, exit, malloc, calloc, realloc, free, atoi, atol, atof, strtol, strtoul,
strtod, abs, labs, div, ldiv, rand, srand, bsearch, qsort
stdlib.h
setjmp, longjmp
setjmp.h
time, mktime, gmtime
time.h
acos, asin, atan, atan2, ceil, cos, cosh, exp, fabs, floor, fmod, frexp,
ldexp, log, log10, modf, pow, sin, sinh, sqrt, tan, tanh
math.h,errno.h,float.h,limits.h
memchr, memmove, strchr, strcspn, strncat, strpbrk, strstr, memcmp,
memset, strcmp, strerror, strncmp, strrchr, strtok, memcpy, strcat, strcpy,
strlen, strncpy, strspn
string.h
isalnum, iscntrl, isgraph, isprint, isspace, isxdigit, toupper, isalpha,
isdigit, islower, ispunct, isupper, tolower
ctype.h
va_start, va_arg, va_end
stdarg.h
Emulation library
File name
Functions
libgcc.a
___subdf3,__adddf3,__addsf3,__ashldi3,__ashlhi3,__ashlsi3,__ashrdi3,__ashrhi3,__ashrsi3,
__cmpdi2,__divdf3,__divdi3,__divhi3,__divsf3,__divsi3,__eqdf2,__eqsf2,__extendsfdf2,
__fixdfdi,__fixdfsi,__fixsfdi,__fixsfsi,__fixunsdfdi,__fixunsdfsi,__fixunssfdi,__fixunssfsi,
__floatdidf,__floatdisf,__floatsidf,__floatsisf,__gedf2,__gesf2,__gtdf2,__gtsf2,__ledf2,__lesf2,
__lshrdi3,__lshrhi3,__lshrsi3,__ltdf2,__ltsf2,__moddi3,__modhi3,__modsi3,__muldf3,
__muldi3,__mulhi3,__mulsf3,__mulsi3,__nedf2,__negdf2,__negdi2,__negsf2,__nesf2,
__subsf3,__truncdfsf2,__ucmpdi2,__udivdi3,__udivhi3,__udivsi3,__umoddi3,__umodhi3,
__umodsi3,__cmpsi2,__ucmpsi2
Functions with prototype declarations only
Functions
Corresponding header file
freopen, tmpfile, tmpnam, remove, rename, fopen, fclose, setbuf, setvbuf, fflush, clearerr, feof,
ferror, fseek, fgetpos, fsetpos, ftell, rewind
stdio.h
atexit, getenv, system
stdlib.h
difftime, clock, localtime, asctime, ctime
time.h
For details about the functions included in the libraries, refer to Chapter 5, "Library". When using a library function, be sure to
specify the library file that contains the function used when linking. The linker extracts only the necessary object modules from the
specified library file as it links them.

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-4
(Rev. 1.0)
2.2.3 In-line Assemble
The xgcc C compiler supports in-line assembly, so the asm statement can be used. As a result, the word "asm" is reserved for
system use.
Format: asm("<character string>");
Example 1: /* HALT mode */
asm("halt");
Example 2: /* Trap Table*/
asm(" .long BOOT\n\
.long ADDR_ERR\n\
.long NMI\n\}
.space 4\n\
.long EINT0\n\
.long EINT1");
Example 3: BOOT(){
asm("xld.a %sp,0x3f00"); /* set SP */
:
}
For details on how to write an assembly source, refer to Section 2.3, "Grammar of Assembly Source".
2.2.4 Prototype Declarations


Declaring interrupt handler functions
Interrupt handler functions should be declared in the following format:
<type><function name> __attribute__ ((interrupt_handler));
Example: void foo(void) __attribute__ ((interrupt_handler));
int int_num;
void foo()
{
int_num =5;
}
Assembler code
foo:
ld.a -[%sp],%r2
ld %r2,5
xld [int_num],%r2
ld.a %r2,[%sp]+
reti

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-5
(Rev. 1.0)
2.3 Grammar of Assembly Source
2.3.1 Statements
Each individual instruction or definition of an assembly source is called a statement. The basic composition of a statement is as
follows:


Syntax pattern
1
<Mnemonic>
（
<Operands>
）
（
;<Comment>
）
2
<Assembler directive>
（
<Parameters>
）
（
;<Comment>
）
3
<Label>:
（
;<Comment>
）
4
;<Comment>
5
<Extended instruction>
<Operands>
（
;<Comment>
）
6
<Preprocessor directive>
（
<Parameters>
）
（
;<Comment>
）
Example:
——————————————— Statement ——————————————— —Syntax pattern —
; boot.s 4
; boot program 4
#define SP_INI,0x3f00
; Stack pointer value
6
.text
2
.long BOOT
; BOOT VECTOR
2
BOOT:
3
xld.a %sp,SP_INI
; set SP
5
xcall main
; goto main
5
jpr BOOT
; infinity loop
1
The example given above is an ordinary source description method. For increased visibility, the elements composing each statement
are aligned with tabs and spaces.


Restrictions
Only one statement can be described in one line. A description containing more than two instructions in one line will result in
an error. However, comments may be described in the same line with an instruction or label.
Example: ;OK
BOOT: ld %r1,%r2
ld %r0,%r1
;Error
BOOT: ld %r1,%r2 ld %r0,%r1
One statement cannot be described in more than one line. A statement not complete in one line will result in an error.
Example: ;OK
ld %r1,%r2
;Error
ld %r1,
%r2
The usable characters are limited to ASCII characters (alphanumeric symbols), except for use in comments. Also, the usable
symbols have certain limitations (details below).
Comments can be described using other characters than ASCII characters. When using non-ASCII characters (such as Chinese
characters) for comments, use /* · · · */ as the comment symbol.

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-6
(Rev. 1.0)
(1) Instructions (Mnemonics and Operands)
An instruction to the S1C17 Core is generally composed of <Mnemonic> + <Operand>. Some instructions do not contain an
operand.


General notation forms of instructions
General forms: <Mnemonic>
<Mnemonic> tab or space <Operands>
<Mnemonic> tab or space <Operand 1> , <Operand 2>
Example: nop
call SUB1
ld%r0,0x4
There is no restriction as to where the description of a mnemonic may begin in a line. A tab or space preceding a mnemonic
is ignored. Generally, mnemonics are justified left by tab setting.
An instruction containing an operand needs to be broken with one or more tabs or spaces between the mnemonic and the
operand. If there are plural operands, the operands are separated from each other with one comma (,). Space between
operands is ignored.
The elements of operands will be described further below.


Types of mnemonics
The following S1C17 Core instructions can be used in the S1C17 Family:
ld.b
add
ld.ub
add/c
ld
add/nc
ld.a
add.a
add.a/c
add.a/nc
adc
adc/c
adc/nc
sub
sub/c
sub/nc
sub.a
sub.a/c
sub.a/nc
sbc
sbc/c
sbc/nc
cmp
cmp/c
cmp/nc
cmp.a
cmp.a/c
cmp.a/nc
cmc
cmc/c
cmc/nc
and
and/c
and/nc
or
or/c
or/nc
xor
xor/c
xor/nc
not
not/c
not/nc
sr
sa
sl
swap
cv.ab
cv.as
cv.al
cv.la
cv.ls
jpr
jpr.d
jpa
ipa.d
jrgt
jrgt.d
jrge
jrge.d
jrlt
jrlt.d
jrle
jrle.d
jrugt
jrugt.d
jruge
jruge.d
jrult
jrult.d
jrule
jrule.d
jreq
jreq.d
jrne
jrne.d
call
call.d
calla
calla.d
ret
ret.d
int
intl
reti
reti.d
brk
retd
ext
nop
halt
slp
ei
di
ld.cw
ld.ca
ld.cf
Refer to the "S1C17 Core Manual" for details of each instruction.


Restrictions on characters
Mnemonics can be written in uppercase (A–Z) characters, lowercase (a–z) characters, or both.
For example, "ld", "LD", and "Ld" are all accepted as "ld" instructions.
For purposes of discrimination from symbols, this manual uses lowercase characters.
More will be said about operands later.

2Source Files
S5U1C17001C Manual Seiko Epson Corporation 2-7
(Rev. 1.0)
(2) Assembler Directives
The as assembler supports the standard directives provided in the gnu assembler.
Refer to the gnu assembler manual for the standard directives. Each directive begins with a period (.). The following lists
often-utilized directives.
.text Declares a .text section.
.section .data Declares a .data section.
.section .rodata Declares a .rodata section.
.section .bss Declares a .bss section.
.long <data> Defines a 4-byte data.
.short <data> Defines a 2-byte data.
.byte <data> Defines a byte data.
.ascii <string> Defines an ASCII character strings.
.space <length> Defines a blank (0x0) space.
.zero <length> Defines a blank (0x0) space.
.align <value> Alignment to a specified boundary address.
.global <symbol> Defines a global symbol.
.set <symbol>,<address> Defines a symbol with an absolute address.
(3) Labels
A label is an identifier designed to refer to an arbitrary address in the program. You can refer to a branch destination of a
program or an address in the .text/.data section by using a symbol defined as a label.


Definition of a label
A symbol described in the following format is regarded as a label.
<Symbol>:
Preceding spaces and tabs are ignored. It is a general practice to describe from the top of a line.
A defined symbol denotes the address of a described location.
An actual address value will be determined in the linking process.


Restrictions
Only the following characters can be used:
A–Z a～z _ 0–9
A label cannot begin with a numeral. Uppercase and lowercase are discriminated.
Example: ;OK ;Error
FOO: 1label:
_Abcd: 0_ABC:
L1: