How it Works
Epson
Loading...
S5U1C63000A
User Manual
346 pgs2.82 Mb0
Table of contents
Loading...

Epson S5U1C63000A User Manual

MF910-06
CMOS 4-BIT SINGLE CHIP MICROCOMPUTER
S5U1C63000A
(S1C63 Family Assembler Package)
Manual
NOTICE
MS-DOS, Windows, Windows 95, Windows 98 and Windows NT are registered trademarks of Microsoft Corporation, U.S.A. PC-DOS, PC/AT, PS/2, VGA, EGA and IBM are registered trademarks of International Business Machines Corporation, U.S.A. NEC PC-9800 Series and NEC are registered trademarks of NEC Corporation. All other product names mentioned herein are trademarks and/or registered trademarks of their respective owners.
© SEIKO EPSON CORPORATION 2001 All rights reserved.
The information of the product number change
Starting April 1, 2001, the product number will be changed as listed below. To order from April 1, 2001 please use the new product number. For further information, please contact Epson sales representative.
Configuration of product number
Devices
S1 C 63158 F 0A01
Development tools
S5U1
∗1: For details about tool types, see the tables below. (In some manuals, tool types are represented by one digit.) ∗2: Actual versions are not written in the manuals.
C 63000 A1 1
00
Packing specification Specification Package (D: die form; F: QFP) Model number Model name (C: microcomputer, digital products) Product classification (S1: semiconductor)
00
Packing specification Version (1: Version 1 ∗2) Tool type (A1: Assembler Package ∗1) Corresponding model number (63000: common to S1C63 Family) Tool classification (C: microcomputer use) Product classification (S5U1: development tool for semiconductor products)
Comparison table between new and previous number
S1C63 Family processors
Previous No.
E0C63158 E0C63256 E0C63358 E0C63P366 E0C63404 E0C63406 E0C63408 E0C63F408 E0C63454 E0C63455 E0C63458 E0C63466 E0C63P466
New No.
S1C63158 S1C63256 S1C63358 S1C6P366 S1C63404 S1C63406 S1C63408 S1C6F408 S1C63454 S1C63455 S1C63458 S1C63466 S1C6P466
Previous No.
E0C63467 E0C63557 E0C63558 E0C63567 E0C63F567 E0C63658 E0C63666 E0C63F666 E0C63A08 E0C63B07 E0C63B08 E0C63B58
New No.
S1C63467 S1C63557 S1C63558 S1C63567 S1C6F567 S1C63658 S1C63666 S1C6F666 S1C63A08 S1C63B07 S1C63B08 S1C63B58
S1C63 Family peripheral products
Previous No.
E0C5250 E0C5251
New No.
S1C05250 S1C05251
Comparison table between new and previous number of development tools
Development tools for the S1C63 Family Development tools for the S1C63/88 Family
Previous No.
ADP63366 ADP63466 ASM63 GAM63001 ICE63 PRC63001 PRC63002 PRC63004 PRC63005 PRC63006 PRC63007 URS63366
New No.
S5U1C63366X S5U1C63466X S5U1C63000A S5U1C63000G S5U1C63000H1 S5U1C63001P S5U1C63002P S5U1C63004P S5U1C63005P S5U1C63006P S5U1C63007P S5U1C63366Y
Previous No.
ADS00002 GWH00002 URM00002
New No.
S5U1C88000X1 S5U1C88000W2 S5U1C88000W1

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 "S1C63 Family Assembler Package" common to all the models of the S1C63 Family.

Caution

