Epson S1C88 Series User manual

(Integrated Tool Package for S1C88 Family)
CMOS 8-BIT SINGLE CHIP MICROCOMPUTER
S5U1C88000C Manual II
Workbench/Development Tools/Assembler Package Old Version

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. This material or portions thereof may contain technology or the subject relating to strategic
products under the control of the Foreign Exchange and Foreign Trade Law of Japan and may require an export license from
the Ministry of Economy, Trade and Industry or other approval from another government agency.
The C compiler, assembler and tools explained in this manual are developed by TASKING, Inc.
Windows 2000 and Windows XP are registered trademarks of Microsoft Corporation, U.S.A.
PC/AT and IBM are registered trademarks of International Business Machines Corporation, U.S.A.
All other product names mentioned herein are trademarks and/or registered trademarks of their respective owners.
© SEIKO EPSON CORPORATION 2008, All rights reserved.

Devices
S1 C 88104 F 0A01
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
Development tools
S5U1 C 88348 D1 1
Packing specifications
00: standard packing
Version
1: Version 1
Tool type
Hx : ICE
Ex : EVA board
Px : Peripheral board
Wx: Flash ROM writer for the microcomputer
Xx : ROM writer peripheral board
Cx : C compiler package
Ax : Assembler package
Dx : Utility tool by the model
Qx : Soft simulator
Corresponding model number
88348: for S1C88348
Tool classification
C: microcomputer use
Product classification
S5U1: development tool for semiconductor products
00
00
Configuration of product number

MANUAL ORGANIZATION
S5U1C88000C MANUAL II EPSON i
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
MANUAL ORGANIZATION
The S1C88 Family Integrated Tool Package contains the tools required to develop software for the S1C88
Family microcomputers. The S5U1C88000C Manual (S1C88 Family Integrated Tool Package) describes the
tool functions and how to use the tools. The manual is organized into two documents as shown below.
I. C Compiler/Assembler/Linker
Describes the C Compiler and its tool chain ([Main Tool Chain] part shown in the figure on the next
page).
II.Workbench/DevelopmentTools/Assembler Package Old Version (this document)
Describes the Work Bench that provides an integrated development environment, Advanced Locator,
the Mask Data Creation Tools ([Development Tool Chain] part shown in the figure on the next page),
Debugger, and Structured Assembler ([Sub Tool Chain] part shown in the figure on the next page).
This manual assumes that the reader is familiar with C and Assembly languages.
Refer to the following manuals as necessary when developing an S1C88xxx microcomputer:
S1C88xxx Technical Manual
Describes the device specifications, control method and Flash EEPROM programming.
S5U1C88000Q Manual
Describes the operation of the tools included in the Simulator Package.
S5U1C88000H5 Manual
Describes the operation of the ICE (S5U1C88000H5).
S5U1C88xxxP Manual
Describes the operation of the peripheral circuit board installed in the ICE.

MANUAL ORGANIZATION
ii EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
S1C88 F
AMILY
I
NTEGRATED
D
EVELOPMENT
E
NVIRONMENT
ice88ur.exe
Segment option
generator winsog.exe
file.SSA
Segment option
HEX file
file.SDC
file.ini
Mask data checker
winmdc.exe
file.PAn Mask
data file
Function option
generator winfog.exe
file.FSA file.FDC
Function option
document file
Function option
HEX file
Segment option
document file
Program unused area
filling utility fil88xxx
file.PSA Program
data HEX file
C compiler
c88.exe
Assembler
as88.exe
Object reader
pr88.exe
Library maintainer
ar88.exe
Text editor
(prepared by customer)
file.OUT Linker
object
module
file.ABS Absolute
load
module
Motorola S
object file
file.C C source
files
file.SRC Assembly
files
file.OBJ Object
modules
Bitmap utility BmpUtil.exe
(Simulator package)
Bitmap editor
(prepared by customer)
file.BMP Bitmap
file(s)
file.BMU
Bitmap
definition
file
file.TXT
Data
table file
file.ERR Error
file
∗1
∗2
∗2∗2
∗2∗2
∗2
∗3
∗1
file.LST List
file
file.A Object
library
Make program
mk88.exe
Control program
cc88.exe
file.MAK Make
file
file.MEM file.INF
file.CPU
file.DSC Locator
description
files
OR
file.ERS Error
file
file.MAP Locate
map
file file.SY
Symbolic
table
file
∗1
∗4
∗5
∗4
file.ELC
Error
file
Linker
lk88.exe
file.PRT Port
setting
file
Port setting utility
PrtUtil.exe
Simulator
sim88.exe
Debugger
db88.exe
(under development)
ICE & Peripheral circuit board
Target board
ROM writer control software
file.WPJ Project
file
Workbench
wb88.exe
file.LCD LCD
definition
file
file.CMP file.SPJ
Component
mapping file Simulator
project file
model.PAR
ICE
parameter
file
model.MOT
Peripheral
circuit board
FPGA data
ice88ur.ini
ICE
ini file
file.BMP
Bitmap
file
LCD panel customize utility
LcdUtil.exe
file.Axx
Result
data file
file.CSV
Check
sheet file
file.Mxx
Reference
data file
file.TXT
Command
file
Auto evaluation system
AutoEva.exe
file.SY Symbolic
table file
Symbolic table file generator
sy88.exe
file.SY Symbolic
table file
Symbolic table file generator
sym88.exe
∗1
file.LNL Link
map
file
Advanced locator
definition file
file.CAL Call
graph
file
file.ELK Error
file
file.SA
Main tool chain
Embedded system simulator
Preprocessor
sap88.exe
Assembler
asm88.exe
file.SA Motorola S
object file
file.ABS Absolute
object
file
file.S Assembly
source files Device
information
definition file
file.MS Preprocessed
source files
file.O Object
modules
file.LCM Link command
parameter file
HEX converter
hex88.exe
file.REF Symbol
information
reference file
Linker
link88.exe
Symbol information generator
rel88.exe
file.X
Cross
reference
file
Error
list file
file.LST Assembly
list file file.E
Sub tool chain Development tool chain
ROM writer
Manufactured in
Seiko Epson
Flash ROM
MCU Mask ROM
MCU
WB
WB
Build
Build
Build
Build
Advanced locator
alc88.exe
Build
Locator
lc88.exe
Build
Build
WB
WB
WB
WB
WB
WB
WB
WB
∗1: If the error file is generated, wb88 displays the contents of the file in the message view and allows a tag jump function. ∗2: Created using a text editor. ∗3: Created using a bitmap editor.
∗4:
Created using the wb88 section editor (or a text editor)
. ∗5: Selected by wb88.
WB
Build
WB
Can be invoked from the workbench wb88. Tools executed automatically during build process by wb88.
Build

