Copyright: Copyright 1999 Keil Software, Inc.  All Rights Reserved.


Help Contents
Contents

What's New

Enhanced µVision2 Interface

Getting Help

Technical Support

Support Solutions Database

Application Notes

On-line Discussion Forum

E-mail

FAX Support

Telephone Support

Menu Commands

Device Database

Creating and Editing Device Specifications

Setting Device Options

Project Management

Creating and Editing a Project

Setting Project Options

Debugging

Preparing Targets for Debugging

Software License Agreement

Keil Software License Agreement

About

Revision Information

Dialog Boxes


Enhanced µVision2 Interface

The user interface of the µVision2 Integrated Development Environment has been completely redesigned to make it easier for you to get started with your application development.  The information found in this help file will help you learn to use some of the more powerful features of µVision2.


Technical Support

You can get technical support from Keil Software in a number of different ways:

Web Site:  http://www.keil.com

Support Solutions Database

Application Notes

On-line Discussion Forum

E-mail

FAX

Telephone


Support Solutions Database

The Support Solutions Database is a collection of questions we receive from customers.  When a new question arises, we add it to the database.  Then, when that question comes up again, we can quickly provide the answer.  An added benefit is that we can easily publish the contents of the database on the web.  That makes it easier for you to get technical support at times when our support staff is unavailable.  We update this information on a daily basis.  The Support Solutions Database is available on the web at http://www.keil.com/support.


Application Notes

Application Notes discuss specific aspects of the Keil development tools and various Microcontrollers.  We frequently create Application Notes to help you with difficult problems.  All of our Application Notes are available on the web at http://www.keil.com/appnotes.


On-line Discussion Forum

Keil Software provides an on-line forum where users may discuss any topics related to embedded software development and the Keil development tools.  The forum is unmoderated and is available on the web at http://www.keil.com/discuss.  You may post questions and comments to the forum for other users to read.


E-mail

One of the best ways to get technical support is to send us e-mail.  Please be sure to include any source code in the body of the e-mail.  Try to avoid large program listings sent as attachments because they take longer for us to process.

In North and South America, e-mail Keil Software, Inc. in the USA at support.us@keil.com.

In Europe, Asia, Africa, Australia and the Pacific Rim, e-mail Keil Elektronik GmbH at support.intl@keil.com.


FAX Support

FAX support is available to anyone with a FAX machine.  Please be sure to include you name, phone number, FAX number, and e-mail address so we can reply to your FAX.  You may include source code in your FAX, however, please limit the listing to one page of code.  Larger programs take longer for us to process.

In North and South America, FAX Keil Software, Inc. in the USA at 972-735-8055.

In Europe, Asia, Africa, Australia and the Pacific Rim, FAX Keil Elektronik GmbH at +49 89 468162.


Telephone Support

You may always contact our technical support personnel directly via the telephone.

In North and South America, contact Keil Software, Inc. in the USA at 800-648-0251 or 972-735-8052.

In Europe, Asia, Africa, Australia and the Pacific Rim, contact Keil Elektronik GmbH at +49 89 456040 0.


Opens a new, empty document.


Opens or finds a document.


Closes the active document without quitting the application.


Saves the active document.


Saves the active document under a specified file name.


Displays the device database where you may configure specific Microcontroller information.


Displays printing options and prints all or part of the active document.


Displays printing options.


Displays the recent workspaces.


Opens or finds a workspace.


Closes the current workspace without quitting the application.


Ends a µVision session.


Displays progress status on the status bar.


Reverses changes to the active document made since the last save.


Restores changes made by the Undo command.


Removes selected text from the active document and puts it on the clipboard.


Copies selected text from the active document and puts it on the clipboard.


Copies text from the clipboard and puts it in the active document at the insertion point.


Searches for specified text in the active document.


Searches for and replaces specified text in the active document.


Displays or hides the File and Edit commands tool bar.


Displays or hides the Status Bar.


Displays documents in workbook mode with a tab for each document.


Modifies µVision settings that affect the editor.


Opens a new, empty project.


Creates and edits project targets and source file groups in a project.


Defines the file extensions for C, assembly, object, library, document, and PL/M source files.


Selects the Microcontroller specifications to use for the current project.


Selects the target, output, listing, assembler, compiler, and linker options for the project.  The options depend on the toolset required for the device selected for the project target.


Compiles, assembles, and links files in the project.


