Epson S5U1C62000A User Manual
MF1121-03a
CMOS 4-BIT SINGLE CHIP MICROCOMPUTER
S5U1C62000A
(S1C60/62 Family Assembler Package)
Manual
NOTICE
No part of this material may be reproduced or duplicated in any form or by any means without the written permission of Seiko
Epson. Seiko Epson reserves the right to make changes to this material without notice. Seiko Epson does not assume any
liability of any kind arising out of any inaccuracies contained in this material or due to its application or use in any product or
circuit and, further, there is no representation that this material is applicable to products 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 International Trade and Industry or other approval from another government agency.
Windows 95, Windows 98 and Windows NT 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 CORPORA TION 2002, All rights reserved.
Configuration of product number
Devices
S1 C 60N01 F 0A01
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
Model number
Model name
C: microcomputer, digital products
Product classification
S1: semiconductor
Development tools
S5U1 C 60R08 D1 1
00
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
60R08: for S1C60R08
Tool classification
C: microcomputer use
Product classification
S5U1: development tool for semiconductor products
INTRODUCTION
Introduction
This document describes the development procedure from assembling source files to debugging. It also
explains how to use each development tool of the S1C62 Family Assembler Package common to all the
models of the S1C62 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:
• Basic knowledge about assembler language
• Basic knowledge about the general concept of program development by an assembler
• Basic operating methods for Windows
Before installation
See Chapter 1. Chapter 1 describes the composition of this package, and provides a general outline of
each tool.
Installation
Install the tools following the installation procedure described in Chapter 2.
To understand the flow of program development
See the program development flow in Chapter 3.
For coding
See the necessary parts in Chapter 5. Chapter 5 describes the grammar for the assembler language as
well as the assembler functions. Also refer to the following manuals when coding:
S1C62xxx T echnical Manual
Covers device specifications, and the operation and control method of the peripheral circuits.
S1C6200/6200A Core CPU Manual
Has the instructions and details the functions and operation of the Core CPU.
®
95 or Windows NT®4.0
For debugging
Chapter 9 gives detailed explanation of the debugger. Sections 9.1 to 9.8 give an overview of the
functions of the debugger. See Section 9.9 for details of the debug commands. Also refer to the following manuals to understand operations of the In-Circuit Emulator ICE (S5U1C62000H) and the Evaluation Board (S5U1C62xxxE):
S5U1C62000H Manual
Explains the functions and handling methods of the In-Circuit Emulator ICE.
S5U1C62xxxE Manual
Covers the functions and handling methods of the evaluation board designed to evaluate the
hardware specifications of each model.
For details of each tool
Chapters 4 to 9 explain the details of each tool. Refer to it if necessary.
Once familiar with this package
Refer to the listings of instructions and commands contained in Quick Reference.
S5U1C62000A MANUAL EPSON i
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
INTRODUCTION
Manual Notations
This manual was prepared by following the notation rules detailed below:
(1) Sample screens
The sample screens provided in the manual are all examples of displays under Windows®95. These
displays may vary according to the system or fonts used.
(2) 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 | Exit] menu item ([Exit]
command in [File] menu), [Key Break] button, [q] key, etc.
(3) 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.
(4) 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. Moreover, a hexadecimal number may be expressed as xxxxh, or a
binary number as xxxxb, for reasons of convenience of explanation.
(5) Mouse operations
To c lick: 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".
(6) 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 [ ].
Moreover, the operation of pressing the [Enter] key in sample entries is represented by "↵".
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.
(7) 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, <file
name> needs to be replaced with an actual file name.
Items enclosed in { } and separated with | indicate that you should choose an item. For example, {A |
B} needs to have either A or B selected.
ii EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CONTENTS
Contents
CHAPTER 1GENERAL ................................................................................................ 1
1.1 Features.........................................................................................................1
1.2 Tool Composition ..........................................................................................2
1.2.1 Composition of Package.............................................................................. 2
1.2.2 Outline of Software Tools ............................................................................ 2
CHAPTER 2INSTALLATION .......................................................................................... 3
2.1 Working Environment ....................................................................................3
2.2 Installation Method ....................................................................................... 4
2.3 Directories and Files after Installation.........................................................6
CHAPTER 3SOFTWARE DEVELOPMENT PROCEDURE ..................................................... 7
3.1 Software Development Flow .........................................................................7
3.2 Development Using Work Bench ................................................................... 8
3.2.1 Starting Up the Work Bench ........................................................................ 8
3.2.2 Creating a New Project............................................................................... 9
3.2.3 Editing Source Files .................................................................................... 9
3.2.4 Configuration of Tool Options ................................................................... 11
3.2.5 Building an Executable Object .................................................................. 12
3.2.6 Debugging.................................................................................................. 13
CHAPTER 4WORK BENCH......................................................................................... 14
4.1 Features........................................................................................................14
4.2 Starting Up and Terminating the Work Bench.............................................. 14
4.3 Work Bench Windows ................................................................................... 15
4.3.1 Window Configuration ............................................................................... 15
4.3.2 Window Manipulation ................................................................................ 16
4.4 Toolbar and Buttons ..................................................................................... 20
4.4.1 Standard Toolbar........................................................................................ 20
4.4.2 Build Toolbar ............................................................................................. 21
4.4.3 Window Toolbar ......................................................................................... 21
4.4.4 Toolbar Manipulation ................................................................................ 22
4.4.5 [Insert into project] Button on a [Edit] Window........................................ 22
4.5 Menus ........................................................................................................... 23
4.5.1 [File] Menu ................................................................................................ 23
4.5.2 [Edit] Menu................................................................................................ 24
4.5.3 [View] Menu............................................................................................... 24
4.5.4 [Insert] Menu ............................................................................................. 25
4.5.5 [Build] Menu.............................................................................................. 25
4.5.6 [Tools] Menu.............................................................................................. 25
4.5.7 [Window] Menu ......................................................................................... 26
4.5.8 [Help] Menu .............................................................................................. 26
4.6 Project and Work Space ...............................................................................27
4.6.1 Creating a New Project.............................................................................. 27
4.6.2 Inserting Sources into a Project................................................................. 28
4.6.3 [Project] Window ....................................................................................... 29
4.6.4 Opening and Closing a Project.................................................................. 29
4.6.5 Files in the Work Space Folder ................................................................... 30
S5U1C62000A MANUAL EPSON iii
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CONTENTS
4.7 Source Editor ............................................................................................... 31
4.7.1 Creating a New Source or Header File...................................................... 31
4.7.2 Loading and Saving Files .......................................................................... 32
4.7.3 Edit Function ............................................................................................. 33
4.7.4 Tag Jump Function ..................................................................................... 36
4.7.5 Printing ...................................................................................................... 37
4.8 Build Task ..................................................................................................... 37
4.8.1 Preparing a Build Task .............................................................................. 37
4.8.2 Building an Executable Object .................................................................. 37
4.8.3 Debugging.................................................................................................. 38
4.8.4 Executing Other Tools ................................................................................ 39
4.9 Tool Option Settings ..................................................................................... 41
4.9.1 Assembler Options ..................................................................................... 41
4.9.2 Linker Options ........................................................................................... 42
4.9.3 Debugger Options ...................................................................................... 44
4.9.4 HEX Converter Options ............................................................................. 44
4.10 Short-Cut Key List........................................................................................ 45
4.11 Error Messages ............................................................................................45
4.12 Precautions ..................................................................................................46
CHAPTER 5ASSEMBLER ............................................................................................ 47
5.1 Functions...................................................................................................... 47
5.2 Input/Output Files ........................................................................................ 47
5.2.1 Input File.................................................................................................... 47
5.2.2 Output Files................................................................................................ 48
5.3 Starting Method............................................................................................ 49
5.4 Messages ......................................................................................................50
5.5 Grammar of Assembly Source ...................................................................... 51
5.5.1 Statements .................................................................................................. 51
5.5.2 Instructions (Mnemonics and Pseudo-instructions) .................................. 53
5.5.3 Labels ......................................................................................................... 54
5.5.4 Comments................................................................................................... 56
5.5.5 Blank Lines ................................................................................................ 56
5.5.6 Register Names .......................................................................................... 56
5.5.7 Numerical Notations .................................................................................. 57
5.5.8 Symbols ...................................................................................................... 58
5.5.9 Operators ................................................................................................... 58
5.5.10 Location Counter Symbol "$" .................................................................. 60
5.6 Section Management .................................................................................... 61
5.6.1 Definition of Sections ................................................................................. 61
5.6.2 Absolute and Relocatable Sections ............................................................ 61
5.6.3 Sample Definition of Sections .................................................................... 62
5.7 Assembler Pseudo-Instructions.................................................................... 63
5.7.1 Include Instruction (#include).................................................................... 64
5.7.2 Define Instruction (#define) ....................................................................... 65
5.7.3 Macro Instructions (#macro ... #endm)...................................................... 67
5.7.4 Conditional Assembly Instructions
(#ifdef ... #else ... #endif, #ifndef... #else ... #endif) ................................... 69
5.7.5 Section Defining Pseudo-Instructions (.code, .bss) ................................... 71
5.7.6 Location Defining Pseudo-Instructions (.org, .bank, .page, .align) .......... 72
5.7.7 Symbol Defining Pseudo-Instruction (.set) ................................................ 77
5.7.8 Data Defining Pseudo-Instruction (.codeword)......................................... 78
5.7.9 Area Securing Pseudo-Instructions (.comm, .lcomm)................................ 79
iv EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CONTENTS
5.7.10 Global Declaration Pseudo-Instruction (.global).................................... 80
5.7.11 List Control Pseudo-Instructions (.list, .nolist)........................................ 81
5.7.12 Source Debugging Information Pseudo-Instructions (.stabs, .stabn)...... 81
5.7.13 Comment Adding Function ...................................................................... 82
5.7.14 Priority of Pseudo-Instructions................................................................ 82
5.8 Summary of Compatibility with the Older Tool ...........................................83
5.9 Relocatable List File ....................................................................................84
5.10 Sample Executions ....................................................................................... 85
5.11 Error/Warning Messages.............................................................................. 87
5.11.1 Errors ....................................................................................................... 87
5.11.2 W arning .................................................................................................... 88
5.12 Precautions ..................................................................................................88
CHAPTER 6LINKER .................................................................................................. 89
6.1 Functions...................................................................................................... 89
6.2 Input/Output Files ........................................................................................ 89
6.2.1 Input Files .................................................................................................. 89
6.2.2 Output Files................................................................................................ 90
6.3 Starting Method............................................................................................ 91
6.4 Messages ......................................................................................................94
6.5 Linker Command File................................................................................... 95
6.6 Link Map File............................................................................................... 96
6.7 Symbol File...................................................................................................97
6.8 Absolute List File ......................................................................................... 98
6.9 Cross Reference File .................................................................................... 99
6.10 Linking ........................................................................................................100
6.11 Automatic Insertion/Removal/Correction of "pset" Instruction.................. 102
6.12 Error/Warning Messages............................................................................. 103
6.12.1 Errors ...................................................................................................... 103
6.12.2 W arning ................................................................................................... 103
6.13 Precautions .................................................................................................104
CHAPTER 7HEX CONVERTER ................................................................................... 105
7.1 Functions..................................................................................................... 105
7.2 Input/Output Files ....................................................................................... 105
7.2.1 Input Files ................................................................................................. 105
7.2.2 Output Files............................................................................................... 105
7.3 Starting Method........................................................................................... 106
7.4 Messages .....................................................................................................107
7.5 Output Hex Files ......................................................................................... 108
7.5.1 Hex File Configuration ............................................................................. 108
7.5.2 Intel-HEX Format ..................................................................................... 108
7.5.3 Motorola-S Format.................................................................................... 109
7.5.4 Conversion Range ..................................................................................... 109
7.6 Error/Warning Messages............................................................................. 110
7.6.1 Errors ........................................................................................................ 110
7.6.2 W arning ..................................................................................................... 110
7.7 Precautions ................................................................................................. 111
S5U1C62000A MANUAL EPSON v
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CONTENTS
CHAPTER 8DISASSEMBLER ...................................................................................... 112
8.1 Functions..................................................................................................... 112
8.2 Input/Output Files ....................................................................................... 112
8.2.1 Input Files ................................................................................................. 112
8.2.2 Output Files............................................................................................... 112
8.3 Starting Method........................................................................................... 113
8.4 Messages .....................................................................................................114
8.5 Disassembling Output ................................................................................. 115
8.6 Error/Warning Messages............................................................................. 118
8.6.1 Errors ........................................................................................................ 118
8.6.2 W arning ..................................................................................................... 118
CHAPTER 9DEBUGGER ............................................................................................ 119
9.1 Features.......................................................................................................119
9.2 Input/Output Files ....................................................................................... 119
9.2.1 Input Files ................................................................................................. 119
9.2.2 Output Files............................................................................................... 120
9.3 Starting Method........................................................................................... 121
9.3.1 Start-up Format......................................................................................... 121
9.3.2 Start-up Options........................................................................................ 121
9.3.3 Start-up Messages ..................................................................................... 122
9.3.4 Hardware Check at Start-up ..................................................................... 122
9.3.5 Method of Termination .............................................................................. 123
9.4 Windows ...................................................................................................... 124
9.4.1 Basic Structure of Window ........................................................................ 124
9.4.2 [Command] Window ................................................................................. 126
9.4.3 [Source] Window....................................................................................... 127
9.4.4 [Data] Window.......................................................................................... 129
9.4.5 [Register] Window .................................................................................... 129
9.4.6 [Trace] Window......................................................................................... 130
9.5 Tool Bar....................................................................................................... 131
9.5.1 Tool Bar Structure ..................................................................................... 131
9.5.2 [Key Break] Button ................................................................................... 131
9.5.3 [Load File] and [Load Option] Buttons ................................................... 131
9.5.4 [Source], [Mix], and [Unassemble] Buttons ............................................ 131
9.5.5 [Go], [Go to Cursor], [Go from Reset], [Step], [Next],
and [Reset] Buttons................................................................................... 131
9.5.6 [Break] Button .......................................................................................... 132
9.5.7 [Help] Button ............................................................................................ 132
9.6 Menu............................................................................................................ 133
9.6.1 Menu Structure.......................................................................................... 133
9.6.2 [File] Menu ............................................................................................... 133
9.6.3 [Run] Menu ............................................................................................... 133
9.6.4 [Break] Menu............................................................................................ 134
9.6.5 [Trace] Menu ............................................................................................ 134
9.6.6 [View] Menu.............................................................................................. 134
9.6.7 [Option] Menu .......................................................................................... 135
9.6.8 [Windows] Menu....................................................................................... 135
9.6.9 [Help] Menu ............................................................................................. 135
9.7 Method for Executing Commands...............................................................136
9.7.1 Entering Commands from Keyboard......................................................... 136
9.7.2 Executing from Menu or Tool Bar............................................................. 138
9.7.3 Executing from a Command File .............................................................. 139
9.7.4 Log File ..................................................................................................... 140
vi EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CONTENTS
9.8 Debug Functions .........................................................................................141
9.8.1 Loading Program and Option Data.......................................................... 141
9.8.2 Source Display and Symbolic Debugging Function ................................. 142
9.8.3 Displaying and Modifying Program, Data, and Register ......................... 144
9.8.4 Executing Program ................................................................................... 146
9.8.5 Break Functions ........................................................................................ 148
9.8.6 Trace Functions......................................................................................... 150
9.8.7 Coverage ................................................................................................... 153
9.9 Command Reference ................................................................................... 154
9.9.1 Command List ........................................................................................... 154
9.9.2 Reference for Each Command .................................................................. 155
9.9.3 Program Memory Operation..................................................................... 156
as (assemble mnemonic).............................................................. 156
pe (program memory enter)......................................................... 158
pf (program memory fill) ............................................................. 159
pm (program memory move)........................................................ 160
9.9.4 Data Memory Operation........................................................................... 161
dd (data memory dump)............................................................... 161
de (data memory enter) ............................................................... 163
df (data memory fill) .................................................................... 165
dm (data memory move) .............................................................. 166
9.9.5 Register Operation .................................................................................... 167
rd (register display) ..................................................................... 167
rs (register set)............................................................................. 168
9.9.6 Program Execution ................................................................................... 169
g (go) ........................................................................................... 169
gr (go after reset CPU)................................................................ 171
s (step) ......................................................................................... 172
n (next) ......................................................................................... 173
9.9.7 CPU Reset ................................................................................................. 174
rst (reset CPU)............................................................................. 174
9.9.8 Break ......................................................................................................... 175
bp (break point set)...................................................................... 175
bpc (break point clear) ................................................................ 177
bd (data break) ............................................................................ 178
bdc (data break clear) ................................................................. 180
br (register break) ........................................................................ 181
brc (r egister break clear) ............................................................. 183
bm (multiple break) ..................................................................... 184
bmc (multiple break clear) .......................................................... 186
bl (break point list) ...................................................................... 187
bac (break all clear) .................................................................... 188
be (break enable) ......................................................................... 189
bsyn (break disable)..................................................................... 190
9.9.9 Program Display....................................................................................... 191
u (unassemble)............................................................................. 191
sc (source code) ........................................................................... 192
m (mix)......................................................................................... 193
9.9.10 Symbol Information................................................................................. 194
sy (symbol list) ............................................................................. 194
9.9.11 Load File................................................................................................. 195
lf (load file) .................................................................................. 195
lo (load option) ............................................................................ 196
9.9.12 ROM Access ............................................................................................ 197
rp (ROM program load)............................................................... 197
vp (ROM program verify) ............................................................ 198
rom (ROM type) ........................................................................... 199
S5U1C62000A MANUAL EPSON vii
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CONTENTS
9.9.13 Trace........................................................................................................ 200
tc (trace condition) ...................................................................... 200
ta (trace area).............................................................................. 201
tac (trace area clear)................................................................... 203
tp (trace pointer).......................................................................... 204
td (trace data display) ................................................................. 205
ts (trace search) ........................................................................... 207
tf (trace file) ................................................................................. 209
9.9.14 Coverage ................................................................................................. 210
cv (coverage) ............................................................................... 210
cvc (coverage clear) .................................................................... 211
9.9.15 Command File......................................................................................... 212
com (execute command file) ........................................................ 212
rec (record commands to a file)................................................... 213
9.9.16 log ........................................................................................................... 214
log (log) ....................................................................................... 214
9.9.17 Map Information ..................................................................................... 215
ma (map information).................................................................. 215
9.9.18 Mode Setting ........................................................................................... 216
otf (on-the-fly display) ................................................................. 216
tim (time or step mode)................................................................ 217
9.9.19 Self Diagnosis ......................................................................................... 218
chk (self diagnostic test) .............................................................. 218
9.9.20 Quit ......................................................................................................... 219
q (quit) ......................................................................................... 219
9.10 Error/Warning Messages.............................................................................. 220
QUICK REFERENCE ................................................................................................... 221
viii EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL
CHAPTER 1GENERAL
1.1 Features
The S1C62 Family Assembler Package contains software development tools that are common to all the
models of the S1C62 Family. The package comes as an efficient working environment for development
tasks, ranging from source program assembly to debugging.
Its principal features are as follows:
Simple composition
A task from assembly to debugging can be made with minimal tools.
Integrated working environment
A Windows-based integrated environment allows the tool chain to be used on its Windows GUI
interface.
Modular programming
The relocatable assembler lets you develop a program which is made up of multiple sources. This
makes it possible to keep a common part independently and to use it as a part or a basis for the next
program.
Source debugging
A debugger can display an assembler source to show its execution status and allow debugging
operations on it. This makes debugging much easier to perform.
Common to all S1C62 chips
The tools (workbench, assembler, linker, hex converter, disassembler, and debugger) are common to
all S1C62 Family models except for several chip dependent masking tools ("Dev" tools). The chip
dependent information is read from the ICE parameter file for each chip.
Complete compatibility with old syntax sources
By supporting old syntax together with the new syntax, an existing ".dat" sources written for old 62
tools are available with these new tools.
S5U1C62000A MANUAL EPSON 1
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL
1.2 Tool Composition
1.2.1 Composition of Package
The S1C62 Family Assembler Package contains the items listed below. When it is unpacked, make sure
that all items are supplied.
1) CD-ROM................................................................................. One
2) Warranty card ......................................................................... One each in English and Japanese
1.2.2 Outline of Software Tools
The following shows the outlines of the software tools included in the package:
Assembler (as62.exe)
Converts the mnemonic of the source files into object codes (machine language) of the S1C62. The
results are output in a relocatable object file. This assembler includes preprocessing functions such as
macro definition/call, conditional assembly, and file-include functions.
Linker (lk62.exe)
Links the relocatable objects created by the assembler by fixing the memory locations, and creates
executable absolute object codes. The linker also provides an auto PSET insertion/correction function
allowing the programmer to create sources without having to know branch destination page numbers.
Hex converter (hx62.exe)
Converts an absolute object in IEEE-695 format output from the linker into ROM-image data in IntelHEX format or Motorola-S format. This conversion is needed when making the ROM or when creating mask data using the development tools provided with each model.
Disassembler (ds62.exe)
Disassembles an absolute object file in IEEE-695 format or a hex file in Intel-HEX format, and restores
it to a source format file. The restored source file can be processed in the assembler/linker/hex
converter to obtain the same object or hex file.
Debugger (db62.exe)
This software performs debugging by controlling the ICE hardware tool. 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. The debugger has both Windows
and DOS user interfaces available.
Work Bench (wb62.exe)
This software provides an integrated development environment with Windows GUI. Creating/
editing source files, selecting files and major start-up options, and the start-up of each tool can be
made with simple Windows operations.
2 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: INSTALLATION
CHAPTER 2INST ALLATION
This chapter describes the required working environments for the tools supplied in the S1C62
Family Assembler Package and their installation methods.
2.1 Working Environment
To use the S1C62 Family Assembler Package, the following conditions are necessary:
Personal computer
An IBM PC/AT or a compatible machine which is equipped with a CPU equal to or better than a
Pentium 75 MHz, and 32MB or more of memory is recommended.
To use the optional In-Circuit Emulator ICE, the personal computer also requires a serial port (with a
D-sub 9 pin).
Display
A display unit capable of displaying 800 × 600 dots or more is necessary.
Hard disk and CD-ROM drive
Since the installation is done from a CD-ROM to a hard disk, a CD-ROM drive and a hard disk drive
are required.
Mouse
A mouse is necessary to operate the tools.
System software
The S1C62 Family Assembler Package supports Microsoft
Windows NT
Other development tools
To debug the target program, the optional In-Circuit Emulator ICE (S5U1C62000H) and an Evaluation
Board (S5U1C62xxxE) are needed as the hardware tools.
The evaluation board is prepared for each S1C62 model.
®
4.0 (English or Japanese).
®
Windows®95 (English or Japanese) and
S5U1C62000A MANUAL EPSON 3
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: INSTALLATION
2.2 Installation Method
The supplied CD-ROM contains the installer (Setup.exe) that installs the tools.
To install the tools
(1) Start up Windows
When Windows has already activated, terminate all
the programs activated.
(2) Insert the CD-ROM into the CD-ROM drive, and
display its contents.
(3) Start up the Setup.exe by double-clicking the icon.
Welcome
(4) Click [Next>] to continue installation.
®
95 or Windows NT®4.0.
Choose Destination Location
A dialog box appears for specifying the installation
directory.
(5) Click [Next>] if the default directory
"C:\EPSON\S1C62" is not changed to another
directory.
To install the tools to another directory
Open the [Choose Folder] dialog box by clicking
[Browse...] and then enter the path name or choose
directory. Close the dialog box by clicking [OK] and
then click [Next>].
The installation starts after this selection.
4 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: INSTALLATION
InstallShield Wizard Complete
(6) Click [Finish] to terminate the installer.
Program Menu
Installer registers the WorkBench62 icon to the program
menu.
To discontinue installation
The dialog boxes that appear during installation have a [Cancel] button. To discontinue installation,
click [Cancel] when a dialog box appears.
To uninstall the tools
Use [Add/Remove Programs] in the control panel to uninstall the tools.
S5U1C62000A MANUAL EPSON 5
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: INSTALLATION
2.3 Directories and Files after Installation
The installer copies the following files in the specified directory (default is "C:\EPSON\S1C62"):
[Specified folder]
README.TXT ... ReadMe document
[bin]
WB62.EXE ... Work bench
AS62.EXE ... Assembler
LK62.EXE ... Linker
HX62.EXE ... Hex converter
DS62.EXE ... Disassembler
DB62.EXE ... Debugger
IEEE695.DLL ... Object format library for debugger
HEXLIB.DLL ... Hex file library for debugger
AS62.DLL ... Inline assembler for debugger
CORE62.DLL ... CPU library for debugger
ICE62.DLL ... ICE library for debugger
MSVCRT.DLL ... Run time library for work bench
OLEPRO32.DLL ... OLE library for work bench
SPAWNEX.EXE ... Child task library for work bench
[doc]
[English] ... Manual folder (English)
MANUAL_E.PDF ... S5U1C62000A Manual
DEV_MANUAL_E.PDF ... S1C60/62 Family Development Tool Manual
[Japanese] ... Manual folder (Japanese)
MANUAL_J.PDF ... S5U1C62000A Manual
DEV_MANUAL_J.PDF ... S1C60/62 Family Development Tool Manual
[dev62]
[bin]
WINFOG.EXE ... Function option generator
WINSOG.EXE ... Segment option generator
WINMDC.EXE ... Mask data checker
WINMLA.EXE ... Melody assembler
[62XXX] ... Model-dependent files for development tools
:
[dos]
:
... Model-dependent files for development tools (DOS version)
Note: Work bench assumes the above directory structure. Do not rename these folders or file names and
do not change the tree structure.
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.
6 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
CHAPTER 3
S
OFTW ARE
D
EVELOPMENT PROCEDURE
This chapter outlines a basic development procedure.
3.1 Software Development Flo w
Figure 3.1.1 represents a flow of software development work.
Work Bench
wb62
hx62
file.CM
file.SYMSymbol file
file.MAP file.XRFLink map file
Intel-HEX
format files
fileL.HEX
or
Assembly
source file(s)
fileH.HEX
Assembler
as62
file.Ofile.LST
Object
file(s)
Linker
lk62
file.ABS
Absolute
object file
file.MS
Preprocessed
source file(s)
file.ALS
Absolute
list file
Cross
reference
file
Make
file.MAK file.DAT
file
file.S
command file
Motorola-S
format files
or
Assembly
list file(s)
Linker
HEX converter
file.HSA
file.LSA
Development tools for each model
file.par
Function Option
Generator fog62XX
fileF.HEX fileF.DOC
Function option
HEX file
Generator sog62XX
fileS.HEX
Segment option
HEX file
Melody Assembler
fileA.HEX
Melody
HEX file
Function option
document file
file.SEG
Segment Option
fileS.DOC
Segment option
document file
file.mel
mla62XX
fileA.DOC
document file
Segment option
source file
Melody
data file
Melody
Mask Data Checker
mdc62XX
Mask
file.PAn
data file
Debugger
db62
In-Circuit Emulator
Disassembler
ds62
file.MS
Disassembled
source file
Fig. 3.1.1 Software development flow
The work bench provides an integrated development environment from source editing to debugging.
Tools such as the assembler and linker can be invoked from the work bench. The tools can also be invoked individually from the DOS prompt.
Refer to the respective chapter for details of each tool.
The part indicated as "Development tools for each model" is not covered in this manual. For details, refer
to the tool manual associated with each specific model.
S5U1C62000A MANUAL EPSON 7
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
3.2 Development Using W ork Bench
This section shows a basic development procedure using the work bench wb62.
Refer to Chapter 4, "Work Bench", for operation details.
3.2.1 Starting Up the Work Bench
Start up the work bench by choosing "WorkBench62" from the program menu.
8 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
3.2.2 Creating a New Project
The work bench manages necessary file and tool setting information as a project.
First a new project file should be created.
1. Select [New] from the [File] menu (or click the [New] button).
[New] button
The [New] dialog box appears.
2. Select [E0C Project File] and click [OK].
The [Project] dialog box appears.
3. Enter a project name, select an ICE parameter file and select a
directory, then click [OK].
∗ The [ICE parameter file:] box lists the parameter files that exist
in the "dev62" directory.
The work bench creates a folder (directory) with the specified
project name as a work space, and puts the project file (.epj) into
the folder.
The specified project name will also be used for the absolute object
and other files.
Created project [Project] window
3.2.3 Editing Source Files
The work bench has an editor function. This makes it possible to edit source files without another editor.
To create a new source file:
1. Select [New] from the [File] menu (or click the [New] button).
[New] button
The [New] dialog box appears.
2. Select [E0C Assembly Source File] and click [OK].
S5U1C62000A MANUAL EPSON 9
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
[Edit] windowA new edit window appears.
3. Enter source codes in the [Edit] window.
4. Save the source in a file by selecting [Save] from the [File] menu (or clicking the [Save] button).
[Save] button
10 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
5. Click the [Insert into project] button on the [Edit] window.
[Insert into project] button
The created source file is added in the project.
To add existing source files, use [Files into project...] in the [Insert] menu. It can also be done by dragging
source files from Windows Explorer to the project window.
Create necessary source files and add them into the project.
Sample list in the [Project] window
The added source files are listed in the project window. Double-clicking a listed source file name opens
the edit window.
3.2.4 Configuration of Tool Options
The work bench supports all the start up options of each tool and they can be selected in a dialog box. A
make process for generating an executable object will be configured based on the settings.
In addition to option selection, command files for the linker and debugger can be configured here.
To set tool options:
1. Select [Setting...] from the [Build] menu.
A dialog box appears.
2. Configure options if necessary.
Check box items can be selected by clicking. Items in the list can be toggled or entered by doubleclicking.
Refer to Chapter 4, "Work Bench", for details of the [Settings] dialog box.
S5U1C62000A MANUAL EPSON 11
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
3.2.5 Building an Executable Object
To make an executable object file:
1. Select [Build] from the [Build] menu (or click the [Build] button).
[Build] button
This will invoke the assembler and linker to create an executable object file. If a HEX file format (Intel
HEX or Motorola S) is selected by the [Output format] box, the HEX converter will be invoked after
linking. By default, an absolute object file in IEEE-695 format will be created.
[Output format] box
Messages delivered from each executed tool are displayed in the [Output] window. The work bench has a
tag-jump function that jumps to the source line in which an error has occurred by double-clicking a
source syntax error message that appears in the [Output] window. It opens the corresponding source
window if it is closed.
Linked with the corresponding source line
[Output] window
In the build task, a general make process is executed to update the least necessary files. To rebuild all the
files without the make function, select [Rebuild All] from the [Build] menu (or click the [Rebuild All]
button).
[Rebuild All] button
To invoke the assembler only to correct syntax errors, select [Assemble] in the [Built] menu (or click the
[Assemble] button).
[Assemble] button
12 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE
3.2.6 Debugging
To debug the executable object:
1. Select [Debug] from the [Build] menu (or click the [Debug] button).
[Debug] button
The debugger starts up with the specified ICE parameter file and then loads the executable object file.
Note: Make sure that the ICE is ready to debug before invoking the debugger. Refer to the ICE hardware
manual for settings and startup method of the ICE.
For the debugging functions and operations, refer to Chapter 9, "Debugger".
S5U1C62000A MANUAL EPSON 13
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 4: WORK BENCH
CHAPTER 4WORK BENCH
This chapter describes the functions and operating method of the Work Bench wb62.
4.1 Features
The Work Bench wb62 provides an integrated operating environment ranging from editing source files to
debugging. Its functions and features are summarized below:
• Source edit function that supports copy/paste, find/replace, print, label jump and tag jump from error
messages.
• Allows simple management of all necessary files and information as a project.
• General make process to invoke necessary tools and to update the least necessary files.
• Supports all options of the assembler, linker, HEX converter, disassembler and debugger.
•Windows GUI interface for simple operation.
4.2 Starting Up and Terminating the Work Bench
To start up the work bench
Choose "WorkBench62" from the [Program] menu to
start up the work bench.
∗ If "WorkBench62" is not registered in the [Program]
menu, it means that the installation was not successful. Therefore, reinstall the tools by referring to
Chapter 2, "Installation".
When the work bench starts up, the window shown
below appears.
To terminate the work bench
Select [Exit] from the [File] menu.
14 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
4.3 Work Bench Windows
4.3.1 Windo w Configuration
Menu bar Toolbar [Edit] window
CHAPTER 4: WORK BENCH
[Project] window [Output] window Status bar
The work bench has three types of windows: [Edit] window, [Project] window and [Output] window.
[Edit] window
This window is used for editing a source file. A standard text file can also be displayed in this window. Two or more windows can be opened in the edit window area.
When an E0C62 assembly source file is opened, the source is displayed with in colors according to the
contents.
S1C62 instructions: Black
Preprocess (#) pseudo-instructions: Dark brown
Assemble (.) pseudo-instructions: Blue
Labels: Light brown
Comments: Green
[Project] window
This window shows the currently opened work space folder and lists all the source files in the project,
with a structure similar to Windows Explorer.
Double-clicking a source file icon opens the source file in the [Edit] window.
S5U1C62000A MANUAL EPSON 15
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 4: WORK BENCH
[Output] window
This window displays the messages delivered from the executed tools in a build or assemble process.
Double-clicking a syntax error message with a source line number displayed in this window activates
or opens the [Edit] window of the corresponding source so that the source line in which the error has
occurred can be viewed.
Menu bar
Refer to Section 4.5.
Toolbar
Refer to Section 4.4.
Status bar
Shows help messages when the mouse cursor is placed on a menu item or a button.
It also indicates the cursor position in the [Edit] window, Key lock status (Num lock, Caps lock, Scroll
lock).
4.3.2 Windo w Manipulation
Resizing the windows
Each window area can be
resized by dragging the window boundary. The size
information is saved when the
work bench is terminated. So
the same window layout will
appearat the next time the work
bench starts up.
←| |→
←| |→
Double click
Floating and docking the
[Project] and [Output]
window
The [Project] window and the
[Output] window can be made
a floating window by doubleclicking the window boundary
and the floating window can be
moved and resized in the work
bench window. The floating
window will be restored to a
docking window by double
clicking the window's title bar
or dragging the title bar
towards an edge of the work
bench window.
16 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 4: WORK BENCH
Closing the [Project] and [Output] window
The [Project] window and the [Output] window can be closed by selecting [Project Window] and
[Output Window] from the [View] menu, respectively. To open them, select the menu items again.
Maximizing the [Edit] window area
The [Edit] window area can be
maximized to the full screen size by
selecting [Full Screen] from the
[View] menu. All other windows
and toolbars are hidden behind the
[Edit] window area.
To return it to the normal display,
click the button that appears on the
screen. This button can be moved
anywhere in the screen by dragging
its title bar. Pressing the [ESC] key
also returns the window to the
normal display.
Opening/Closing [Edit] windows
An [Edit] window opens when a source file (text file) is loaded using a menu, button or a file icon in
the [Project] window, or when a new source is created.
[Edit] windows close by clicking the [Close] box of each window or selecting [Close] from the [File]
menu.
When a project file is saved, the [Edit] window information (files opened, size and location) is also
saved. So the next time the project opens, editing can begin in the saved condition.
Arrangement of the [Edit] windows
The [Edit] windows being opened can be arranged similar to standard Windows applications.
1Cascade windows
Select [Cascade] from the [Window] menu or click the [Cascade Windows] button.
[Cascade Windows] button
S5U1C62000A MANUAL EPSON 17
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CHAPTER 4: WORK BENCH
2Tile windows
To tile windows vertically, select [Tile Vertically] from the [Window] menu or click the [Tile Vertically]
button.
[Tile Vertically] button
To tile windows horizontally, select [Tile Horizontally] from the [Window] menu or click the [Tile
Horizontally] button.
[Tile Horizontally] button
18 EPSON S5U1C62000A MANUAL
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
Loading...