CONTENTS
S5U1C88000C MANUAL II EPSON iii
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
CONTENTS
CHAPTER 1GENERAL _______________________________________________ 1
1.1 Features........................................................................................................................1
1.2 S1C88 Family Integrated Development Environment .................................................2
CHAPTER 2INSTALLATION ____________________________________________ 5
2.1 Package Components................................................................................................... 5
2.2 Operating Environment ............................................................................................... 5
2.3 Installation Method .....................................................................................................6
2.4 Directories and Files after Installation....................................................................... 7
2.5 Environment Settings ................................................................................................... 8
CHAPTER 3WORK BENCH ____________________________________________ 9
3.1 Features........................................................................................................................9
3.2 Starting Up and Terminating the Work Bench............................................................. 9
3.3 Work Bench Windows..................................................................................................10
3.4 Toolbar and Buttons ................................................................................................... 12
3.5 Menus.......................................................................................................................... 13
3.5.1 [File] Menu.......................................................................................................... 13
3.5.2 [View] Menu ........................................................................................................ 13
3.5.3 [Source] Menu..................................................................................................... 14
3.5.4 [Build] Menu ....................................................................................................... 14
3.5.5 [Debug] Menu ..................................................................................................... 14
3.5.6 [Tools] Menu ....................................................................................................... 14
3.5.7 [Help] Menu ........................................................................................................ 15
3.6 Project and Work Space..............................................................................................16
3.6.1 Creating a New Project ....................................................................................... 16
3.6.2 Inserting Sources into a Project.......................................................................... 17
3.6.3 Removing a Source from the Project................................................................... 17
3.6.4 Project View ......................................................................................................... 17
3.6.5 Opening and Closing a Project........................................................................... 18
3.6.6 Saving the Project ............................................................................................... 18
3.7 Creating/Editing Source Files ....................................................................................19
3.7.1 Specifying an Editor ............................................................................................ 19
3.7.2 Creating a New Source or Header File .............................................................. 20
3.7.3 Editing Files ........................................................................................................ 20
3.7.4 Tag Jump Function .............................................................................................. 21
3.8 Build Task ...................................................................................................................22
3.8.1 Preparing a Build Task........................................................................................ 22
3.8.2 Building an Executable Object ........................................................................... 22
3.8.3 Running only the Compiler or Assembler........................................................... 23
3.9 Setting Tool Options ................................................................................................... 24
3.9.1 Compiler Options ................................................................................................ 25
3.9.2 Assembler Options............................................................................................... 27
3.9.3 Linker Options ..................................................................................................... 29
3.9.4 Locator Options................................................................................................... 30
3.9.5 Section Editor ...................................................................................................... 32
3.10 Debugging...................................................................................................................38
3.10.1 Simulator ........................................................................................................... 38
3.10.2 In-circuit Emulator (S5U1C88000H5) and Debugger..................................... 40

