- •Chapter 1. Introduction
- •How to Develop A Program
- •What is an Assembler?
- •Modular Programming
- •Modular Program Development Process
- •Segments, Modules, and Programs
- •Translate and Link Process
- •Filename Extensions
- •Program Template File
- •Chapter 2. Architecture Overview
- •Memory Classes and Memory Layout
- •Classic 8051
- •Extended 8051 Variants
- •Philips 80C51MX
- •Intel/Atmel WM 251
- •CPU Registers
- •CPU Registers of the 8051 Variants
- •CPU Registers of the Intel/Atmel WM 251
- •Program Status Word (PSW)
- •Instruction Sets
- •Opcode Map
- •8051 Instructions
- •Additional 251 Instructions
- •Additional 80C51MX Instructions via Prefix A5
- •Chapter 3. Writing Assembly Programs
- •Assembly Statements
- •Directives
- •Controls
- •Instructions
- •Comments
- •Symbols
- •Symbol Names
- •Labels
- •Operands
- •Special Assembler Symbols
- •Immediate Data
- •Memory Access
- •Program Addresses
- •Expressions and Operators
- •Numbers
- •Characters
- •Character Strings
- •Location Counter
- •Operators
- •Expressions
- •Chapter 4. Assembler Directives
- •Introduction
- •Segment Directives
- •Location Counter
- •Generic Segments
- •Stack Segment
- •Absolute Segments
- •Default Segment
- •SEGMENT
- •RSEG
- •BSEG, CSEG, DSEG, ISEG, XSEG
- •Symbol Definition
- •CODE, DATA, IDATA, XDATA
- •esfr, sfr, sfr16, sbit
- •LIT (AX51 & A251 only)
- •Memory Initialization
- •DD (AX51 & A251 only)
- •Reserving Memory
- •DBIT
- •DSW (AX51 & A251 only)
- •DSD (AX51 & A251 only)
- •Procedure Declaration (AX51 & A251 only)
- •PROC / ENDP (AX51 & A251 only)
- •LABEL (AX51 and A251 only)
- •Program Linkage
- •PUBLIC
- •EXTRN / EXTERN
- •NAME
- •Address Control
- •EVEN (AX51 and A251 only)
- •USING
- •Other Directives
- •_ _ERROR_ _
- •Chapter 5. Assembler Macros
- •Standard Macro Directives
- •Defining a Macro
- •Parameters
- •Labels
- •Repeating Blocks
- •REPT
- •IRPC
- •Nested Definitions
- •Nested Repeating Blocks
- •Recursive Macros
- •Operators
- •NUL Operator
- •& Operator
- •< and > Operators
- •% Operator
- •;; Operator
- •! Operator
- •Invoking a Macro
- •C Macros
- •C Macro Preprocessor Directives
- •Stringize Operator
- •Predefined C Macro Constants
- •Examples with C Macros
- •C Preprocessor Side Effects
- •Chapter 6. Macro Processing Language
- •Overview
- •Creating and Calling MPL Macros
- •Creating Parameterless Macros
- •MPL Macros with Parameters
- •Local Symbols List
- •Macro Processor Language Functions
- •Comment Function
- •Escape Function
- •Bracket Function
- •METACHAR Function
- •Numbers and Expressions
- •Numbers
- •Character Strings
- •SET Function
- •EVAL Function
- •Logical Expressions and String Comparison
- •Conditional MPL Processing
- •IF Function
- •WHILE Function
- •REPEAT Function
- •EXIT Function
- •String Manipulation Functions
- •LEN Function
- •SUBSTR Function
- •MATCH Function
- •Console I/O Functions
- •Advanced Macro Processing
- •Literal Delimiters
- •Blank Delimiters
- •Identifier Delimiters
- •Literal and Normal Mode
- •MACRO Errors
- •Chapter 7. Invocation and Controls
- •Environment Settings
- •Running Ax51
- •ERRORLEVEL
- •Output Files
- •Assembler Controls
- •Controls for Conditional Assembly
- •Conditional Assembly Controls
- •Chapter 8. Error Messages
- •Fatal Errors
- •Non–Fatal Errors
- •Chapter 9. Linker/Locator
- •Overview
- •Combining Program Modules
- •Segment Naming Conventions
- •Combining Segments
- •Locating Segments
- •Overlaying Data Memory
- •Resolving External References
- •Absolute Address Calculation
- •Generating an Absolute Object File
- •Generating a Listing File
- •Bank Switching
- •Using RTX51, RTX251, and RTX51 Tiny
- •Linking Programs
- •Command Line Examples
- •Control Linker Input with µVision2
- •ERRORLEVEL
- •Output File
- •Linker/Locater Controls
- •Locating Programs to Physical Memory
- •Classic 8051
- •Extended 8051 Variants
- •Philips 80C51MX
- •Intel/Atmel WM 251
- •Data Overlaying
- •Program and Data Segments of Functions
- •Using the Overlay Control
- •Tips and Tricks for Program Locating
- •Locate Segments with Wildcards
- •Special ROM Handling (LX51 & L251 only)
- •Bank Switching
- •Common Code Area
- •Code Bank Areas
- •Bank Switching Configuration
- •Configuration Examples
- •Control Summary
- •Listing File Controls
- •Output File Controls
- •Segment and Memory Location Controls
- •High-Level Language Controls
- •Error Messages
- •Warnings
- •Non-Fatal Errors
- •Fatal Errors
- •Exceptions
- •Chapter 10. Library Manager
- •Using LIBx51
- •Interactive Mode
- •Create Library within µVision2
- •Command Summary
- •Creating a Library
- •Adding or Replacing Object Modules
- •Removing Object Modules
- •Extracting Object Modules
- •Listing Library Contents
- •Error Messages
- •Fatal Errors
- •Errors
- •Chapter 11. Object-Hex Converter
- •Using OHx51
- •OHx51 Command Line Examples
- •Creating HEX Files for Banked Applications
- •OHx51 Error Messages
- •Using OC51
- •OC51 Error Messages
- •Intel HEX File Format
- •Record Format
- •Data Record
- •Extended 8086 Segment Record
- •Extended Linear Address Record
- •Example Intel HEX File
- •Appendix A. Application Examples
- •ASM – Assembler Example
- •Using A51 and BL51
- •Using AX51 and LX51
- •Using A251 and L251
- •CSAMPLE – C Compiler Example
- •Using C51 and BL51
- •Using C51 and LX51
- •Using C251 and L251
- •BANK_EX1 – Code Banking with C51
- •Using C51 and BL51
- •Using C51 and LX51
- •BANK_EX2 – Banking with Constants
- •Using C51 and BL51
- •Using C51 and LX51
- •Using BL51
- •Using C51 and LX51
- •Philips 80C51MX – Assembler Example
- •Philips 80C51MX – C Compiler Example
- •Appendix B. Reserved Symbols
- •Appendix C. Listing File Format
- •Assembler Listing File Format
- •Listing File Heading
- •Source Listing
- •Macro / Include File / Save Stack Format
- •Symbol Table
- •Listing File Trailer
- •Appendix D. Assembler Differences
- •Differences Between A51 and A251/AX51
- •Differences between A51 and ASM51
- •Differences between A251/AX51 & ASM51
- •Glossary
- •Index
370 Chapter 9. Linker/Locator
Fatal Errors
9 |
Error |
Error Message and Description |
|
201INVALID COMMAND LINE SYNTAX
A syntax error is detected in the command line. The command line is displayed up to and including the point of error.
202INVALID COMMAND LINE, TOKEN TOO LONG
The command line contains a token that is too long. The command line is displayed up to and including the point of error.
203EXPECTED ITEM MISSING
An expected item is missing in the command line. The command line is displayed up to and including the point of error.
204INVALID KEYWORD
The invocation line contains an invalid keyword. The command line is displayed up to and including the point of error.
205CONSTANT TOO LARGE
A constant in the invocation line is larger than 0FFFFH. The command line is displayed up to and including the point of error.
206INVALID CONSTANT
A constant in the invocation line is invalid; e.g., a hexadecimal number with a leading letter. The command line is displayed up to and including the point of error.
207INVALID NAME
A module or segment name is invalid. The command line is displayed up to and including the point of error.
208INVALID FILENAME
A filename is invalid. The command line is displayed up to and including the point of error.
209FILE USED IN CONFLICTING CONTEXTS
FILE: filename
A specified filename is used for multiple files or used as an input as well as an output file.
210I/O ERROR ON INPUT FILE: system error message
FILE: filename
An I/O error is detected by accessing an input file. A detailed error description of the EXCEPTION messages is described afterwards.
Keil Software — A51/AX51/A251 Macro Assembler and Utilities |
371 |
|
||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Error |
Error Message and Description |
|
|
|
|
|
|
|
|
|
9 |
|
211 |
I/O ERROR ON OUTPUT FILE: |
|
|
||
|
|
|
system error message |
|
|
|
|
|
|
FILE: filename |
|
|
|
|
|
|
An I/O error is detected by accessing an output file. A detailed error description of |
|
|
|
|
|
|
the EXCEPTION messages is described afterwards. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
212I/O ERROR ON LISTING FILE: system error message
FILE: filename
An I/O error is detected by accessing a listing file. A detailed error description of the EXCEPTION messages is described afterwards.
213I/O ERROR ON WORK FILE:
system error message
An I/O error is detected by accessing a temporary work file of BL51. A detailed error description of the EXCEPTION messages is described afterwards.
214INPUT PHASE ERROR
MODULE: filename (modulename)
This error occurs when BL51 encounters different data during pass two. This error could be the result of an assembly error.
215CHECK SUM ERROR
MODULE: filename (modulename)
The checksum does not correspond to the contents of the file.
216INSUFFICIENT MEMORY
The memory available for the execution of BL51 is used up.
217NO MODULE TO BE PROCESSED
No module to be processed is found in the invocation line.
218NOT AN OBJECT FILE
FILE: filename
The specified file is not an object file.
219NOT AN 8051/X51 OBJECT FILE FILE:filename
The specified file is not a valid x51 object file.
220INVALID INPUT MODULE
FILE: filename
The specified input module is invalid. This error could be the result of an assembler error.
|
372 |
|
|
Chapter 9. Linker/Locator |
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Error |
Error Message and Description |
|
|
9 |
|
|
|
|
|
|
|
221 |
MODULE SPECIFIED MORE THAN ONCE |
|
|||
|
|
|
The invocation line contains the specified module more than once. The command |
|
|
|
|
|
|
|
|
||
|
|
|
|
line is displayed up to and including the point of error. |
|
|
|
|
|
|
|
|
|
|
|
222 |
SEGMENT SPECIFIED MORE THAN ONCE |
|||
|
|
|
|
The invocation line contains the specified segment more than once. The |
||
|
|
|
|
command line is displayed up to and including the point of error. |
224DUPLICATE KEYWORD OR CONFLICTING CONTROL
The same keyword is contained in the invocation line more than once or contradicts with other keywords. The command line is displayed up to and including the point of error.
225SEGMENT ADDRESS ARE NOT IN ASCENDING ORDER
The base addresses for the segments are not displayed in ascending order during the location control. The command line is displayed up to and including the point of error.
226SEGMENT ADDRESS INVALID FOR CONTROL
The base addresses for the segments are invalid for the location control. The command line is displayed up to and including the point of error.
227PARAMETER OUT OF RANGE
The specified value for the PAGEWIDTH or PAGELENGTH control is out of the acceptable range. The command line is displayed up to and including the point of error.
228RAMSIZE PARAMETER OUT OF RANGE
The specified value for the RAMSIZE control is out of the acceptable range. The command line is displayed up to and including the point of error.
229INTERNAL PROCESS ERROR
Lx51 detects an internal processing error. Please contact your dealer.
230START ADDRESS SPECIFIED MORE THAN ONCE
The invocation line contains more than one start address for unnamed segment group. The command is displayed up to and including the point of error.
231ADDRESS RANGE FOR BANKAREA INCORRECT
The address space specified with the BANKAREA control is invalid.
232APPLICATION CONTAINS TOO MANY RECURSIONS
The application contains to many recursive calls. Refer to “RECURSIONS” on page 356 for more information.
Keil Software — A51/AX51/A251 Macro Assembler and Utilities |
373 |
|
|||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Error |
Error Message and Description |
|
|
|
|
|
|
233 |
ILLEGAL USE OF * IN OVERLAY CONTROL |
|
|
9 |
|
|
|
|
The use of “* ! *” or “* ~ *” with the OVERLAY control is illegal. |
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
234USE RTX251 OR RTX51 CONTROL
The application uses RTXx51 tasks.
233ILLEGAL USE OF * IN OVERLAY CONTROL
command line
The use of “* ! *” or “* ~ *” with the OVERLAY control is illegal.
234USE RTX-251 SWITCH
The application uses a real-time operating system RTX251 Full or RTX251 Tiny. The L251 linker/locater must be invoked with the RTX251 or RTX251TINY control.
235TOO MANY ADDRESS RANGES
You are using to many address ranges.
236ADDRESSES ARE NOT IN ASCENDING ORDER
The address range does not contain addresses in ascending order.
237INVALID CLASS NAME
The class name given in the CLASSES control is not valid.
238BIT ADDRESS INVALID FOR THIS CLASS TYPE
The CLASSES control contains a bit address for a memory class which cannot be used for bit objects.
239BASE ADDRESS ALREADY GIVEN FOR THIS CLASS
The CLASSES control contains a base address, but the class has already a base address specified with a previous CLASSES control.
240BASE ADDRESS MUST BE THE FIRST ARGUMENT
The base address must be the first argument in the CLASSES control.
241BASE ADDRESS CANNOT BE GIVEN FOR THIS CLASS
A base address cannot be given for this memory class in the CLASSES control.
242WRONG SYNTAX FOR THE EXECUTION ADDRESS
The execution address field contains a wrong syntax.
243EXECUTION ADDRESS REQUIRED IF SPACE IS NOT RESERVED
You need to specify an execution address, if the execution space should not be reserved.
|
374 |
|
|
Chapter 9. Linker/Locator |
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Error |
Error Message and Description |
|
|
9 |
|
|
244 |
OVERLAPPING CLASS RANGE |
|
|
|
|
|
The address ranges in the classes control are overlapping. |
|
|
|
|
|
|
|
|
||
|
|
|
|
|
|
|
245ADDRESS RANGE INVALID FOR THIS CLASS TYPE
The address range given in the CLASSES control is not valid for this memory class type.
246SYMBOL SPECIFIED MORE THAN ONCE
The symbol name is already used.
249MODULE USES AN UNKNOWN OMF VERSION
MODULE: filename (modulename)
The module uses an un-known or unsupported OMF version.
250CODE SIZE LIMIT IN RESTRICTED VERSION EXCEEDED
You are using modules that are created with an evaluation version or a code size limited version and the size limit is exceeded.
251RESTRICTED MODULE IN LIBRARY NOT SUPPORTED
A library contains a module that is created with an evaluation version or a code size limited version. This is not supported.