Family 32-BIT MICROCONTROLLER ABSOLUTE ASSEMBLY LIST GENERAT
|
|
|
Top Searches for this datasheet
CM71-00305-2E
Family
32-BIT MICROCONTROLLER
ABSOLUTE ASSEMBLY LIST GENERATOR TOOL MANUAL
Family
32-BIT MICROCONTROLLER
ABSOLUTE ASSEMBLY LIST GENERATOR TOOL MANUAL
FUJITSU LIMITED
PREFACE
Objectives Intended Readership This manual describes functions absolute assembly list generator utility called MEAL (Make Extended Assemble List), which designed operate Windows Windows MS-DOS UNIX operating systems. This manual written programmers actually using MEAL development application programs Family 32-bit microcontroller. sure read entire manual carefully. text this manual intended description assembler also applied family. Trademarks Microsoft, Windows MS-DOS registered trademarks Microsoft Corporation other countries. UNIX registered trademark licensed X/Open Company, limited other countries. family abbreviation FUJITSU RISC controller. addition, other system names product names used this manual registered trademarks respective corporations organizations. Note that marks used cases.
Configuration This Manual This manual consists four chapters appendix.
Chapter Functions This chapters presents overview MEAL functions. Chapter Operating Procedures This chapters describes start operate MEAL. Chapter Options This chapters provides detailed descriptions options, reference format. Chapter Absolute Assembly Lists This chapters describes contents absolute assembly lists. Appendix appendix provides descriptions error messages output MEAL, lists option formats, notes specifications different operating systems.
contents this document subject change without notice. Customers advised consult with FUJITSU sales representatives beforeordering. information circuit diagrams this document presented examples semiconductor device applications, intended incorporated devices actual use. Also, FUJITSU unable assume responsibility infringement patent rights other rights third parties arising from this information circuit diagrams. contents this document reproduced copied without permission FUJITSU, Ltd. FUJITSU semiconductor devices intended standard applications (computers, office automation other office equipment, industrial, communications, measurement equipment, personal household devices, etc.). CAUTION: Customers considering products special applications where failure abnormal operation directly affect human lives cause physical injury property damage, where extremely high levels reliability demanded (such aerospace systems, atomic energy controls, floor repeaters, vehicle operating controls, medical devices life support, etc.) requested consult with FUJITSU sales representatives before such use. company will responsible damages arising from such without prior approval. semiconductor devices have inherently certain rate failure.You must protect against injury, damage loss from such failures incorporating safety design measures into your facility equipment such redundancy, fire protection, prevention over-current levels other abnormal operating conditions. products described this document represent goods technologies subject certain restrictions export under Foreign Exchange Foreign Trade Control Japan, prior authorization Japanese government should required export those products from Japan.
1997 FUJITSU LIMITED Printed Japan
READING THIS MANUAL
Page Layout this manual, entire section presented single page spread whenever possible. reader thus view section without having flip pages. content each section summarized immediately below title. obtain rough overview this product reading through these summaries. Also, higher level section headings given lower sections that know which section text currently reading belongs without referring table contents cover each chapter.
Finding Information contents section this manual referenced using table contents index normal way, well following methods. find information larger units than index listings "subheading index" useful search subheadings that presented within sections manual. subheading index provides alphabetical listing subheadings, sorted according keywords. remember keywords particular subheading, find list subheadings containing that particular keyword. refer figures tables "figure table index" useful find figures tables anywhere manual. This alphabetical listing figures tables, sorted according keywords. used same subheading index. Notation formats This manual presents definition statements other notations using symbols formats following table. Items enclosed brackets optional omitted from notation. Items enclosed braces alternatives: must selected. vertical represents division between elements notation. Three horizontal dots indicate that immediately preceding item entered repeatedly, many times necessary. Indicates that pressed while <Control> held down.
CTRL-C
[Example] This format indicates that either alpha beta selected. This format indicates that either alpha beta selected, both omitted. [,.] This format indicates that more alphas written.
Note Notation used this manual based MS-DOS conventions. reading this manual, user should aware that path file names used UNIX type systems distinguish between upper lower case letters, MS-DOS systems make this distinction. [Example] meal911 .\test.obj meal911 ./test.obj (MS-DOS) (UNIX based operating systems)
Naming convertor This manual uses following conventions representing product names. Microsoft®Windows®95 operating system represented Windows Naming convertion Windows applies Microsoft®Windows NT®Server network operating system Version 3.51, Microsoft®Windows NT®Workstation operating system Version 3.51, Microsoft®Windows NT®Server network operating system Version Microsoft®Windows NT®Workstation operating system Version 4.0. Microsoft®MS-DOS®operating system Version represented MS-DOS.
Spread Layout
Section title
Section summary Subheading
Subheading Figure table title
MEMO
CONTENTS
CHAPTER FUNCTIONS
Overview.2 Creating Absolute Assembly Lists Selecting List Output Module.6
CHAPTER OPERATING PROCEDURES
2.4.1 2.4.2 2.5.1 2.5.2 Starting Up.8 Startup Format Expressions Execution Environment Variables.12 (Working Directory) FELANG Input/Output Files Input Files Output Files Preparing Generate Absolute Assembly Lists Exit.22 Restrictions
CHAPTER OPTIONS.25
3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 3.20 3.21 3.22 3.23 Options Option Descriptions Specifying Absolute Load Module File [-a] Specifying Relative Assembly List Input Directory [-in].31 Specifying Source File Input Directory [-cin] Specifying Error Data Output File [-ep, -epf].33 Specifying Absolute Assembly List Output Directory [-out].34 Specifying Absolute Assembly List Output Module [-l, -lf] Specifying Absolute Assembly List Output Suppress Module [-nl, -nlf] Specifying ROM/RAM ARRAY List Output [-lr, -lrf].37 Suppressing ROM/RAM ARRAY List Output [-nlr, -nlrf] Specifying NAME, ADDRESS Display Position [-na].39 Specifying NAME, ADDRESS Display Position [-an].40 Specifying Source List Output Module [-lc, -lcf] Specifying Source List Output Suppress Module [-nlc, -nlcf] Specifying Section Information List Output Module [-lsec, -lsecf].43 Specifying Section Information List Output Suppress Module [-nlsec, -nlsecf].44 Specifying Cross Reference List Output Module [-lcros, -lcrosf] Specifying Cross Reference List Output Suppress Module [-nlcros, -nlcrosf] Displaying Version Number/Message [-V] Suppressing Version Number/Message Display [-XV] Displaying Help Message [-help] Specifying Option File Name [-f]
CHAPTER ABSOLUTE ASSEMBLY LISTS
List Format. Header Information Lists. ROM/RAM ARRAY Listings Assembly Source Listing. Source Listing. Section Information Listing. Cross Reference Listing.
APPENDIX
Appendix Appendix Appendix Appendix Appendix Error Messages Option Format Lists Sample Absolute Assembly Listing Output Differences Operating System Specifications Windows 95/Windows Version
INDEX.
Keyword Index Subheading Index Figure Table Index
viii
FIGURES
Figure Figure Figure Example Selection Absolute Assembly List MEAL Input/Output Files Assembly List Configuration
TABLES
Table Table Table Table Table Table Codes State Processing Option List Rrelation between -nlf Options Option Option Format Lists.79 Differences Operating System Specifications Handling Omitted File Names
CHAPTER
FUNCTIONS
This chapter presents overview MEAL functions.
Overview Creating Absolute Assembler Lists Selecting List Output Module
Overview
FR20 family absolute assembly list generation tool (hereafter referred MEAL) utility program that generates absolute assembly lists based assembler lists produced FR20 family assembler.
Overview Assemblers produce assembly lists that generated using relative addressing with linked programs. This because possible know what actual assembled addresses will until linking completed. Such lists called relative assembly lists.* Absolute assembly lists, other hand, express addresses absolute form using results module linking feedback. MEAL utility program that generates absolute assembly lists from relative-type assembly lists. This program referenced during debugging assembly language level enables user identify addresses each machine language steps, which impossible identify from link lists. Functions MEAL following functions: Generation absolute assembly lists Selection list output modules This manual refers such lists "relative assembly lists" distinguish them from "absolute assembly lists."
MEMO
Creating Absolute Assembly Lists
Absolute assembly lists generated based assembly lists relative format. This process involves conversion following components relative assembly list: Locations within section Machine language code Cross-reference listings
Locations within Section Locations within section assembly list expressed absolute addresses. [Example] Assembler output: Relative assembly list LLINE SOURCE
00000000 -<CODE>- 2390 00000000 00000002 00000004 0F05 C030 2391 2392
.SECTION CODE,CODE ENTER
Relative location values within section
MEAL output: Absolute assembly list LLINE SOURCE
0000402C 0000402C 0000402E 00004030
-<CODE>- 2390 0F05 C030 2391 2392
.SECTION CODE,CODE ENTER
Absolute addresses program
Creating Absolute Assembly Lists
Machine Language Code addresses undefined assembly level, therefore follows that address component machine language also undefined this point. machine language also undefined symbols used external references. absolute assembly list, machine language that undefined relative assembly list expressed using values determined time that information values linked. [Example] Assembler output: Relative assembly list LLINE SOURCE
00000004 00000006 00000008 9000000E 00000014
A810 8BE0 A580 9F8100000000 9F8C00000000
10257 10258 10259 10260 10261
LDI:32 CALL32
#-8, #RELSYM, EXTSYM,
RELSYM, EXTSYM values undefined
MEAL output: Absolute assembly list LLINE SOURCE
00000004 00000006 00000008 0000000E 00000014
A810 8BE0 A580 9F81040000FF 9F8C0000206C
10257 10258 10259 10260 10261
LDI:32 CALL32
#-8, #RELSYM, EXTSYM,
RELSYM, EXTSYM values determined
Cross Reference Listings cross reference listings, symbol addresses expressed 32-bit absolute addresses.
Selecting List Output Module
MEAL allows user select more modules that comprise program used output absolute assembly lists.
Selecting List Output Module Figure shows example selection modules absolute assembly lists.
Entire program Relative assembly list files
xxxx1.lst
xxxx2.lst
xxxx3.lst
xxxx4.lst
MEAL
Selects xxxx2 xxxx4 output
xxxx1.als
xxxx2.als
xxxx3.als
xxxx4.als
Absolute assembly list files
Figure Example Selection Absolute Assembly List
CHAPTER
OPERATING PROCEDURES
This chapter describes start operate MEAL.
Starting Startup Format Expressions Execution Environment Variables Input/Output Files Preparing Generate Absolute Assembly Lists Exit Restrictions
Starting
There ways start MEAL. input file name options specified follows: specified directly command line Specified using option files Options used determine MEAL processing works.
Direct Description Using Startup Command Statements this method, MEAL input files options specified directly command line. [Synopsis] meal911 input-file-name [option(s)] input file name option specified position. input-file-name name link list file generated during linking. file name extension given, ".mp1" will assumed. Option(s) Used determine detailed processing operations.
[Options] -option-name [parameter.] Options designated hyphen preceding option name. Parameters, required, must separated spaces. option specified, MEAL will default settings. default settings detailed information about options, Chapter "Options."
[Examples] meal911 system.mp1 -lcros sigctl.lst,tgetpic.lst meal911 -lcros sigctl.lst,tgetpic.lst system.mp1
Description Using Option Files this method, command line contains name file which options listed. This effective when there many files command line, when applying same processing many times. [Synopsis] meal911 option-file-name option-file-name: name file which options listed
[Example] fmeal911 mealcmd.opt
[Option file notation format] syntax same description command line, except that following items added option file. Comment lines added. Line returns inserted desired position. Comment lines begin with comment symbol with line return. Each comment line line return symbol treated equivalent space command line.
[Notes use] More than option specified line, however number characters line must exceed bytes. More than option file invoked line, however possible option file call another option file option).
[Example] MEAL911 option-file sample.mp1 -lcros sigctl.lst, tgtdef.lst Specification continues Link list file name
Startup Format Expressions
Either enter startup name (meal911) itself, specify -help options MEAL startup format.
Startup Format Expressions following table lists startup format option statements, with simplified descriptions.
usage meal911 [-option.] link-map-file-name -options -cin -epf -out filename path filename path path specify absolute load module file specify relative assembly list file stored path specify source file stored path display error information specify target file error information display specify absolute assembly list output path absolute assembly list output inhibit absolute assembly list output
filename[,.]: specify target file absolute assembly list
environment variable FELANG used display text Japanese. environment variable FELANG, Section 2.4, "Environment Variables."
Execution
MEAL starts executing first checking command line descriptions, will indicate errors displaying standard error messages output returning control operating system. this case, processing will executed. there errors input file names option specification, processing will begin.
Execution MEAL starts executing first checking command line descriptions (including contents option files when specified option), will indicate errors displaying standard error messages output returning control operating system. this case, processing will executed. errors must corrected then program restarted. there errors input file names option specification, processing will begin. Errors that occur during processing indicated displaying standard error messages output. there fatal error (making further execution impossible), processing will aborted control returned operating system.
Environment Variables
MEAL supports types environment variables. FELANG
(Working Directory) variable identifies working directory. details, Section 2.4.1, "TMP (Working Directory)."
FELANG variable FELANG used select specify language used message statements. details, Section 2.4.2, "FELANG."
Environment Variables
2.4.1 (Working Directory)
variable specifies working directory used MEAL during execution. This section shows formats statements, with explanations examples.
(Working Directory)
[MS-DOS synopsis] <path-name>
[UNIX-based operating system synopsis] setenv <path-name>
[Explanation] Identifies working directory used MEAL during execution environment variable also used with other FR20 family development tools compilers, assemblers, linkage kits, etc.). environment variable absent, following directory used. MS-DOS systems current directory
UNIX based operating systems /tmp
[Examples] =G:\WORK setenv TMP/usr/tmp MS-DOS systems UNIX-based operating systems
Environment Variables
2.4.2 FELANG
variable FELANG used select specify language used message statements, such help messages error messages. This section shows description formats FELANG, with explanations examples.
FELANG [MS-DOS format] FELANG= {ASCII SJIS}
[UNIX-based operating system format] setenv FELANG {ASCII SJIS} ASCII: English ASCII code (default) EUC: Japanese code SJIS: Japanese SJIS code
[Explanation] Selects either English Japanese help message displays. specified, English messages ASCII code) selected. systems without Japanese language environment, FELANG environment variable does operate with codes other than SJIS; specify ASCII setting. FELANG environmental variable also used with other FR20 family development tools compilers, assemblers, etc.). [Examples] FELANG=SJIS setenv FELANG MS-DOS UNIX-based operating systems
Input/Output Files
This section describes relationship MEAL input output files shown Figure 2.5.
Input/Output Files only item that must clearly specified input MEAL link list output from linking process. When link list generated, option must specified, information must output without omitting section names. Implicit reference made files enclosed dotted lines Figure including absolute load module, relative assembly list source files. Therefore necessary specify each these items, files themselves must available. Note that necessary provide relative assembly lists which absolute assembly lists output, source files modules which source listing output specified. MEAL output normally contained multiple absolute assembly lists.
Relative assembly list files
xxxxx.lst
Link list file xxxxx.mp1
Absolute load module files xxxxx.abs
source files
MEAL xxxxx.c
Absolute assembly list files
xxxxx.als
Figure MEAL Input/Output Files
Input/Output Files
2.5.1 Input Files
Four types files required input MEAL: Link lists Absolute load modules Relative assembly lists source (when source lists specified output)
Input Files From specified link list file, MEAL reads input (linked) module names absolute load module file names. from input module name, MEAL assumes name assembly list file. Note that absolute load module linked relative load module object module within library file, necessary specifically identify name linked object module. [Example]
FR20 Series Linker
Control List
1995-03-17 11:18:23
Option File(s)
Control(s) hyperw.abs userlb.lib hyperw.mp1 PROG=0xc0000/0xcffff DATA=0x0000/0x03ff code+const=PROG,data+stack=DATA Absolute load module file name hyperw.abs
Input Module(s) pca01.obj(pca01) pcasb.obj(pcasb) xccdef.obj(xccdef) Assembly list file name pca01.lst Assembly list file name pcasb.lst Assembly list file name xccdef.lst
Absolute load module names specified user. name specified, MEAL will file name read from link list. link list contains absolute load module name specifications option), MEAL will assume name link list file with file name extension ".abs". order conservedisk space, assembly lists designed stored separate directories, details, Chapter "Options." source list output specified, source file name read from debugging information. this case, necessary specify output debugging information option) during compiling assembling. also possible designate directory contain source file. details, Chapter "Options."
Input/Output Files
2.5.2 Output Files
MEAL output normally contained multiple absolute assembly lists.
Absolute assembly lists
Output Files absolute assembly list output each object module (source program file) that makes load module. File names absolute assembly lists consist input module name plus file name extension ".als". user select which module(s) required absolute assembly list, also select modules that required. order conserve disk space, assembly lists designed stored separate directories. details, Chapter "Options."
MEMO
Preparing Generate Absolute Assembly Lists
following preparations necessary generate absolute assembly lists. Relative assembly list object module Absolute load module link list source source listing output specified)
Compiling output ROM/RAM ARRAY listings source listings necessary specify output debugging information.
Assembly assembly process, relative assembly list object module generated. Note following restrictions: Whenever programs macro processing language include files, such notations must stated expanded format assembly list. This because MEAL operates comparing object code load module files with machine language statements assembly list, output omissions from assembly list will therefore cause process alignment. DUMMY sections should avoided. DUMMY sections will have corresponding machine language expression assembly list, will generate object code load module likely trigger errors MEAL. Object file names assembly list file names should match except file name extension. options specifying files with different names should avoided. [Example] fasm911 fasm911 sample.asm main.obj sample.lst [Not acceptable] sample.asm main.obj main.lst [Acceptable]
first example, object file name does enable program assume list file name. second example does enable program assume list file name, therefore acceptable. When specifying output ROM/RAM ARRAY listings, source lists, sure specify output debugging data. These lists cannot generated without output debugging data. such cases, also necessary specify output debugging data during compiling.
Linking linking process, absolute load modules link lists generated. Link lists must specified time MEAL started. link list section names lengthy, they output truncated form. Specify option linking output section names without truncation.
Note Absolute Assembly List Generation types files that form input this process must left form that established linking stage. File names must changed after linking, that assembly list file names assumed based names input modules link list. also necessary avoid correcting reassembling source files regenerate relative assembly lists. such changes made, file names differ from names assumed from input module name, with result that file searches will fail assembly lists formed after time load module generation will cause errors MEAL. recommended that assembly, linking MEAL executed single batch process.
Exit
MEAL uses code indicate processing return control operating system. abort MEAL processing, enter CTRL-C.
Code Values Status MEAL uses code indicate state processing (normal end, error, etc.) return control operating system. Table shows codes corresponding state processing. Table Codes State Processing code state processing Normal warning-level error Error prevented generation output Fatal error, continued processing impossible
codes useful when executing series processes batch using multiple support software packages operating system, from compiling linking absolute assembly list generation. example, error linking will prevent generation proper absolute assembly lists. this case code from linking process used determine where suspend batch processing change flow execution order avoid unnecessary production output lists. information batch processing, refer your operating system manual.
Forced Termination When necessary abort MEAL processing, enter CTRL-C. MEAL processing will aborted, control will return operating system. Processed files will remain they were before processing aborted, files being processed will deleted.
Restrictions
MEAL places limits factors such number modules that registered while program operating. these limits exceeded, MEAL will operate properly.
Restrictions Option Notation following limitations apply MEAL option descriptions. Number files that listed parameters following options: -nlf -lrf -nlrf -lcf -nlcf -lsecf -nlsecf -lcrosf -nlcrosf
Restrictions Assembly During assembly, -linf, -lsrc, -linc, -lexp option specifications should assembly list output should include information lists, source lists, include files macro expansions. dummy section specifications should made section attribute settings. required information output, dummy section used, MEAL will return error message.
MEMO
CHAPTER
OPTIONS
Options used control operation MEAL, output absolute assembly lists. This chapter provides detailed descriptions options.
Options Option Descriptions Specifying Absolute Load Module File [-a] Specifying Relative Assembly List Input Directory [-in] Specifying Source File Input Directory [-cin] Specifying Error Data Output File [-ep, -epf] Specifying Absolute Assembly List Output Directory [-out] Specifying Absolute Assembly List Output Module [-l, -lf] Specifying Absolute Assembly List Output Suppress Module [-nl, -nlf]
3.10 Specifying ROM/RAM ARRAY List Output [-lf, -lrf] 3.11 Suppressing ROM/RAM ARRAY List Output [-nlr, -nlrf] 3.12 Specifying NAME, ADDRESS Display Position [-na] 3.13 Specifying NAME, ADDRESS Display Position [-an] 3.14 Specifying Source List Output Module [-lc, -lcf] 3.15 Specifying Source List Output Suppress Module [-nlc, -nlcf] 3.16 Specifying Section Information List Output Module [-lsec, -lsecf] 3.17 Specifying Section Information List Output Suppress Module [-nlsec, -nlsecf] 3.18 Specifying Cross Reference List Output Module [-lcros, -lcrosf] 3.19 Specifying Cross Reference List Output Suppress Module [-nlcros, -nlcrosf] 3.20 Displaying Version Number/Message [-V] 3.21 Suppressing Version Number/Message Display [-XV] 3.22 Displaying Help Message [-help] 3.23 Specifying Option File Name [-f]
Options
Options used control operation MEAL, control output absolute assembly lists provide detailed specifications input files other resources.
Option Formats options preceded hyphen head option name. When more than option used, space between option names. Parameters written after option names, separated more spaces. Multiple parameters, used, separated commas. Some options require parameters, others parameters. -option-name [parameter [,.]]
Option List Option names case-sensitive, that capital lower-case letters considered different. Table lists options used MEAL. options specified, MEAL performs following processing: Outputs list modules Outputs absolute assembly listing with section information listing cross reference listing relative assembly lists used) more contradictory options specified, last option will valid. Options within each following combinations contradictory: -epf -nlf -nlr -lrf -nlrf -nlc -lcf -nlcf -lsec -nlsec -lsecf -nlsecf -lcros -nlcros -lcrosf -nlcrosf
Table Option List Option file-name path -cin path -epf file-name -out path file-name [,.] -nlf file-name [,.] -lrf file-name [,.] -nlr -nlrf file-name [,.] Format function Specifies input absolute load module file name Specifies relative assembly list file input directory Specifies source file input directory Displays error information standard output Specifies error information output file Specifies directory absolute assembly list file output Specifies output entire absolute assembly list file Specifies output selected absolute assembly list files Suppresses output entire absolute assembly list file Suppresses output selected absolute assembly list file(s) Specifies output ROM/RAM ARRAY lists Specifies output ROM/RAM ARRAY lists selected modules Suppresses output ROM/RAM ARRAY lists Suppresses output ROM/RAM ARRAY lists selected module(s) Outputs ROM/RAM ARRAY lists NAME, ADDRESS sequence Outputs ROM/RAM ARRAY lists ADDRESS, NAME sequence Specifies source list output
Table Option List (Continued) Option -lcf file-name [,.] -nlc -nlcf file-name [,.] -lsec -lsecf file-name [,.] -nlsec -nlsecf file-name [,.] -lcros -lcrosf file-name [,.] -nlcros Format function Specifies selected modules source list output Suppresses source list output Suppresses source list output selected modules Specifies section information list output Specifies section information list output selected modules Suppresses section information list output Suppresses section information list output selected modules Specifies cross reference output Specifies cross reference output selected modules Suppresses cross reference output
-nlcrosf file-name [,.] Suppresses cross reference output selected modules -help file-name Specifies version/message display Suppresses version/message display Specifies display help messages Specifies option file name(s)
Option Descriptions
This section describes format function each option used MEAL. Where necessary, sample commands also given.
Format Detailed Description Options
Overview option
Summary function
[Synopsis]
-XXX <XXXXX>
[Parameters]
<XXXXX>
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxx
[Explanation] xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxx [Example] meal911 xxxxx -xxx xxxxx
Synopsis
Shows designated format option statements.
Parameter(s): Describes operation parameter(s) <XXXXX> used with option. Explanation Describes function option. Example(s) Sample option statement
Specifying Absolute Load Module File [-a]
This option specifies name absolute load module file input MEAL. absolute load module file contains names modules linked generate absolute assembly lists.
[Synopsis]
[Parameter] Name absolute load module file input MEAL.
[Explanation] absolute load module file referenced during generation lists output MEAL. This option should specify name absolute load module file created linker. This load module file contains names modules linked generate absolute assembly lists. file name extension omitted, extension ".abs" assumed. directory path name given, current directory will used. this option specified, name absolute load module file determined following steps: MEAL will automatically reference absolute load module file name (linker option), which must specified link list linker control option display area time MEAL started. step does contain option specification, MEAL will name link list file specified startup, file name extension ".abs" will added. directory path this case will same path link list file. This option must used directory storing absolute load module file changed after linking, changes made file name. [Examples] meal911 sample d:\frabs\sample.abs meal911 sample d:\frabs\sample above examples equivalent meaning.
Specifying Relative Assembly List Input Directory [-in]
This option specifies directory containing relative assembly list file. omitted, current directory used.
[Synopsis] <path-name>
[Parameter] <path-name>: Directory containing relative assembly list file.
[Explanation] This option specifies directory containing relative assembly list file. this option omitted, current directory used. option with path name relative assembly list file, MEAL will give priority path specified with option. [Examples] meal911 sample d:\fr20 swctrl.lst,mstdef.lst meal911 sample above examples equivalent meaning.
Table shows relation between -nlf options option. Table Relation between -nlf Options option -lf, -nlf option specification xxx.lst option specification d:\fr20 None d:\fr20\xxx.lst xxxxx.lst c:\fasm\xxx.lst c:\fasm\xxx.lst c:\fasm\xxx.lst
Specifying Source File Input Directory [-cin]
This option specifies directory containing source file. omitted, MEAL will refer available debugging information.
[Synopsis] -cin <path-name>
[Parameter] <path-name>: Directory containing source file
[Explanation] This option specifies directory containing source file. this control command omitted, MEAL will refer available debugging information. This option effective only with modules which ROM/RAM ARRAY listing output specified. [Example] meal911 sample -cin d:\fr20\csrc
Specifying Error Data Output File [-ep, -epf]
This option determines where error information output. specification made, default setting standard error output.
[Synopsis] [Parameter] None [Explanation] Error information output standard error output. This option specifies default setting, therefore actually required. option invalidates previous -epf options. [Examples] meal911 sample meal911 sample above examples equivalent meaning. [Synopsis] -epf [Parameter] <file-name>: [Explanation] Specifies name error information output file. directory path specified <file-name>, current directory used. <file-name> default file name extension. -epf option invalidates previous options. [Example] meal911 sample -epf meal.err Specifies name file receive error information output. <file-name> (default)
Specifying Absolute Assembly List Output Directory [-out]
This option specifies directory which absolute assembly list files output.
[Synopsis] -out <path-name>
[Parameter] <path-name>: Directory which absolute assembly list files output.
[Explanation] This option specifies directory which absolute assembly list files output. this option specified, current directory used. [Example]
meal911 sample d:\fr20 swctrl.lst,mstdef.lst -out d:\fr20\als
Specifying Absolute Assembly List Output Module [-l, -lf]
This option specifies object modules generation absolute assembly list output. used specify output from object modules, from selected modules.
[Synopsis] [Parameter] None [Explanation] Specifies that absolute assembly lists generated from modules. This option specifies default setting, therefore actually required. option invalidates previous -lf, -nl, -nlf options. [Examples] meal911 sample meal911 sample above examples equivalent meaning. [Synopsis] [Parameter] Name relative assembly list file from which generate absolute assembly lists. [Explanation] This option selects module generation absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. absolute assembly lists will generated from modules specified this option. This option divided into multiple option statements. This option invalidates previous -nl, -nlf options. option used specify directory path containing relative assembly list, that possible omit path designation from this option statement. [Examples] meal911 sample swctrl.lst,mstdef.lst meal911 sample swctrl.lst mstdef.lst meal911 sample swctrl mstdef above three examples equivalent meaning. [,.] (Default)
Specifying Absolute Assembly List Output Suppress Module [-nl, -nlf]
This option specifies modules from which absolute assembly list output suppressed. used suppress output from object modules, from selected modules.
[Synopsis] [Parameter] None [Explanation] Because this option specifies that absolute assembly list generation suppressed modules, used invalidate previous -lf, -nlf options. With this option, absolute assembly list generation executed contents related input files checked whether files required processing present. [Example] meal911 sample swctrl.lst,mstdef.lst [Synopsis] -nlf [Parameter] Name relative assembly list file module which absolute assembly list generation suppressed. [Explanation] This option selects modules from which absolute assembly lists generated. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. Absolute assembly lists will generated from modules specified this option. This option divided into multiple option statements. This option invalidates previous -nf, -nlf options. option used specify directory path containing relative assembly list, that possible omit path designation from this option statement. [Examples] meal911 sample -nlf swctrl.lst,mstdef.lst meal911 sample -nlf swctrl.lst -nlf mstdef.lst meal911 sample -nlf swctrl -nlf mstdef above three examples equivalent meaning. [,.]
3.10
Specifying ROM/RAM ARRAY List Output [-lr, -lrf]
This option specifies modules output ROM/RAM ARRAY listings. Debugging information must output during compiling assembly.
[Synopsis] [Parameter] None [Explanation] This option specifies that ROM/RAM ARRAY listings will appended absolute assembly lists. This option invalidates previous -lrf, -nlr, -nlrf options. ROM/RAM ARRAY listings cannot generated absolute load modules which debugging information been output. debugging information output option (-g) specify output during compiling, assembly linking. [Examples] meal911 sample meal911 sample above examples equivalent meaning. [Synopsis] -lrf [Parameter] Modules ROM/RAM ARRAY listing output specified using name corresponding relative assembly list file. [Explanation] This options selects modules which ROM/RAM ARRAY listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. ROM/RAM ARRAY listings will generated modules specified this option. This option divided into multiple option statements. This option invalidates previous -lr, -nlr, -nlrf options. [Examples] meal911 sample -lrf swctrl.lst,mstdef.lst meal911 sample -lrf swctrl,mstdef meal911 sample -lrf swctrl.lst -lrf mstdef.lst above three examples equivalent meaning. [,.]
3.11
Suppressing ROM/RAM ARRAY List Output [-nlr, -nlrf]
This option specifies modules which ROM/RAM ARRAY listings output.
[Synopsis] -nlr [Parameter] None [Explanation] This option specifies that ROM/RAM ARRAY listings appended absolute assembly lists. This option specifies default setting, therefore actually required. This option invalidates previous -lr, -lrf, -nlrf options. debugging information present absolute load module, ROM/RAM ARRAY listings cannot generated regardless this option statement. [Example] meal911 sample -nlr [Synopsis] -nlrf [Parameter] Modules which ROM/RAM ARRAY listing output suppressed specified using name corresponding relative assembly list file. [Explanation] This option selects modules which ROM/RAM ARRAY listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. ROM/RAM ARRAY listings will generated modules specified this option. This option divided into multiple option statements. This option invalidates previous -lr, -lrf, -nlr options. [Examples] meal911 sample -nlrf swctrl.lst,mstdef.lst meal911 sample -nlrf swctrl,mstdef meal911 sample -nlrf swctrl.lst -nlrf mstdef.lst above three examples equivalent meaning. [,.] (default)
3.12
Specifying NAME, ADDRESS Display Position [-na]
This option specifies output ROM/RAM ARRAY listing symbols addresses NAME, ADDRESS sequence.
[Synopsis] (default)
[Parameter] None
[Explanation] This option specifies output ROM/RAM ARRAY listing symbols addresses NAME, ADDRESS sequence. Symbols output alphabetic order. This option valid only modules which ROM/RAM ARRAY listing output been specified. This option specifies default function, primarily used cancel previous option setting. [Examples] meal911 sample -nlr swctrl.lst,mstdef.lst meal911 sample -nlr swctrl.lst,mstdef.lst above examples equivalent meaning.
3.13
Specifying NAME, ADDRESS Display Position [-an]
This option specifies output ROM/RAM ARRAY listing symbols addresses ADDRESS, NAME sequence.
[Synopsis]
[Parameter] None
[Explanation] This option specifies output ROM/RAM ARRAY listing symbols addresses ADDRESS, NAME sequence. Symbols output order address. This option used change option setting (default). This option valid only modules which ROM/RAM ARRAY listing output been specified. [Examples] meal911 sample -nlr swctrl.lst,mstdef.lst meal911 sample -nlr swctrl.lst,mstdef.lst above examples equivalent meaning.
3.14
Specifying Source List Output Module [-lc, -lcf]
This option specifies modules source listing output. Debugging information must output during compiling assembly.
[Synopsis] [Parameter] None [Explanation] This option appends source listings absolute assembly lists. This option invalidates previous -lcf, -nlc, -nlcf options. source listings cannot generated absolute load modules which debugging information been output. debugging output option (-g) specify output during compiling, assembly linking. [Examples] meal911 sample meal911 sample above examples equivalent meaning. [Synopsis] -lcf [Parameter] Modules source listing output specified using name corresponding relative assembly list file. [Explanation] This option selects modules from which source listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. source listings will generated from modules specified this option. This option divided into multiple option statements. This option invalidates previous -lc, -nlc, -nlcf options. [Examples] meal911 sample -lcf swctrl.lst,mstdef.lst meal911 sample -lcf swctrl,mstdef meal911 sample -lcf swctrl.lst -lcf mstdef.lst above three examples equivalent meaning. [,.]
3.15
Specifying Source List Output Suppress Module [-nlc, -nlcf]
This options suppresses source listing output specified modules.
[Synopsis] -nlc [Parameter] None [Explanation] This option specifies that source listings appended absolute assembly lists. This option specifies default setting, therefore actually required. This option invalidates previous -lc, -lcf, -nlcf options. [Example] meal911 sample -nlc [Synopsis] -nlcf [,.] [Parameter] Modules which source listing output suppressed specified using name corresponding relative assembly list file. [Explanation] This options selects modules which source listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. source listings will generated modules specified this option. This option divided into multiple option statements. This option invalidates previous -lc, -nlc, -nlcf options. [Examples] meal911 sample -nlcf swctrl.lst,mstdef.lst meal911 sample -nlcf swctrl,mstdef meal911 sample -nlcf swctrl.lst -nlcf mstdef.lst above three examples equivalent meaning. (default)
3.16
Specifying Section Information List Output Module [-lsec, -lsecf]
This option specifies that section information listings from original relative assembly lists output absolute assembly lists. option statement used, MEAL will follow relative assembly list output state.
[Synopsis] -lsec [Parameter] None [Explanation] This option appends section information listings absolute assembly lists. This option specifies default setting, therefore actually required. This option invalidates previous -lsecf, -nlsec, -nlsecf options. section information listings generated section information been output original relative assembly lists, regardless this option statement. (default)
[Examples] meal911 sample -lsec meal911 sample above examples equivalent meaning. [Synopsis] -lsecf [Parameter] Modules section information listing output specified using name corresponding relative assembly list file. [Explanation] This option selects modules which section information listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. Section information listings will generated modules specified this option. Section information listings cannot generated unless section information been output relative assembly lists specified this option. This option divided into multiple option statements. This option invalidates previous -lsec, -nlsec, -nlsecf options. [Examples] meal911 sample -lsecf swctrl.lst,mstdef.lst meal911 sample -lsecf swctrl,mstdef meal911 sample -lsecf swctrl.lst -lsecf mstdef.lst above three examples equivalent meaning. [,.]
3.17
Specifying Section Information List Output Suppress Module [-nlsec, -nlsecf]
This option suppresses output section information listings from original relative assembly lists. option statement used, MEAL will follow relative assembly list output state.
[Synopsis] -nlsec [Parameter] None [Explanation] This option specifies that section information listings appended absolute assembly lists. This option invalidates previous -lsec, -lsecf, -nlsecf options. [Examples] meal911 sample -nlsec meal911 sample -lsec -nlsec above examples equivalent meaning. [Synopsis] -nlsecf [Parameter] Modules which section information listing output suppressed specified using name corresponding relative assembly list file. [Explanation] This option selects modules which section information listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. Section information listings will generated modules specified this option. section information listings generated modules (not specified this option) which section information output original relative assembly lists. This option divided into multiple option statements. This option invalidates previous -lsec, -lsecf, -nlsec options. [Examples] meal911 sample -nlsecf swctrl.lst,mstdef.lst meal911 sample -nlsecf swctrl.lst -nlsecf mstdef.lst meal911 sample -nlsecf swctrl -nlsecf mstdef above three examples equivalent meaning. [,.]
3.18
Specifying Cross Reference List Output Module [-lcros, -lcrosf]
This option specifies that cross reference listings from original relative assembly lists output absolute assembly lists. option statement used, MEAL will follow relative assembly list output state.
[Synopsis] -lcros (default)
[Parameter] None [Explanation] This option appends cross reference listings absolute assembly lists. This option specifies default setting, therefore actually required. cross reference listings generated section information been output relative assembly lists. This option used invalidate previous -nlcros, -lcrosf, -nlcrosf options. [Examples] meal911 sample -lcros meal911 sample above examples equivalent meaning. [Synopsis] -lcrosf [,.]
[Parameter] cross reference listing output specified using name corresponding relative assembly list file. [Explanation] This option selects modules which cross reference listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. Cross reference listings will generated modules specified this option. Cross reference listings cannot generated unless cross reference information been output relative assembly lists specified this option. This option divided into multiple option statements. This option invalidates previous -lcros, -nlclos, -nlcrosf options. [Examples] meal911 sample -lcrosf swctrl.lst,mstdef.lst meal911 sample -lcrosf swctrl,mstdef meal911 sample -lcrosf swctrl.lst -lcrosf mstdef.lst above three examples equivalent meaning.
3.19
Specifying Cross Reference List Output Suppress Module [-nlcros, -nlcrosf]
This option suppresses output cross reference listings from original relative assembly lists. option statement used, MEAL will follow relative assembly list output state.
[Synopsis] -nlcros [Parameter] None [Explanation] This option specifies that cross reference listings appended absolute assembly lists. This option invalidates previous -lcros, -lcrosf, -nlcrosf options. [Examples] meal911 sample -nlcros meal911 sample -lcros -nlcros above examples equivalent meaning. [Synopsis] -nlcrosf [,.]
[Parameter] Modules which cross reference listing output suppressed specified using name corresponding relative assembly list file. [Explanation] This option selects modules which cross reference listings appended absolute assembly lists. Modules specified using name corresponding relative assembly list file. file name extension omitted, extension ".lst" assumed. Cross reference listings will generated modules specified this option. cross reference listings generated target modules (not specified this option) which cross reference information output original relative assembly lists. This option divided into multiple option statements. This option invalidates previous -lcros, -nlcros, -lcrosf options. [Examples] meal911 sample -nlcrosf swctrl.lst,mstdef.lst meal911 sample -nlcrosf swctrl.lst -nlcrosf mstdef.lst meal911 sample -nlcrosf swctrl -nlcrosf mstdef above three examples equivalent meaning.
3.20
Displaying Version Number/Message [-V]
Under default settings, MEAL does output startup message. This option used specify output startup message.
[Synopsis] [Parameter] None
[Explanation] This option used specify output startup messages. startup message displays program version, copyright information, etc. startup message will output unless this option specified. [Example] meal911 sample -lrf swctrl.lst,mstdef.lst
3.21
Suppressing Version Number/Message Display [-XV]
This option suppresses output startup message. used invalidate previous option.
[Synopsis] (default)
[Parameter] None
[Explanation] This option represents default setting, used cancel previous option.
[Examples] meal911 sample -lrf swctrl.lst,mstdef.lst meal911 sample -lrf swctrl.lst,mstdef.lst above examples equivalent meaning.
3.22
Displaying Help Message [-help]
This option specifies display MEAL startup format list options.
[Synopsis] -help
[Parameter] None
[Explanation] This option specifies display MEAL startup screen list options. Help messages shown standard output format. When this option valid, MEAL program will execute only help message screen will displayed. help message screen will displayed even when only MEAL startup command name (meal911) specified. [Examples] meal911 meal911 -help meal911 sample -help above three examples equivalent meaning.
3.23
Specifying Option File Name [-f]
This option specifies file containing option data. same effect contents designated file were specified command line. This option effective when using many files appear startup statement, when applying process repetitively.
[Synopsis] <option-file-name>
[Parameter] <option-file-name>: Specifies name file containing option data.
[Explanation] specified file contain option statements well names input files. This option should used when giving detailed instructions MEAL involving statements lengthy command line, when applying same process repetitively. There default value file name extensions. This option cannot used within option file. [Examples] meal911 sample -epf meal.err -cin d:\fr20\csrc Contents file meal.opt -epf meal.err -cin d:\fr20\csrc
meal911 sample meal.opt Contents file sample.opt sample -epf meal.err -cin d:\fr20\csrc
meal911 sample.opt above three examples equivalent meaning.
CHAPTER
ABSOLUTE ASSEMBLY LISTS
This chapter describes contents absolute assembly lists, which essentially identical relative assembly lists.
List Format Header Information Lists ROM/RAM ARRAY Listings Assembly Source Listing Source Listing Section Information Listing Cross Reference Listing
List Format
Each absolute assembly list output from MEAL consists header, information list, ROM/RAM ARRAY listings, source listings, section information listing cross reference listing. Figure shows configuration assembly list.
List Format Header header appears each page. Information list information list output unchanged, output from assembler. ROM/RAM ARRAY lists ROM/RAM listing name absolute address information output each global symbol placed ROM/RAM area. ARRAY listing Names array elements output with names structures absolute address information. ROM/RAM ARRAY listings shown option specified, suppressed when -nlr option specified. Source listings Assembly source listing assembly source listing displays various information related assembly source program, according line number. information shown includes error information, location, object code. source listing source listing displays source program, correlated with line numbers. source listings shown option specified. -nlc option specified, assembly source listing shown. Section information listing This list presents name attributes each section defined source program. Section information listings shown when -lsec option specified, suppressed when -nlsec option specified. Section information listings processed MEAL, shown just they output from assembler.
Cross reference listing This list shows definition cross-reference relationships symbol names used source program, indexed line number. Cross reference listings shown when -lcros option specified, suppressed when -nlcros option specified. details concerning MEAL options, Chapter "Options." overall configuration assembly list shown below.
Information list
ROM/RAM lists
option
ARRAY lists
Assembly source listings
source listings
option
Section information listings
-lsec option
Cross reference listings
-lcros option
Figure Assembly List Configuration
Error Messages Assembly Lists Error messages related errors occurring during assembly will shown assembly list just they were output from assembler.
Header Information Lists
header 4-line format. first page each assembly list begins with header, followed information list (description settings effect assembler startup, number errors, number warnings, source file name, include file name(s), option file name(s), etc.).
Header Format header composed four lines, appears each page. format first lines same throughout assembly list, third line changes according source program. header format described below.
[Lines
FR20 Series MEAL VxxLxx
yyyy-mm-dd hh:mm:ss
Page: xxxxx
Tool name
Absolute assembly list generation date
Page number
[Line
list-name
(module-name)
This line shows name original assembly list.
[Line This line blank.
MEMO
ROM/RAM ARRAY Listings
ROM/RAM ARRAY listings show information about symbols used writing source programs. output ROM/RAM ARRAY listings, necessary specify output debugging information during compiling assembling.
ROM/RAM ARRAY Listings ROM/RAM lists have following format: ROM/RAM LISTING (module-name)
NAME -Name-*1
ADDRESS xxxxxxx
VALUE xxxxxxx
KIND
MEMORY
ARRAY listings have following format: ARRAY LISTING (module-name)
NAME -Name-*1
ADDRESS xxxxxxx
VALUE xxxxxxx
Symbol name This field contains name symbol used program. ARRAY listings, indicates elements arrays structures.
Address This field contains absolute address hexadecimal format.
position symbol name address changed using option setting. Specify option list symbol name followed address, option list address followed symbol name. details, Chapter "Options."
Value This field contains value decimal notation) initial values used substitute symbols.
Symbol type There three types symbols: Variable name Function name name reference
Memory array This field indicates memory area which symbols arrayed. ROM: area RAM: area
[Example] ROM/RAM LISTING sample1
NAME _Line _Nameleng _symref _Tflg
ADDRESS 00002B8 000004C 0005592 0000763
VALUE 000100 000016
KIND
MEMORY
000002
[Example]
ARRAY LISTING sample1
NAME _symref[0].val _symref[0].nam _symref[0].atr _symref[1].val _symref[1].nam _symref[1].atr _Xpcr[0][0] _Xpcr[0][1]
ADDRESS 0005592 0005596 0005598 000559A 000559E 00055A0 0001066 00010A0
VALUE 000100 000002 000016 012000 000002 000016 000400 000120
Assembly Source Listing
assembly source listing, location field shows absolute address object code field shows code verified after linking.
Assembly Source Listing Format Assembly source listings have following format.
SOURCE LISTING (module-name)
xxxxxxxx
xxxxxxxxxxxxxxxx
LINE xxxxx
SOURCE
first line above format called source listing header. source listing header shown each page list. Section name initials This field contains first characters section name. Location 32-bit location value shown form absolute address hexadecimal notation. Object code object code determined after linking shown hexadecimal format. More than line used complete display necessary. Object code type Attributes values included object code listed, following order priority: External reference value Section value
Space: Absolute value attributes shown relative assembly list will converted absolute values absolute assembly list, therefore will appear here. Line number Line numbers shown 5-digit decimal values.
Preprocessor optimization code check processing status Preprocessor Lines excluded from assembly Macro expansion lines
Optimization code check Optimization instruction deleted Optimization replaced instruction another instruction Optimization generated instruction Optimization switched with following instruction (paired with Optimization switched with preceding instruction (paired with
Source line Indicates line source program. Multiple lines used results will list line.
[Example] SOURCE LISTING sample1
LLINE 1025 1026 0010 1027 1028 1029
SOURCE
002CE724 -<INIT>-002CE724 002CE726 0020
.DATAB.B .DATA.H .SECTION CODE, CODE LDI:32 #LS1,
0000A280 -<CODE>-0000A280 9F840000043C
Line number
Source program
Object code: Value determined after linking Location counter value: 32-bit absolute address Section initials: First characters section name
Source Listing
source listings indexed line numbers source program.
Source Listing Format source listing following format. SOURCE LISTING (module-name)
LINE xxxx
SOURCE
Line number Line numbers shown 5-digit decimal values.
source Indicates line source program. Multiple lines used entire description will list line.
[Example]
SOURCE LISTING
sample1
LINE
SOURCE #include <stdio.h> #include "mlext.h"
main()
MEMO
Section Information Listing
section information listing contains information about each section defined source program. section information listing begins with page break, that list starts fresh page.
Section Information Listing section information listing following format.
FR20 Series MEAL
VxxLxx
yyyy-mm-dd hh:mm:ss
Page: xxxxx
SECTION LISTING (module-name)
SECTION-NAME -section-name-*2
SIZE
ATTRIBUTES
xxxxxxxx xxxx xxxx=xxxx
Section order number Numbers begin with zero, correspond section numbers object code file.
Section name Section names presented sequential order, defined.
Section size size section indicated 32-bit value.
Section type section type indicated following characters: CODE: DATA: CONST: Code section Data section Data section with default value
COMMON: Common section STACK: Stack section
Section array format This field shows relative assembly list value unchanged. relative assembly list sections during assembly, ALIGN value shown here. absolute sections, LOCATE value shown here.
[Example]
FR20 Series MEAL
V01L01
1995-03-03 10:04:51
Page:
SECTION LISTING sample1
SECTION-NAME
SIZE
ATTRIBUTES
DATA .00000004 DATA INIT .0000001C DATA CONST .00000020 CONST
ALIGN=4 ALIGN=4 ALIGN=4 ALIGN=2
CODE .00000038 CODE
Cross Reference Listing
cross reference listing shows definition cross-reference relationships names used source program, indexed line number. cross reference listing begins with page break, that list starts fresh page.
Cross Reference Listing cross reference listing following format:
FR20 Series MEAL
VxxLxx
yyyy-mm-dd hh:mm:ss
Page: xxxxx
CROSSREFERENCE LISTING
(module-name)
NAME -Name-*1
ATTRIB.
VALUE
DEFINITION/REFERENCES 1004
xxxx/xxxx xxxxxxxx
Name This field shows symbol names section names, including capital lower case letters, alphabetical order.
Symbol type symbol type indicated follows: ABS: REL: ABS/EXP: REL/EXP: IMP: SECT/ABS: SECT/REL: UNDEFINED: REGLIST: Absolute symbol Relative symbol Absolute symbol (externally defined) Relative symbol (externally defined) Imported external reference symbol Absolute section Relative section Undefined symbol Register list symbol
Value symbol value, shown here 32-bit absolute address.
Definition, reference line number reference number line which symbol defined. line number with symbol definition followed sharp sign (#).
[Example]
FR20 Series MEAL V01L01
1995-03-03 13:54:23
Page:
CROSSREFERENCE LISTING sample1
NAME
ATTRIB.
VALUE
DEFINITION/REFERENCES
ARRSY. SECT/REL 000021C2 BINCOL REL/EXP DATAC. IROAS. 00000308 00006D58 00000101
MEMO
APPENDIX
appendix provides descriptions error messages output MEAL, lists option description formats, sample absolute assembly listings output notes specifications different operating systems.
Appendix Appendix
Error Messages Option Format Lists
Appendix Sample Absolute Assembly Listing Output Appendix Differences Operating System Specifications Appendix Windows 95/NT Version
Appendix
Error Messages
Improper input instruction, difficulty execution will cause MEAL generate warning messages, error messages fatal error messages, according cause severity error.
Types Errors There three types errors: warnings, errors fatal errors. Warning messages Warning messages indicate that MEAL discovered problem during processing. Processing continued, user advised verify accuracy absolute assembly list generated. Error messages Error messages indicate that MEAL unable execute processing instructed user. Processing continued, intended. Fatal error messages Fatal errors indicate that MEAL unable continue processing. After error message displayed, control returned operating system.
Error Message Display Format Error messages output following standard format. XnnnnE: Message statement (supplementary message) Error level, indicated with three letters: nnnn Message statement Warning message Error Fatal error
Error number Indicates that message output MEAL. Text error message (user select Japanese English)
Supplementary message Name file, option, etc. where error occurred. -epf option used output error messages file.
Warning Messages
W1601E
.mp1 file older than .abs file
generation date link list file older than that absolute load module file, indicating possible conflict problem. user should verify that contents reflect results same linking process. MEAL will continue processing, however other error messages occur, user should create link list absolute load module file again.
W1602E
.abs file older than .mp1 file
generation date absolute load module file older than that link list file, indicating possible conflict problem. user should verify that contents reflect results same linking process. MEAL will continue processing, however other error messages occur, user should create link list absolute load module file again.
W1603E
.mp1 file older than .lst file (file name)
generation date link list file older than that relative assembly list file shown supplementary message, indicating that linking have used most recent object module. other error messages occur, user should rerun linking process again.
Error Messages
E4601E
.lst file exist .abs file (file name)
relative assembly list file specified option designates module output absolute assembly list, there such module absolute load module file. MEAL will ignore file name shown supplementary message. user should designate file name module indicated this message, again.
E4602E
.lst file found (file name)
relative assembly list file shown supplementary message could found. MEAL will continue processing, without creating absolute assembly list file corresponding file name shown supplementary message.
E4603E
lllegal .lst file (file name)
relative assembly list file shown supplementary message field created FR20 assembler. MEAL will continue processing next list file, will process list file shown supplementary message field.
E4604E
lllegal .lst file format (file name)
relative assembly list file shown supplementary message format that cannot processed MEAL. MEAL will stop processing list file shown supplementary message field, will continue processing with next list file.
E4605E
Object data .abs file correspond .lst file (file name)
Object data absolute load module file does match source data relative assembly list shown supplementary message field. Repeat linking again.
E4606E
Debug information exist .abs file
When ROM/RAM ARRAY listings source listings output, debugging information must output absolute load module file. sure specify output debugging information during compiling, assembly linking.
E4607E
Dimension structure array level
number dimensions arrays output ARRAY listing, structure calls totals more than eight levels. sure that total number dimensions structure calls does exceed eight levels.
E4611E
source file found (file name)
source file shown supplementary message field found. MEAL will output assembly source listing place source listing corresponding source file name shown supplementary message field will continue processing. sure that source files available, again.
E4612E
DUMMY section specified (file name)
assembler section description uses name dummy section. MEAL cannot operate with dummy sections, will therefore ignore dummy section.
Fatal Error Messages
F9001E
Insufficient memory
MEAL unable continue processing insufficient memory. MEAL requires considerable memory size process debugging information absolute load module file. output ROM/RAM ARRAY listings source files necessary, possible execute regenerating absolute load module file without debugging information. recommended solution increase available memory size again.
F9015E
File open error (file name)
message shown supplementary message field output file, operating system current have exceeded number files that managed directory. Unnecessary files should deleted moved.
F9016E
File read error (file name)
Attempts read file shown supplementary message failed. file readprohibited, there hardware error.
F9017E
File write error (file name)
Attempts write file shown supplementary message failed. There insufficient space disk. Increase open disk space again.
F9022E
Unknown option name (option name)
option shown supplementary message field cannot used. Verify names available options using -help option this manual.
F9023E
lllegal option parameter (option name)
option parameter shown supplementary message field illegal. Verify proper option description.
F9027E
`-f' option cannot specified option file
Option files allow nesting. Delete option from option file.
F9051E
.mp1 file specified
name input link list file must always specified when starting MEAL.
F9052E
Syntax error
There syntax error option notation statement. option name long, there space before hyphen. proper option notation.
F9053E
many parameters
number parameters (file names) allowed option been exceeded.
F9054E
Option file found (file name)
option file could found. Verify that this file exists.
F9601E
.mp1 file found (file name)
link list file shown supplementary message field could found. Verify that this link list file exists properly specified input.
F9602E
.abs file found (file name)
absolute load module file shown supplementary message field could found. Verify that this absolute load module file exists properly specified input.
F9603E
lllegal .mp1 file (list file name)
link list file shown supplementary message field created FR20 linker. Verify contents file, specify proper link list file name.
F9604E
lllegal .mp1 file format (list file name)
There error format link list file. contents link list file have been changed editor, file have been generated properly error linking. recommended solution repeat linking, then re-run MEAL.
F9605E
lllegal .abs file (file name)
absolute load module file shown supplementary message created FR20 linker. recommended solution repeat linking, then re-run MEAL.
F9621E
Module name .mp1 file exist .abs file
module corresponding module name link list file does exist absolute load module file. recommended solution repeat linking, then re-run MEAL.
F9622E
Link option specified
option used specify incremental link format output during linking. MEAL tool processing using absolute load modules. sure option create absolute load modules during linking.
F9623E
Link option specified
option used specify creation relative load module during linking. MEAL tool processing using absolute load modules. sure option create absolute load modules during linking.
F9624E
Load module file relocatable type (file name)
file designated absolute load module file actually contains relative load module. sure properly specify name absolute load module file output linker.
F9625E
violation
MEAL trying process absolute load module file wrong type. Check notify version numbers linker MEAL, MEAL version that corresponds version linker.
F9698E
error (#error number)
There error absolute load module file. Either absolute load module file output FR20 linker, contents file have been corrupted. Recreate absolute load module file. this error occurs again with this file, notify your FUJITSU representative error number.
F9999E
Internal error
this error occurs, contact your FUJITSU representative immediately.
Appendix
Option Format Lists
Table presents listing option formats.
Option Format Lists Table Option Format Lists Option format file-name path -cin path -epf file-name -out path file-name [,.] -nlf file-name [,.] -lrf file-name [,.] -nlr -nlrf file-name [,.] Function Specifies input absolute load module file name Specifies relative assembly list file input directory path Specifies source file input directory path Displays error information standard output Specifies error information output file Specifies directory absolute assembly list file output Specifies output entire absolute assembly list file Specifies output selected absolute assembly list files Suppresses output entire absolute assembly list file Suppresses output selected absolute assembly list file(s) Specifies output ROM/RAM ARRAY lists Specifies output ROM/RAM ARRAY lists selected modules Suppresses output ROM/RAM ARRAY lists Suppresses output ROM/RAM ARRAY lists selected module(s) Outputs ROM/RAM ARRAY lists NAME, ADDRESS sequence Outputs ROM/RAM ARRAY lists ADDRESS, NAME sequence
Table Option Format Lists (Continued) Option format -lcf file-name [,.] -nlc -nlcf file-name [,.] -lsec -lsecf file-name [,.] -nlsec Specifies source list output Specifies selected modules source list output Suppresses source list output Suppresses source list output selected modules Specifies section information list output Specifies section information list output selected modules Suppresses section information list output Function
-nlsecf file-name [,.] Suppresses section information list output selected modules -lcros Specifies cross reference output
-lcrosf file-name [,.] Specifies cross reference output selected modules -nlcros Suppresses cross reference output
-nlcrosf file-name [,.] Suppresses cross reference output selected modules -help file-name Specifies version/message display Suppresses version/message display Specifies display help messages Specifies option file name(s)
Appendix
Sample Absolute Assembly Listing Output
Appendix presents examples absolute assembly listing output.
Sample Absolute Assembly Listing Output
Users: following examples differ slightly from actual output. FR20 Series MEAL V01L01 ASSEMBLE INFORMATION sample1 Command line Total errors Total warnings 1995-03-03 13:05:32 Page:
fasm911 sample1 -lcros There were errors. sample1.obj sample1.lst
Object file List file
NEST
SOURCE-FILE-NAME -sample1.asm
CREATE DATE/TIME -1995-03-03 13:04:46
Current path Include path Work file path Default Option file
C:\FMEAL INC911 OPT911
-None- D:\FETOOL\LIB\9 11\include\ -None- D:\FETOOL\LIB\9 11\(fasm911.opt)
NEST OPTION-FILE-NAME D:\FETOOL\LIB\911\fasm911.opt
CREATE DATE/TIME -1994-09-22 11:48:30
FR20 Series MEAL V01L01 ROM/RAM LISTING sample1 NAME _atrsn _main _sp11 ADDRESS 00000008 00000000 00000040 00000020 00000004 VALUE
1995-03-03 13:05:32
Page:
KIND MEMORY
FR20 Series MEAL
V01L01
1995-03-03 13:05:32
Page:
ARRAY LISTING sample1
NAME
ADDRESS
VALUE
-atrsn[0].attr -atrsn[0].len -atrsn[0].flg -atrsn[1].attr -atrsn[1].len -atrsn[1].flg -sp11[0][0] -sp11[0][1] -sp11[0][2] -sp11[1][0] -sp11[1][1] -sp11[1][2]
00000008 0000000C 00000010 00000014 00000018 0000001C 00000020 00000024 00000028 0000002C 00000030 00000034 5000 12000 500000
Series MEAL V01L01 SOURCE LISTING sample1
1995-03-03 13:05:32 LLINE SOURCE .PROGRAM .LIBRARY .LIBRARY
Page:
<sample1.asm> MODULE NAME sample1
===== 00000000 -<DATA>-5 00000000 00000000 00000000 00000000 [4]B 00000004 -<INIT>-12 00000004 00000004 00000004 00000004 00000002 00000020 -<CONST>-19 00000020 00000020 00000020 00000020 0000000A 00000024 00000014 00000028 0000001E 0000002C 00000001 0000003C 00000002 00000034 00000003 00000008 -<INIT>-31 00000008 00000008 00000008 00000008 00000038 0000000C 000000C8 00000010 0007A120 00000014 0000003C 00000018 00001388 0000001C 00002EE0 00000038 -<CONST>-43 00000038 00000038 00000038 00000038 0000003C 0000003C 00000040 -<CODE>-52
sample1 "lib911.lib" "lib911if.lib"
.SECTION DATA, DATA, ALIGN=4 .ALIGN .EXPORT -i1: .RES.B .SECTION .ALIGN .EXPORT _x1: .DATAB.W INIT, DATA, ALIGN=4
.SECTION CONST, CONST, ALIGN .ALIGN .EXPORT _sp11: .DATAB.W .DATAB.W .DATAB.W .DATAB.W .DATAB.W .DATAB.W _sp11
.SECTION INIT, DATA, ALIGN=4 .ALIGN .EXPORT _atrsn _atrsn: .DATAB.W LS_0+0 .DATAB.W .DATAB.W 500000 .DATAB.W LS_1+0 .DATAB.W 5000 .DATAB.W 12000 .SECTION CONST, CONST, ALIGN .ALIGN LS_0: .SDATA LS_1: "cng\000"
.SDATA "mol\000" .SECTION CODE, CODE, ALIGN=2 ._LANGUAGE C_FR20,
FR20 Series MEAL V01L01 SOURCE LISTING sample1 LLINE
1995-03-03 13:05:32 SOURCE
Page:
00000040 00000040 1781 00000042 0F07
00000044 9F8C00000018 0000004A 04C0 0000004C 3FE0 0000004E 00000054 00000056 0000005C 9F8C00000034 04C0 9F8C00000000 14C0
0000005E 2FF0 00000060 9F8C0000001C 00000066 14C0 00000068 9F8C00000034
._FILE "C:\FR20\sample1.c", ._FILE "K:\fcc64ee_0.i", ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._BTYPE ._MEMBER ._SYMBOL "attr", ._POINTER ._SYMBOL "len", ._SYMBOL "flg", ._MEMBER ._SYMBOL "att", ._SYMBOL "main", "_main", ._FPARAM ._FPARAM ._CONFIG ._LINE ;-begin_of_function .EXPORT _main _main: @-SP ENTER ._FUNCTION "FP", "FP", ._CONFIG ._SYMBOL "l", ._SYMBOL "il", ._SYMBOL "Lin", ._ARRAY ._LINE LDI:32 #_atrsn+16,R12 @R12, @(FP,-8) ._LINE LDI:32 #_sp11+20,R12 @R12, LDI:32 #_i1, @R12 ._LINE @(FP,-4), LDI:32 #_atrsn+20,R12 @R12 ._LINE LDI:32 #_atrsn+44,R12
FR20 Series MEAL V01L01 SOURCE LISTING sample1 LLINE
1995-03-03 13:05:32
Page:
SOURCE @R12, @(FP,-12) ._LINE ._CONFIG ._LINE L_main: LEAVE @SP+,RP ._CONFIG ._SYMBOL "i1", "_i1" ._SYMBOL "x1", "_x1" ._SYMBOL "sp11", "_sp11" ._ARRAY ._TYPED ._SYMBOL "atrsn", "_atrsn" ._ARRAY .END 1995-03-03 13:05:32 Page:
0000006E 04C0 00000070 3FD0
00000072 00000072 9F90 00000074 0781 00000076 9720
FR20 Series MEAL V01L01 SECTION LISTING sample1 SECTION-NAME DATA INIT CONST CODE
SIZE 00000004 0000001C 00000020 00000038
ATTRIBUTES DATA DATA CONST CODE ALIGN=4 ALIGN=4 ALIGN=4 ALIGN=2
FR20 Series MEAL V01L01 1995-03-03 13:05:32 -CROSSREFERENCE LISTING sample1 NAME CODE CONST DATA INIT LS_0 LS_1 L_main _atrsn _main -sp11 ATTRIB. SECT/REL SECT/REL SECT/REL SECT/REL REL/EXP REL/EXP REL/EXP REL/EXP REL/EXP VALUE 00000040 00000020 00000000 00000004 00000038 0000003C 00000072 00000008 00000000 00000040 00000020 00000004
Page:
DEFINITION/REFERENCES
Appendix
Differences Operating System Specifications
Appendix describes differences specifications between various operating systems.
Differences Operating System Specifications MEAL specifications differ slightly according operating system used. These differences reflect differences specifications operating systems themselves, well differences that each system processes applications. Table summarizes differences. Table Differences Operating System Specifications types OS-dependent items UNIX-based File name upper/lower-case sensitivity Default file name extension Directory used when environment variable omitted Handling File Names File names MEAL handled follows. File name specification notation format File notation formats each type operating system follows. (For details, refer documentation provided with your particular operating system.) UNIX-based systems [path-name] primary-file-name [extension] Lower case (.lst, .als, .mp1, .abs) /tmp Upper case (.LST, .ALS, .MP1, .ABS) Current directory MS-DOS
MS-DOS systems [device-name:] [directory-name] primary-file-name [extension] Note: MEAL uses file names composed primary file name plus file name extension. (UNIX-based systems concept file name extension, these provided independently MEAL support system.) file name extensions refer characters immediately following period file name. there more than period, file name extension follows last period.
[Example] /usr1/link/tool/test10.mp1
Path name Handling Omitted File Names
Primary file name
File name extension
Table shows MEAL handles files which part file name omitted. Table Handling Omitted File Names type Item UNIX-based Current Absolute load module file name extension Link list file name extension File type Relative assembly list file name extension Absolute assembly list file name extension [Example UNIX-based operating systems .lst .als .LST .ALS .abs .mp1 MS-DOS Current Current .ABS .MP1
Device name Directory name Path name
meal911 tstlnk01
tstlnk01.mp1 [Example MS-DOS systems
D:\> MEAL911 TSTLNK01
TSTLNK01.MP1 Note: underlined portion indicates omitted extension, which supplied system. Appendix Windows 95/NT Version Appendix Windows 95/NT Version Appendix Windows 95/NT Version
Appendix
Windows 95/Windows Version
This appendix describes Windows Windows versions system.
Startup Name startup, distinguish this version from MS-DOS version, when entering file name executable file, appended basic file name. Following linker examples: MS-DOS version: MEAL911.EXE Windows MS-Windows version: MEAL911S.EXE
Windows 95/NT version executed from Windows command prompt. used same MS-DOS version. File Names When enclosing file name double quotes enclose full file name. Number Characters maximum characters used portion (path name, basic file name, extension) full file name. full file name [(all three parts it)] have maximum characters. Character Types allowable file name characters accordance with operating system, with certain restrictions. kanji code, only SJIS supported. Characters that used file names, accordance with specifications operating system, follows: Drive directory separator character Redirect pipe[line] characters Option separator character Wild card characters Enclosure character
Following characters used accordance with family support specification: file name separators Extensions file extension consists characters that follow final period. Extensions supplied tool when extension specified lower case characters.
INDEX
indexes consist keyword index, subheading, Picture table index. They listed symbolic alphabetic order.
Keyword Index <Symbol> <Alphabetic> Subheading Index <Alphabetic> Figure Table Index
Keyword Index
<Symbol>
-cin -epf -help -lcf -lcros -lcrosf -lrf -lsec -lsecf -nlc -nlcf -nlcros -nlcrosf -nlf -nlr -nlrf -nlsec -nlsecf -out
<Alphabetic>
absolute address absolute assembly list absolute load module absolute section absolute symbol absolute value address array elements ASCII code source code section command line common section copyright cross reference list CTRL-C data section data section with default value debugging information definition, reference line number displaying help message [-help] displaying version number/message [-V] DUMMY section enviroment variable FELANG error error information error messages code external reference value fatal error function name
Keyword Index
MB91100 series
generation date global symbol help message imported external reference symbol include file initial values Japanese library file line number link list linker control option list name location location value macro expansion lines macro processing MEAL module module name object code object module optimization option option list page number parameters program version
area register list symbol relative assembly list relative load module relative section relative symbol area section information listing section name section order number section size section type SJIS code source line specification continues specifying absolute assembly list output directory [-out] specifying absolute assembly list output module [-l, -lf] specifying absolute load module file [-a] specifying source file input directory [-cin] specifying source list output module [-lc, -lcf] specifying source list output suppress module [-nlc, -nlcf] specifying cross reference list output module [-lcros, -lcrosf] specifying cross reference list output suppress module [-nlcros, -nlcrosf] specifying error data output file [-ep, -epf] specifying NAME, ADDRESS display position [-an] specifying NAME, ADDRESS display position [-na] specifying option file name [-f] specifying relative assembly list input directory [-in] specifying ROM/RAM ARRAY list output [-lr, -lrf] specifying section information list output module [-lsec, -lsecf] specifying section information list output suppress module [-nlsec, -nlsecf] stack section startup format startup message structure names
MB91100 series
Keyword Index
suppressing ROM/RAM ARRAY list output [-nlr, -nlrf] suppressing version number/message display [-XV] symbol symbol name symbol type name reference undefined symbol warning-level error working directory
Keyword Index
MB91100 series
Subheading Index
<Alphabetic>
Assembly Assembly Source Listing Format Source Listing Format Compiling Cross Reference Listing Description Using Option Files Differences Operating System Specifications Direct Description Using Startup Command Statements Code Values Status Error Message Display Format Error Message Assembly Lists Error Messages Execution
Machine Language Code Note Absolute Assembly List Generation Option Format Lists Option Formats Option List Output Files Overview Restrictions Assembly Restrictions Option Notation ROM/RAM ARRAY Listings Sample Absolute Assembly Listing Output Section Information Listing Selecting List Output Module Startup Format Expressions Startup Name (Working Directory) Type Errors
FELANG File Names. Forced Termination Format Detailed Description Options Functions Handling File Names Handling Omitted File Names Header Format Input Files Input Output Files. Linking List Format Location within Section
Warning Messages
MB91100 series
Subheading Index
Figure Table Index
Example Selection Absolute Assembly List (figure 1.3) MEAL input/output (figure 2.5) Codes State Processing (table 2.7) Option List (table 3.1) Relation between -nlf Options option (table 3.4) Assembly List Configuration (figure 4.1) Option Format Lists (table Differences Operating System Specifications (table Handling Omitted File Names (table
Figure Table Index
MB91100 series
CM71-00305-2E
FUJITSU SEMICONDUCTOR CONTROLLER MANUAL FR20 32-Bit Microcontroller Absolute Assembly List Generator Tool Manual
October 1997 second edition
Published Edited
FUJITSU LIMITED
Electronic Devices
Technical Communication Dept.
FUJITSU LIMITED
further information please contact:
Japan FUJITSU LIMITED Corporate Global Business Support Division Electronic Devices KAWASAKI PLANT, 4-1-1, Kamikodanaka Nakahara-ku, Kawasaki-shi Kanagawa 211-88, Japan Tel:(044)754-3763 Fax:(044)754-3329
http://www.fujitsu.co.jp/
North South America FUJITSU MICROELECTRONICS, INC. Semiconductor Division 3545 North First Street Jose, 95134-1804, U.S.A Tel:(408)922-9000 Fax:(408)922-9179 Customer Response Center Mon.-Fri.:7am-5pm(PST) Tel: (800)866-8608 Fax: (408)922-9179
http://www.fujitsumicro.com/
Europe FUJITSU MIKROELEKTRONIK GmbH Siebenstein 6-10 D-63303 Dreieich-Buchschlag Germany Tel:(06103)690-0 Fax:(06103)690-122
http://www.fujitsu-ede.com/
Asia Pacific FUJITSU MICROELECTONICS ASIA #05-08,151 Lorong Chuan Tech Park Singapore 556741 Tel:(65)281 0770 Fax:(65)281 0220
http://www.fmap.com.sg/
Other recent searches
TN1145 - TN1145 TN1145 Datasheet
TM3097 - TM3097 TM3097 Datasheet
S5865 - S5865 S5865 Datasheet
LTC4425 - LTC4425 LTC4425 Datasheet
LTC4425 - LTC4425 LTC4425 Datasheet
LNK362-364 - LNK362-364 LNK362-364 Datasheet
KDZ2 - KDZ2 KDZ2 Datasheet
2SC3734LT1 - 2SC3734LT1 2SC3734LT1 Datasheet
2SC1621 - 2SC1621 2SC1621 Datasheet
Privacy Policy | Disclaimer
© 2012 Datasheet Archive