CONTENTS
iv EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
3.11 Executing Other Tools ................................................................................................ 41
3.12 File List .......................................................................................................................42
3.13 Error Messages............................................................................................................43
CHAPTER 4OUTLINE OF THE MAIN TOOL CHAIN ___________________________ 44
CHAPTER 5ADVANCED LOCATOR <alc88> ________________________________ 45
5.1 Functions of alc88 ......................................................................................................45
5.2 Input/output Files .......................................................................................................46
5.3 Using alc88................................................................................................................. 47
5.4 Error Messages...........................................................................................................47
5.5 Precautions ................................................................................................................. 47
CHAPTER 6OUTLINE OF THE DEVELOPMENT TOOLS _________________________ 48
CHAPTER 7PROGRAM UNUSED AREA FILLING UTILITY <fil88xxx> _____________ 50
7.1 Outline of fil88xxx ......................................................................................................50
7.2 Input/output Files .......................................................................................................50
7.3 Using fil88xxx .............................................................................................................51
7.4 Error Messages...........................................................................................................52
7.5 Example of Input/output Files .................................................................................... 53
CHAPTER 8FUNCTION OPTION GENERATOR <winfog> _______________________ 54
8.1 Outline of winfog ........................................................................................................54
8.2 Input/output Files .......................................................................................................54
8.3Using winfog ............................................................................................................... 55
8.3.1 Starting Up .......................................................................................................... 55
8.3.2 Window ................................................................................................................ 56
8.3.3 Menus and Toolbar Buttons ................................................................................ 57
8.3.4 Operation Procedure ........................................................................................... 58
8.4 Error Messages...........................................................................................................61
8.5 Example Output Files ................................................................................................. 62
CHAPTER 9SEGMENT OPTION GENERATOR <winsog> _______________________ 63
9.1 Outline of winsog........................................................................................................ 63
9.2 Input/output Files .......................................................................................................63
9.3 Using winsog ..............................................................................................................64
9.3.1 Starting Up .......................................................................................................... 64
9.3.2 Window ................................................................................................................ 66
9.3.3 Menus and Toolbar Buttons ................................................................................ 67
9.3.4 Option Selection Buttons..................................................................................... 68
9.3.5 Operation Procedure ........................................................................................... 68
9.4 Error Messages...........................................................................................................74
9.5 Example Output Files ................................................................................................. 75
CHAPTER 10 MASK DATA CHECKER <winmdc> _____________________________ 76
10.1 Outline of winmdc....................................................................................................... 76
10.2 Input/output Files ....................................................................................................... 76

CONTENTS
S5U1C88000C MANUAL II EPSON v
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
10.3 Using winmdc .............................................................................................................77
10.3.1 Starting Up ........................................................................................................ 77
10.3.2 Menus and Toolbar Buttons .............................................................................. 78
10.3.3 Operation Procedure......................................................................................... 79
10.4 Error Messages........................................................................................................... 82
10.5 Example Output File................................................................................................... 83
CHAPTER 11 SELF-DIAGNOSTIC PROGRAM <t88xxx> _________________________ 84
11.1 Outline of t88xxx......................................................................................................... 84
11.2 File Configuration ...................................................................................................... 84
11.3 Operation Procedure ..................................................................................................84
CHAPTER 12 88xxx.par FILE __________________________________________ 85
12.1 Contents of 88xxx.par File .........................................................................................85
12.2 Description of the Parameters.................................................................................... 86
12.3 Emulation Memory .....................................................................................................86
CHAPTER 13 S1C88 FAMILY DEBUGGER __________________________________ 87
13.1 Overview ..................................................................................................................... 87
13.2 Input/output Files ....................................................................................................... 87
13.3 Starting and Terminating the Debugger..................................................................... 88
13.3.1 Starting the Debugger ....................................................................................... 88
13.3.2 Terminating the Debugger................................................................................. 89
13.4 Windows ...................................................................................................................... 90
13.4.1 Basic Structure of Window ................................................................................ 90
13.4.2 [Command] Window.......................................................................................... 91
13.4.3 [Source] Window ............................................................................................... 93
13.4.4 [Dump] Window ................................................................................................ 98
13.4.5 [Register] Window ............................................................................................. 99
13.4.6 [Symbol] Window .............................................................................................. 99
13.4.7 [Watch] Window ................................................................................................ 99
13.4.8 [Trace] Window ................................................................................................ 100
13.4.9 [Coverage] Window.......................................................................................... 100
13.5Menu ..........................................................................................................................101
13.6 Tool Bar ..................................................................................................................... 105
13.7 Method for Executing Commands ............................................................................. 106
13.7.1 Entering Commands from Keyboard................................................................ 106
13.7.2 Executing from Menu or Tool Bar ................................................................... 108
13.7.3 Executing from a Command File ..................................................................... 109
13.7.4 Log File............................................................................................................. 110
13.8 Debug Functions........................................................................................................ 111
13.8.1 Loading Files .................................................................................................... 111
13.8.2 Source Display and Symbolic Debugging Function........................................ 112
13.8.3 Displaying/Modifying Memory and Register Data ......................................... 114
13.8.4 Executing Program........................................................................................... 116
13.8.5 Break Functions ............................................................................................... 120
13.8.6 Trace Functions ................................................................................................ 127
13.8.7 Coverage........................................................................................................... 131
13.8.8 Writing Data to the FPGA on the Standard Peripheral Circuit Board........... 133
13.8.9 System Options ................................................................................................. 134

