Page
© SEIKO EPSON CORPORATION 2001 All rights reserved
Devices
Development tools
S1C63 Family processors
S1C63 Family peripheral products
Development tools for the S1C63 Family
Page
Introduction
Caution
How To Read the Manual
Before installation
Installation
Manual Notations
(1)Sample screens
(2)Names of each part
(3)Names of instructions and commands
(4)Notation of numeric values
Features
Tool Composition
Working Environment
Installation
Software Development Flow
Build Task
Tool Option Settings
Work Bench Options
Short-CutKey List
Functions
Relocatable List File
Sample Executions
Error/Warning Messages
Linker Command File
Link Map File
Disassembling Output
Windows
Tool Bar
Menu
Method for Executing Commands
8.9 Command Reference
8.10 Status/Error/Warning Messages
9.1 Outline of the Function Option Generator winfog
Input/output Files
Example Output Files
Outline of the Melody Assembler winmla
Using winmla
Melody Data
Error Symbols
Sample Files
Using winmdc
Page
CHAPTER 1 GENERAL
1.1 Features
1.2 Tool Composition
1.3 Working Environment
1.4 Installation
1.5 Directories and Files after Installation
Online manual in PDF format
Files for future release models
CHAPTER 2 SOFTWARE DEVELOPMENT PROCEDURE
2.1 Software Development Flow
2.2 Development Using Work Bench
2.2.2 Creating a New Project
2.2.3 Editing Source Files
Page
2.2.4 Configuration of Tool Options
2.2.5 Building an Executable Object
2.2.6 Debugging
CHAPTER 3 WORK BENCH
3.1 Features
3.2 Starting Up and Terminating the Work Bench
3.3 Work Bench Windows
[Output] window
Menu bar
Toolbar
Status bar
3.3.2 Window Manipulation
Resizing the windows
Floating and docking the [Project] and [Output] window
Closing the [Project] and [Output] window
Maximizing the [Edit] window area
Opening/Closing [Edit] windows
Arrangement of the [Edit] windows
1Cascade windows
2Tile windows
3Maximizing an [Edit] window
4Minimizing an [Edit] window
5Moving and resizing an [Edit] window
Switching active [Edit] window
Scrolling display contents
3.4 Toolbar and Buttons
3.4.2 Build Toolbar
[Assemble] button
[Build] button
[Rebuild All] button
[Stop Build] button
3.4.4 Toolbar Manipulation
Hiding and showing toolbars
Changing the toolbar location
3.4.5 [Insert into project] Button on a [Edit] Window
3.5 Menus
3.5.2 [Edit] Menu
[Undo] ([Ctrl]+[Z])
[Cut] ([Ctrl]+[X])
[Copy] ([Ctrl]+[C])
[Paste] ([Ctrl]+[V])
3.5.4 [Insert] Menu
[File...]
[Files into project...]
3.5.5 [Build] Menu
[Assemble] ([Ctrl]+[F7])
3.5.6 [Tools] Menu
[HEX Converter...]
[Disassembler...]
[WinFOG]
[WinSOG]
3.6 Project and Work Space
3.6.2 Inserting Sources into a Project
Removing a source from the project
3.6.3 [Project] Window
3.6.4 Opening and Closing a Project
3.6.5 Files in the Work Space Folder
3.7 Source Editor
3.7.2 Loading and Saving Files
3.7.3 Edit Function
Editing text
Find, replace and go to
Find
Replace
Go to
Inserting a file
Shortcut menu
3.7.4 Tag Jump Function
3.8 Build Task
3.8.3 Debugging
3.8.4 Executing Other Tools
HEX converter
Disassembler
3.9 Tool Option Settings
Check here → ■ sub.s
Source
Debug info
List file
3.9.2 Linker Options
Specifying section allocation
BSS
CODE
DATA
Symbol definition
Other option selections
3.9.3 Debugger Options
3.9.4 HEX Converter Options
3.10 Work Bench Options
3.11 Short-CutKey List
3.12 Error Messages
3.13 Precautions
CHAPTER 4 ASSEMBLER
4.1 Functions
4.2 Input/Output Files
4.2.2 Output Files
Object file
Relocatable list file
Preprocessed file
4.3 Starting Method
4.4 Messages
4.5 Grammar of Assembly Source
Restrictions
4.5.2 Instructions (Mnemonics and Pseudo-instructions)
Mnemonics
General notation forms of instructions
<Mnemonic
<Mnemonic> tab or space <Operand
4.5.3 Symbols (Labels)
Definition of a symbol
.set
.comm
.lcomm
Scope
Symbol masks
4.5.4 Comments
Definition of comment
4.5.5Blank Lines
4.5.6 Register Names
The CPU register names may be written in either uppercase or lowercase letters
Table 4.5.6.1 Notations of register names
4.5.7 Numerical Notations
Decimal notations of values
4.5.8 Operators
Types of operators
Arithmetic operators
Logical operators
Relational operators
Priority
Examples
Precautions
4.5.9 Location Counter Symbol "$
Precaution
4.5.10 Optimization Branch Instructions for Old Preprocessor
4.6 Section Management
4.6.3 Sample Definition of Sections
4.7 Assembler Pseudo-Instructions
4.7.1 Include Instruction (#include)
Instruction format
#include "<File name
#include
Expansion rule
4.7.2 Define Instruction (#define)
#define <Define name> [<Substitute character string>]
Page
4.7.3 Numeric Define Instruction (#defnum)
#defnum <Numeric Define name> <Number
4.7.4 Macro Instructions (#macro ... #endm)
#macro <Macro name
[<Dummy parameter>] [,<Dummy parameter>]
<Statement string
#endm
Expansion rules
Conditional Assembly Instructions
Instruction formats
Format 1)
#ifdef
<Name
Page
4.7.6 Section Defining Pseudo-Instructions(.code, .data, .bss)
.code pseudo-instruction
.code
.data pseudo-instruction
.data
.bss pseudo-instruction
.bss
4.7.7 Location Defining Pseudo-Instructions(.org, .align)
.org pseudo-instruction
.org <Address
.align)
Page
.align pseudo-instruction
.align
<Alignment number
4.7.8 Absolute Assembling Pseudo-Instruction(.abs)
.abs
.abs
4.7.9 Symbol Defining Pseudo-Instruction(.set)
.set
<Symbol>[,] <Value
4.7.10 Data Defining Pseudo-Instructions(.codeword, .word)
.codeword pseudo-instruction
.codeword <Data>[,<Data> ...,<Data>]
.codeword
.word pseudo-instruction
4.7.11 Area Securing Pseudo-Instructions(.comm, .lcomm)
.comm <Symbol>[,] <Size
.lcomm <Symbol>[,] <Size
Difference between .comm and .lcomm
4.7.12 Global Declaration Pseudo-Instruction(.global)
.global <Symbol
4.7.13 List Control Pseudo-Instructions(.list, .nolist)
.list
.nolist
4.7.15 Comment Adding Function
4.7.16 Priority of Pseudo-Instructions
#ifdef
#ifndef
4.8 Relocatable List File
4.9 Sample Executions
Preprocessed file
Assembly list file
Error file
4.10 Error/Warning Messages
4.11 Precautions
CHAPTER 5 LINKER
5.1 Functions
5.2 Input/Output Files
5.2.2 Output Files
Absolute object file
Link map file
Symbol file
Cross reference file
5.3 Starting Method
-code<address
-data<address
-bss<address
-rcode<file name>=<address
-rdata<file name>=<address
-rbss<file name>=<address
-defsym<symbol name>=<address
5.4 Messages
5.5 Linker Command File
5.6 Link Map File
5.7 Symbol File
5.8 Absolute List File
5.9 Cross Reference File
5.10 Linking
Page
5.11 Branch Optimization Function
5.12 Error/Warning Messages
5.13 Precautions
CHAPTER 6 HEX CONVERTER
6.1 Functions
6.2 Input/Output Files
6.3 Starting Method
6.4 Messages
6.5 Output Hex Files
6.5.3 Intel-HEXFormat
6.5.4 Conversion Range
6.6 Error/Warning Messages
6.7 Precautions
CHAPTER 7 DISASSEMBLER
7.1 Functions
7.2 Input/Output Files
7.3 Starting Method
7.4 Messages
7.5 Disassembling Output
Output source file "test.ms" (default)
Output source file "test.ms" (when -clis specified)
Output source file "test.ms" (when -cuis specified)
7.6 Error/Warning Messages
CHAPTER 8 DEBUGGER
8.1 Features
8.2 Input/Output Files
Program file
Data file for data ROM
8.2.2 Output Files
Log file
log
Record file
rec
8.3 Starting Method
8.3.3 Start-upMessages
8.3.4 Hardware Check at Start-up
(1)Testing connection of the ICE
During test
When terminated normally
When the ICE is executing the target program:
When the ICE is in the BUSY state:
When the ICE is in a free-runstate:
When the ICE is performing self-diagnosis:
(2)Version check
8.3.5 Method of Termination
8.4 Windows
Features common to all windows
(1)Open/close and activating a window
(2)Resizing and moving a window
(3)Scrolling a window
(4)Other
8.4.2 [Command] Window
(1)Entering debug commands
(2)Displaying debug commands selected from menus or tool bar
(3)Displaying command execution results
8.4.3 [Source] Window
(1)Unassembled codes and source codes
1.Mix mode
2.Source mode
3.Unassemble mode
∗Updating of display
rst
a (as)
(2)Current PC
(3)PC breakpoint
8.4.4 [Data] Window
(1)Displaying data memory contents
*Updating of display
(2)Direct modification of data memory contents
8.4.5[Register] Window
8.4.6 [Trace] Window
∗Updating of display:
8.5 Tool Bar
[Go from Reset] button
[Step] button
[Next] button
[Reset] button
8.5.6 [Break] Button
8.5.7 [Help] Button
8.6 Menu
[Command File...]
[Reset CPU]
8.6.4 [Break] Menu
[Breakpoint Set...]
[Data Break...]
[Register Break...]
[Sequential Break...]
8.6.6 [View] Menu
[Command]
[Program]
[Data Dump]
[Register]
8.7 Method for Executing Commands
•Commands that replace existing data after confirmation
Numeric data format of parameter
Specification with a symbol
Successive execution using the [Enter] key
8.7.2 Executing from Menu or Tool Bar
Table 8.7.2.1 Commands that can be specified from menu or tool bar
8.7.3 Executing from a Command File
Creating a command file
Example of a command file
Reading in and executing a command file
(1)Execution by the start-upoption
8.7.4 Log File
Command example
Display of [Command] window in log mode
(1) When executing a command when each window is open
(2)When executing a command while each window is closed
8.8 Debug Functions
8.8.2 Source Display and Symbolic Debugging Function
Displaying program code
(1) Unassemble mode
(2) Source mode
(3) Mix mode
Symbol reference
(1)Referencing global symbols
@<symbol
(2)Referencing local symbols
8.8.3 Displaying and Modifying Program, Data, Option Data and Register
Operating on program memory area
(1)Entering/modifying program code
(2)In-lineassemble
(3)Rewriting specified area
An entire specified area is rewritten with specified data
(5)Monitoring memory
Monitor data
Operating registers
The following operations can be performed on registers:
8.8.4 Executing Program
Successive execution
(1)Types of successive execution
(2)Stopping successive execution
(3)On-the-flyfunction
Single-stepping
(1)Types of single-stepping
(2)Display during single-stepping
(3)HALT and SLEEP states and interrupts
Measuring execution cycles/execution time
(1)Execution cycle counter and measurement mode
(2)Displaying measurement results
(3)Hold mode and reset mode
(4)Resetting execution cycle counter
8.8.5 Break Functions
Break by command
(1)Break by PC
(2)Data break
(3)Register break
(4)Sequential break
(5)Accessing outside stack area
Forced break by the [Key Break] button or the [Esc] key
Pulling ICE BRKIN pin low
Map break and illegal instruction break
(1)Access to undefined program area
(2)Access to undefined data area
(3)Write to data ROM area
8.8.6 Trace Functions
Trace memory and trace information
Trace modes
(1)Normal trace mode
(2)Single delay trigger trace mode
(3)Address-areatrace
∗Trace trigger address
Displaying and searching trace information
Saving trace information
8.8.7 Operation of Flash Memory
(1)Read from flash memory
(2)Write to flash memory
(3)Erasing flash memory
sfl
8.8.8 Coverage
8.8.9 Writing Data to the FPGA on the Standard Peripheral Circuit Board
(1)Erasing FPGA
(2)Writing data to FPGA
(3)FPGA data comparison
8.9 Command Reference
8.9.2 Reference for Each Command
Format
Note
GUI utility
a / as
Notes
pe (program memory enter)
(1) >pe <address> <code1> [<code2> [...<code8>]]↵
(2) >pe [<address>]↵
Program enter address ? <address>↵
: <code
pf (program memory fill)
>pf <address1> <address2> <code>↵
>pf↵
Start address ? <address1>↵
End address ? <address2>↵
pm (program memory move)
>pm <address1> <address2> <address3>↵
>pm↵
8.9.4 Data Memory Operation
dd (data memory dump)
>dd [<address1> [<address2>]]↵
(1) When [data] window is opened
(2)When [data] window is closed
(3)During log output
(4)Successive display
[View | Data Dump] menu item
de (data memory enter)
(1) >de <address> <data1> [<data2> [...<data16>]]↵
(2) >de↵
Data enter address ? : <address>↵
: <data
[Data] window
df (data memory fill)
>df <address1> <address2> <data> ↵
>df↵
Start address ? <address1>↵ End address ? <address2>↵ Data pattern ? <data>↵
dm (data memory move)
>dm <address1> <address2> <address3>↵
>dm↵
dw (data memory watch)
>dw <address1> [ ... <address4>] ↵
>dw↵
Address 1 = Old value
: <address1>↵
Page
8.9.5 Command to Display Option Information
od (option data dump)
>od <type> [<address1> [<address2>]]↵
>od↵
fog 2. sog 3. mla . . . ? <type
Page
8.9.6 Register Operation
rd (register display)
>rd↵
(1) Contents of display
(2)When [Register] window is opened
rs (register set)
(2) >rs↵
PC = Old value : <value>↵
A = Old value : <value>↵
B = Old value : <value>↵
[Register] window
8.9.7 Program Execution
g (go)
This command executes the target program from the current PC position
>g [<address1> [<address2>]]↵
0 ≤ address1(2) ≤
(4)Execution cycle counter
[Run | Go] menu item, [Go] button
[Run | Go to Cursor] menu item, [Go to Cursor] button
gr (go after reset CPU)
[Run | Go from Reset] menu item, [Go from Reset] button
s (step)
>s [<step>]↵
(1)Step execution
(2)HALT and SLEEP states and interrupts
(3)Execution cycle counter
(4)During log mode
[Run | Step] menu item, [Step] button
n (next)
>n [<step>]↵
[Run | Next] menu item, [Next] button
rst
8.9.9 Break
bp (break point set)
(1) >bp <break1> [<break2> [ ... <break16>]]↵
(2) >bp↵
1. set
[Break | Breakpoint Set...] menu item
bc / bpc
bd (data break)
(1) >bd <data> <option> <address1> <address2>↵
(2) >bd↵
<1 | 2>↵
: <data>↵
[Break | Data Break …] menu item
bdc
br (register break)
>br <register> <value> [<register> <value> [...<register> <value>]]↵
>br↵
…? <1 | 2>↵
: <value
[Break | Register Break …] menu item
brc
bs (sequential break)
(1) >bs <pass> <address1> [<address2> [<address3>]]↵
(2) >bs↵
1. set 2. clear
Number of sequential address (1–3)? : <1 | 2 | 3>↵
[Break | Sequential Break …] menu item
bsc
bsp
[Break | Stack Break …] menu item
bl (break point list)
>bl↵
[Break | Break List] menu item
bac
8.9.10 Program Display
u (unassemble)
>u [<address>]↵
(1) When [Source] window is opened
(2)When [Source] window is closed
[View | Program | Unassemble] menu item, [Unassemble] button
sc (source code)
>sc [<address>] ↵
[View | Program | Source Display] menu item, [Source] button
m (mix)
>m [<address>] ↵
[View | Program | Mix Mode] menu item, [Mix] button
8.9.11 Symbol Information
sy (symbol list)
>sy [/a]↵
>sy $<keyword> [/a]↵
>sy #<keyword> [/a]↵
8.9.12 Load File
lf (load file)
>lf <file name>↵
>lf↵
File Name
lo (load option)
File
Name specification
(1) >lo <file name>↵
(2) >lo↵
lfl
[File | Flash Memory Operation…] menu item
sfl
slf
efl
8.9.14 Trace
tm (trace mode display/set)
(2) >tm↵
[Trace | Trace Mode Set …] menu item
td (trace data display)
(1) >td [<cycle>]↵
(2) >td↵
Start point ?: (ENTER from the latest) <num>↵
(1)When [Trace] window is opened:
(2)When [Trace] window is closed:
[View | Trace] menu item
ts (trace search)
>ts <option> <address>↵
>ts↵
[Trace | Trace Search …] menu item
tf (trace file)
(1) >tf [<cycle1> [<cycle2>]] <file name>↵
(2) >tf↵
Start cycle number
(max 8191) ? : <cycle1>↵
8.9.15 Coverage
cv (coverage)
>cv [<address1> [<address2>]]↵
cvc
com
cmw
rec
log
8.9.18 Map Information
ma (map information)
This command displays the map information that is set by a parameter file
Chip name
: 63A08
8.9.19 Mode Setting
md (mode)
1.Displaying on-the-flyinformation
2.Measurement mode for the execution cycle counter
3.Interrupt mode for step execution
(1) >md <option> <num> [ ... <option> <num>]↵
(2) >md↵
On the fly interval
0 - 5 times/sec
...? Current setting : <0 ... 5>↵
[Option | Mode Setting…] menu item
xfer/xfers
xfwr/xfwrs
xfcp/xfcps
xdp/xdps
8.9.21 Quit
q (quit)
This command quits the debugger
>q↵
[File | Exit] menu item
8.9.22 Help
?(help)
This command displays the input format of each command
? <n
? <command
8.10 Status/Error/Warning Messages
Page
CHAPTER 9 FUNCTION OPTION GENERATOR
9.1 Outline of the Function Option Generator winfog
9.2 Input/output Files
9.3 Using winfog
9.3.2 Window
Function option document area
The area can be resized by dragging the frame boundary
Fig. 9.3.2.1 Window Configuration
The [FOG] window is divided into three areas as shown above
9.3.3 Menus and Toolbar Buttons
[File] menu
9.3.4 Operation Procedure
(1) Loading the device information definition file
(2) Setup
Date
Function Option Document file
EPROM Type
User's Name
Comment
(3)Selecting options
(4) Creating files
(5) Correcting an existing document file
(6) Quitting
9.4 Error Messages
9.5 Example Output Files
CHAPTER 10 SEGMENT OPTION GENERATOR
10.1 Outline of Segment Option Generator winsog
10.2 Input/output Files
10.3 Using winsog
Page
10.3.2 Window
Option setup area
Fig. 10.3.2.1 Window Configuration
The [SOG] window is divided into two areas as shown above
Option setup area
10.3.3 Menus and Toolbar Buttons
Record - Save
Record - Load
10.3.4 Option Selection Buttons
OUTPUT Option buttons
[Delete] button
10.3.5 Operation Procedure
Segment Option Document file
Segment Option HEX
Segment Options HEX file
(3)Setting segment outputs
(4)Setting DC outputs
(5) Setting SEG/COM shared pins
(6) Setting unused SEG pins
(7) Creating files
(8) Saving uncompleted segment option data
(9)Correcting an existing document file
(10)Quitting
10.4 Error Messages
10.5 Example Output Files
CHAPTER 11 MELODY ASSEMBLER
11.1 Outline of the Melody Assembler winmla
11.2 Input/output Files
11.3 Using winmla
11.3.2 Window
Melody ROM option document area
Fig. 11.3.2.1 Window Configuration
The [MLA] window is divided into three areas as shown above
Melody ROM option document area
11.3.3 Menus and Toolbar Buttons
Exit
11.3.4 Operation Procedure
(2) Selecting options
(3) Setup and creating files
Melody Data file
Select reference frequency
Melody ROM Option Document file
Melody ROM Option HEX
Melody ROM Option HEX file
(4) Correcting an existing document file
(5) Quitting
11.4 Melody Data
11.4.3 Method of Creating Melody Data
(1)Writing score
(2)Creating melody data
11.4.4 Description of Melody Data
; mX data
A comment should be described for easy reading
Tempo No
Jump bit
Pitch data
(2-4)Pitch data
Table 11.4.4.4 Pitch Data (example)
∗All of the half tones should be described using pitches with a #
(2-5)Jump bit
(2-6)Tempo No
11.4.5 Precautions
11.5 Error Messages
11.6 Error Symbols
11.7 Sample Files
;FINE
D5# 1 0 ;D.C
673 7 RR 1 0 ;Data for ending the melody
3 7 RR 1 0 ;
CONTROL m0
Example of output file (Melody ROM option document file)
Example of output file (Melody ROM option HEX file)
CHAPTER 12 MASK DATA CHECKER
12.1 Outline of the Mask Data Checker winmdc
12.2 Input/Output Files
12.3 Using winmdc
12.3.2 Menus and Toolbar Buttons
Pack
Unpack
12.3.3 Operation Procedure
(1) Loading the Device information definition file
(2)Packing
Page
(3)Unpacking
(4)Quitting
12.4 Error Messages
12.5 Example Output File
Page
Page
Page
CMOS 4-bitSingle Chip Microcomputer
S1C63 Family Assembler Package
S1C63000 Core CPU
Program Memory Map
Data Memory Map
Registers
Symbols in the Instruction List
Registers/Register Data
Memory/Addresses/Memory Data
Immediate Data
Functions
4-bitdata transfer
Remarks
Page
Page
Page
Page
Page
Page
Page
Page
Shift and rotate
Stack
Branch control JR
System
Remarks ∗1: sign16(s15–s8)= imm8, sign16(s7–s0)= sign8
Development Tools
1. Programming
editor
2. Assembly and Linking
Start up the work bench
Outline
Windows
[Project] window
[Output] window
[Edit] window
Tool bars
[Standard] tool bar
[Build] tool bar
[Window] tool bar
Controls on [Edit] window
Menus
[Edit] menu
[View] menu
[Insert] menu
[Build] menu
Short-CutKey List
[Tools] menu
[Window] menu
Error Messages
Converts the mnemonic of the source files into object codes (machine
conditional assembly, and file-includefunctions
Flowchart
file.lst
Object file
Operators
Warning Message
Links the relocatable objects created by the assembler by fixing
the memory locations, and creates executable absolute object
codes. The linker also provides a branch optimization function that
automatically inserts, deletes or corrects extension codes for
branch instructions
Converts an absolute object in IEEE-695format output from the
linker into ROM-imagedata in Intel-HEXformat or Motorola-S
creating mask data using the development tools provided with
each model
Absolute
file in Motorola-Sformat, 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
Motorola-Sfile
[Source] window
[Register] window
[Trace] window
[Data] window
[Command] window
Buttons
[Run] menu
[Break] menu
[Trace] menu
[Option] menu
[Help] menu
Debug Commands
Program memory operation
Data memory operation
Option information
Register operation
Debugger Messages
ICE status
ICE errors
Flash memory errors
Command errors
Option list area
Function option document area
Message area
Tool bar
[Tool] menu
Option setup area
Page
Melody ROM option document area
Error Symbols
Melody Data
Page
I/O Error Messages
ROM Data Error Messages
Function Option Data Error Messages
Segment Option Data Error Messages
International Sales Operations
In pursuit of “Saving” Technology, Epson electronic devices
Our lineup of semiconductors, liquid crystal displays and quartz devices
assists in creating the products of our customers’ dreams
(S1C63 Family Assembler Package)
