- •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 |
193 |
|
|
MACRO Errors
The MPL processor emits error messages if errors occur in the MPL processing phase. Macro errors are displayed like other assembly errors in the listing file. The following table lists the error messages generated by the MPL processor.
Number |
Error Message and Description |
|
|
200PREMATURE END OF FILE
The end of the source module was reached while processing some macro call, which requires more input from the source file.
201'<token>' IDENTIFIER EXPECTED
The MPL processor expected an identifier while processing some macro. None was found. The unexpected token is displayed with this error message.
202MPL FUNCTION '<name>': '<character>' EXPECTED
The context of the MPL processor language requires a specific character from the input given by <character> while processing the built-in function given by <name>.
203<string>: UNBALANCED PARENTHESES
A balanced string requires the same number of right parentheses and left parentheses.
204EXPECTED '<token>'
The syntax requires a specific token to follow, for example THEN after the balanced text argument to IF.
205INCOMPLETE MACRO DEFINITION
The macro definition has not been completely processed due to premature end of input file.
206FUNCTION 'MATCH': ILLEGAL CALL PATTERN
|
The built-in function MATCH was called with an illegal call pattern. The call pattern |
6 |
|
must consist of some formal name followed by a delimiter specification and another |
|
|
formal name. |
|
207 |
FUNCTION 'EXIT' IN BAD CONTEXT |
|
|
The built-in function EXIT is allowed only in the loop control constructs WHILE and |
|
|
|
|
|
REPEAT. |
|
|
|
|
208 |
ILLEGAL METACHARACTER '<character>' |
|
|
The first character of the balanced text argument to METACHAR is taken to be the |
|
|
new value of the metacharacter. The characters @, (, ), *, blank, tab, and |
|
|
identifier-characters are not allowed to be the metacharacter. |
|
209 |
CALL PATTERN - DELIMITER '<delimiter>' NOT FOUND |
|
|
The call pattern of some macro does not conform to the define pattern of that macro. |
|
|
The delimiters of the macro call should be checked for conformance. |
|
|
|
|
210 |
CALL TO UNDEFINED MACRO '<name>' |
|
|
The macro call specifies the name of an undefined macro. |
|
194 |
|
Chapter 6. Macro Processing Language |
|
|
|
|
|
|
|
|
|
|
Number |
Error Message and Description |
|
|
|
|
|
211INVALID MPL COMMAND '%<character>'
The character following the metacharacter does not form a valid MPL command.
212INVALID DIGIT '<character>' IN NUMBER
A number of an expression contains an invalid digit.
213UNCLOSED STRING OR CHARACTER CONSTANT
214INVALID STRING OR CHARACTER CONSTANT
The string representing a number in an expression is invalid. The string must be either one or two characters long. A character constant must not be longer than one character. Strings or character constants must be enclosed by single or double quotes.
215UNKNOWN EXPRESSION IDENTIFIER
The identifier within some expression is not an operator or a number.
216<character>: INVALID EXPRESSION TOKEN
The given character does not form a valid operator or an identifier operator.
217DIV/MOD BY ZERO
A division or modulo by zero error occurred while evaluating an expression.
218EVAL: SYNTAX ERROR IN EXPRESSION
The expression to be evaluated contains a syntax error, for example two consecutive number, not separated by an operator.
219CAN'T OPEN FILE '<file>'
The file specified in the INCLUDE directive could not be opened.
220'<file>' IS NOT A DISK FILE
The file name given in the INCLUDE directive does not specify a disk file. Files other than disk files are not allowed (example: CON).
221ERROR IN INCLUDE DIRECTIVE
6 |
The INCLUDE directive is ill-formed. The argument to INCLUDE must be the name |
|
of some file, enclosed in parentheses. |
||
|
||
|
|