CONTENTS
vi EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
13.9 Command Reference.................................................................................................. 135
13.9.1 Command List................................................................................................... 135
13.9.2 Reference for Each Command ......................................................................... 136
13.9.3 Memory Operation ........................................................................................... 137
dd (data dump) ......................................................................................... 137
de (data enter) .......................................................................................... 140
df (data fill) .............................................................................................. 142
dm (data move)......................................................................................... 143
ds (data search) ........................................................................................ 144
13.9.4 Register Operation ........................................................................................... 145
rd (register display) .................................................................................. 145
rs (register set) ......................................................................................... 146
13.9.5 Program Execution........................................................................................... 148
g (go) ........................................................................................................ 148
gr (go after reset CPU) ............................................................................ 150
s (step) ...................................................................................................... 151
n (next) ..................................................................................................... 153
se (step exit).............................................................................................. 154
13.9.6 CPU Reset ........................................................................................................ 155
rst (reset CPU) ......................................................................................... 155
13.9.7 Break ................................................................................................................. 156
bp (software breakpoint set) ..................................................................... 156
bpa (software area breakpoint set)........................................................... 158
bpr / bc / bpc (software breakpoint clear)................................................ 160
bas (sequential break setting) .................................................................. 161
ba (hardware breakpoint set) ................................................................... 162
bar (hardware breakpoint clear) .............................................................. 164
bd (hardware data breakpoint set) ........................................................... 165
bdr (hardware data breakpoint clear) ...................................................... 167
bl (breakpoint list) .................................................................................... 168
bac (break all clear)................................................................................. 169
13.9.8 Program Display .............................................................................................. 170
u (unassemble) ......................................................................................... 170
sc (source code)........................................................................................ 172
m (mix) ..................................................................................................... 174
13.9.9 Symbol Information .......................................................................................... 176
sy (symbol list) ......................................................................................... 176
w (symbol watch)...................................................................................... 177
13.9.10 Load File......................................................................................................... 178
lf (load file)............................................................................................... 178
par (load parameter file).......................................................................... 179
13.9.11 Trace ............................................................................................................... 180
td (trace data display) .............................................................................. 180
ts (trace search)........................................................................................ 183
tf (trace file).............................................................................................. 185
13.9.12 Coverage......................................................................................................... 186
cv (coverage) ............................................................................................ 186
cvc (coverage clear) ................................................................................. 188

CONTENTS
S5U1C88000C MANUAL II EPSON vii
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
13.9.13 Command File ................................................................................................ 189
com (execute command file)..................................................................... 189
cmw (execute command file with wait) .................................................... 190
rec (record commands to a file) ............................................................... 191
13.9.14 log ................................................................................................................... 192
log (log) .................................................................................................... 192
13.9.15 Map Information ............................................................................................ 193
ma (map information) .............................................................................. 193
13.9.16 FPGA Operation ............................................................................................ 194
xfer (xilinx fpga data erase) ..................................................................... 194
xfwr (xilinx fpga data write)..................................................................... 195
xfcp (xilinx fpga data compare) ............................................................... 196
xdp (xilinx fpga data dump) ..................................................................... 197
13.9.17 Quit ................................................................................................................. 198
q (quit) ...................................................................................................... 198
13.9.18 Help ................................................................................................................ 199
? (help) ..................................................................................................... 199
13.10 Error Messages......................................................................................................... 200
APPENDIX AASSEMBLER (Sub tool chain) _______________________________ 203
A.1 Outline of Package.....................................................................................................203
A.1.1 Introduction ........................................................................................................ 203
A.1.2 Outline of Software Tools................................................................................... 203
A.2 Program Development Procedures............................................................................205
A.2.1 Development Flow ............................................................................................. 205
A.2.2 Creating Source File .......................................................................................... 207
A.2.3 Assembly............................................................................................................. 210
A.2.3.1 Structured preprocessor (sap88) ......................................................... 210
A.2.3.2 Cross assembler (asm88) .................................................................... 210
A.2.3.3 Starting sap88 and asm88................................................................... 212
A.2.3.4 Batch processing for relocatable assembly (ra88.bat) ....................... 214
A.2.3.5 Relocatable object file......................................................................... 218
A.2.3.6 Assembly list file.................................................................................. 218
A.2.3.7 Cross reference list .............................................................................. 219
A.2.3.8 Error list.............................................................................................. 220
A.2.3.9 Example of assembly execution........................................................... 220
A.2.4 Link..................................................................................................................... 221
A.2.4.1 Linking modules .................................................................................. 221
A.2.4.2 Section control .................................................................................... 221
A.2.4.3 Module allocation information ........................................................... 223
A.2.4.4 Starting link88..................................................................................... 224
A.2.4.5 Batch processing for linking (lk88.bat)............................................... 224
A.2.4.6 Absolute object file .............................................................................. 229
A.2.4.7 Execution example of linking .............................................................. 229
A.2.5 Creating Program Data HEX File..................................................................... 230
A.2.5.1 Program data HEX file ....................................................................... 230
A.2.5.2 Creating program data HEX file using hex88..................................... 230
A.2.5.3 Motorola S2 format ............................................................................. 231

