Win 8051
Win 8051
Initial Topics..................................................................................................................1
Limited Warranty.......................................................................................................1
Copyright...................................................................................................................1
Contact Information...................................................................................................1
Registration ...............................................................................................................2
Introduction ...............................................................................................................3
Software Installation..................................................................................................3
Software Operation ...................................................................................................3
Context Help command ............................................................................................4
Title Bar.....................................................................................................................4
Scroll bars .................................................................................................................4
Output window ..........................................................................................................4
Options menu............................................................................................................4
Default Settings dialog ..............................................................................................5
File Menu ......................................................................................................................7
File menu commands................................................................................................7
New command (File menu).......................................................................................7
Open command (File menu) .....................................................................................7
File Open Dialog .......................................................................................................8
Close command (File menu).....................................................................................8
File Open Workspace command...............................................................................8
File Save Workspace command ...............................................................................8
File Close Workspace command ..............................................................................8
Recent Workspaces 1, 2, 3, 4 command (File menu)...............................................9
Save command (File menu)......................................................................................9
Save As command (File menu).................................................................................9
File Save As Dialog...................................................................................................9
Save All command (File menu)...............................................................................10
Recent Files 1, 2, 3, 4 command (File menu).........................................................10
Exit command (File menu) ......................................................................................10
Editor Basics...............................................................................................................11
Creating a New Edit Window ..................................................................................11
Opening an Existing Text File .................................................................................11
Saving Text in an Edit Window ...............................................................................11
Save a File Under a New Name .............................................................................11
Closing an Editor Window.......................................................................................12
Printing the Editor Text ...........................................................................................12
Previewing Printed Text ..........................................................................................12
Printer Setup ...........................................................................................................12
Exiting the IDE ........................................................................................................12
i
Table of Contents
Editor.......................................................................................................................13
Basic Editor Operations ..........................................................................................14
Cursor movement ...................................................................................................14
Line Editing .............................................................................................................15
Word Editing............................................................................................................15
Block Editing ...........................................................................................................15
Clip Board ...............................................................................................................16
Text Search.............................................................................................................16
Text Highlighting .....................................................................................................16
Miscellaneous Keyboard Commands .....................................................................17
Mouse Operations...................................................................................................18
Editor Commands .......................................................................................................19
Edit menu commands .............................................................................................19
Undo/Can't Undo command (Edit menu) ................................................................19
Redo command (Edit menu) ...................................................................................19
Cut command (Edit menu) ......................................................................................19
Copy command (Edit menu) ...................................................................................20
Paste command (Edit menu) ..................................................................................20
Find command (Edit menu).....................................................................................20
Find In Files command (Edit menu)........................................................................20
Replace command (Edit menu) ..............................................................................20
Find Dialog ..............................................................................................................21
Find In Files Dialog .................................................................................................22
Choose Directory Dialog .........................................................................................23
Replace Dialog........................................................................................................23
View Menu ..................................................................................................................25
View menu commands............................................................................................25
Toolbar command (View menu)..............................................................................25
Toolbar ....................................................................................................................25
Status Bar command (View menu) .........................................................................26
Status bar................................................................................................................26
Output command (View menu) ...............................................................................27
Registers command (View menu)...........................................................................27
Control Registers command (View menu) ..............................................................27
Ports command (View menu)..................................................................................27
Direct Memory command (View menu) ..................................................................27
Indirect Memory command (View menu) ................................................................27
External Memory command (View menu)...............................................................28
Watch Window command (View menu)..................................................................28
Assembler Basics .......................................................................................................29
Assembler ...............................................................................................................29
Project File ..............................................................................................................29
ii
Table of Contents
File Generation........................................................................................................29
Source File Format .................................................................................................29
Assembler Directives ..............................................................................................31
Inline Intel Hex Formatted Code .............................................................................34
Conditional Assembly .............................................................................................35
Multi-file Projects.....................................................................................................36
Assembler Commands ...............................................................................................37
Assemble menu commands....................................................................................37
Assemble command (Assemble menu) ..................................................................37
Build command (Assemble menu) ..........................................................................37
Stop command (Assemble menu) ..........................................................................37
Project command (Assemble menu).......................................................................38
Close Project command (Assemble menu) ............................................................38
Simulator Commands .................................................................................................39
Simulator .................................................................................................................39
Simulate menu commands .....................................................................................40
Start Simulator command (Simulate menu)............................................................40
Restart command (Simulate menu) ........................................................................40
Stop command (Simulate menu) ............................................................................41
Continue command (Simulate menu) .....................................................................41
Break command (Simulate menu) ..........................................................................41
Step Into command (Simulate menu) .....................................................................41
Step Over command (Simulate menu) ...................................................................42
Step Out command (Simulate menu) .....................................................................42
Run To Cursor command (Simulate menu) ............................................................42
Toggle Break Point command (Simulate menu) .....................................................42
Remove All Break Points (Simulate menu).............................................................43
Simulator Commands .............................................................................................43
Modify Simulated Registers ....................................................................................43
Simulate Execution .................................................................................................43
Counter and Interrupt Simulation ............................................................................44
Serial Port Simulation .............................................................................................44
Button Simulation....................................................................................................44
See Also..................................................................................................................44
Simulator Display Values ........................................................................................45
Registers window....................................................................................................45
Ports window...........................................................................................................45
Control Registers window .......................................................................................46
XRAM window.........................................................................................................46
IRAM window ..........................................................................................................46
DRAM window.........................................................................................................47
Watch window .........................................................................................................47
iii
Table of Contents
iv
Table of Contents
v
Initial Topics
Limited Warranty
With respect to the physical diskette and physical documentation enclosed herein,
AceBus warrants the same to be free of defects in materials and workmanship for
a period of 60 days from the date of purchase. In the event of notification within
the warranty period of defects in material or workmanship, AceBus will replace the
defective diskette or documentation. The remedy for breach of this warranty shall
be limited to replacement and shall not encompass any other damages, including
but not limited to loss of profit, and special, incidental, consequential, or other
similar claims.
AceBus specifically disclaims all other warranties, expressed or implied, including
but not limited to implied warranties of merchantability and fitness for a particular
purpose with respect to defects in the diskette and documentation, and the
program license granted herein in particular, and without limiting operation of the
program license with respect to any particular application, use, or purpose. In no
event shall AceBus be liable for any loss of profit or any other commercial
damage, including but not limited to special, incidental, consequential or other
damages.
AceBus reserves the right to stop supporting the software/hardware and to stop
releasing updates for this software at any time after the warranty period.
Copyright
Under the copyright laws, neither the documentation nor the software may be
copied, photocopied, reproduced, translated, or reduced to any electronic medium
or machine-readable form, in whole or in part, without the prior written consent of
AceBus.
Copyright 1997-2003 AceBus
835 Weatherhead Hollow Road
Guilford, VT 03501
All rights reserved.
Contact Information
You can contact AceBus via one of the following methods:
By mail at: AceBus
835 Weatherhead Hollow Road
Guilford, VT 03501
Via e-mail at: [email protected]
Via WWW at: www.acebus.com
1
Printed Documentation
Registration
AceBus is a small one-man operation. Your purchase of this program will help
insure its continued development. If you find this program useful please obtain a
registered version.
The unregistered evaluation version of this program has the following limitations.
• Editor text buffer limited to 16k bytes
• No include file support
Otherwise it is fully functional. It is provided for evaluation purposes only. If you
continue to use it then please register it.
The Registered version adds include file support and the editor uses a dynamic
text buffer size. The size of the text buffer is allocated to be 64k bytes larger than
the file being loaded.
The primary difference between the evaluation and registered versions is the size
of the 8051 application that can be developed.
The installation and registration key files can be obtained online using secure
order processing via the following Register Now (http://www.regnow.com/) link
The online registration process uses electronic distribution of the IDE and
registration key file. Upon completion of the on-line order process you will be given
a time limited download link for a compressed file containing the IDE setup files.
You will also be sent the registration key file as an e-mail attachment. This e-mail
also contains instructions on using the attached key file to register the IDE. A hard
copy of the program on diskette is not included with the on-line registration
process.
The manual is supplied in an Adobe Acrobat (PDF) format file and is automatically
copied to your computer during the installation process.
2
Initial Topics
Introduction
The 8051 Integrated Development Environment (IDE) combines a text editor,
assembler and software simulator into a single program. All components needed
to develop 8051 programs (and its various derivatives) available and controllable
from this single IDE.
Enter and modify the program source code from within the built in editor. Then
assemble the source code by selecting the Assemble command. If any errors are
located the appropriate source module can be automatically loaded and the cursor
placed on the line containing the error. Fix the error and move to the next error (if
any). Once all errors have been fixed reassemble the code.
After successfully assembling the source code use the simulator to step through
your program. You can watch registers, flags, ports and memory locations change
as your program progresses. You will see the flow of your program and be able to
verify that it operates as intended. If it does not then return to the editor,
reassemble and back to the simulator.
Software Installation
To install the 8051 IDE onto the hard disk of a Windows 95 (98/ME/NT4.0 or XP)
based computer perform the following steps:
1. Download the 8051 for Windows IDE from the following web link
http://www.acebus.com/download/win8051.zip
2. Extract the setup files contained in the win8051.zip file to a temporary directory.
3. Once the setup files have been extracted, run the Setup.exe program to begin
the installation process.
Once setup has completed a 8051 IDE program group will be added to the Start
menu under Programs. A short cut to the 8051 IDE executable is located in this
new file group.
Selecting its shortcut from the Start Menu runs the 8051 IDE.
Software Operation
The 8051 Integrated Development Environment (IDE) is a Windows 95 based
application. It operates with the same look and feel of other Windows based
application.
The following interface objects are present:
Menu bar: contains the main menu options from which submenus are displayed.
Tool bar: contains a row of icon providing a short cut to many of the menu
commands.
Status bar: contains information about the programs current operations.
Client area: contains the editor and simulation windows.
See Also
File menu
Edit menu
View menu
Simulate menu
Options menu
Window menu
Help menu
3
Printed Documentation
Toolbar:
Keys: Shift+F1
Title Bar
The title bar is located along the top of a window. It contains the name of the
application and document.
To move the window, drag the title bar. Note: You can also move dialog boxes by
dragging their title bars.
A title bar may contain the following elements:
• Application Control-menu button
• Document Control-menu button
• Maximize button
• Minimize button
• Name of the application
• Name of the document
• Restore button
Scroll bars
Displayed at the right and bottom edges of the document window. The scroll
boxes inside the scroll bars indicate your vertical and horizontal location in the
document. You can use the mouse to scroll to other parts of the document.
Output window
The output window list single line messages which result from assembly or
searching for files. Double clicking on a error message or found in file entry will
cause the associated source file to be displayed with the cursor positioned on the
indicated line.
See Also
Output command (View menu)
Options menu
The Options menu offers the following commands:
Defaults Displays a dialog box which allows you to change various program
defaults.
4
Initial Topics
5
File Menu
File menu commands
The File menu offers the following commands:
New Creates a new document.
Open Opens an existing document.
Close Closes an opened document.
Save Saves an opened document using the same file name.
Save As Saves an opened document to a specified file name.
Print Prints a document.
Print Setup Selects a printer and printer connection.
Exit Exits 8051 IDE.
Toolbar:
Keys: Ctrl+N
Toolbar:
Keys: Ctrl+O
7
Printed Documentation
8
File Menu
Shortcuts
Toolbar:
Keys: Ctrl+S
9
Printed Documentation
Toolbar:
Keys: Alt+F4
10
Editor Basics
Creating a New Edit Window
To create a new empty edit window, select New from the File menu.
A new edit window will be displayed into which you can enter text.
See Also
File New command
11
Printed Documentation
Printer Setup
To specify an alternate printer or to change the settings of the selected printer use
the Print Setup command in the File menu. Selecting the Print Setup command
will result in the Print Setup Dialog box being displayed. Use this dialog box to
change the printer options.
See Also
File Print Setup command
Print Setup Dialog
12
Editor Basics
Editor
The editor will be invoked when a file is loaded or when the New command is
selected.
The editor in the IDE is a full screen editor, designed for program editing and not
word processing. Features like word wrap are not available.
Many editor commands are invoked through a compound key sequence (or
keystroke). A compound keystroke is accomplished by holding down one key,
pressing another, and then releasing them both. Compound key sequences are
indicated with a plus sign. For example pressing and holding down the Ctrl key,
pressing the L key and releasing them both performs the Ctrl+L compound
keystroke. Some compound key strokes require three keys. Pressing and holding
the Shift key, pressing and holding the Ctrl key, pressing the PgUp key and
releasing all three keys perform for example Shift+Ctrl+PgUp.
Some editor commands utilize a compound keystroke and a single keystroke. For
example the key sequence Ctrl+Q Y is composed of a compound keystroke and a
single keystroke. Pressing and holding down the Ctrl key, pressing the Q key,
releasing them both, then pressing and releasing the Y key performs this example.
This type of key sequence requires that the Ctrl key be released before the
second key is pressed. For example Ctrl+Q Ctrl+Y is not the same as Ctrl+Q Y.
See Also
Basic Editor Operations
Cursor movement
Line Editing
Word Editing
Block Editing
Clip Board
Text Search
Text Highlighting
Miscellaneous Keyboard Commands
Mouse Operations
13
Printed Documentation
Cursor movement
Key Stroke Description
Home Moves the cursor to the start of the current line.
End Move the cursor to the end of the current line.
PgUp Displays the previous page of text. If you are at the top of the text
buffer then pressing PgUp will be ignored.
PgDn Displays the next page of text. If you are at the bottom of the text
buffer then pressing PgDn will be ignored.
UpArrow Moves the cursor up one line. If the cursor is at the top of the text
buffer then pressing UpArrow will have no effect.
DownArrow Moves the cursor down one line. If the cursor is on the last line of
the text buffer pressing DownArrow will have no effect.
RightArrow Moves the cursor one character location to the right. If the cursor
is at the end of a line then it will be positioned to the start of the
next line.
LeftArrow Moves the cursor one character location to the left. If the cursor
is at the start of a line then the cursor is moved to the end of the
previous line.
Ctrl+PgUp Go to top of document: Moves the cursor to the top of the text
buffer.
Ctrl+PgDn Go to end of document: Moves the cursor to the bottom of the text
buffer.
Ctrl+Home Same as Ctrl+PgUp
14
Editor Basics
Line Editing
Key Stroke Description
Ctrl+Q Y Delete rest of line: Deletes all character from the current cursor
location to the end of the current line, including the character
under the cursor.
Ctrl+Q S Go to start of line: Moves the cursor to the start of current line
(same as the Home key).
Ctrl+Q D Go to end of line: Moves cursor to the end of the current line
(same as the End key).
Word Editing
Key Stroke Description
Ctrl+K T Highlight word: Highlights (block marks) the word the cursor is
currently on.
Ctrl+LeftArrow Word left: Moves the cursor left one word (to the next blank
space).
Ctrl+RightArrow Word right: Moves the cursor right one word (to the next blank
space).
Ctrl+T Delete word: Deletes the word the cursor is currently on.
Block Editing
Key Stroke Description
Ctrl+K I Indent block: Adds a blank space at the start of all lines contained
15
Printed Documentation
Clip Board
Key Stroke Description
Ctrl+C Copy to clip board: Copies the currently selected block of text to
the clipboard (temporary storage area).
Ctrl+X Cut to clipboard: Copies the currently selected block of text to the
clipboard. Then removes the marked block from the text buffer.
Ctrl+V Paste from clipboard: Copies the previously stored text from the
clipboard to the current cursor position.
Text Search
Key Stroke Description
Ctrl+F Find string: This command prompts you for a string of characters.
The cursor will be positioned just after the first occurrence of the
specified search string.
Ctrl+H Find and replace string: This command prompts you for two
strings of characters. The first is the string to locate and the
second the string to replace the one located.
F3 Repeat last find or find/replace: This command positions the
cursor just after the next occurrence of the string specified by the
last Find or Find and replace string command (which ever was
performed last).
Text Highlighting
Key Stroke Description
Shift+LeftArrow Extend highlight left: Adds the character to the left of the cursor to
the marked block.
Shift+RightArrow Extend highlight right: Adds the character to the right of the cursor
to the marked block.
Shift+UpArrow Extend highlight up: Adds the rest of the current line and the right
side of the previous line to the marked block.
Shift+DownArrow Extend highlight down: Adds the rest of the current line and the
left side of the next line to the marked block.
Shift+Home Highlight to start of line: Moves the start of the block marker to the
beginning of the current line.
Shift+End Highlight to end of line: Moves the end of block marker to the end
of the current line.
Shift+Ctrl+PgUp Highlight to start of buffer: Moves the start of block marker to the
beginning of the text buffer.
Shift+Ctrl+Home Highlight to start of buffer: Performs the same function as
Shift+Ctrl+PgUp.
16
Editor Basics
Shift+Ctrl+PgDn Highlight to end of buffer: Moves the end of block marker to the
end of the text buffer.
Shift+Ctrl+End Highlight to end of buffer: Performs the same function as
Shift+Ctrl+PgDn.
Shift+Ctrl+LeftArr Highlight word left: Extends the highlight to include the word to
the left of the cursor.
Shift+Ctrl+RightArr Highlight word right: Extends the highlight to include the word to
the right of the cursor.
17
Printed Documentation
Mouse Operations
Many of the previously mentioned keyboard operations can also be performed
using the mouse. The following lists available mouse operations.
Position Cursor: the cursor can be position in the editor windows by moving the
mouse pointer to the desired location and clicking the left mouse button.
Text Highlighting: text can be selected by moving the mouse pointer to the start
of the text to be selected. Click and hold down the left mouse button. While
holding down the left mouse button move the mouse pointer to the end of the text
to be selected. Text will be highlighted as the mouse pointer is dragged across
the window.
Highlight Word: a word (text surrounded by blanks) can be selected by
positioning the mouse pointer over the desired text. While the mouse pointer is
over the desired text double clicking the left mouse button.
Popup Menu: a popup menu is displayed by clicking the right mouse button with
the pointer over the editor window. A context sensitive menu will be display from
which commands can be selected. The menu options correspond to Edit menu
commands and perform the same operation.
18
Editor Commands
Edit menu commands
The Edit menu offers the following commands:
Undo Reverse previous editing operation.
Cut Deletes data from the document and moves it to the clipboard.
Copy Copies data from the document to the clipboard.
Paste Pastes data from the clipboard into the document.
Find Locates the specified text in the active editor window.
Find In Files Locates the specified text in the specified file group.
Replace Locates and replaces the specified text in the active window with the
specified text.
Toolbar:
Keys: Ctrl+X
19
Printed Documentation
Toolbar:
Keys: Ctrl+C
Toolbar:
Keys: Ctrl+V
Toolbar:
See Also
Find In Files Dialog
20
Editor Commands
Find Dialog
The following options allow you to specify the text to locate:
Find what
Type or select the text you want to search for. Clicking on the down arrow
at the right of this text box will cause a list of previous search texts to be
displayed. Select the text from the drop down list box or type the text you
want to search for.
Match whole words only
Select this check box is you want to search for whole words only. When
checked the specified text must be surrounded by blanks; or be at the start
of a line followed by a space; or at the end of the line proceeded by a
space; or the only word on the line. If this box is not checked then text will
be found even if it is part of a word.
Match case
Select this check box if you want to perform a case sensitive search.
Remove the check if you want to search regardless of case.
Direction
Up: search starting at the current cursor location towards the start of the
document. If not found before the start of the document is reached then it
continues at the end of the document.
Down: search starting at the current cursor location towards the end of the
document. If not found before the end of the document is reached then is
continues at the start of the document.
Find Next
Starts or continues the search for the specified text in the specified
direction.
Cancel
Stops or cancel the search.
When Find Next is selected the current search parameters are saved for the next
search operation. The Find what text is also added to the list of previous search
texts. It is added to the start of the list and the last item in the list is discarded if
room is not available to retain it.
21
Printed Documentation
22
Editor Commands
Replace Dialog
The following options allow you to specify the text to locate:
Find what
Type or select the text you want to search for. Clicking on the down arrow
at the right of this text box will cause a list of previous search texts to be
displayed. Select the text from the drop down list box or type the text you
want to search for.
Replace with
Type or select the text you want to replace the found text with. Clicking on
the down arrow at the right of this text box will cause a list of previous
search texts to be displayed. Select the text from the drop down list box or
type the text into the edit box.
Match whole words only
Select this check box is you want to search for whole words only. When
checked the specified text must be surrounded by blanks; or be at the start
of a line followed by a space; or at the end of the line proceeded by a
space; or the only word on the line. If this box is not checked then text will
be found even if it is part of a word.
Match case
Select this check box if you want to perform a case sensitive search.
Remove the check if you want to search regardless of case.
Direction
Up: search starting at the current cursor location towards the start of the
document. If not found before the start of the document is reached then it
continues at the end of the document.
Down: search starting at the current cursor location towards the end of the
document. If not found before the end of the document is reached then is
continues at the start of the document.
23
Printed Documentation
Find Next
Starts or continues the search for the specified text in the specified
direction.
Replace
If the search has begun and text has been found clicking this button will
cause the located text to be replaced with the specified text. If the search
has not begun then clicking this button performs the same action as Find
Next.
Replace All
If the search has begun and text has been found clicking this button will
cause the located text to be replaced with the specified text and all
remaining occurrences to be located and replaced automatically. If the
search has not begun then clicking this button will search out all occurrence
of the specified text and automatically replace it with the specified text.
Cancel
Stops or cancel the search.
When Find Next, Replace, or Replace All is selected the current search and
replace parameters are saved for the next search and replace operation. The
Find what and Replace with text is added to their corresponding lists of previous
search texts. They are added to the start of the list and the last item in the list is
discarded if room is not available to retain it.
24
View Menu
View menu commands
The View menu offers the following commands:
Toolbar Shows or hides the toolbar.
Status Bar Shows or hides the status bar.
Output Opens an Output window.
Registers Opens a Registers window.
Ports Opens a Ports window.
Direct Opens a Direct Memory window.
Memory
Indirect Opens an Indirect Memory window.
Memory
External Opens an External Memory window.
Memory
Watch Opens a Variable Watch window.
Window
Toolbar
The toolbar is displayed across the top of the application window, below the menu
bar. The toolbar provides quick mouse access to many tools used in the 8051
IDE,
To hide or display the Toolbar, choose Toolbar from the View menu (ALT, V, T).
Click To
Open an existing document. The 8051 IDE displays the Open dialog
box, in which you can locate and open the desired file.
Save the active document with its current name. If you have not named
the document, the 8051 IDE displays the Save As dialog box.
Saves all open documents with their current name. If you have not
named a document, the 8051 IDE displays the Save As dialog box for
each unnamed document.
25
Printed Documentation
Add variable to Watch window. The text under the cursor will be
presented as the variable name. You can then accept this text or edit
and change it.
Set or clears a break point at the current cursor location. If the line the
cursor is one does not contain a break point then one is placed there. If
the line does contain a break point then it is removed.
Status bar
The status bar is displayed at the bottom of the 8051 IDE window. To display or
hide the status bar, use the Status Bar command in the View menu.
26
View Menu
The left area of the status bar describes actions of menu items as you use the
arrow keys to navigate through menus. This area similarly shows messages that
describe the actions of toolbar buttons as you depress them, before releasing
them. If after viewing the description of the toolbar button command you wish not
to execute the command, then release the mouse button while the pointer is off
the toolbar button.
The right areas of the status bar indicate the following:
Indicator Description
INS Indicates the state of the Insert/Overtype mode of the editor.
Ready Indicates the status of back ground processing (Ready or Busy).
Ln 1, Col 1 Indicates the Line and Column position of the cursor in the editor.
27
Printed Documentation
28
Assembler Basics
Assembler
Selecting Assemble from the Assemble menu assembles the source in the
currently active editor window. The number of errors found in the source will be
displayed in the Output window.
If any errors are located double clicking on an error message will load the
associated source code and position the cursor at the location of the line
containing that error.
NOTE: Some errors will generate additional errors, usually the first error is the
actual offense. If you fix an error and are unable to see the problem with a
subsequent error try reassembling the source.
Once an error is fixed, double clicking on other listed errors will load the
associated source code and position the cursor on the corresponding line If you
add a new line or delete an existing line the offending line no longer has the same
line number as the one in the error list. For this reason if you add or delete lines
containing errors reassemble the source to regenerate an accurate error/line
number list. If no errors are reported you can simulate the source.
Refer to 8051 source format, for a description of the layout of an 8031 assembly
language program.
Project File
The Project option allows you to specify the main source file in a multi-file project.
The project file contains include statements which list all the files in the project.
This allows you to assemble your project without having to first load the main file.
To specify a project file select the Project command from the Assemble menu and
type in the file name or select one from the list.
Use the Close Project command to clear the specified project file name.
Refer to the section titled Multi-file Projects for an explanation of how to setup a
multi-file project.
File Generation
The 8051 assembler generates a number of files when it assembles either an
individual file or a project. These files have the same name as either the individual
file being assembled or the name of the project being built. They will however
have the following extensions
29
Printed Documentation
LABEL: Each line of source can contain an optional label. Labels may contain
letters, digits and an under score (_) character. The label must start with a
alphabetic character and terminate with a colon ":". Labels can contain as many
characters as you want although the assembler only recognizes the first 32. The
first time a label is encountered its name along with the current value of the
program counter is added to the label table. When the label is used as an
operand the value of the program counter associated with that label is substituted.
OPCODE: Opcodes can be either an 8051 mnemonic or an assembler directive.
A list of mnemonics and their operands are given in appendix A. The following
section contains a list of assembler directives. Opcodes must be separated from
labels and operands by at least one blank.
OPERAND: Operands are added after a mnemonic or directive to indicate what
the operation is to be performed on.
For example in the instruction: MOV R1,A
The operands are R1 and A. A comma, as in the example just given must
separate multiple operands.
COMMENT: Comments begin with a semicolon and instruct the assembler to
ignore all text from the semicolon to the end of the line.
SYMBOL: A symbol is a character string, which represents a specific value. For
example the source line
CR EQU 13
Instructs the assembler to equate the value 13 with the character sequence CR.
Symbols must conform to the same requirements as labels (but they are
terminated with a blank instead of a colon).
EQUATIONS: The assembler has a built in equation evaluator. Opcodes requiring
an immediate value or directives requiring a value can be constructed into an
equation. For example in the following source line
MOV A,8*4
8 * 4 is the equation which will be evaluated. Equations can be comprised of
numbers, labels, symbols, operators and parenthesized sub-equations.
Numbers must start with a digit between 0 and 9. Terminating with a B, H or D
respectively can specify binary, hexadecimal and decimal numbers. For example
01000001b, 041h and 65d are binary, hexadecimal and decimal representations of
the same value. If the radix is not specified then decimal is assumed. Although
the default assembler radix can be changed with the RADIX assembler directive.
Values for ASCII characters can be specified by surrounding the character with
single quotes, for example 'A' will cause the ASCII value (65) for the character to
be substituted.
Labels and symbols can be used if previously defined or equated to a value.
Labels and symbols not defined prior to their use can be used in expressions if
their value is not required on the first assembler pass. For example in the source
lines
DB 'hello', CR, LF
CR EQU 13
LF EQU 10
the value of CR and LF are not needed on the first pass, their values can be
substituted on the second pass. The only exception is the DS (Define Space)
directive. An example of this is
DS BUFSIZE
BUFSIZE EQU 20
30
Assembler Basics
This code segment will generate a phase error. On the first pass the assembler
must know how many bytes to allocate for the DS (Define Space) directive in order
for it to continue determining address values for subsequent labels. For this
reason labels and symbols used in the DS directive must be defined prior to their
use.
The available operators are listed below in order of precedent
() parenthesized sub-equations
High returns the high byte of an integer value/result.
Example: if val is equal to 0x1234
High(val) returns 0x12
Low returns the low byte of an integer value/result.
Example: if val is equal to 0x1234
Low(val) returns 0x34
HighWord Returns the high word (two-byte) of an integer value/result.
Example: if val is equal to 0x12345678
HighWord(val) returns 0x1234
LowWord Returns the low word (two-byte) of an integer value/result.
Example: if val is equal to 0x12345678
LowWord(val) returns 0x5678
^ exponential
* multiplication
/ division
%, MOD modular, either type can be used.
&, AND logical AND, either type can be used.
|, OR logical OR, either type can be used.
+ addition
- subtraction
+, - unary operations
.n dot operator (20H.1=33, 20H.2=34, ... 20H.7=39)
Assembler Directives
The following is a list of directives supported by the 8051 Assembler:
ORG: Originate. Resets the program counter (at assembly time) to a specific
value. For example the source line
ORG 7
resets the program counter to the value 7.
DATAORG: Data Originate. Resets the data address counter used by the DS
directive. For example the source code segment
DATAORG 10
VAR1 DS 1
VAR2 DS 1
sets the symbols VAR1 and VAR2 to 10 and 11 respectively.
31
Printed Documentation
EQU: Equates a value with a character string (Symbol). For example the source
line
LF EQU 10
adds the symbol LF to the symbol table with the associated value 10. Each time
LF is used as an operand the value 10 will be substituted. A symbol can be
equated only once in a project. Equated symbols are evaluated to a numeric
result. The EQU directive does not perform a character substitution.
SET: Like EQU, SET sets a symbol to a specific value. A symbol’s value can be
modified at more than one location in the source file by the SET command.
BIT: Equates a bit address with a character string (Symbol). For example the
source line
HoldPin BIT 80h
adds the symbol HoldPin to the symbol table with the associated bit address 80h
(128 decimal, same as bit 0 of port 0). Each time HoldPin is used as an operand
the value 80h will be substituted. A symbol can be defined using the BIT
operation only once in a project. Bit defined symbols are evaluated to a numeric
result. The BIT directive does not perform a character substitution.
DATA: Equates an address with a character string (Symbol). For example the
source line
Count1 DATA 10h
adds the symbol Count1 to the symbol table with the associated address 10h (16
decimal). Each time Count1 is used as an operand the value 10h will be
substituted. A symbol can be defined using the DATA operation only once in a
project. Defined symbols are evaluated to a numeric result. The DATA directive
does not perform a character substitution.
DB: Define byte. This directive places a value or string of values in program
memory at the current program counter location (one per memory location). For
example
NUM: DB 10
MSG: DB 'HELLO WORLD',13,10
are legal usage of the DB directive. Each value (or values) will occupy one
memory location.
DW: Define word. This directive places a value or string of values in program
memory at the current program counter location one per 2 bytes of memory. For
example
NUM: DW 10
MSG: DW 'HELLO WORLD',13,10
are legal usage of the DW directive. Each value (or values) will occupy two
memory locations (in LS MS order).
DS: Define space. This directive will allocated a specified number of data memory
locations starting at the current data address counter location. For example
BUF DS 10
will allocate 10 bytes of memory starting at the location associated with BUF. This
directive is used to allocate space in internal and external data memory.
PAGE rows: Rows is optional, if omitted the listing file is advanced to the top of
the next page. If specified this value indicates the number of lines per page in the
listing file (e.g. PAGE 66). The default lines per page is 66.
%TITLE "title string": This directive allows you to specify the title to be displayed
in the listing file. You can change the title as often as you like. But since the title
32
Assembler Basics
is displayed at the top of the first page the last defined title in your source file will
be displayed. This is due to the fact that the title is displayed before any lines of
the source file are processed for the second assembly pass. They have all been
processed for the first pass.
The quotes around the title string are required. Every character after the first
quotation mark to the character just before the next quotation mark will be
included in the title.
%SUBTTL "subtitle string": This directive allows you to specify the subtitle to be
displayed in the listing file. This subtitle is displayed starting will the second page
and can be changed as often as you like. The last declared subtitle will be
displayed in the title block of each page (except the first page).
%TOPMAR val: Allows you to specify the number of lines in the top margin of the
listing file. This value must be greater than 4 and must be less than the page
length minus the bottom margin (defined below).
%BOTMAR val: Allows you to specify the number of lines in the bottom margin of
the listing file. This value must be greater than 0 and must be less than the page
length minus the top margin (defined above).
END: Instructs the assembler to stop assembling the source file (ignore any text,
which follows the END directive). The END directive is not required, the
assembler will stop assembling either when it reaches an END directive or the end
of the text buffer.
RADIX: Allows you to change the default radix conversion from decimal to
hexadecimal or binary. The following lists the possible usage:
RADIX DEC - sets the default conversion radix to decimal.
RADIX HEX - sets the default conversion radix to hexadecimal.
RADIX BIN - sets the default conversion radix to binary.
INCLUDE: Allows you to build and simulate multi-file projects. Allowing for the
creation of programs which are to large to load into the editor. The format for the
include directive is:
INCLUDE "filename.ext"
The name of the included file must be enclosed in quotes. No extension is
assumed and must therefor be specified. The quotation marks are optional. You
can also use the traditional $ include format. This format of the include directive
is:
$filename.ext
An END directive in an included file will stop the assembly of that include file but
not of the project as a whole.
* The INCLUDE directive is only available in the registered version of the 8051
IDE.
BREAK: Specifies a break point in your code. This will cause the Simulator to
suspend your program when this point is reached.
MEMTYPE: Specifies the type of memory subsequent variables (symbols) will be
referencing. This allows the simulator to automatically select the Resource Type
when adding a watch from the edit window. This directive has the following format
MEMTYPE reftype
Were: reftype is one of the following
IRAM – internal Indirect RAM
DRAM – internal Direct RAM
33
Printed Documentation
:108000007581B71282F712817320930B128242207E
can be inserted directly into your source file. You can also use the INCLUDE
directives to insert an entire hex file into your project. A line that starts with a
colon (:) is assumed to be an Intel Hex formatted code segment. An Intel Hex
formatted code segment has the following format
:NNAAAA00DDDD.....DDCS
Were
: signals the start of an Intel Hex formatted segment. Must be the
first non-space character of the line. Otherwise the line will not be
recognized as inline code.
NN is a two-character (1-byte) ASCII hex value indicating the number
of data bytes (DD).
AAAA is a four-character (2-byte) ASCII hex value indicating the address
of the code segment.
00 is a two character (1-byte) ASCII hex format identifier and must be
00 (no other format is recognized).
DD is a two-character (1-byte) ASCII hex code (or data) byte.
CS is a two-character (1-byte) ASCII hex value representing the 2’s
compliment check sum
The Intel Hex formatted code segment is added to your program code starting at
the current program counter address in the following sequence.
NNAAAA00DDDD.....DD
All values (except for the check sum) are added to the program code.
The following is an example code segment that adds a Hex file named flashup.hex
to the program code.
34
Assembler Basics
The Intel Formatted code will be added to the main programs code base starting at
the address associated with RelCodeSeg. The end of this added code segment is
identified by the address associated with RelCodeSegEnd.
Conditional Assembly
The assembler allows you to conditionally assemble segments of your code. This
allows you to assemble (or not assemble) various portions of your program. The
following illustrates the usefulness of conditional assembly. In this example
OFFSET is a constant, LOWBYTE and HIGHBYTE are internal memory locations.
OFFSET does not change at runtime, and LOWBYTE and HIGHBYTE do.
OFFSET EQU 1000H
MOV A,LOWBYTE
ADD A,#LOW OFFSET
MOV LOWBYTE,A
MOV A,HIGHBYTE
ADDC A,#HIGH OFFSET
MOV HIGHBYTE,A
In this example zero is added to the value LOWBYTE and does not change it.
Therefor the code performs no useful purpose and adds overhead to the program.
You could simply delete the code segment although this would cause problems if
the value of OFFSET changes. You can add conditional assembly directives to
help optimize the code. The following illustrates the modified code.
OFFSET EQU 1000H
CLR C ; clear in case the following
; code is omitted.
IF LOW(OFFSET) <> 0 ; if low byte is none zero
MOV A,LOWBYTE ; include code to add
ADD A,#LOW OFFSET ; low byte offset.
MOV LOWBYTE,A
ENDIF
MOV A,HIGHBYTE
ADDC A,#HIGH OFFSET
MOV HIGHBYTE,A
Since the low byte of OFFSET is zero the code is removed (not added) to the
runtime program. Although if at a later time the value of OFFSET changes (to say
1010h) then the code would be included in the assembled program.
It is important to note that this code is added or omitted from the assembled
machine code. The condition is tested at assembly time and not run time.
Therefor the condition of the test must not be able to change during runtime. If the
code is omitted the only way to get it back is to reassemble and reprogram the
circuit.
The conditional test operators are: <, >, =, <> (less than, greater than, equal and
not equal).
In the previous example we include or don't include a segment of code. Using an
ELSE construct we can assemble one of two program segments. For example
HARDWARE EQU 1
IF HARDWARE = 1
MOV R0,#10
ELSE
MOV R0,#20
ENDIF
35
Printed Documentation
This example allows you to maintain one version of source code for two versions
of hardware. In one version you need to load R0 with the value 10 and another
version with the value 20. To create firmware for each of the two versions you
simply change the value HARDWARE gets equated to and reassemble.
Multi-file Projects
The 8051 assembler recognizes a number of directives, which it treats as
comment lines. These directives are:
NAME, RSEG, PUBLIC, and EXTERN
These directives are used by some assemblers to allow a program to be brocken
into separate source modules. They allow each module to be assembled separate
of each other. Since this 8051 assembler does not support true program (source)
modules they have no purpose.
Use the INCLUDE directive to build multi-file projects. You can use a separate
source file, which simply lists each of the modules comprising the project. The
following is an example project file and has the file name PROJECT.ASM
INCLUDE "DEFINES.ASM" ; EQUATED SYMBOLS
36
Assembler Commands
Assemble menu commands
The Assemble menu offers the following commands:
Assemble Assembles the source code in the active editor window.
Build Assembles the source code file(s) indicated by the selected project.
Stop Stops a build or assembly in progress.
Project Specifies the name of the project file.
Close Closes (clears) the project name.
Project
Toolbar:
Keys: Ctrl+F7
See Also
Start Simulator
Toolbar:
Keys: F7
See Also
Project command
Start Simulator
37
Printed Documentation
38
Simulator Commands
Simulator
The simulator allows you to step through your source code watching registers,
flags, ports and RAM change. You can step into, step over and execute to source
lines. Selecting Start Simulator via the Simulate menu enters the simulator.
While the simulator is running it will control the display of source code and values
in the associated windows (Registers, DRAM, IRAM, XRAM and Ports). The
active window contains the cursor and the windows title bar is not grayed.
The Registers window contains the values currently in the processor’s registers.
The registers are defined as follows:
AC Accumulator
B Multiply, divide, and general purpose register
R0-R7 General-purpose register set
SP Stack pointer
PC Program counter
DPTR Data pointer register (16 bits)
The Control Registers window contains the processor status and control registers.
The registers are defined as follows:
PSW Program Status Word
(contains: CY, AC, F0, RS1, RS0, OV, F1 and P)
IP Interrupt priority control register
IE Interrupt enable control register
TCON Timer/Counter control register
TMOD Timer/Counter mode control register
PCON Power control register
T2CON Timer/Counter 2 control register
SCON Serial port control register
SBUF Serial transmit/receive buffer register
T0 Timer/Counter 0 (16 bits)
T1 Timer/Counter 1 (16 bits)
T2 Timer/Counter 2 (16 bits)
RCAP2 Timer/Counter 2 Capture register (16 bits)
The Ports window displays the values each of the processor’s ports. Ports P0, P1,
P2 and P3 reflect the state on the processors external ports.
The XRAM window reflects the values in the processors external data memory.
The number of RAM locations is 64k.
The IRAM window reflects the values in the processors internal memory. The
number of RAM locations is dependent on the chip type specified in the options
menu.
39
Printed Documentation
Toolbar:
Keys: Ctrl+Shift+F5
See Also
Start Simulator
40
Simulator Commands
Toolbar:
Keys: Shift+F5
See Also
Start Simulator
Assemble
Build
Toolbar:
Keys: F5
See Also
Toggle Break Point
Break Program Execution
Toolbar:
See Also
Toggle Break Point
Toolbar:
Keys: F11
41
Printed Documentation
Toolbar:
Keys: F10
See Also
Break Program Execution
Toolbar:
Keys: Shift+F11
See Also
Break Program Execution
Toolbar:
Keys: Ctrl+F10
See Also
Break Program Execution
Toolbar:
Keys: F9
See Also
Remove All Break Points
42
Simulator Commands
Simulator Commands
the following lists commands invoked via key combinations while the simulator is
running:
Key Combination Command Description
Ctrl+F10 Executes to the currently highlighted source line.
F11 Executes the next instruction stepping into a CALL.
F10 Executes the next instruction stepping over a CALL.
F9 Sets break points in the Source window pane. Sets output radix in
Register, IRAM, XRAM and Port window pains.
Simulate Execution
Selecting the Step Into command via the Simulate menu, the toolbar icon or
pressing F11 will cause the next instruction to be executed. If the instruction is a
CALL then the simulator will step into the subroutine stopping at the first
instruction of that subroutine.
Like Step Into the Step Over command via the Simulate menu, the toolbar
icon or pressing F10 will cause the next instruction to be executed. Unlike Step
Into if the instruction is a CALL the simulator will execute all instructions below
(within) the subroutine being called before returning. You can break the program
execution by selecting the Break command via the Simulate menu, the
toolbar icon or pressing the Esc key. Once the Break command is issued the
source line being executed will be displayed with the cursor on it.
You can set break points for any instruction line in the simulator Source pane. A
break point will cause the simulator to stop (break) execution at a specific
instruction. If the next instruction the simulator is to execute has a break point it
will stop before executing that instruction. Break points are set by highlighting the
desired source line (in the Source pane) and selecting the Toggle Break Point
command via the Simulate menu, the toolbar icon or by pressing the F9
function key. Selecting the Toggle Break Point command while on a line
containing a break point will remove that break point.
43
Printed Documentation
Button Simulation
The simulator allows you to define and use buttons as virtual input devices. To
open a virtual button select View, Virtual, Button. A virtual button dialog will be
displayed. This dialog contains two buttons, a configuration and a user button.
Selecting the Configure button displayed the Virtual Button Configuration dialog
box.
You can open as many Virtual Buttons as you wish. The number and
configuration of each Virtual Button will be saved in the workspace. Saving the
workspace will save the placement and configuration of the Virtual Buttons as well.
See Also
Virtual Button Configuration dialog box
44
Simulator Commands
Registers window
The register window contains the values currently in the simulated processors
registers. The registers are defined as follows:
AC Accumulator
B Multiply, divide, and general purpose register
R0-R7 General purpose register set
SP Stack pointer
PC Program counter
DPTR Data pointer register (16 bits)
Doubling clicking on a register will display a dialog box allowing you to specify a
new value for that register.
See Also
Registers command (View menu)
Modify Value Dialog
Radix Popup menu
Ports window
The Ports window displays the values each of the simulated processors ports hold.
Ports P0, P1, P2 and P3 reflect the state on the simulated processors external
ports.
Doubling clicking on a port will display a dialog box allowing you to specify a new
value for that port.
See Also
Ports command (View menu)
Modify Value Dialog
Radix Popup menu
45
Printed Documentation
Doubling clicking on a Control Register entry will display a dialog box allowing you
to specify a new value for that Control Register .
See Also
Control Registers command (View menu)
Modify Value Dialog
Radix Popup menu
XRAM window
The XRAM window reflects the values in the simulated processors external data
memory. The number of RAM locations is 64k.
Doubling clicking on a XRAM entry will display a dialog box allowing you to specify
a new value for that XRAM location.
See Also
External Memory command (View menu)
Modify Value Dialog
IRAM window
The IRAM window reflects the values in the simulated processors indirect memory.
The number of memory locations is dependent on the processor type specified in
the options menu.
The first 128 DRAM and IRAM locations occupy the same physical memory. The
upper 128 locations of both DRAM and IRAM occupy unique physical memory
locations. In addition depending on the processor type the upper 128 locations of
IRAM may or may not be present. Specifying the processor type in the Options
menu will result in the number of IRAM locations being changed to reflect the
selected processor.
46
Simulator Commands
Doubling clicking on a IRAM entry will display a dialog box allowing you to specify
a new value for that IRAM location.
See Also
Indirect Memory command (View menu)
Modify Value Dialog
Radix Popup menu
DRAM window
The DRAM window reflects the values in the simulated processors direct memory.
Although 256 locations are displayed in this window not all of them may be valid
for a specific processor.
The first 128 DRAM and IRAM locations occupy the same physical memory. The
upper 128 locations of both DRAM and IRAM occupy unique physical memory
locations. In addition depending on the processor type the upper 128 locations of
IRAM may or may not be present. Specifying the processor type in the Options
menu will result in the number of IRAM locations being changed to reflect the
selected processor.
Doubling clicking on a IRAM entry will display a dialog box allowing you to specify
a new value for that IRAM location.
See Also
Direct Memory command (View menu)
Modify Value Dialog
Radix Popup menu
Watch window
The Watch window reflects the values of user specified simulator attributes. The
user can specify a custom combination of entries in the other simulator display
windows. These entries can be registers, Internal memory, Direct memory, and
external memory.
To display a Watch window select Watch Window from the View menu. A window
will be display which contains the currently defined watch variables.
To add an entry into the Watch window either place the cursor over the text of the
desired entry in the editor and click on the Add Watch toolbar icon . The text
under the cursor will be presented as the name of the variable to be added to the
watch list. You can then accept this name or edit and change it.
Clicking the right mouse button with the mouse pointer over a Watch window will
cause a popup menu specific to the Watch window to be displayed. The following
table lists commands available in this popup menu.
Add Display an Add Watch entry dialog box. This dialog
allows you to define the entry to be added to the
Watch window list.
Delete Clicking the (left or right) mouse button highlights the
watch entry under the mouse pointer. The left button
will result in the entry being selected. The right button
will select the entry and display the popup menu.
Selecting the Delete Watch option will remove the
highlight entry from the list.
Modify Displays the Modify Watch dialog box for the
highlighted entry. The watch can then be redefined.
47
Printed Documentation
Toolbar:
See Also
Add/Modify Watch dialog
Watch Window command (View menu)
Watch window
48
Simulator Commands
default radix.
Decimal Changes the highlighted entries display radix to
decimal over ridding the default display radix.
Hexadeci Changes the highlighted entries display radix to
mal hexadecimal over ridding the default display radix.
ASCII Changes the highlighted entries display radix to ASCII
over ridding the default display radix.
Binary Changes the highlighted entries display radix to binary
over ridding the default display radix.
49
Printed Documentation
Resource Type
This group box allows you to specify which memory area to associate with
the specified address. If the Register resource is selected the value is
displayed in byte format regardless of the selected format type.
OK
Clicking on OK will result in the associated window entry being changed as
specified.
Cancel
Clicking on Cancel will result in the dialog being closed and the window
entry being left as it was.
50
Monitor Commands
Download code (Monitor menu)
Use this command to open a serial port and download the currently assembled
program to the development board. Once the code has been downloaded the
serial port is left open and is monitored for communication with the development
board. While the serial port is open issuing the Download command will use the
currently open serial port and not ask you to specify one.
Shortcuts
Keys: F8
51
Program Options
Defaults command (Options menu)
Use this command to set various program defaults.
See Also
Default Settings dialog
53
Printed Documentation
54
Window Menu
Window menu commands
The Window menu offers the following commands, which enable you to arrange
multiple views of multiple documents in the application window:
New Window Creates a new window that views the same document.
Cascade Arranges windows in an overlapped fashion.
Tile Arranges windows in non-overlapped tiles.
Arrange Icons Arranges icons of closed windows.
Window 1, 2, Goes to specified window.
...
55
Help Menu
Help menu commands
The Help menu offers the following commands, which provide you assistance with
this application:
Help Topics Offers you an index to topics on which you can get help.
About Displays the version number of this application.
57
Print Operations
Print command (File menu)
Use this command to print a document. This command presents a Print dialog
box, where you may specify the range of pages to be printed, the number of
copies, the destination printer, and other printer setup options.
Shortcuts
Toolbar:
Keys: Ctrl+P
Print Dialog
The following options allow you to specify how the document should be printed:
Printer
This is the active printer and printer connection. Choose the Setup option
to change the printer and printer connection.
Properties
Displays a Print Setup dialog box, so you can select a printer and printer
connection.
59
Printed Documentation
Print Range
Specify the pages you want to print:
All Prints the entire document.
Selectio Prints the currently selected text.
n
Pages Prints the range of pages you specify in the From
and To boxes.
Copies
Specify the number of copies you want to print for the above page range.
Collate Copies
Prints copies in page number order, instead of separated multiple copies of
each page.
60
System, Control and Document Commands
Size command (System menu)
Use this command to display a four-headed arrow so you can size the active
window with the arrow keys.
Mouse: Click the maximize icon on the title bar; or double-click the title
bar.
Keys: Ctrl+F10 enlarges a document window.
61
Printed Documentation
Note: If you have multiple windows open for a single document, the Close
command on the document Control menu closes only one window at a time. You
can close all windows at once with the Close command on the File menu.
Shortcuts
Keys: Ctrl+F4 closes a document window
Alt+F4 closes the 8051 IDE window or dialog box
62
Appendices
Appendix A - Flag Altering Instructions
Instruction Flags affected
ADD C, OV, AC
ADDC C, OV, AC
SUBB C, OV, AC
MUL C=0, OV
DIV C=0, OV
DA C
RRC C
RLC C
SETB C C
CLR C C
CPL C C
ANL C,bit C
ANL C,/bit C
ORL C,bit C
ORL C,/bit C
MOV C,bit C
CJNE C
63
Printed Documentation
Mnemonic Translation
CALL LCALL addr16
JMP LJMP addr16 (if operand is not @A+DPTR)
64
Appendices
65
Printed Documentation
The following is a list of predefined assembler labels for bit addressable memory
locations. In the following table .x represents a value in the range of 0 to 7. For
example P0.x is short hand to represent P0.0, P0.1, P0.2, P0.3, P0.4, P0.5, P0.6
and P0.7. With P0.0 equal to 80h, P0.1 equal to 81h, etc. Associated label values
are given in hexadecimal notation.
66
Appendices
PX0 B8
PT0 B9
PX1 BA
PT1 BB
PS BC
PT2 BD
P D0 Parity flag
OV D2 Overflow flag
RS0 D3 Register Select (bit 0)
RS1 D4 Register Select (bit 1)
F0 D5
AC D6 Auxiliary Carry flag
CY D7 Carry flag
67
Printed Documentation
Logical Operations
Mnemonic Description Size Cycles
ANL A,Rn AND Register to ACC. 1 1
ANL A,direct AND direct byte to ACC. 2 1
ANL A,@Ri AND indirect RAM to ACC. 1 1
ANL A,#data AND immediate data to ACC. 2 1
ANL direct,A AND ACC to direct byte. 2 1
ANL direct,#data AND immediate data to direct byte. 3 2
ORL A,Rn OR Register to ACC. 1 1
ORL A,direct OR direct byte to ACC. 2 1
ORL A,@Ri OR indirect RAM to ACC. 1 1
68
Appendices
Data Transfer
Mnemonic Description Size Cycles
MOV A,Rn Move register to ACC. 1 1
MOV A,direct Move direct byte to ACC. 2 1
MOV A,@Ri Move indirect RAM to ACC. 1 1
MOV A,#data Move immediate data to ACC. 2 1
MOV Rn,A Move ACC to register. 1 1
MOV Rn,direct Move direct byte to register. 2 2
MOV Rn,#data Move immediate data to register. 2 1
MOV direct,A Move ACC to direct byte. 2 1
MOV direct,Rn Move register to direct byte. 2 2
MOV direct,direct Move direct byte to direct byte. 3 2
MOV direct,@Ri Move indirect RAM to direct byte. 2 2
MOV direct,#data Move immediate data to direct byte. 3 2
MOV @Ri,A Move ACC to indirect RAM. 1 1
MOV @Ri,direct Move direct byte to indirect RAM. 2 2
MOV @Ri,#data Move immediate data to indirect RAM. 2 1
MOV Move immediate 16 bit data to data pointer 3 2
DPTR,#data16 register.
MOVC Move code byte relative to DPTR to ACC (16 1 2
A,@A+DPTR bit address).
MOVC A,@A+PC Move code byte relative to PC to ACC (16 bit 1 2
address).
MOVX A,@Ri Move external RAM to ACC (8 bit address). 1 2
MOVX A,@DPTR Move external RAM to ACC (16 bit address). 1 2
69
Printed Documentation
Program Branching
Mnemonic Description Size Cycles
ACALL addr11 Absolute subroutine call. 2 2
LCALL addr16 Long subroutine call. 3 2
RET Return from subroutine. 1 2
RETI Return from interrupt. 1 2
AJMP addr11 Absolute jump. 2 2
LJMP addr16 Long jump. 3 2
SJMP rel Short jump (relative address). 2 2
JMP @A+DPTR Jump indirect relative to the DPTR. 1 2
JZ rel Jump relative if ACC is zero. 2 2
JNZ rel Jump relative if ACC is not zero. 2 2
70
Appendices
Other Instructions
Mnemonic Description Size Cycles
NOP No operation. 1 1
71
Index
8 F
8051 Source Format 29 File Close Workspace command 8
A File Open Workspace command 8
Add Watch command 48 File Save Workspace command 8
Add/Edit Watch dialog 49 files
Appendix A - 8051 Instruction Set 68 managing 7, 8, 9, 10
Appendix B - Instruction Translations 64 Find Dialog 21
Appendix C - Predefined Labels 65 Find In Files Dialog 22
Arrange Windows command (Window menu) 55 Flag Altering Instructions 63
Assemble Assemble 37 H
Assemble Build 37 Hex File Generation 29
Assemble menu 37 I
Assemble Project 38 Inline Code 34
Assemble Stop 37 Instruction Symbols 64
Assembler 29 Introduction 3
Assembler Directives 31 IRAM window 46
B L
Basic Editor Operations 14 Limited Warranty 1
Block Editing 15 Line Editing 15
Break Simulation 41 M
Button Simulation 44 Miscellaneous Keyboard Commands 17
C Modify Simulated Registers 43
Choose Directory Dialog 23 Modify Value Dialog 48
Clip Board 16 Mouse Operations 18
Close Project command (Assemble menu) 38 Multi-file Projects 36
Closing an Editor Window 12 O
Conditional Assembly 35 Opening an Existing Text File 11
Contact Information 1 Options menu 4
Continue Simulation 41 Output window 4
Control Registers command (View menu) 27 P
Copyright 1 Ports window 45
Counter and Interrupt Simulation 44 Previewing Printed Text 12
Creating a New Edit Window 11 Printer Setup 12
Cursor movement 14 printing and print preview 59, 60
D Printing the Editor Text 12
Default Settings dialog 5 Project File 29
Defaults command (Options menu) 53 R
Download code (Monitor menu) 51 Radix Popup menu 48
DRAM window 46, 47 Recent Workspaces 1 2 3 4 command 9
E Registers window 45
Edit Find 20 Registration 2
Edit Find In Files 20 Remove All Break Points (Simulate menu) 43
Edit Replace 20 Replace Dialog 23
Editor 13 Reset Monitor (Monitor menu) 51
exit 10 Restart Simulator 40
Exiting the IDE 12 Run To Cursor 42
73
Printed Documentation
74