Compiles, assembles, and links files in the project that have changed since the last build or rebuild.


Compiles or assembles the active document.


Stops a running build process.


Opens a new window with the same contents as the active window.


Displays all windows overlapped so that the title bar of each window is visible.


Displays all windows so that they do not overlap.  Emphasis given to the width of the window.


Displays all windows so that they do not overlap.  Emphasis given to the height of the window.


Arranges minimized window icons along the bottom of the editor window.


Displays or hides the workspace window.


Displays or hides the output window.


Displays the help system contents page which provides an outline of the available help topics.


Displays the version number of this application, copyright and legal information, user, organization, and serial number.


Creating and Editing Device Specifications

In most cases, the device you use will already be in the Device Database.  µVision2 allows you to add new devices to the database and to modify existing devices to suit your needs.

More:

Add a Device to the Device Database

Update a Device in the Device Database


Add a Device to the Device Database

1.	Enter the name of the chip vendor (Intel, Philips, Siemens, etc.) in the Vendor box.

2.	Select the device family from the drop down menu in the Family box.

3.	Enter the part number for the device in the Device box.

4.	Enter specific chip information in the Description box.

5.	Enter device options to use with the assembler, compiler, and linker in the Options box.  For more information about device options, click

6.	Click the Add button.


Update a Device in the Device Database

1.	Double-click on the desired device in the Database box.

2.	Change the information in the Vendor, Family, Device, Description, or Options boxes.

3.	Click the Update button.


Setting Device Options

There are a number of device options you may specify in the Device Options box in the Device Database dialog box.  The device options are used by the assembler, compiler, and linker when you create a project using that device.

More:

Device Options


Device Options

The following options are available in the Device Database.

CPU specifies the CPU parameters.  Valid parameters are:

IROM specifies the address range of the on-chip ROM

ICAN specifies the address range of the on-chip CAN device

CLOCK specifies the maximum CPU clock for this CPU

IRAM specifies the address range of the on-chip RAM

XRAM specifies the address range of the on-chip XRAM

MOD167 specifies that this CPU needs the MOD167 compiler option set

BOOKx specifies databooks listed in the Project Window:Books page.  The path is relative to the Keil CD-ROM.

SIM specifies the simulator DLL and any necessary arguments.

MON specifies the MONITOR DLL and any necessary arguments.


Creating and Editing a Project

µVision2 maintains all aspects of a project in a project file.  The source files and all options are stored there.  While developing an application you will create a project and add targets, groups, and files to it.

More:

Create a New Project

Add Targets to a Project

Remove a Target from a Project

Select a Project Target

Add File Groups to a Project

Remove a File Group from a Project

Add Source Files to a Project


Create a New Project

1.	Select the New Project command from the Project menu to open the New Project dialog box.

2.	Enter the name of the project in the Project Name box.

3.	Click browse to select the directory for the project.

4.	Click OK.


Add Targets to a Project

1.	Open the Targets and Groups dialog box using the Targets and Groups command in the Project menu.

2.	Enter the name of the target to add in the Target to Add box.

3.	Click the Add button.


Remove a Target from a Project

1.	Open the Targets and Groups dialog box using the Targets and Groups command in the Project menu.

2.	Click on the desired target in the Available Targets box.

3.	Click the Remove Target button.


Select a Project Target

1.	Open the Targets and Groups dialog box using the Targets and Groups command in the Project menu.

2.	Click on the desired target in the Available Targets box.

3.	Click the Set as Current Target button.


Add File Groups to a Project

1.	Open the Targets and Groups dialog box using the Targets and Groups command in the Project menu.

2.	Click on the Groups tab.

3.	Enter the name of the new group in the Group to Add box.

4.	Click the Add button.


Remove a File Group from a Project

1.	Open the Targets and Groups dialog box using the Targets and Groups command in the Project menu.

2.	Click on the Groups tab.

3.	Click on the desired group in the Available Groups box.

4.	Click the Remove Group button.


Add Source Files to a Project

To add source files from the Project window…

1.	In the Project window, right-click on the group to add source files to.

2.	Select Add Files to Group from the drop-down menu that appears.

To add source files from the Project menu…

1.	Open the Targets and Groups dialog box using the Targets and Groups command in the Project menu.

2.	Click on the Groups tab.

3.	Click on the desired group in the Available Groups box.

4.	Click the Add Files to Group button.


Setting Project Options