CONTENTS
viii EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
A.2.6 Symbol Information ........................................................................................... 232
A.2.6.1 Creating symbol information (rel88) .................................................. 232
A.2.6.2 Creating symbolic table file (sym88) .................................................. 234
APPENDIX BCREATING PROCEDURE OF ASSEMBLY SOURCE FILE (Sub tool chain) __ 235
B.1 Outline .......................................................................................................................235
B.1.1 File Name ........................................................................................................... 235
B.1.2 Source File Differences Depending on sap88 and asm88 ................................ 235
B.1.3 Macro Instructions ............................................................................................. 235
B.2 General Format of Source File ..................................................................................236
B.2.1 Symbol ................................................................................................................ 237
B.2.2 Mnemonic ........................................................................................................... 237
B.2.3 Operand.............................................................................................................. 237
B.2.4 Comment ............................................................................................................ 237
B.2.5 Numerical Expression........................................................................................ 238
B.2.6 Characters.......................................................................................................... 238
B.2.7 ASCII Character Set .......................................................................................... 238
B.2.8 Expressions ........................................................................................................ 239
B.2.9 Operators ........................................................................................................... 240
B.2.10 Instruction Set .................................................................................................. 241
B.2.11 Register Name .................................................................................................. 241
B.2.12 Addressing Mode.............................................................................................. 242
B.2.13 Example for Mnemonic Notation .................................................................... 243
B.3 Pseudo-Instructions................................................................................................... 244
B.3.1 Section Setting Pseudo-Instructions.................................................................. 245
B.3.2 Data Definition Pseudo-Instructions ................................................................ 247
B.3.3 Symbol Definition Pseudo-Instructions............................................................. 251
B.3.4 Location Counter Control Pseudo-Instruction ................................................. 253
B.3.5 External Definition and External Reference Pseudo-Instructions ................... 254
B.3.6 Source File Insertion Pseudo-Instruction [sap88 only] ................................... 255
B.3.7 Assembly Termination Pseudo-Instruction........................................................ 256
B.3.8 Macro-Related Pseudo-Instructions [sap88 only]............................................ 257
B.3.9 Conditional Assembly Pseudo-Instructions [sap88 only] ................................ 266
B.3.10 Output List Control Pseudo-Instructions ........................................................ 270
APPENDIX CASSEMBLY TOOL REFERENCE (Sub tool chain) __________________ 273
C.1 Structured Preprocessor <sap88> ............................................................................274
C.2 Cross Assembler <asm88> .......................................................................................276
C.3 Linker <link88> ........................................................................................................281
C.4 Symbol Information Generator <rel88>...................................................................285
C.5 Symbolic Table File Generator <sym88>................................................................. 288
C.6 Binary/HEX Converter <hex88> ..............................................................................290
QUICK REFERENCE _________________________________________________ 293

CHAPTER 1 GENERAL
S5U1C88000C MANUAL II EPSON 1
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
CHAPTER 1GENERAL
1.1 Features
The S1C88 Family Integrated Tool Package contains software development tools that are common to all
the models of the S1C88 Family. The package comes as an efficient working environment for develop-
ment tasks, ranging from compiling/assembly source program to debugging.
The principal features are as follows:
Integrated working environment
The work bench wb88, a Windows GUI application, provides an integrated working environment
that allows management of all files as a project, execution of make process, invocation of tools includ-
ing the editor specified by the user.
Supports C and S1C88 Family assembly languages
This package contains C compiler tools as well as the conventional structured assembler tools.
Supports simulator, auto evaluation system and ICE as debugging tools
The work bench invokes the ICE (S5U1C88000H5) an optional development tool for the S1C88 Family
or the simulator after automatically generating a command file, this makes it possible to debug an
object immediately after building.
Common to all S1C88 chips
The tools included in this package are common to all S1C88 Family models. The chip dependent
information is read from the parameter file and device information definition file for each chip.

