
- •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 |
273 |
|
|
Locating Programs to Physical Memory
This section describes with examples how you locate your application into the |
9 |
physical memory space for the different x51 variants. Refer to “Segment and |
Memory Location Controls” on page 331 for a detailed description of the linker/locater controls used in the examples below.
The linker/locator determines the physical memory range for relocatable segments based on the memory class that is assigned to the segment. Refer to “Memory Classes and Memory Layout” on page 27 for more information. However, it is also possible to specify a fixed address for a segment using linker/locater controls.
Classic 8051
The classic 8051 provides three different memory areas: on-chip RAM that covers the DATA, BIT and IDATA memory, XDATA memory, and CODE memory. The “Classic 8051 Memory Layout” is shown on page 29.

274 Chapter 9. Linker/Locator
|
|
Classic 8051 without Code Banking |
||
9 |
|
The following examples illustrate how to setup the linker/locater. For the BL51 |
||
|
linker/locater the physical memory is defined with the RAMSIZE, XDATA and |
|||
|
|
CODE control. For the LX51 linker/locater the CLASSES control is used to |
||
|
|
specify the available physical memory. |
|
|
|
|
The following example assumes the following memory areas. |
||
|
|
|
|
|
|
|
Memory Type |
Address Range |
Used by |
|
|
ON-CHIP RAM |
D:0 – D:0x7F (128 Bytes) |
registers, bits, variables, etc. |
|
|
XDATA RAM |
X:0 – X:0x7FFF, X:0xF800 – X:0xFFFF |
space for variables. |
|
|
CODE ROM |
C:0 – C:0x7FFF |
program code and constant area. |
To specify this memory layout BL51 should be invoked with as follows:
BL51 PROG.OBJ XDATA (0-0x7FFF, 0xF800-0xFFFF) CODE (0-0x7FFF) RAMSIZE(128)
You may also you the LX51 linker/locater. The CLASSES directive should have the following settings:
LX51 PROG.OBJ CLASSES (IDATA (D:0-D:0x7F),
XDATA (X:0-X:0x7FFF, X:0xF800-X:0xFFFF),
CODE (C:0-C:0x7FFF))
NOTE
You need not to define the address range for the memory classes DATA and BIT since the LX51 default setting already covers the correct physical address range.

Keil Software — A51/AX51/A251 Macro Assembler and Utilities |
275 |
|
|
Classic 8051 with Code Banking
The following example uses classic 8051 with a code banking hardware. This |
9 |
|||||||
hardware has the following memory resources: |
|
|
|
|
||||
|
|
|
|
|
|
|
|
|
|
Memory Type |
|
Address Range |
|
Used by |
|
|
|
|
ON-CHIP RAM |
|
I:0 – I:0xFF (256 Bytes) |
|
registers, bits, variables, etc. |
|
|
|
|
XDATA RAM |
|
X:0 – X:0xEFFF |
|
space for variables. |
|
|
|
|
CODE ROM |
|
C:0 – C:0x7FFF (common area) |
|
program code and constant area. |
|
|
|
|
|
|
B0:0x8000 – B3:0xFFFF (four banks) |
|
|
|
|
|
Parts of your program will be located into banks using BANKx in the inputlist portion of the Lx51 linker/locater command-line. Refer to “Bank Switching” on page 293 for more information. In addition you must specify the size of the common area and the other memory resources of your hardware. For this memory layout, the BL51 linker/locater should be invoked with as follows:
BL51 BANK0 {A.OBJ}, BANK1 {B.OBJ}, BANK2 {C.OBJ}, BANK3 {D.OBJ}
XDATA (0-0xEFFF) BANKAREA (0x8000 – 0xFFFF) RAMSIZE(256)
The LX51 linker/locater needs to be invoked as follows:
LX51 BANK0 {A.OBJ}, BANK1 {B.OBJ}, BANK2 {C.OBJ}, BANK3 {D.OBJ}
CLASSES (IDATA (I:0-I:0xFF), XDATA (X:0-X:0xEFFF),
CODE (C:0-C:0xFFFF)) BANKAREA (0x8000-0xFFFF)

276 Chapter 9. Linker/Locator
|
|
Extended 8051 Variants |
|
|
9 |
|
|||
|
Some extended 8051 variants expand the external data and program memory to |
|||
|
up to 16MB. The additional memory space is addressed with the memory |
|||
|
|
classes HDATA and HCONST. The “Extended 8051 Memory Layout” is shown |
||
|
|
on page 31. Only the LX51 linker/locater supports this expanded memory space. |
||
|
|
The following example shows assumes the following memory areas. |
||
|
|
|
|
|
|
|
Memory Type |
Address Range |
Used by |
|
|
ON-CHIP RAM |
D:0 – D:0xFF (256 Bytes) |
registers, bits, variables. |
|
|
XDATA RAM |
X:0 – X:0x1FFFF (128 KB) |
space for variables. |
|
|
CODE ROM |
C:0 – C:0xFFFFF (1 MB) |
program code and constant area. |
To specify this memory layout LX51 should be invoked with the following
CLASSES directive.
LX51 MYPROG.OBJ CLASSES (HDATA (X:0 – X:0x1FFFF),
HCONST (C:0 – C:0xFFFFF))
NOTE
You need not to define the address range for the memory classes DATA, IDATA, BIT, CODE, CONST, and XDATA since the LX51 default already covers the correct physical address ranges for these memory classes.
The memory classes HDATA and HCONST are used for constants or variables only. Program code is located into the expanded program memory with the same code banking mechanism as described above under “Classic 8051 with Code Banking”. A command line example that locates also program code into the expanded program memory will look as follows:
LX51 BANK0 {A.OBJ}, BANK1 {B.OBJ}, BANK2 {C.OBJ}, BANK3 {D.OBJ}
CLASSES (IDATA (I:0-I:0xFF), XDATA (X:0-X:0xEFFF),
HDATA (X:0-X:0x1FFFF), HCONST (C:0-C:0xFFFFF)
CODE (C:0-C:0xFFFF)) BANKAREA (0x8000-0xFFFF)
There are several Keil Application Notes available that show how to create programs for extended 8051 devices. Check www.keil.com or the Keil development tools CD-ROM for Keil Application Notes that explain how to setup the tools for extended 8051 devices.