
- •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
Keil Software — A51/AX51/A251 Macro Assembler and Utilities |
237 |
|
|
Chapter 8. Error Messages
This chapter lists the error messages generated by Ax51. The following sections include a brief description of the possible error messages along with a description of the error and any corrective actions you can take to avoid or eliminate the error.
Fatal errors terminate the assembly and generate a message that is displayed on the console. Non–fatal errors generate a message in the assembly listing file but do not terminate the assembly.
Fatal Errors
Fatal errors cause immediate termination of the assembly. These errors usually occur as a result of an invalid command line. Fatal errors are also generated when the assembler cannot access a specified source file or when the macros are nested more than 9 deep.
Fatal errors produce a message that conforms to one of the following formats:
A251 FATAL ERROR –
FILE:
LINE:
ERROR:
A251 TERMINATED.
<file in which the error occurred> <line in which the error occurred <corresponding error message>
or
A251 FATAL ERROR –
ERROR:
A251 TERMINATED.
<error message with description>
where |
|
|
FILE |
is the name of an input file that could not be opened. |
|
LINE |
is the line where the error occurred |
8 |
ERROR |
is the fatal error message text explained below. |
|
|
|
|

238 Chapter 8. Error Messages
Fatal Error Messages
ATTEMPT TO SHARE FILE
A file is used both for input and output (e.g. list file uses the same name as the source file).
BAD NUMERIC CONSTANT
The numeric argument to the given control is illegal.
CAN’T ATTACH FILE
The given file can’t be opened for read access.
CAN’T CREATE FILE
The given file can’t be opened for write/update access.
CAN’T HAVE GENERAL CONTROL IN INVOCATION LINE
The given control is allowed in $control lines within the source file only (for example the EJECT control). Some controls are allowed only in the source text and not in the command line. Refer to “Chapter 7. Invocation and Controls” on page 195 for more information about the A251 controls.
CAN’T REMOVE FILE
The given temporary file could not be removed for some reason.
CONFLICTING CONTROL
The given control conflicts with an earlier control (for example $NOMOD251 MODSRC).
CONTROL LINE TOO LONG (500)
A $-control line has more than 500 characters.
DISK FILE REQUIRED
The given file does not represent a disk file.
ERRORPRINT– AND LIST–FILE CANNOT BE THE SAME
It is illegal to direct the listing file output and the errorprint output to the console at the same time.
EXPECTED DELIMITER ‘(‘ AFTER CONTROL
The given control requires a brace enclosed argument
8 |
EXPECTED DELIMITER ‘)‘ AFTER ARGUMENT |
The given control requires a brace enclosed argument |
|
|
Keil Software — A51/AX51/A251 Macro Assembler and Utilities |
239 |
|
|
FILE DOES NOT EXIST
The given file does not exist.
FILE IS READ ONLY
The given file does not permit write/update access.
FILE WRITE ERROR
The given file could not be written to (check free space)
IDENTIFIER EXPECTED
The given control requires an identifier as it’s argument, for example SET
(VAR1=1234H).
ILLEGAL FILE NAME, VOLUME OR DIRECTORY NAME
The name of the file is invalid or designates an invalid file.
INVOCATION LINE TOO LONG
The invocation line is longer than 500 characters.
LIMIT EXCEEDED: BALANCED TEXT LENGTH
The maximum length of a balanced text string is 65000 characters.
LIMIT EXCEEDED: INCLUDE OR MACRO NESTING
The maximum nesting level for MPL-macros is 50. The maximum nesting level of standard macros plus include files is 10.
LIMIT EXCEEDED: MACRO DEFINITION LENGTH
The maximum definition length of a standard macro is 20000 characters.
MPL macros are limited to 65000 characters.
LIMIT EXCEEDED: MORE THAN 16000 SYMBOLS
The number of symbols (labels, equ/set symbols, externals, segment-symbols) must not exceed 16000 per source file.
LIMIT EXCEEDED: SOURCE LINE LENGTH (500)
A single source line must not exceed the 500 characters per line limit.
LIMIT EXCEEDED: TOO MANY EXTERNALS (65535)
The number of external symbols must not exceed 65535 per source module.
LIMIT |
EXCEEDED: TOO MANY EXTERNALS (65535) |
|
|
The number of externals must not exceed 65535 per source module. |
|
||
LIMIT |
EXCEEDED: TOO MANY SEGMENTS (65535) |
8 |
|
The number of segments must not exceed 65535 per source module. |
|||
|
|||
|
|
|

240 |
Chapter 8. Error Messages |
|
|
NON-NULL ARGUMENT EXPECTED
The argument to the given control must not be null (for example $PRINT()).
OUT OF MEMORY
The assembler has run out of memory. Remove unnecessary drivers from your system configuration.
OUT OF RANGE NUMERIC VALUE
The numeric argument to the given control is out of range (for example $PAGEWIDTH(3000)).
UNKNOWN CONTROL
The given control is undefined.
8