Manuals / Brands / Computer Equipment / Computer Accessories / Epson / Computer Equipment / Computer Accessories

Epson S5U1C63000A CHAPTER 5 LINKER, 5.1 Functions, 5.2 Input/Output Files, 5.2.1 Input Files, ICE parameter file, Linker command file, Fig. 5.2.1 Flow chart

1 346

Download 346 pages, 2.7 Mb

CHAPTER 5: LINKER

CHAPTER 5 LINKER

This chapter describes the functions of the linker, lk63.

5.1 Functions

The linker lk63 is a software that generates executable object files. It provides the following functions:

•Puts together multiple object modules to create one executable object file.•Resolves external reference from one module to another.•Relocates relative addresses to absolute addresses.

•Delivers debugging information, such as line numbers and symbol information, in the object file created after linking.

•Capable of outputting a link map file, symbol file, absolute list file and a cross reference file.

•Automatic page correction function (insertion/removal/correction of the "ldb %ext, imm8" branch extension instruction) for branch instructions.

5.2 Input/Output Files

		from Assembler
	Linker	Relocatable	ICE
	command file	object file(s)	parameter file
	file.cm	file.o	file.par
	file.cm		file.par
		Linker
		lk63
file.map	file.sym	file.abs	file.xrf	file.als	lk63.err
Link	Symbol	Absolute	Cross	Absolute	Error file
map file	file	object file	reference file	list file

to Debugger

Fig. 5.2.1 Flow chart

5.2.1 Input Files

Relocatable object file ∗ This file must always be specified in either a command line or a link command file.

File format: Binary file in IEEE-695 formatFile name: <File name>.o (A path can also be specified.)Description: Object file of individual modules created by the assembler.Linker command file

File format: Text file

File name: <File name>.cm (A path can also be specified.)

Description: File to specify the linker options. This makes it possible to reduce typing in a command line. This file is dispensable if all start-up options can be input in a command line.

ICE parameter file ∗ This file must always be specified in either a command line or a link command file.

File format: Binary fileFile name: <File name>.par (A path can also be specified.)

Description: File to specify the memory mapping and unsupported instruction information of each S1C63 Family model. This file is provided for each model and commonly used with the debugger and HEX converter.

S5U1C63000A MANUAL	EPSON	89
(S1C63 FAMILY ASSEMBLER PACKAGE)

Contents

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)