Epson S5U1C62000A S, P, D

S5U1C62000A MANUAL EPSON 7(S1C60/62 FAMILY ASSEMBLER PACKAGE)

CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE

CHAPTER 3

S

OFTWARE

D

EVELOPMENT

P

ROCEDURE

This chapter outlines a basic development procedure.

3.1 Software Development Flow

Figure 3.1.1 represents a flow of software development work.

Development tools for each model

Work Bench

wb62

Assembler

as62

file.MS

Preprocessed

source file(s)

Linker

lk62

file.Ofile.LST

Object

file(s)

Assembly

list file(s)

file.ALS Absolute

list file

Cross

reference

file

file.SYMSymbol file

file.MAP file.XRFLink map file

file.CM

Linker

command file

file.MAK file.DAT

Make

file

Debugger

db62

HEX converter

hx62

file.ABS

Disassembler

ds62

file.MS

Disassembled

source file

In-Circuit Emulator

Segment Option

Generator sog62XX

fileS.HEX

Segment option

HEX file

fileS.DOC

file.SEG Segment option

source file

Melody Assembler

mla62XX

fileA.HEX

file.par

Melody

HEX file

fileA.DOC

file.mel Melody

data file

Mask Data Checker

mdc62XX

file.PAn Mask

data file

Function Option

Generator fog62XX

fileF.HEX fileF.DOC

Function option

document file

Function option

HEX file

Segment option

document file

Melody

document file

file.S Assembly

source file(s)

or

file.LSA

file.HSA

Intel-HEX

format files

Motorola-S

format files

or fileH.HEX

fileL.HEX

Absolute

object 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 in-

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

Contents