There are a number of options you may set for a project.  File extensions as well as compiler, assembler, and linker options for targets, groups, and files can easily be changed.

More:

Set File Extensions for Source Files

Set Options for a Target

Set Options for a Group

Set Options for a File


Set File Extensions for Source Files

1.	Select the File Extensions command from the Project menu.

2.	Enter file extensions for each file type.

Note
Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.c; *.cpp.


Set Options for a Target

Projects support three levels of toolset options:  Target options, Group options, and File options.  You set options for each level using the Project window.

To set target options from the Project window…

1.	In the Project window, right-click on the target to change.

2.	Select Options for Target from the drop-down menu that appears.

To set target options from the Project menu…

1.	In the Project window, click on the target to change.

2.	Select the Options command from the Project menu.

Note
Options for a target may be overridden by group or file options.


Set Options for a Group

Projects support three levels of toolset options:  Target options, Group options, and File options.  You set options for each level using the Project window.

To set group options from the Project window…

1.	In the Project window, right-click on the group to change.

2.	Select Options for Target from the drop-down menu that appears.

To set group options from the Project menu…

1.	In the Project window, click on the group to change.

2.	Select the Options command from the Project menu.


Set Options for a File

Projects support three levels of toolset options:  Target options, Group options, and File options.  You set options for each level using the Project window.

To set file options from the Project window…

1.	In the Project window, right-click on the file to change.

2.	Select Options for File from the drop-down menu that appears.

To set file options from the Project menu…

1.	In the Project window, click on the file to change.

2.	Select the Options command from the Project menu.

Note
Options for a file may not be overridden.


Preparing Targets for Debugging

The debugger integrated into µVision2 supports symbolic, source-level debugging.  The compiler and assembler include debug information in the generated object files when you enable debug information.

More:

Enable Debug Information


Enable Debug Information

To include debug information from the Project window…

1.	Right-click on the desired target in the Project window.

2.	Select Options for Target from the drop-down menu that appears.

3.	Select the Output tab in the Options dialog box.

4.	Select the Debug Information check box.

To include debug information from the Project menu…

1.	Click on the desired target in the Project window.

2.	Select the Options for Target command from the Project menu.

3.	Select the Output tab in the Options dialog box.

4.	Select the Debug Information check box.


Keil Software License Agreement

(Single-User Products)

This is a legal agreement between you (either an individual or an entity) and Keil Software.  By opening the sealed software package, you agree to be bound by the terms of this agreement.  If you do not agree to the terms of this agreement, promptly return the unopened software package and the accompanying items (including written materials and binders or other containers) to the place you obtained them for a full refund.

GRANT OF LICENSE.  Keil Software grants you the right to use one copy of the enclosed software program (the SOFTWARE) on a single computer.  The SOFTWARE is in use on a computer when it is loaded into temporary memory (i.e., RAM) or installed into permanent memory (e.g., hard disk, CD-ROM, or other storage device) of that computer.  However, installation on a network server for the sole purpose of distribution to one or more other computers shall not constitute "use" for which a separate license is required.

COPYRIGHT.  The SOFTWARE is owned by Keil Software or its suppliers and is protected by United States copyright laws and international treaty provisions.  Therefore, you must treat the SOFTWARE like any other copyrighted material (e.g., a book or musical recording) except that you may make one backup copy of the SOFTWARE solely for backup or archival purposes and you may transfer the SOFTWARE to a single hard disk.  You may not copy the written materials that accompany the SOFTWARE.

OTHER RESTRICTIONS.  You may not rent or lease the SOFTWARE, but you may transfer the SOFTWARE and all accompanying written materials on a permanent basis provided you retain no copies and the recipient agrees to the terms of this Agreement.  You may not reverse engineer, decompile, or disassemble the SOFTWARE.  If the SOFTWARE is an update or has been updated, any transfer must include the most recent update and all prior versions.

RIGHT TO CREATED FILES.  Keil Software extends you a royalty-free right to reproduce and distribute executable files (e.g., OMF object modules and HEX files) created using the SOFTWARE provided that you do not use the Keil name, logo, or trademarks to market your software product and that you agree to indemnify, hold harmless, and defend Keil Software and its suppliers from and against any claims or lawsuits, including attorneys' fees, that arise or result from the use or distribution of your software product.

