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