Main NOTICE SEIKO EPSON CORPORATION 2002, All rights reserved. Configuration of product number Devices S1 C 60N01 F 0A01 Development tools S5U1 C 60R08 D1 1 00 Page Introduction How To Read the Manual Before installation Installation To understand the flow of program development Manual Notations (1) Sample screens (2) Names of each part (3) Names of instructions and commands (4) Notation of numeric values Contents Page Page Page Page Page CHAPTER 1GENERAL 1.1 Features 1.2 Tool Composition 1.2.1 Composition of Package 1.2.2 Outline of Software Tools CHAPTER 2INSTALLATION 2.1 Working Environment 2.2 Installation Method To install the tools Welcome Choose Destination Location Page 2.3 Directories and Files after Installation Online manual in PDF format S5U1C62000A MANUAL EPSON 7 (S1C60/62 FAMILY ASSEMBLER PACKAGE) CHAPTER 3: SOFTWARE DEVELOPMENT PROCEDURE Development tools for each model S P EVELOPMENT D OFTWARE Page 3.2.2 Creating a New Project 3.2.3 Editing Source Files Page 3.2.4 Configuration of Tool Options 3.2.5 Building an Executable Object 3.2.6 Debugging CHAPTER 4WORK BENCH 4.1 Features 4.2 Starting Up and Terminating the Work Bench To start up the work bench To terminate the work bench 4.3 Work Bench Windows 4.3.1 Window Configuration [Edit] window [Project] window [Output] window 4.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 Page 4.4 Toolbar and Buttons 4.4.1 Standard Toolbar 4.4.2 Build Toolbar 4.4.3 Window Toolbar 4.4.4 Toolbar Manipulation Hiding and showing toolbars Changing the toolbar location 4.4.5 [Insert into project] Button on a [Edit] Window 4.5 Menus 4.5.1 [File] Menu 4.5.2 [Edit] Menu 4.5.3 [View] Menu 4.5.4 [Insert] Menu 4.5.5 [Build] Menu 4.5.6 [Tools] Menu 4.5.7 [Window] Menu 4.5.8 [Help] Menu 4.6 Project and Work Space 4.6.1 Creating a New Project 4.6.2 Inserting Sources into a Project Removing a source from the project 4.6.3 [Project] Window 4.6.4 Opening and Closing a Project 4.6.5 Files in the Work Space Folder 4.7 Source Editor 4.7.1 Creating a New Source or Header File 4.7.2 Loading and Saving Files 4.7.3 Edit Function Editing text Find, replace and go to Find Replace Go to Inserting a file Shortcut menu 4.7.4 Tag Jump Function 4.7.5 Printing 4.8 Build Task 4.8.1 Preparing a Build Task 4.8.2 Building an Executable Object 4.8.3 Debugging 4.8.4 Executing Other Tools HEX converter Disassembler 4.9 Tool Option Settings 4.9.1 Assembler Options 4.9.2 Linker Options Specifying section allocation Other option selections 4.9.3 Debugger Options 4.9.4 HEX Converter Options 4.10 Short-Cut Key List 4.11 Error Messages The work bench error messages are given below. 4.12 Precautions CHAPTER 5ASSEMBLER 5.1 Functions 5.2 Input/Output Files 5.2.1 Input File 5.2.2 Output Files 5.3 Starting Method Source file name 5.4 Messages 5.5 Grammar of Assembly Source 5.5.1 Statements Syntax pattern Page 5.5.2 Instructions (Mnemonics and Pseudo-instructions) Mnemonics Assembler pseudo-instructions Restriction 5.5.3 Labels .lcomm .comm Definition of a label Reference with labels Scope 5.5.4 Comments Definition of comment Note: These symbols are reserved words, therefore they cannot be used as user-defined symbol names. 5.5.5 Blank Lines 5.5.6 Register Names 5.5.7 Numerical Notations Decimal notations of values Hexadecimal notations of values Binary notations of values Specified ranges of values 5.5.8 Symbols 5.5.9 Operators Types of operators Priority Examples Compatibility with the older tools 5.5.10 Location Counter Symbol "$" 5.6 Section Management 5.6.1 Definition of Sections CODE section BSS section 5.6.2 Absolute and Relocatable Sections 5.6.3 Sample Definition of Sections 5.7 Assembler Pseudo-Instructions 5.7.1 Include Instruction (#include) Expansion rule 5.7.2 Define Instruction (#define) Expansion rule Page 5.7.3 Macro Instructions (#macro ... #endm) Internal branch label Expansion rules 5.7.4 Conditional Assembly Instructions Instruction formats Name definition Page 5.7.5 Section Defining Pseudo-Instructions (.code, .bss) 5.7.6 Location Defining Pseudo-Instructions (.org, .bank, .page, .align) .org pseudo-instruction Page .page pseudo-instruction .bank pseudo-instruction .align pseudo-instruction 5.7.7 Symbol Defining Pseudo-Instruction (.set) 5.7.8 Data Defining Pseudo-Instruction (.codeword) 5.7.9 Area Securing Pseudo-Instructions (.comm, .lcomm) Difference between .comm and .lcomm 5.7.10 Global Declaration Pseudo-Instruction (.global) 5.7.11 List Control Pseudo-Instructions (.list, .nolist) 5.7.12 Source Debugging Information Pseudo-Instructions (.stabs, .stabn) 5.7.13 Comment Adding Function 5.7.14 Priority of Pseudo-Instructions 5.8 Summary of Compatibility with the Older Tool Numeric notation Arithmetic operators Logical operators Relation operators 5.9 Relocatable List File Content of line No. Content of address Content of code CHAPTER 5: ASSEMBLER 5.10 Sample Executions Command line C:\E0C62\bin\as62 -g -e -l main.s Assembly source file Preprocessed file Assembly list file Error file 5.11 Error/Warning Messages 5.11.1 Errors 5.11.2 Warning 5.12 Precautions CHAPTER 6LINKER 6.1 Functions 6.2 Input/Output Files 6.2.1 Input Files 6.2.2 Output Files 6.3 Starting Method Page Page 6.4 Messages 6.5 Linker Command File File format Option description Input file specification Comment 6.6 Link Map File Sample link map file Contents of link map file 6.7 Symbol File Sample symbol file Contents of symbol file 6.8 Absolute List File Sample absolute list file Contents of absolute list file Results of automatic pset insertion/deletion/correction Instructions preprocessed in the assembler 6.9 Cross Reference File Sample cross reference file Contents of cross reference file 6.10 Linking Linking rules Restrictions on linking Example of linking Page 6.11 Automatic Insertion/Removal/Correction of "pset" Instruction For jp instruction For call instruction 6.12 Error/Warning Messages 6.12.1 Errors 6.12.2 Warning 6.13 Precautions CHAPTER 7HEX CONVERTER 7.1 Functions 7.2 Input/Output Files 7.2.1 Input Files 7.2.2 Output Files 7.3 Starting Method 7.4 Messages 7.5 Output Hex Files 7.5.1 Hex File Configuration 7.5.2 Intel-HEX Format 7.5.3 Motorola-S Format 7.5.4 Conversion Range 7.6 Error/Warning Messages 7.6.1 Errors 7.6.2 Warning 7.7 Precautions CHAPTER 8DISASSEMBLER 8.1 Functions 8.2 Input/Output Files 8.2.1 Input Files 8.2.2 Output Files 8.3 Starting Method 8.4 Messages 8.5 Disassembling Output Sample outputs Absolute list file "test.abs" Output source file "test.ms" (default) Output source file "test.ms" (when -cl is specified) Output source file "test.ms" (when -cu is specified) 8.6 Error/Warning Messages 8.6.1 Errors 8.6.2 Warning CHAPTER 9DEBUGGER 9.1 Features 9.2 Input/Output Files 9.2.1 Input Files 9.2.2 Output Files 9.3 Starting Method 9.3.1 Start-up Format 9.3.2 Start-up Options 9.3.3 Start-up Messages 9.3.4 Hardware Check at Start-up 9.3.5 Method of Termination 9.4 Windows 9.4.1 Basic Structure of Window Features common to all windows Note for display 9.4.2 [Command] Window Note: The [Command] window cannot be closed. 9.4.3 [Source] Window Display of source line numbers and source statements Updating of display Page 9.4.4 [Data] Window * Updating of display 9.4.5 [Register] Window Updating the display 9.4.6 [Trace] Window Updating of display: 9.5 Tool Bar 9.5.1 Tool Bar Structure 9.5.2 [Key Break] Button 9.5.3 [Load File] and [Load Option] Buttons 9.5.4 [Source], [Mix], and [Unassemble] Buttons 9.5.6 [Break] Button 9.5.7 [Help] Button 9.6 Menu 9.6.1 Menu Structure 9.6.2 [File] Menu 9.6.3 [Run] Menu 9.6.4 [Break] Menu 9.6.5 [Trace] Menu 9.6.6 [View] Menu 9.6.7 [Option] Menu 9.6.8 [Windows] Menu 9.6.9 [Help] Menu 9.7 Method for Executing Commands 9.7.1 Entering Commands from Keyboard General command input format Command input accompanied by guidance Numeric data format of parameter Specification with a symbol Step execution using the [Enter] key 9.7.2 Executing from Menu or Tool Bar 9.7.3 Executing from a Command File Creating a command file Example of a command file Reading in and executing a command file 9.7.4 Log File Command example Display of [Command] window in log mode 9.8 Debug Functions 9.8.1 Loading Program and Option Data Loading files Loading ROM data Debugging a program with source display 9.8.2 Source Display and Symbolic Debugging Function Displaying program code Symbol reference 9.8.3 Displaying and Modifying Program, Data, and Register Operating on program memory area Operating on data memory area Operating registers 9.8.4 Executing Program Successive execution Single-stepping Resetting the CPU 9.8.5 Break Functions Break by command Forced break by the [Key Break] button or the [Esc] key Forced break by the [Break] or [Reset] switch on the ICE Break enable/disable mode in the ICE Note 9.8.6 Trace Functions Trace memory and trace information Trace areas and conditions Displaying and searching trace information Saving trace information 9.8.7 Coverage CHAPTER 9: DEBUGGER 9.9 Command Reference 9.9.1 Command List Table 9.9.1.1 lists the debug commands available with the debugger. Table 9.9.1.1 Command list 9.9.2 Reference for Each Command 9.9.3 Program Memory Operation as Address Original code Original mnemonic Page pe Address Original code pf pm 9.9.4 Data Memory Operation dd (1) When [Data] window is opened (2) When [Data] window is closed (3) During log output de Address Original data Page df dm 9.9.5 Register Operation rd (1) Contents of display (2) When [Register] window is opened (3) When [Register] window is closed (4) During log output rs 9.9.6 Program Execution g Page gr s n 9.9.7 CPU Reset rst 9.9.8 Break bp PC break set status Page bpc bd Data break set status Old option Old data Old address Page bdc br Register break set status Page brc bm Multiple break set status Page bmc bl bac be bsyn 9.9.9 Program Display u sc m 9.9.10 Symbol Information sy 9.9.11 Load File lf lo 9.9.12 ROM Access rp vp rom (ROM type) Current type setting 9.9.13 Trace tc Current type setting ta Current trace area Page tac tp td (Trace data is displayed) (1) When [Trace] window is opened: (2) When [Trace] window is closed: ts (Search result is displayed) Page tf 9.9.14 Coverage cv cvc 9.9.15 Command File com (Display execution progress) rec (1) First rec execution after debugger starts up (2) "rec" command input in the second and following sessions 9.9.16 log log (1) First log execution after debugger starts up (2) "log" command input in the second and following sessions 9.9.17 Map Information ma 9.9.18 Mode Setting otf tim 9.9.19 Self Diagnosis chk 9.9.20 Quit q 9.10 Error/Warning Messages 1. ICE errors 2. ICE status 3. Command errors/warning Page Memory Map S1C6200 Core CPU Program Memory Map Registers S1C6200 Core CPU Registers Flags Quick Reference for Development Data Memory Map Instruction List (1) S1C6200 Core CPU Symbols in the Instruction List Registers/Register Data Memory/Addresses/Memory Data Immediate Data Functions Instruction List (2) S1C6200 Core CPU Instruction List (3) S1C6200 Core CPU Instruction List (4) S1C6200 Core CPU Software Development Flowchart Development Tools 1. Programming 2. Assembly and Linking 3. Option Data Creation * 4. Debugging 5. Mask Data Creation * Page Work Bench wb62 (2) Development Tools [Build] tool bar Controls on [Edit] window [Window] tool bar Tool bars Work Bench wb62 (3) Development Tools [File] menu [Edit] menu [Tools] menu [View] menu Work Bench wb62 (4) Development Tools [Window] menu [Help] menu Short-Cut Key List Assembler as62 (1) Development Tools Start-up Command Usage Pseudo-instructions Assembler as62 (2) Development Tools Operators Linker lk62 Development Tools Start-up Command Usage Warning Messages HEX Converter hx62 Development Tools Start-up Command Usage Disassembler ds62 Development Tools Start-up Command Usage Page Buttons Tool bar [Break] menu Controls on [Source] window Debugger db62 (2) Development Tools Debugger db62 (3) Development Tools [Window] menu [Option] menu [Help] menu [Trace] menu Debugger db62 (4) Development Tools Debug Commands Program memory operation Data memory operation Register operation Program execution Debugger db62 (5) Development Tools Debugger Messages Command errors Command warning ICE errors ICE status International Sales Operations AMERICA EUROPE ASIA