# Release Notes for uVision2
IDE and Debugger

This file contains release notes and last minute changes that are not found in the printed manuals.

Information in this file, the accompany manuals, and software is
Copyright © Keil Software, Inc and Keil Elektronik GmbH.
All rights reserved.

## Contents

1. What's New in uVision2
2. What is uVision2?
3. Limitations of Evaluation Software
4. Example Programs
5. Device Database™
6. Peripheral Simulation
7. Technical Support
8. Contact Details

## What's New in uVision2

The following sections list the changes instituted in each release of the uVision2 IDE and Debugger.

### uVision2 Version 2.39 Release

- New dialog for project component management under Project - Components, Environment and Books that allows you to change the order or project targets and file groups.
- Docking Windows have now a descriptive text in the navigation bar.
- New configuration file for Microsoft Source Safe 6.0 added.
- ARM specific support added.

### uVision2 Version 2.36 Release

- In some cases, projects that include user libraries were always linked-even when the library was up-to-date. This problem has been corrected.

### uVision2 Version 2.33 Release

- Corrected minor problems with OCDS Debugging and ULINK.

### uVision2 Version 2.32 Release

- Added Flash menu commands and configuration dialog under Options for Target - Utilities.
- Added listing of files included in each C source file to the Project Window - File tab.
- Added ability to automatically copy startup code into the project.

### uVision2 Version 2.31 Release

- Added a Device tab in the Options for Target dialog. From this tab, you may select the device you use as well as any additional options like whether or not to use the extended linker and extended assembler.
- Corrected several minor problems with the IDE.

### uVision2 Version 2.30 Release

- Added Copy to Clipboard and Find functionality for Disassembly Window and Output Window in the debugger.
- Made several minor improvements in the Options for Target Dialog.
- Added simulation support and monitor peripheral dialogs for all SST devices (SST89x554, SST89x554Rx, SST89x556, and SST89x556Rx).
- Added simulation support for all Analog Devices parts (ADuC812, ADuC814, ADuC816, ADuC824, ADuC831, ADuC832, ADuC834, and ADuC836).
- Added simulation support and monitor peripheral dialogs for the Atmel AT89LS53 and AT89LS8252.
- Added simulation support for the Infineon C505A and C505CA.
- Added simulation support and monitor peripheral dialogs for the Winbond W77E468.

### uVision2 Version 2.23 Release

- Updated dialogs to support new features in C51 V6.23.
- Corrected several minor problems.

### uVision2 Version 2.20a Release

- Corrected various minor problems.

### uVision2 Version 2.20 Release

- Improved the SVCS connection.
- Corrected several problems with environment variables.
- Added several new items to the Help Menu.
- Added several minor project management enhancements.
- Added support for the ST Microelectronics ST10F280.
- Added RTX166 Full Kernel-Aware Debugging.
- Completed simulation support for all C16x devices.
- Added several new devices to the device database.

### uVision2 Version 2.14 Release

- Added simulation support for the Dallas 320, 323 and 520.
- Added simulation support for the Infineon C509, C517A, C515C.

### uVision2 Version 2.12 Release

- Added simulation support for the Atmel WM T87C5111 and T87C5112.
- Added simulation support for the Infineon C161xx, C163, C164, C165xx, 80C166, and C167xx.
- Added simulation support for the ST Microelectronics ST10F163, ST10x167, ST10F168, ST10R262, ST10R272, and ST10F269.
- Added simulation support for devices with on-chip CAN controllers (C167CR & C167CS).

### uVision2 Version 2.10 Release

- Corrected various minor problems.

### uVision2 Version 2.06 Release

- Added simulation support for the Analog Devices ADuC812.
- Added simulation support for the Philips LPC Devices.
- Added simulation support for most standard 40-pin 8051 devices (8051FC, RD, RD+, 8052, and so on).
- Added simulation support for multiple DPTR registers.
- Corrected various incompatibilities with DAvE2.

### uVision2 Version 2.05 Release

- Corrected various minor problems.

### uVision2 Version 2.04 Release

- Added support for the C51 toolset.

### uVision2 Version 2.03 Release

- Added extensible emulator support (via AGDI) for the Hitex DProbe.
- Corrected minor problems in the source browser.

### uVision2 Version 2.02 Release

- Changed project file format to ASCII Text.
- Added support for software version control systems (SVCS).
- Added RTX166 Tiny Kernel-Aware Debugging.

### uVision2 Version 2.00 Release

This is the initial release of uVision2. The following new/enhanced features are included.

- Added support for the C16x/ST10 toolset.
- Added source browser capability.
- Added direct support for PC-Lint.
- Added application manager that allows you to incorporate user programs into the uVision2 menus.

## What is uVision2?

uVision2 is an IDE (Integrated Development Environment) that helps you write, compile, and debug embedded programs. It encapsulates the following components:

- A project manager.
- A make facility.
- Tool configuration.
- Editor.
- A powerful debugger.

To help you get started, several example programs (located in the \C51\EXAMPLES, \C251\EXAMPLES, and \C166\EXAMPLES) are provided.

- HELLO is a simple program that prints the string "Hello World" using the Serial Interface.
- MEASURE is a data acquisition system for analog and digital systems.
- TRAFFIC is a traffic light controller with the RTX Tiny operating system.
- SIEVE is the SIEVE Benchmark.
- DHRY is the Dhrystone Benchmark.
- WHETS is the Single-Precision Whetstone Benchmark.

Additional example programs not listed here are provided for each device architecture.

### Building an Application in uVision2

To build (compile, assemble, and link) an application in uVision2, you must:

1. Select Project - Open Project (for example, \C166\EXAMPLES\HELLO\HELLO.UV2).
2. Select Project - Rebuild all target files or Build target.

uVision2 compiles, assembles, and links the files in your project.

### Creating Your Own Application in uVision2

To create a new project in uVision2, you must:

1. Select Project - New Project.
2. Select a directory and enter the name of the project file.
3. Select Project - Select Device and select an 8051, 251, or C16x/ST10 device from the Device Database™.
4. Create source files to add to the project.
5. Select Project - Targets, Groups, Files. Add/Files, select Source Group1, and add the source files to the project.
6. Select Project - Options and set the tool options. Note when you select the target device from the Device Database™ all special options are set automatically. You typically only need to configure the memory map of your target hardware. Default memory model settings are optimal for most applications.
7. Select Project - Rebuild all target files or Build target.

### Debugging an Application in uVision2

To debug an application created using uVision2, you must:

1. Select Debug - Start/Stop Debug Session.
2. Use the Step toolbar buttons to single-step through your program. You may enter G, main in the Output Window to execute to the main C function.
3. Open the Serial Window using the Serial #1 button on the toolbar.
4. Debug your program using standard options like Step, Go, Break, and so on.

## Limitations of Evaluation Software

The following limitations apply to the evaluation versions of the C51, C251, or C166 tool chains.

### C51 Evaluation Software Limitations

- The compiler, assembler, linker, and debugger are limited to 2 Kbytes of object code but source code may be any size. Programs that generate more than 2 Kbytes of object code will not compile, assemble, or link.
- The startup code generated includes LJMP's and cannot be used in single-chip devices supporting less than 2 Kbytes of program space like the Philips 750/751/752.
- The debugger supports files that are 2 Kbytes and smaller.
- Programs begin at offset 0x0800 and cannot be programmed into single-chip devices.
- No hardware support is available for multiple DPTR registers.
- No support is available for user libraries or floating-point arithmetic.

The following components, which are present in the PK51 Full Version, are not included in the C51 Evaluation Software:

- Code-Banking Linker/Locator.
- Library Manager.
- RTX-51 Tiny Real-Time Operating System.

### C251 Evaluation Software Limitations

- The compiler, assembler, linker, and debugger are limited to 4 Kbytes of object code but source code may be any size. Programs that generate more than 4 Kbytes of object code will not compile, assemble, or link.
- The debugger supports files that are 4 Kbytes and smaller.

### C166 Evaluation Software Limitations

- The compiler, assembler, linker, and debugger are limited to 4 Kbytes of object code but source code may be any size. Programs that generate more than 4 Kbytes of object code will not compile, assemble, or link.
- The debugger supports files that are 4 Kbytes and smaller.

## Example Programs

Example programs included in the \C51\EXAMPLES, \C251\EXAMPLES, and C166\EXAMPLES directories demonstrate how to use the uVision2 Project Manager and Debugger (see the uVision2 Quick Start Guide for details). Please refer to these example projects if you are new to the tools and want to get started quickly.

## Device Database™

A unique feature of the Keil uVision2 IDE is the Device Database™ which contains information about more than 400 supported microcontrollers. When you create a new uVision2 project and select the target chip from the database, uVision2 sets all assembler, compiler, linker, and debugger options for you. The only option you must configure is the memory map.

As new devices become available, they are added to the database along with data sheets and header files. For information about adding your own chips to the database or about creating your own personal databases refer to the following knowledgebase articles.

- Adding Custom Parts to the Device Database
- Creating Custom Databases

## Peripheral Simulation

The uVision2 Debugger provides complete simulation for the CPU and on-chip peripherals of most embedded devices. To discover which peripherals of a device are supported, in uVision2 select the Simulated Peripherals item from the Help menu. You may also use the web-based Device Database™. We are constantly adding new devices and simulation support for on-chip peripherals so be sure to check Device Database™ often.

## Technical Support

At Keil Software, we are dedicated to providing you with the best development tools and technical support. That's why we offer numerous ways you can get the technical support you need to complete your embedded projects.

- Technical Support Knowledgebase
  More than 1500 technical support questions and answers are available in the Support Solutions Knowledgebase. When a new question arises, it is added to the knowledgebase which is continuously published to the Web. This enables you to get technical support at times when our support staff is unavailable.
- Application Notes
  Numerous Application Notes help you decipher complex features and implement robust applications.
- Example Programs and Files
  Utility programs, example code, and sample projects are regularly added to the Download File section of the web site.
- Discussion Forum
  Post questions, comments, and suggestions to the Keil Software Discussion Forum and interact with other Keil users around the world.

Many of the features of our Technical Support Knowledgebase and Web Site are the results of your suggestions. If you have any ideas that will improve them, please give us your feedback!

## Contact Details

If you experience any problems or have any questions about this product, contact one of our distributors or offices for assistance.

In the USA... Keil Software, Inc. 1501 10th Street, Suite 110 Plano, TX 75074 USA 800-348-8051 - Sales 972-312-1107 - Support 972-312-1159 - Fax sales.us@keil.com - Sales E-Mail support.us@keil.com - Support E-mail |  | In Europe... Keil Elektronik GmbH Bretonischer Ring 15 D-85630 Grasbrunn Germany +49 89 456040-0 - Sales +49 89 456040-24 - Support +49 89 468162 - Fax sales.intl@keil.com - Sales E-Mail support.intl@keil.com - Support E-Mail

Copyright © Keil Software, Inc. and Keil Elektronik GmbH.
All rights reserved.
Visit our web site at www.keil.com.