LIMITED WARRANTY.  Keil Software warrants that the SOFTWARE will perform substantially with the accompanying written materials for a period of ninety (90) days from the date of receipt and that any hardware accompanying the SOFTWARE will be free from defects in materials and workmanship under normal use and service for a period of one (1) year from the date of receipt.  Any implied warranties on the SOFTWARE are limited to ninety (90) days.  Any implied warranties on hardware are limited to one (1) year.  Some states do not allow limitations on duration of an implied warranty, so the above limitation may not apply to you.

CUSTOMER REMEDIES.  The entire liability of Keil Software and its suppliers and your exclusive remedy shall be, at the option of Keil Software either return of the price paid or repair or replacement of the SOFTWARE or hardware that does not meet the Limited Warranty and which is returned to Keil Software with a copy of your receipt.  This Limited Warranty is void if failure of the SOFTWARE or hardware has resulted from accident, abuse, or misapplication.  Any replacement of the SOFTWARE or hardware will be warranted for the remainder of the original warranty period or thirty (30) days whichever is longer.

NO OTHER WARRANTIES.  Keil Software and its suppliers disclaim all other warranties, either express or implied, including, but not limited to implied warranties of merchantability and fitness for a particular purpose, with regard to the SOFTWARE, the accompanying written materials, and any accompanying hardware.  This limited warranty gives you specific legal rights.  You may have others which vary from state to state.

NO LIABILITY FOR CONSEQUENTIAL DAMAGES.  In no event shall Keil Software or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use or inability to use this product, even if Keil Software has been advised of the possibility of such damages.  Because some states do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to you.


Revision Information

This help file is Copyright © 1998-1999 Keil Software, Inc.  All rights reserved.

Revision:  8
Date:  8/27/99 2:31


Use the Device Database dialog box to add new devices (chips) to the device database.  Later, you may use information from the database in your projects.

More:

Description

Options


Use the database window to select a device to update.  To select a specific device, double-click on the desired chip vendor then double-click on the desired device.


When you add a new device to the database, use the Vendor box to specify the name of the chip vendor who manufactures the device.


Use the Family box to select the microcontroller family for a new device.


Use the Device box to enter the name or part number for the new device.


Dialog Boxes - Device Database - Description
Description

Use the Description box to specify a description of the new device.  You may enter part specifications, chip features, or other information.


Options

Use the Options box to specify parameters for the assembler, compiler, linker, and other tools when building a Project Target.  For more information, click


Click Add to add a new device to the database.


Click Update to change a device in the database.


Click OK when you are done making database changes.


Use the Find dialog box to search for text in the active window.


Use the Replace dialog box to search for and replace text in the active window.


Use this dialog box to select a file type to configure editor options for.


Use this box to select the file type whose editor options you want to change.


Click OK when you have selected a file type.


Use the Editor Options dialog box to specify editor options for the specified file types.


Use the Syntax Coloring dialog box to specify colors to use for various token types.


Click OK to save your color selections.


Click Cancel to close this dialog box without saving your color selections.


The New Project dialog box lets you specify the name and folder or path for a new project file.  When you have entered the name and folder, click OK to create the new project file.


Enter the name of the project you want to create in the Project Name box.


The Project Folder box displays the path name to the project folder.


This box displays the complete path name and file name of the project.


Click OK to create a new project file using the specified name and folder.


Click Cancel to close this dialog box without creating a new project file.


Click Browse to select the project folder.


The Targets and Groups dialog box lets you add new project targets and source file groups to a project.


Enter the name of the new project target in the Target to Add box.


This box lists the available targets in the project.


Click Add to add a new project target.


Click Set as Current Target to build executable programs for the selected project target.


Click Remove Target to delete a project target.


Click OK to save changes to the project.


Click Cancel to close this dialog box without adding a new target or without changing the selected target for the project.


The Targets and Groups dialog box lets you add new project targets and source file groups to a project.


Enter the name of the source file group in the Group to Add box.


This box lists the available source file groups in the project.


Click Add to add a new source file group to the project.


Click Add Files to Group to add files to the source file group.


Click Remove Group to delete a source file group from the project.


Click OK to save changes to the project.


Click Cancel to close this dialog box without adding new source file groups to the project.


The File Extensions dialog box lets you specify the file extensions that are used for the various file types that compose a project.


Use the C Source File box to enter the file extension(s) for C files.

Note:  Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.c;*.c51;*.cpp.


Use the Asm Source File box to enter the file extension(s) for assembly files.

Note:  Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.asm;*.a51;*.a.


Use the Object File box to enter the file extension(s) for object files.