CHAPTER 1 GENERAL
2EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
1.2 S1C88 Family Integrated Development Environment
ice88ur.exe
Segment option
generator winsog.exe
file.SSA
Segment option
HEX file
file.SDC
file.ini
Mask data checker
winmdc.exe
file.PAn Mask
data file
Function option
generator winfog.exe
file.FSA file.FDC
Function option
document file
Function option
HEX file
Segment option
document file
Program unused area
filling utility fil88xxx
file.PSA Program
data HEX file
C compiler
c88.exe
Assembler
as88.exe
Object reader
pr88.exe
Library maintainer
ar88.exe
Text editor
(prepared by customer)
file.OUT Linker
object
module
file.ABS Absolute
load
module
Motorola S
object file
file.C C source
files
file.SRC Assembly
files
file.OBJ Object
modules
Bitmap utility BmpUtil.exe
(Simulator package)
Bitmap editor
(prepared by customer)
file.BMP Bitmap
file(s)
file.BMU
Bitmap
definition
file
file.TXT
Data
table file
file.ERR Error
file
∗1
∗2
∗2∗2
∗2∗2
∗2
∗3
∗1
file.LST List
file
file.A Object
library
Make program
mk88.exe
Control program
cc88.exe
file.MAK Make
file
file.MEM file.INF
file.CPU
file.DSC Locator
description
files
OR
file.ERS Error
file
file.MAP Locate
map
file file.SY
Symbolic
table
file
∗1
∗4
∗5
∗4
file.ELC
Error
file
Linker
lk88.exe
file.PRT Port
setting
file
Port setting utility
PrtUtil.exe
Simulator
sim88.exe
Debugger
db88.exe
(under development)
ICE & Peripheral circuit board
Target board
ROM writer control software
file.WPJ Project
file
Workbench
wb88.exe
file.LCD LCD
definition
file
file.CMP file.SPJ
Component
mapping file Simulator
project file
model.PAR
ICE
parameter
file
model.MOT
Peripheral
circuit board
FPGA data
ice88ur.ini
ICE
ini file
file.BMP
Bitmap
file
LCD panel customize utility
LcdUtil.exe
file.Axx
Result
data file
file.CSV
Check
sheet file
file.Mxx
Reference
data file
file.TXT
Command
file
Auto evaluation system
AutoEva.exe
file.SY Symbolic
table file
Symbolic table file generator
sy88.exe
file.SY Symbolic
table file
Symbolic table file generator
sym88.exe
∗1
file.LNL Link
map
file
Advanced locator
definition file
file.CAL Call
graph
file
file.ELK Error
file
file.SA
Main tool chain
Embedded system simulator
Preprocessor
sap88.exe
Assembler
asm88.exe
file.SA Motorola S
object file
file.ABS Absolute
object
file
file.S Assembly
source files Device
information
definition file
file.MS Preprocessed
source files
file.O Object
modules
file.LCM Link command
parameter file
HEX converter
hex88.exe
file.REF Symbol
information
reference file
Linker
link88.exe
Symbol information generator
rel88.exe
file.X
Cross
reference
file
Error
list file
file.LST Assembly
list file file.E
Sub tool chain Development tool chain
ROM writer
Manufactured in
Seiko Epson
Flash ROM
MCU Mask ROM
MCU
WB
WB
Build
Build
Build
Build
Advanced locator
alc88.exe
Build
Locator
lc88.exe
Build
Build
WB
WB
WB
WB
WB
WB
WB
WB
∗1: If the error file is generated, wb88 displays the contents of the file in the message view and allows a tag jump function. ∗2: Created using a text editor. ∗3: Created using a bitmap editor.
∗4:
Created using the wb88 section editor (or a text editor)
. ∗5: Selected by wb88.
WB
Build
WB
Can be invoked from the workbench wb88. Tools executed automatically during build process by wb88.
Build

CHAPTER 1 GENERAL
S5U1C88000C MANUAL II EPSON 3
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
The following shows the outlines of the software tools included in the package:
Integrated working environment
Work Bench (wb88.exe)
This software provides an integrated development environment with Windows GUI. Creating/editing
source files using an editor, selecting files and the major start-up options for C compiler Tool Chain,
and the start-up of each tool can be made with simple Windows operations.
Main tool chain
C compiler (c88.exe)
Compiles C source files to generate assembly source files.
Assembler (as88.exe)
Assembles the assembly source files generated by the C compiler to convert into relocatable object
files.
Linker (lk88.exe)
Links relocatable object files and libraries to generate a combined relocatable object file.
Locator (lc88.exe)
Relocates the relocatable object file generated by the linker to generate a load module that has abso-
lute address. This file is used for debugging and creating mask data.
Advanced locator (alc88.exe)
Realizes the locator's relocation functions without using description files in DELFEE. Moreover, it
incorporates a new function that helps to optimize branching. See Chapter 5 for details about ad-
vanced locator.
The tools available in the Main tool chain, except advanced locator, are detailed in the document titled
"S5U1C88000C Manual I".
Sub tool chain
Preprocessor (sap88.exe)
Expands the preprocessor instructions in assembly source files into the source codes that can be
assembled.
Assembler (as88.exe)
Assembles the assembly source files generated by the preprocessor to convert into relocatable object
files.
Linker (lk88.exe)
Relocates the relocatable object files generated by the assembler to generate an absolute object file.
Hex converter (hx88.exe)
Converts the absolute object file generated by the linker into a HEX data file in the Motorola S format.
This HEX file is used for debugging and creating mask data.
Refer to Appendix for details of the tools in the Sub tool chain.

