Epson S5U1C62000A - page 104

92 EPSON S5U1C62000A MANUAL

(S1C60/62 FAMILY ASSEMBLER PACKAGE)

CHAPTER 6: LINKER

-e Function: Output of error file

Explanation: Also delivers in a file (.err) the contents to be output by the linker through the

Standard Output (stdout), such as error messages.

Default: If this option is not specified, no error file will be output.

-g Function: Addition of debugging information

Explanation: • Creates an absolute object file containing debugging information.

•Always specify this function when you perform source display or use the

symbolic debugging facility of the debugger.

Default: If this option is not specified, no debugging information will be added to the

absolute object file.

-l Function: Output of absolute list file

Explanation: Outputs an absolute list file.

Default: If this option is not specified, no absolute list file will be output.

-o <file name>

Function: Specification of output path/file name

Explanation: Specifies an output path/file name without extension or with an extension ".abs".

If no extension is specified, ".abs" will be supplemented at the end of the specified

output path/file name.

Default: The 1st input file name is used for the output files.

-m Function: Output of link map file

Explanation: Outputs a link map file.

Default: If this option is not specified, no link map file will be output.

-s Function: Output of symbol file

Explanation: Outputs a symbol file.

Default: If this option is not specified, no symbol file will be output.

-x Function: Output of cross reference file

Explanation: Outputs a cross reference file.

Default: If this option is not specified, no cross reference file will be output.

-code <address>

Function: Set up of a relocatable CODE section start address

Explanation: • Sets the absolute start address of a relocatable CODE section. Absolute sections

remain unaffected.

•CODE sections are mapped from this address, unless otherwise specified.

•One or more spaces or tabs are necessary between -code and <address>.

•The address should be described in hexadecimal format (0x####).

Default: If this option is not specified, the CODE section will begin from the program

ROM physical start address specified with the ICE parameter file.

Sample description: -code 0x100

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