Note:  Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.obj;*.omf;*.abs.


Use the Library File box to enter the file extension(s) for library files.

Note:  Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.lib;*.l51.


Use the Document File box to enter the file extension(s) for documentation files.

Note:  Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.doc;*.txt.


Use the PL/M Source File box to enter the file extension(s) for PL/M files.

Note:  Each file extension specification must be prefixed with (*.).  Multiple file extensions may be separated with a semicolon (';').  For example:  *.plm;*.p51.


Click OK to save changes to the file extensions for this project.


Click Cancel to close this dialog box without saving changes to the file extensions.


Use this dialog box to select the device information to use when building a project target.  Note that the project options are different for each toolset.

More:

Description


The Database box lists the devices manufactured by each chip vendor.  To select a specific device, click on the desired device.  For more information on how to add devices to the database, click


The Toolset box displays the assembler, compiler, and linker set for the selected device.


Dialog Boxes - Select Device - Description
Description

The Description dialog box displays a description of the device.  You may find part specifications, chip features, or other information listed here.


Click OK to save changes to the device to use when generating the selected project target.


Click Cancel to close this dialog box without saving changes to the project.


Use the Options dialog box to select the various configuration options for the 166 assembler, 166 compiler, 166 linker, and other 166 tools used in the current project.


Enter the speed of the CPU clock in Hz in the Clock box.


Use the Memory Model box to select the desired memory model for the target.


Use the Operating System box to select the desired real-time operating system to use for the target.


Use the Data box to specify the memory area and maximum size for variables.


Select this check box if your application uses the on-chip XRAM or CAN.


Use this box to specify the amount of memory to use for the NCONST group.


Use this box to specify the amount of memory to use for the NDATA group.


Use this box to select whether the memory range is mapped to a read-only device (ROM) or a read-write device (RAM).


Use the Start box to specify the address where a memory device is located.


Use the Size box to specify the length of the memory device in bytes.


Use this box to specify that on-chip ROM is used by your application.


Use the on-chip XRAM memory for your program.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Click Select Directory for Objects to select a directory where object files are stored.


Use the Name of Executable box to specify the name of the target file created by the linker.


Select the Create Executable check box to create an executable program.


Select the Debug Information check box  to include debugging information in the object files and in the executable program.


Select the Create HEX File check box to create an Intel HEX file for the executable program.


Use the HEX Format box to specify the HEX file format to use.


USe this bos to generate source browser information.  You may use the source browser to rapidly locate variable and function declarations and variable usage in your project.


Use the Start box to specify the starting address for the HEX file to begin.


Use the End box to specify the ending address for the HEX file.


Use the Fill Byte box to specify the value to use for unused memory in the HEX file.


Use the Offset box to specify a value that is added to each address.


Select this check box to create a library file.


Select this check box to beep the speaker when project builds are complete.


Select this check box to start the simulator immediately after a project build.


Select this check box to start the target debugger immediately after a project build.


Use these boxes to specify a user program to run after a project build.


Enter the program name and parameters exactly as they would appear on a DOS command line.


Click this button to browse for a program file.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Click Select Directory for Objects to select a directory where listing files are stored.


Use the Page Width box to specify the number of characters per line for the listing file.


Use the Page Length box to specify the number of lines per page for the listing file.


Select the C Compiler Listing check box to create listing files for the C source files in the project target.


Select the Conditional check box to include uncompiled conditional code in the listing file.


Select the Symbols check box to include symbol information in the listing file.


Select the #include Files check box to insert text from include files in the listing file.


Select the Assembly Code check box to include the generated assembly code in the listing file.


Select the Assembler Listing check box to create listing files for the assembly source files in the project target.


Select the Conditional check box to include unassembled conditional code in the listing file.


Select the Symbols check box to include symbol information in the listing file.


Use the Macros box to specify how macros are listed in the listing file.


Use the Cross Reference check box to include a cross reference table of symbols in the listing file.


Enter the number of spaces a Tab character requires in the Tab Space box.


Select the Linker Listing check box to create map files from the linker for the project target.


Select this check box to include a memory map of the program in the map file.


Select this check box to include public symbol information in the map file.


Select this check box to include local symbol information in the map file.


Select this check box to include line number information in the map file.


Select this check box to include comment information in the map file.


Select this check box to include a cross reference listing in the map file.


Select this check box to include compiler-generated symbol information in the map file.