CHAPTER 1 GENERAL
4EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
Development tool chain
Function option generator (winfog.exe)
This tool creates an ICE function option setup file after selecting the mask options of the S1C88xxx
and the function option document file that is necessary to generate IC mask patterns.
Segment option generator (winsog.exe)
This tool creates an ICE segment option setup file after selecting the segment options of the S1C88xxx
and the segment option document file that is necessary to generate IC mask patterns. The winsog is
used only for the model that has segment options.
Program unused area filling utility (fil88xxx.exe)
This tool extracts the built-in ROM area from a program data HEX file and fills unused areas in the
built-in ROM with FFH. It also sets a system code to the system-reserved area. This processing must
be performed before debugging the program with the ICE as well as before generating a mask data
with winmdc.
Mask data checker (winmdc.exe)
This tool checks the data in development-completed program file and option document files to create
the mask data file that will be presented to Seiko Epson.
Refer to Chapters 6 through 12 for details of the tools in the Development tool chain.
Debug tool
db88 debugger (ice88ur.exe)
Controls the ICE (S5U1C88000H5) provided as a hardware tool for the S1C88 Family to debug pro-
grams. Commands that are used frequently, such as break and step, are registered on the tool bar,
minimizing the necessary keyboard operations. Moreover, sources, registers, and command execution
results can be displayed in multiple windows, with resultant increased efficiency in the debugging
tasks. Refer to Chapter 13 for details of the db88 debugger.
ice88ur debugger (ice88ur.exe)
Controls the ICE (S5U1C88000H5) provided as a hardware tool for the S1C88 Family to debug pro-
grams. The operations are described in a Windows help file (.hlp) that can be opened from the start
menu. (The help file in English can also be opened from the menu/tool bar in ice88ur.)
PROM writing tool
ROM writer control software
Controls the dedicated PROM writer to write data to the PROM in the built-in Flash EEPROM
microcomputer. A different tool and firmware are provided for each microcomputer model and each
type of PROM writer. Refer to the technical manual of each built-in Flash EEPROM microcomputer for
PROM writers and how to write data.

CHAPTER 2 INSTALLATION
S5U1C88000C MANUAL II EPSON 5
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
CHAPTER 2INSTALLATION
2.1 Package Components
The S1C88 Family Integrated Tool Package contains the items listed below. When it is unpacked, make
sure that all items are supplied.
1. CD-ROM (Tools and PDF manuals are included) .................. One
2.Warranty card.......................................................................... One each in English and Japanese
3. Registration card..................................................................... One each in English and Japanese
2.2 Operating Environment
For each tool to be used, the following operating environment is required:
Personal computer
IBM PC/AT or fully compatibles that can run the system software listed below. Apersonal computer
using Pentium 200 MHz or greater as the CPU and incorporating 64 MB or more of RAM is recom-
mended. Installation requires a CD-ROM drive.
To use the optional ICE (S5U1C88000H5), the personal computer also requires a USB port and Win-
dows 2000 or Windows XP.
Display
A 800 ×600 dots display unit or higher is required.
System software
Each tool is designed to run under Microsoft Windows 2000 and Windows XP (in English or Japa-
nese).
To use the optional ICE (S5U1C88000H5), Windows 2000 or Windows XP is necessary.
Other
To debug the target program using the in-circuit emulator system, the optional ICE (S5U1C88000H5)
and a Peripheral Circuit Board (S5U1C88xxxP) are needed as the hardware tools.

CHAPTER 2 INSTALLATION
6EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
2.3 Installation Method
To install the development tools, use the installer (Setup.exe) on the CD-ROM included with the package.
To install the tools
(1) Start Windows 2000 or Windows XP. If the OS is already active, close active programs.
(2) Insert the CD-ROM into the drive and display the contents.
(3) Double-click Setup.exe.
When old-version tools are installed, the installer displays a warning message and stops
installation. In this case, uninstall the old-version tools and then run the installer again.
Welcome to ...
The install wizard starts and displays the welcome
dialog box.
(4) Click on the [Next>] button to proceed.
Choose Destination Location
A dialog box for specifying the folder in which to install
the tools appears.
(5) If you do not wish to change the default settings,
simply click the [Next>] button to execute installa-
tion.
To install in another folder
Click [Browse...] to bring up the [Choose Folder]
dialog box. From this dialog box, enter the path or
select the folder in which to install the tools. Click
the [OK] button to finish folder selection and then
click the [Next>] button.
Note: When installing the tools to a folder other than
default, be aware that the folder must satisfy the
following requirements:
-The folder name must be 8 letters or less.
-The folder name cannot contain any spaces.
-When selecting a sub-directory, it must be
located within two levels from the root directory.
The installer will start installing the tools.

