- •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 |
255 |
|
|
Chapter 9. Linker/Locator
The Lx51 linker/locator is used to link or join together object modules that were |
9 |
||
created using the Ax51 assembler, the Cx51 compiler, and the Intel PL/M-51 |
|||
compiler. Object modules that are created by these translators are relocatable |
|
||
and cannot be directly executed. They must be converted into absolute object |
|
||
modules. The Lx51 linker/locator does this and much more. |
|
||
For optimum support of the different 8051 and 251 variants, the following |
|
||
linker/locater variants are available. The LX51 and L251 linker/locater provide |
|
||
an improved memory allocation handling and are supersets of the BL51 |
|
||
linker/locater. The following table gives you an overview of the linker/locater |
|
||
variants along with the translators that are supported. |
|
||
|
|
|
|
Linker/Locater |
Processes Files from… |
Description |
|
BL51 Code |
Keil A51 Macro Assembler |
For classic 8051. Includes support for |
|
Banking |
Keil C51 Compiler |
32 x 64KB code banks. |
|
Linker/Locater |
Intel ASM51 Assembler |
|
|
|
Intel PL/M51 Compiler |
|
|
LX51 Extended |
Keil A51 Macro Assembler |
For classic 8051 and extended 8051 |
|
Linker/Locater |
Keil C51 Compiler |
versions (Philips 80C51MX, Dallas 390, |
|
|
Keil AX51 Macro Assembler |
etc.) |
|
|
Keil CX51 Compiler for |
Allows code and data banking and |
|
|
80C51MX |
supports up to 16MB code and xdata |
|
|
Intel ASM51 Assembler |
memory. |
|
|
Intel PL/M51 Compiler |
|
|
L251 |
Keil A51 Macro Assembler |
For Intel/Atmel WM 251. |
|
Linker/Locater |
Keil C51 Compiler |
|
|
|
Keil A251 Macro Assembler |
|
|
|
Keil C251 Compiler |
|
|
|
Intel ASM51 Assembler |
|
|
|
Intel PL/M51 Compiler |
|
|
Programs you create using the Ax51 Assembler and the Cx51 Compiler must be linked using the Lx51 linker/locator. You cannot execute or simulate programs that are not linked, even if they consist of only one source module. The Lx51 linker/locator will link one or more object modules together and will resolve references within these modules. This allows you to create a large program that is spread over a number of source files.
|
256 |
Chapter 9. Linker/Locator |
|
|
|
|
The Lx51 linker/locator provides the following functions: |
|
9 |
|
Combines several program modules into one module, automatically |
|
||
|
|
incorporating modules from the library files |
|
|
Combines relocatable partial segments of the same segment name into a |
|
|
single segment |
|
|
Allocates and manipulates the necessary memory for the segments with |
|
|
which all relocatable and absolute segments are processed |
|
|
Analyzes the program structure and manipulates the data memory using |
|
|
overlay techniques |
|
|
Resolves external and public symbols |
|
|
Defines absolute addresses and computes the addresses of relocatable |
|
|
segments |
|
|
Produces an absolute object file that contains the entire program |
|
|
Produces a listing file that contains information about the Link/Locate |
|
|
procedure, the program symbols, and the cross reference of public and |
|
|
external symbol names |
|
|
Detects errors found in the invocation line or during the Link/Locate run. |
|
|
Supports programs that are larger than 64 Kbytes and applications that are |
|
|
using a Real-Time Multitasking Operating System (RTX51, RTX251, etc.). |
All of these operations are described in detail in the remaining sections of this chapter.
“Overview” on page 257 provides you with a summary of the features and capabilities of the BL51 linker/locator. This chapter introduces the concepts of what a linker is and does.
“Linking Programs” on page 266 describes how to invoke the linker from the command line. The command-line arguments are discussed, and examples are provided.
“Locating Programs to Physical Memory” on page 273 shows how to specify the physical memory available in the target hardware and how to locate segments to specific addresses.
“Data Overlaying” on page 280 explains how the Lx51 linker/locater creates a call tree for segment overlaying of local variables and discusses how to modify this call tree for applications that use indirect program calls.