Select this check box to include library-generated symbol information in the map file.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Use the Define box to define names which may be used by the C preprocessor directives #if, #ifdef, and #ifndef.


Use the Undefine box to remove previously defined names which were defined in a group or target.


Use the Level box to specify the optimization level used by the compiler.  Larger numbers indicate more optimizations.


Use the Emphasis box to specify the priority (code size or program speed) for the optimizer.


Select this check box to enable global register optimizations.


Select this check box to force the compiler to use static memory for all automatic variables that are nor stored in registers.  Clear this box to use the stack for automatic variables.


Select this check box to force the compiler to reload registers holding variables that have aliases (usually through pointers).  When this check box is clear, the compiler reuses register contents even though a pointer or other alias may have changed the variable.


Use the Warnings box to enable or disable compiler warnings.  Warning level 0 disables most warnings while level 3 enables all warnings.


Select this check box to keep variables in the same order in memory as they are declared in the source files.


Select this check box to treat char data types as unsigned char.


Select this check box to force the compiler to save DPP registers in interrupt service routines.


Select this check box to use 64-bit floating-point math.


Select this check box to allow the compiler to save temporary variables on the user stack.


Use the Misc Controls box to specify any required compiler commands for which there is no individual dialog control.


This box displays the complete compiler command line.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Use the Set box to assign numeric values to variables.


Use the Reset box to assign a value of 0 to the specified variables.


Select this check box to enable the macro preprocessor.  If this box is not checked, the assembler does not process macros.


Select the Case-sensitive Symbols check box to force the assembler to distinguish between uppercase and lowercase characters in symbol names.  Clear this box to ignore case in symbol names.


Use the Misc Controls box to specify any required assembler commands for which there is no individual dialog control.


This box displays the complete assembler command line.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Select this check box to use the RAM and ROM definitions specified in the Target dialog.


Use this box to specify the location of the tables used to initialize variables declared with explicit values and variables which are to be cleared to zero.


This check box displays whether or not multiple DPPs are used for the NDATA and NCONST data groups.


These boxes specify the starting DPP register and the address range for the NDATA data group.


These boxes specify the starting DPP register and the address range for the NCONST data group.


The Target Classes box displays the classes created for the RAM and ROM definitions specified in the Target dialog.


Use the User Classes box to specify class names and their physical address ranges.


Use the User Sections box to locate sections as specific addresses or to define the address order of specific sections.


This box displays the complete linker command line.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Use the Warnings box to enable or disable linker warnings.  Warning level 0 disables most linker warnings while level 2 enables all warnings.


Use this box to specify warning messages to disable.  Enter a comma-separated list of numbers for warnings to disable.


Select this check box to use a linker control file when linking.


Click create to create a linker control file.


Click browse to select a linker control file.


Click edit to open a window for the linker control file.


Select this check box to create a relocatable object module.  When this options is used, the output file may be passed to the linker a second time.  This is similar to incremental linking.


The Interrupt Vector Table Address box lets you specify the starting address for the interrupt vector table.  The default starting address is 000000h.


Use the Assign box to define public symbols and their values at link time.  Use commas to separate symbols.


Use the RegBank box to specify the base address, physical memory address, or order for the specified register banks.


Use the Reserve box to specify memory ranges that are reserved and that the linker should avoid.


Use the Misc Controls box to specify any required linker commands for which there is no individual dialog control.


This box displays the complete linker command line.


Click Defaults to restore all option settings to the default status.


Click OK to save changes to the project.


Click Cancel to close this dialog box without saving changes to the project.


Glossary of Terms

Linker Control File

Map File

Project Target

Source File Group

Toolset


Linker Control File

A linker control file is a text file that µVision passes to the linker when linking.  The control file includes all directives and names of object files and library files to include in the output file.


Map File

The Map File is a listing file generated by the linker.


Project Target

In a project, a target is an executable program that is generated.  A project may generate a target that runs on an 8051 and another target that runs on a 166.  Targets may be created for builds with no optimization and for builds with full optimization.


Source File Group

In a project, a group is a number of source files that compose the project target.  Although you may individually specify the toolset options for a file, a group lets you apply the same options to a group of source files.  The options for a group may be different from the options for the target.


Toolset

A toolset include an assembler, compiler, linker, HEX converter, debugger, and the other associated tools for a particular device family like the 8051, 251, or 166.  All of the tools or programs in a toolset are dedicated to generating target code for a specific family of chips.