We are not responsible for any problems involving products you have manufactured using packed data created without the use of the tool contained in this package, or using packed data edited after being created using the tool contained in this package.

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 "setup_e.pdf".
®
95/98 or Windows NT®4.0
To understand the flow of program development
See the program development flow in Chapter 2.
For coding
See the necessary parts in Chapter 4. Chapter 4 describes the grammar for the assembler language as well as the assembler functions. Also refer to the following manuals when coding:
S1C63xxx T echnical Manual
Covers device specifications, and the operation and control method of the peripheral circuits.
S1C63000 Core CPU Manual
Has the instructions and details the functions and operation of the Core CPU.
For debugging
Chapter 8 gives detailed explanation of the debugger. Sections 8.1 to 8.8 give an overview of the functions of the debugger. See Section 8.9 for details of the debug commands. Also refer to the follow­ing manuals to understand operations of the In-Circuit Emulator (ICE) and the Peripheral Circuit Board S5U1C63xxxP:
S5U1C63000H1 Manual (S1C63 Family In-Circuit Emulator)
Explains the functions and handling methods of the ICE.
S5U1C63xxxP Manual (Peripheral Circuit Board for S1C63xxx)
Covers the functions and handling methods of the peripheral circuit board that provides the hardware specifications of each model to the ICE.
For details of each tool
Chapters 3 to 8 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 Appendices.
S5U1C63000A MANUAL EPSON i (S1C63 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/98. 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 lower­case characters are annotated in lowercase characters in this manual, except for user-specified sym­bols.
(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 click: The operation of pressing the left mouse button once, with the cursor (pointer)
placed in the intended location, is expressed as "to click". The clicking operation of the right mouse button is expressed as "to right-click".
To double-click: Operations of pressing the left mouse button twice in a row, with the cursor (pointer)
placed in the intended location, are all expressed as "to double-click".
To drag: The operation of clicking on a file (icon) with the left mouse button and holding it
down while moving the icon to another location on the screen is expressed as "to drag".
To select: The operation of selecting a menu command by clicking is expressed as "to select".
(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.
(8) Development tool name
ICE: Indicates S5U1C63000H1 (S1C63 Family In-Circuit Emulator).
ii EPSON S5U1C63000A MANUAL
(S1C63 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
1.3 Working Environment .................................................................................... 3
1.4 Installation ....................................................................................................4
1.5 Directories and Files after Installation.........................................................4
CHAPTER 2 SOFTWARE DEVELOPMENT PROCEDURE .................................................... 6
2.1 Software Development Flow .........................................................................6
2.2 Development Using Work Bench ................................................................... 7
2.2.1 Starting Up the Work Bench ........................................................................ 7
2.2.2 Creating a New Project ............................................................................... 8
2.2.3 Editing Source Files .................................................................................... 8
2.2.4 Configuration of Tool Options ................................................................... 10
2.2.5 Building an Executable Object .................................................................. 11
2.2.6 Debugging.................................................................................................. 12
CHAPTER 3WORK BENCH......................................................................................... 13
3.1 Features........................................................................................................13
3.2 Starting Up and Terminating the Work Bench.............................................. 13
3.3 Work Bench Windows ................................................................................... 14
3.3.1 Window Configuration ............................................................................... 14
3.3.2 Window Manipulation ................................................................................ 15
3.4 Toolbar and Buttons .....................................................................................19
3.4.1 Standard Toolbar........................................................................................ 19
3.4.2 Build Toolbar ............................................................................................. 20
3.4.3 Window Toolbar ......................................................................................... 20
3.4.4 Toolbar Manipulation ................................................................................ 21
3.4.5 [Insert into project] Button on a [Edit] Window........................................ 21
3.5 Menus ........................................................................................................... 22
3.5.1 [File] Menu ................................................................................................ 22
3.5.2 [Edit] Menu................................................................................................ 23
3.5.3 [View] Menu............................................................................................... 23
3.5.4 [Insert] Menu ............................................................................................. 24
3.5.5 [Build] Menu.............................................................................................. 24
3.5.6 [Tools] Menu.............................................................................................. 25
3.5.7 [Window] Menu ......................................................................................... 25
3.5.8 [Help] Menu .............................................................................................. 25
3.6 Project and Work Space ...............................................................................26
3.6.1 Creating a New Project .............................................................................. 26
3.6.2 Inserting Sources into a Project................................................................. 27
3.6.3 [Project] Window ....................................................................................... 28
3.6.4 Opening and Closing a Project.................................................................. 28
3.6.5 Files in the Work Space Folder................................................................... 29
3.7 Source Editor ............................................................................................... 30
3.7.1 Creating a New Source or Header File...................................................... 30
3.7.2 Loading and Saving Files .......................................................................... 31
3.7.3 Edit Function ............................................................................................. 32
3.7.4 Tag Jump Function ..................................................................................... 35
3.7.5 Printing ...................................................................................................... 36
S5U1C63000A MANUAL EPSON iii (S1C63 FAMILY ASSEMBLER PACKAGE)
CONTENTS
3.8 Build Task .....................................................................................................36
3.8.1 Preparing a Build Task .............................................................................. 36
3.8.2 Building an Executable Object .................................................................. 36
3.8.3 Debugging.................................................................................................. 37
3.8.4 Executing Other Tools ................................................................................ 38
3.9 Tool Option Settings .....................................................................................40
3.9.1 Assembler Options ..................................................................................... 40
3.9.2 Linker Options ........................................................................................... 41
3.9.3 Debugger Options ...................................................................................... 43
3.9.4 HEX Converter Options ............................................................................. 43
3.10 Work Bench Options..................................................................................... 44
3.11 Short-Cut Key List........................................................................................ 45
3.12 Error Messages ............................................................................................45
3.13 Precautions .................................................................................................. 46
CHAPTER 4ASSEMBLER ............................................................................................ 47
4.1 Functions......................................................................................................47
4.2 Input/Output Files ........................................................................................ 47
4.2.1 Input File.................................................................................................... 47
4.2.2 Output Files................................................................................................ 48
4.3 Starting Method............................................................................................ 49
4.4 Messages ......................................................................................................50
4.5 Grammar of Assembly Source ...................................................................... 51
4.5.1 Statements .................................................................................................. 51
4.5.2 Instructions (Mnemonics and Pseudo-instructions) .................................. 53
4.5.3 Symbols (Labels) ........................................................................................ 54
4.5.4 Comments................................................................................................... 56
4.5.5 Blank Lines ................................................................................................ 56
4.5.6 Register Names .......................................................................................... 57
4.5.7 Numerical Notations .................................................................................. 57
4.5.8 Operators ................................................................................................... 58
4.5.9 Location Counter Symbol "$" .................................................................... 60
4.5.10 Optimization Branch Instructions for Old Preprocessor ......................... 60
4.6 Section Management .................................................................................... 61
4.6.1 Definition of Sections ................................................................................. 61
4.6.2 Absolute and Relocatable Sections ............................................................ 61
4.6.3 Sample Definition of Sections .................................................................... 62
4.7 Assembler Pseudo-Instructions....................................................................63
4.7.1 Include Instruction (#include).................................................................... 64
4.7.2 Define Instruction (#define) ....................................................................... 65
4.7.3 Numeric Define Instruction (#defnum) ...................................................... 67
4.7.4 Macro Instructions (#macro ... #endm) ...................................................... 68
4.7.5 Conditional Assembly Instructions
(#ifdef ... #else ... #endif, #ifndef... #else ... #endif) .................................. 70
4.7.6 Section Defining Pseudo-Instructions (.code, .data, .bss) ......................... 72
4.7.7 Location Defining Pseudo-Instructions (.org, .align)................................ 74
4.7.8 Absolute Assembling Pseudo-Instruction (.abs) ........................................ 77
4.7.9 Symbol Defining Pseudo-Instruction (.set) ................................................ 78
4.7.10 Data Defining Pseudo-Instructions (.codeword, .word) .......................... 79
4.7.11 Area Securing Pseudo-Instructions (.comm, .lcomm).............................. 80
4.7.12 Global Declaration Pseudo-Instruction (.global).................................... 81
4.7.13 List Control Pseudo-Instructions (.list, .nolist)........................................ 81
4.7.14 Source Debugging Information Pseudo-Instructions (.stabs, .stabn)...... 81
4.7.15 Comment Adding Function ...................................................................... 82
4.7.16 Priority of Pseudo-Instructions................................................................ 82
iv EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CONTENTS
4.8 Relocatable List File ....................................................................................83
4.9 Sample Executions ....................................................................................... 84
4.10 Error/Warning Messages..............................................................................87
4.10.1 Errors ....................................................................................................... 87
4.10.2 W arning .................................................................................................... 88
4.11 Precautions .................................................................................................. 88
CHAPTER 5LINKER .................................................................................................. 89
5.1 Functions......................................................................................................89
5.2 Input/Output Files ........................................................................................ 89
5.2.1 Input Files .................................................................................................. 89
5.2.2 Output Files................................................................................................ 90
5.3 Starting Method............................................................................................ 91
5.4 Messages ......................................................................................................94
5.5 Linker Command File...................................................................................95
5.6 Link Map File............................................................................................... 96
5.7 Symbol File................................................................................................... 97
5.8 Absolute List File .........................................................................................98
5.9 Cross Reference File ....................................................................................99
5.10 Linking ........................................................................................................100
5.11 Branch Optimization Function....................................................................102
5.12 Error/Warning Messages.............................................................................103
5.12.1 Errors ...................................................................................................... 103
5.12.2 W arning ................................................................................................... 103
5.13 Precautions ................................................................................................. 104
CHAPTER 6HEX CONVERTER ................................................................................... 105
6.1 Functions.....................................................................................................105
6.2 Input/Output Files ....................................................................................... 105
6.2.1 Input Files ................................................................................................. 105
6.2.2 Output Files............................................................................................... 105
6.3 Starting Method........................................................................................... 106
6.4 Messages .....................................................................................................107
6.5 Output Hex Files ......................................................................................... 108
6.5.1 Hex File Configuration ............................................................................. 108
6.5.2 Motorola-S Format.................................................................................... 108
6.5.3 Intel-HEX Format ..................................................................................... 109
6.5.4 Conversion Range ..................................................................................... 109
6.6 Error/Warning Messages............................................................................. 110
6.6.1 Errors ........................................................................................................ 110
6.6.2 W arning ..................................................................................................... 110
6.7 Precautions ................................................................................................. 110
CHAPTER 7DISASSEMBLER ...................................................................................... 111
7.1 Functions.....................................................................................................111
7.2 Input/Output Files ....................................................................................... 111
7.2.1 Input Files ................................................................................................. 111
7.2.2 Output Files............................................................................................... 111
S5U1C63000A MANUAL EPSON v (S1C63 FAMILY ASSEMBLER PACKAGE)
CONTENTS
7.3 Starting Method........................................................................................... 112
7.4 Messages .....................................................................................................113
7.5 Disassembling Output ................................................................................. 114
7.6 Error/Warning Messages............................................................................. 117
7.6.1 Errors ........................................................................................................ 117
7.6.2 W arning ..................................................................................................... 117
CHAPTER 8DEBUGGER ............................................................................................ 118
8.1 Features....................................................................................................... 118
8.2 Input/Output Files ....................................................................................... 118
8.2.1 Input Files ................................................................................................. 118
8.2.2 Output Files............................................................................................... 119
8.3 Starting Method........................................................................................... 120
8.3.1 Start-up Format ......................................................................................... 120
8.3.2 Start-up Options........................................................................................ 120
8.3.3 Start-up Messages ..................................................................................... 121
8.3.4 Hardware Check at Start-up ..................................................................... 121
8.3.5 Method of Termination .............................................................................. 123
8.4 Windows ...................................................................................................... 124
8.4.1 Basic Structure of Window ........................................................................ 124
8.4.2 [Command] Window ................................................................................. 126
8.4.3 [Source] Window....................................................................................... 127
8.4.4 [Data] Window .......................................................................................... 129
8.4.5 [Register] Window .................................................................................... 129
8.4.6 [Trace] Window......................................................................................... 130
8.5 Tool Bar ....................................................................................................... 131
8.5.1 Tool Bar Structure ..................................................................................... 131
8.5.2 [Key Break] Button ................................................................................... 131
8.5.3 [Load File] and [Load Option] Buttons ................................................... 131
8.5.4 [Source], [Mix], and [Unassemble] Buttons ............................................ 131
8.5.5 [Go], [Go to Cursor], [Go from Reset], [Step], [Next],
and [Reset] Buttons .................................................................................. 131
8.5.6 [Break] Button .......................................................................................... 132
8.5.7 [Help] Button ............................................................................................ 132
8.6 Menu............................................................................................................ 133
8.6.1 Menu Structure.......................................................................................... 133
8.6.2 [File] Menu ............................................................................................... 133
8.6.3 [Run] Menu ............................................................................................... 133
8.6.4 [Break] Menu............................................................................................ 134
8.6.5 [Trace] Menu ............................................................................................ 134
8.6.6 [View] Menu.............................................................................................. 135
8.6.7 [Option] Menu .......................................................................................... 135
8.6.8 [Windows] Menu....................................................................................... 135
8.6.9 [Help] Menu ............................................................................................. 135
8.7 Method for Executing Commands............................................................... 136
8.7.1 Entering Commands from Keyboard......................................................... 136
8.7.2 Executing from Menu or Tool Bar............................................................. 138
8.7.3 Executing from a Command File .............................................................. 139
8.7.4 Log File ..................................................................................................... 140
8.8 Debug Functions ......................................................................................... 141
8.8.1 Loading Program and Data Files ............................................................. 141
8.8.2 Source Display and Symbolic Debugging Function ................................. 142
8.8.3 Displaying and Modifying Program, Data, Option Data and Register .... 144
8.8.4 Executing Program ................................................................................... 146
8.8.5 Break Functions ........................................................................................ 149
vi EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CONTENTS
8.8.6 Tr ace Functions......................................................................................... 152
8.8.7 Operation of Flash Memory...................................................................... 155
8.8.8 Coverage ................................................................................................... 156
8.8.9 Writing Data to the FPGA on the Standard Peripheral Circuit Board..... 156
8.9 Command Reference ...................................................................................157
8.9.1 Command List ........................................................................................... 157
8.9.2 Reference for Each Command .................................................................. 158
8.9.3 Program Memory Operation..................................................................... 159
a / as (assemble mnemonic)......................................................... 159
pe (program memory enter)......................................................... 161
pf (program memory fill) ............................................................. 162
pm (program memory move)........................................................ 163
8.9.4 Data Memory Operation........................................................................... 164
dd (data memory dump)............................................................... 164
de (data memory enter) ............................................................... 166
df (data memory fill) .................................................................... 168
dm (data memory move) .............................................................. 169
dw (data memory watch) .............................................................. 170
8.9.5 Command to Display Option Information ................................................ 172
od (option data dump) ................................................................. 172
8.9.6 Register Operation.................................................................................... 174
rd (register display) ..................................................................... 174
rs (register set) ............................................................................. 175
8.9.7 Program Execution ................................................................................... 177
g (go) ......................................................................................... 177
gr (go after reset CPU)................................................................ 179
s (step) ......................................................................................... 180
n (next)......................................................................................... 182
8.9.8 CPU Reset ................................................................................................. 183
rst (reset CPU)............................................................................. 183
8.9.9 Break ......................................................................................................... 184
bp (break point set)...................................................................... 184
bc / bpc (break point clear) ......................................................... 186
bd (data break) ............................................................................ 187
bdc (data break clear) ................................................................. 189
br (register break) ........................................................................ 190
brc (register break clear)............................................................. 192
bs (sequential break) ................................................................... 193
bsc (sequential break clear) ........................................................ 195
bsp (break stack pointer) ............................................................. 196
bl (break point list) ...................................................................... 198
bac (break all clear) .................................................................... 199
8.9.10 Program Display..................................................................................... 200
u (unassemble)............................................................................. 200
sc (source code) ........................................................................... 202
m (mix)......................................................................................... 204
8.9.11 Symbol Information................................................................................. 206
sy (symbol list) ............................................................................. 206
8.9.12 Load File ................................................................................................. 207
lf (load file) .................................................................................. 207
lo (load option) ............................................................................ 208
8.9.13 Flash Memory Operation........................................................................ 209
lfl (load from flash memory)........................................................ 209
sfl (save to flash memory)............................................................ 211
efl (erase flash memory) .............................................................. 213
8.9.14 Trace........................................................................................................ 214
tm (trace mode display/set) ......................................................... 214
td (trace data display) ................................................................. 216
ts (trace search) ........................................................................... 219
tf (trace file) ................................................................................. 221
S5U1C63000A MANUAL EPSON vii (S1C63 FAMILY ASSEMBLER PACKAGE)
CONTENTS
8.9.15 Coverage ................................................................................................. 222
cv (coverage) ............................................................................... 222
cvc (coverage clear) .................................................................... 223
8.9.16 Command File......................................................................................... 224
com (execute command file) ........................................................ 224
cmw (execute command file with wait)........................................ 225
rec (record commands to a file)................................................... 226
8.9.17 log ........................................................................................................... 227
log (log) ....................................................................................... 227
8.9.18 Map Information ..................................................................................... 228
ma (map information).................................................................. 228
8.9.19 Mode Setting ........................................................................................... 229
md (mode) .................................................................................... 229
8.9.20 FPGA Operation ..................................................................................... 232
xfer/xfers (xilinx fpga data erase)................................................ 232
xfwr/xfwrs (xilinx fpga data write) .............................................. 233
xfcp/xfcps (xilinx fpga data compare) ......................................... 234
xdp/xdps (xilinx fpga data dump) ................................................ 235
8.9.21 Quit ......................................................................................................... 236
q (quit) ......................................................................................... 236
8.9.22 Help......................................................................................................... 237
? (help)......................................................................................... 237
8.10 Status/Error/Warning Messages...................................................................238
CHAPTER 9FUNCTION OPTION GENERATOR .............................................................. 240
9.1 Outline of the Function Option Generator winfog...................................... 240
9.2 Input/output Files ........................................................................................ 240
9.3 Using winfog ............................................................................................... 241
9.3.1 Starting Up................................................................................................ 241
9.3.2 Window...................................................................................................... 242
9.3.3 Menus and Toolbar Buttons ...................................................................... 243
9.3.4 Operation Procedure................................................................................. 244
9.4 Error Messages ........................................................................................... 247
9.5 Example Output Files.................................................................................. 248
CHAPTER 10 SEGMENT OPTION GENERATOR .............................................................. 249
10.1 Outline of Segment Option Generator winsog ............................................249
10.2 Input/output Files ........................................................................................249
10.3 Using winsog ............................................................................................... 250
10.3.1 Starting Up.............................................................................................. 250
10.3.2 Window.................................................................................................... 252
10.3.3 Menus and Toolbar Buttons .................................................................... 253
10.3.4 Option Selection Buttons ........................................................................ 254
10.3.5 Operation Procedure ............................................................................... 254
10.4 Error Messages ...........................................................................................260
10.5 Example Output Files..................................................................................261
CHAPTER 11 MELODY ASSEMBLER ............................................................................ 262
11.1 Outline of the Melody Assembler winmla ................................................... 262
11.2 Input/output Files ........................................................................................262
viii EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CONTENTS
11.3 Using winmla ..............................................................................................263
11.3.1 Starting Up.............................................................................................. 263
11.3.2 Window.................................................................................................... 264
11.3.3 Menus and Toolbar Buttons .................................................................... 265
11.3.4 Operation Procedure ............................................................................... 266
11.4 Melody Data................................................................................................ 269
11.4.1 Outline of Melody Data .......................................................................... 269
11.4.2 Melody Data Creation Procedure........................................................... 269
11.4.3 Method of Creating Melody Data ........................................................... 270
11.4.4 Description of Melody Data.................................................................... 271
11.4.5 Precautions ............................................................................................. 274
11.5 Error Messages ...........................................................................................275
11.6 Error Symbols ............................................................................................. 276
11.7 Sample Files ................................................................................................277
CHAPTER 12 MASK DATA CHECKER .......................................................................... 281
12.1 Outline of the Mask Data Checker winmdc ................................................ 281
12.2 Input/Output Files .......................................................................................281
12.3 Using winmdc.............................................................................................. 282
12.3.1 Starting Up.............................................................................................. 282
12.3.2 Menus and Toolbar Buttons .................................................................... 283
12.3.3 Operation Procedure ............................................................................... 284
12.4 Error Messages ...........................................................................................287
12.5 Example Output File ................................................................................... 288
APPENDIX QUICK REFERENCE
S5U1C63000A MANUAL EPSON ix (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL
CHAPTER 1GENERAL

1.1 Features

The S1C63 Family Assembler Package contains software development tools that are common to all the models of the S1C63 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 <Workbench wb63>.
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 S1C63 chips
The tools included in this package are common to all S1C63 Family models except for several chip dependent masking tools ("Dev" tools). The chip dependent information is read from the ICE param­eter file for each chip.
Complete compatibility with old syntax sources
By supporting old syntax, existing sources written for old 63 tools are available with these new tools.
S5U1C63000A MANUAL EPSON 1 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL

1.2 Tool Composition

1.2.1 Composition of Package

The S1C63 Family Assembler 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

1.2.2 Outline of Software Tools

The following shows the outlines of the software tools included in the package:
Assembler (as63.exe)
Converts the mnemonic of the source files into object codes (machine language) of the S1C63000. 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 (lk63.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 EXT insertion/correction function allowing the programmer to create sources without having to know branch destination ranges.
Hex converter (hx63.exe)
Converts an absolute object in IEEE-695 format output from the linker into ROM-image data in Motorola-S format or Intel-HEX format. This conversion is needed when making the ROM or when creating mask data using the mask data checker.
Disassembler (ds63.exe)
Disassembles an absolute object file in IEEE-695 format or a hex file in Motorola-S 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 (db63.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.
Work Bench (wb63.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 S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL
The tools listed below are Windows GUI applications for creating mask data. A device information definition file (s1c63xxx.ini) is required to run these tools. The CD-ROM contains the device information definition files for the models supported with the following tools. For unsupported models, model specific Development Tools are provided.
Function option generator (winfog.exe)
This tool creates an ICE function option setup file after selecting the mask options of the S1C63xxx and the function option document file that is necessary to generate IC mask patterns. You can create function option data by selecting the appropriate item using the check boxes.
Segment option generator (winsog.exe)
This tool creates an ICE segment option setup file after selecting the segment options of the S1C63xxx and the segment option document file that is necessary to generate IC mask patterns. You can create segment assignment data by merely clicking on the display memory map and segment decode table shown on the window. The winsog is used only for the model that has segment options.
Melody assembler (winmla.exe)
This tool converts the melody data created using an editor into the melody ROM and melody option data for the S1C63xxx melody generator. The winmla is used only for the model with a melody output function.
Mask data checker (winmdc.exe)
This tool checks the data in development-completed program ROM/data ROM files and option document files to create the mask data file that will be presented to Seiko Epson.

1.3 Working Environment

To use the S1C63 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 S1C63 Family Assembler Package supports Microsoft Windows
®
98 (English or Japanese) and Windows NT®4.0 (English or Japanese).
Other development tools
To debug the target program, the optional In-Circuit Emulator and a Peripheral Circuit Board S5U1C63xxxP are needed as the hardware tools. The S5U1C63xxxP board is prepared for each S1C63 model.
®
Windows®95 (English or Japanese),
S5U1C63000A MANUAL EPSON 3 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL

1.4 Installation

The supplied CD-ROM contains the installer (Setup.exe) that installs the tools. To install the tools, start up the "Setup.exe" and follow the instructions in the dialog boxes that will be appeared. For more information on the installation procedure, please refer to "setup_e.pdf" on the CD­ROM.

1.5 Directories and Files after Installation

The installer copies the following files in the specified directory (default is "C:\EPSON\S1C63\"):
[EPSON\S1C63]
README_E.TXT ... ReadMe document (English) README_J.TXT ... ReadMe document (Japanese)
[\BIN] ... S1C63 Family Assembler Package Tool
WB63.EXE ... Work bench AS63.EXE ... Assembler LK63.EXE ... Linker HX63.EXE ... Hex converter DS63.EXE ... Disassembler DB63.EXE ... Debugger S1C63.CNT ... Help index S1C63.HLP ... Help contents
. . . ... Other related files
[\DEV]
[\BIN] ... S1C63 Family Development Tool for Windows
WINFOG.EXE ... Function option generator WINSOG.EXE ... Segment option generator WINMLA.EXE ... Melody assembler WINMDC.EXE ... Mask data checker
[\63xxx] ... Model-dependent files
S1C63xxx.INI ... Device information definition file PAR63xxx.PAR ... Parameter file C63xxx.FSA ... Sample function option HEX file (for ICE configuration) C63xxx.SSA ... Sample segment option HEX file (for ICE configuration)
:
[\WRITER]
[\6xxxx] ( \6Pxxx or \6Fxxx)
[\URW2]
US6xxxx.EXE ... ROM Writer II control software (English) JP6xxxx.EXE ... ROM Writer II control software (Japanese) 6xxxx.FRM ... Firmware
. . . ... Other related files
: ∗ Refer to the technical manual for details of the ROM Writer II.
[\ICE]
[\ICE63UPD]
TM63.EXE ... ICE firmware updater to support standard peripheral circuit board ICE63.COM I63COM.O I63.PAR
[\FPGA]
C63xxx.MOT ... FPGA data to configure standard peripheral circuit board :
4 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 1: GENERAL
[\DOC]
[\ENGLISH] ... Document folder (English)
REL_xxxx_E.TXT ... Tool release note MANUAL_E.PDF ... This manual in PDF format QUICK_E.PDF ... Quick reference in PDF format
[\HARD]
xxxx_E.PDF ... Hardware development tool manuals in PDF format
[\JAPANESE] ... Document folder (Japanese)
REL_xxxx_J.TXT ... Tool release note MANUAL_J.PDF ... This manual in PDF format QUICK_J.PDF ... Quick reference in PDF format
[\HARD]
xxxx_J.PDF ... Hardware development tool manuals in PDF format
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 may be provided in FDs. Refer to the Readme file included in the FD for installation.
S5U1C63000A MANUAL EPSON 5 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: SOFTWARE DEVELOPMENT PROCEDURE
CHAPTER 2 SOFTW ARE DEVELOPMENT PROCEDURE
This chapter outlines a basic development procedure.

2.1 Software Development Flow

Figure 2.1.1 represents a flow of software development work.
Work Bench
wb63
Make
file.MAK
file
file.S file.MS
or
Assembly
list file(s)
Linker
command file
file.SYMSymbol file
file.MAP file.XRFLink map file
HEX converter
hx63
Intel-HEX format files
fileH.HEX
fileL.HEX
fileC.HEX file.CSA
Assembly source file(s)
file.CM
Motorola-S format files
file.HSA
or
file.LSA
Assembler
as63
file.Ofile.LST
Object file(s)
Linker
lk63
file.ABS
Absolute
object file
file.MS
Preprocessed source file(s)
Absolute
file.ALS
list file Cross
reference file
Disassembler
ds63
file.MS
Disassembled
source file
S1C63xxx Development Tool
file.par file.ini
Function Option
Generator winfog
file.FSA file.FDC
Function option
HEX file
Segment Option
Generator winsog
file.SSA
Segment option
HEX file
Melody
data file
Melody Assembler
file.MSA
Melody ROM
option HEX file
Mask Data Checker
Function option
document file
file.SDC
Segment option
document file
file.MDT
winmla
file.MDC
Melody ROM option
document file
winmdc
file.PAn
SEIKO EPSON
Mask data file
Debugger
db63
In-Circuit Emulator
Fig. 2.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 in­voked individually from the DOS prompt. Refer to the respective chapter for details of each tool. Some models provide other development tools (fog63xxx, sog63xxx, etc.) instead of the "S1C63xxx Development Tool" shown above. Those model dependent tools are not covered in this manual. For details, refer to the tool manual associated with each specific model.
6 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: SOFTWARE DEVELOPMENT PROCEDURE

2.2 Development Using Work Bench

This section shows a basic development procedure using the work bench wb63. Refer to Chapter 3, "Work Bench", for operation details.

2.2.1 Starting Up the Work Bench

Start up the work bench by choosing "WorkBench63" from the program menu.
S5U1C63000A MANUAL EPSON 7 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: SOFTWARE DEVELOPMENT PROCEDURE

2.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 [EPSON 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 "dev63" 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

2.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 [EPSON Assembly Source File] and click [OK].
8 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: 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
S5U1C63000A MANUAL EPSON 9 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: 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.

2.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 double­clicking.
Refer to Chapter 3, "Work Bench", for details of the [Settings] dialog box.
10 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: SOFTWARE DEVELOPMENT PROCEDURE

2.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
S5U1C63000A MANUAL EPSON 11 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 2: SOFTWARE DEVELOPMENT PROCEDURE

2.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 8, "Debugger".
12 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: WORK BENCH
CHAPTER 3WORK BENCH
This chapter describes the functions and operating method of the Work Bench wb63.

3.1 Features

The Work Bench wb63 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.

3.2 Starting Up and Terminating the Work Bench

To start up the work bench
Choose "WorkBench63" from the [Program] menu to start up the work bench.
∗ If "WorkBench63" is not registered in the [Program]
menu, it means that the installation was not successful. Therefore, reinstall the tools .
When the work bench starts up, the window shown below appears.
To terminate the work bench
Select [Exit] from the [File] menu.
S5U1C63000A MANUAL EPSON 13 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: WORK BENCH

3.3 Work Bench Windows

3.3.1 Windo w Configuration

Menu bar Toolbar [Edit] window
[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 win­dow. Two or more windows can be opened in the edit window area. When an assembly source file is opened, the source is displayed with in colors according to the contents. The default colors are shown below. S1C63 instructions: Black Preprocess (#) pseudo-instructions: Dark brown Assemble (.) pseudo-instructions: Blue Labels: Light brown Comments: Green
These colors can be changed by the [Tools | Options ] menu command (refer to Section 3.10).
[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.
14 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: 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 3.5.
Toolbar
Refer to Section 3.3.
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 and Key lock status (Num lock, Caps lock, Scroll lock).

3.3.2 Windo w Manipulation

Resizing the windows
Each window area can be resized by dragging the win­dow boundary. The size information is saved when the work bench is terminated. So the same window layout will appear at 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 double­clicking 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.
S5U1C63000A MANUAL EPSON 15 (S1C63 FAMILY ASSEMBLER PACKAGE)
CHAPTER 3: 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 maxi­mized 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.
1 Cascade windows
Select [Cascade] from the [Window] menu or click the [Cascade Windows] button.
[Cascade Windows] button
16 EPSON S5U1C63000A MANUAL
(S1C63 FAMILY ASSEMBLER PACKAGE)
Loading...
+ 316 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use