CHAPTER 2 INSTALLATION
S5U1C88000C MANUAL II EPSON 7
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
To end installation
All dialog boxes that appear during installation have a [Cancel] button. To prematurely terminate
installation, click [Cancel] in the dialog box when it is displayed.
To uninstall
To uninstall the installed tools, use "Add/Remove Programs" on the Control Panel.
2.4 Directories and Files after Installation
The installer copies the following files in the specified directory (default is "C:\EPSON\S1C88\"):
[EPSON\S1C88]
README_E.TXT ... ReadMe text file (English)
README_J.TXT ... ReadMe text file (Japanese)
ADDPATH.BAT ... Batch file for environment setup
[\BIN] ... S1C88 Family C Compiler Tools
WB88.EXE ... Work bench
C88.EXE ... C compiler
AS88.EXE ... Assembler
LK88.EXE ... Linker
LC88.EXE ... Locator
ALC88.EXE ... Advanced locator
CC88.EXE ... Control program
MK88.EXE ... Make program
AR88.EXE ... Library maintainer
PR88.EXE ... Object reader
SY88.EXE ... Symbolic table file generator
ICE88UR.EXE ... S5U1C88000H control software
ICE88UR.HLP ... S5U1C88000H help file
. . . ... Other related files
[\SAP] ... S1C88 Family Structured Assembler Tools
SAP88.EXE ... Preprocessor
ASM88.EXE ... Assembler
LINK88.EXE ... Linker
HEX88.EXE ... HEX converter
REL88.EXE ... Symbol information generator
SYM88.EXE ... Symbolic table file generator
[\DB88] ... DB88 debugger directory
DB88.EXE ... DB88 debugger
DEFAULT.PAR ... Default parameter file
. . . ... Other related files
[\DEV]
[\BIN] ... S1C88 Family Development Tool for Windows
WINFOG.EXE ... Function option generator
WINSOG.EXE ... Segment option generator
WINMDC.EXE ... Mask data checker
[\88xxx] ... Model-dependent files
S1C88xxx.CPU ... Locator description files
S1C88xxx.DSC
S1C88xxx.MEM
FIL88xxx.EXE ... Program unused area filling utility
S1C88xxx.ini ... Device information definition file
88xxx.PAR ... ICE parameter file
t88xxx.psa ... ICE self-diagnostic files
t88xxx.fsa
t88xxx.fdc
InstallShield Wizard Complete
(6) Click [Finish] to terminate the installer.
"401Comupd.exe" may be executed according to the
system condition.

CHAPTER 2 INSTALLATION
8EPSON S5U1C88000C MANUAL II
WORKBENCH/DEV TOOLS/OLD ASSEMBLER
[\DOC]
[\ENGLISH] ... Document folder (English)
REL_xxxx_E.TXT ... Tool release note
TBD_E.PDF ... Manual (PDF)
TBD_E.PDF ... Quick reference (PDF)
[\HARD] ... Hardware tool document folder (English)
PRC_COMMON_E.PDF ... Standard peripheral circuit board manual (PDF)
ICE88UR_SETUP_E.PDF... ICE manual (PDF)
[\JAPANESE] ... Document folder (Japanese)
REL_xxxx_J.TXT ... Tool release note
TBD_J.PDF ... Manual (PDF)
TBD_J.PDF ... Quick reference (PDF)
[\HARD] ... Hardware tool document folder (Japanese)
PRC_COMMON_J.PDF ... Standard peripheral circuit board manual (PDF)
ICE88UR_SETUP_J.PDF ... ICE manual (PDF)
[\ETC] ... Default locator description files
S1C88.DSC
MK88.MK
S1C88.CPU
S1C88.MEM
[\ICE]
[\FPGA]
C88xxx.MOT ... FPGA data for standard peripheral circuit board
[\INCLUDE] ... C header files
[\LIB] ... C library files
[\LIBCC] ... Library objects for compact code model
[\LIBCD] ... Library objects for compact data mode
[\LIBCL] ... Library objects for large mode
[\LIBCS] ... Library objects for small mode
[\SRC] ... Library source files
[\SAMPLES] ... Sample program sources
Refer to ApplicationNote_J(E).PDF located in this folder for the contents of the sample
programs.
[\WRITER]
[\8xxxx] (Flash microcomputer name)
[\URW2]
RW8xxxxx.EXE ... Universal ROM Writer II control software
8xxxxx.FRM ... Firmware
[\OBPW]
OBW8xxxx.EXE ... On-board Programming ROM Writer control software
RW8xxxx.INI ... Device information setup file
[\MPRW]
G8xxxxxx.EXE ... Multiple-Programming ROM Writer control software
:∗Refer to the technical manual for details of the ROM Writer and PROM programming.
Online manual in PDF format
The online manuals are provided in PDF format, so Adobe Acrobat Reader Ver. 4.0 or later is needed
to read it.
Files for future release models
The files for future release models will be provided in the Microcomputer User's Site of Seiko Epson.
Refer to the Readme file included in the package for installation.
2.5 Environment Settings
The following environment variables must be configured for the tools in this package:
SET PATH=C:\EPSON\S1C88\BIN;%PATH%
SET C88INC=C:\EPSON\S1C88\INCLUDE
SET C88LIB=C:\EPSON\S1C88\LIB
Run addpath.bat in which the above commands are described before using the tools.
When you select another directory at installation, "EPSON\S1C88\" shown above is changed to that
directory name.
However, wb88 automatically configures the environment variables at start-up, so it is not necessary to
run addpath.bat when invoking the tools from wb88.