Файл: CodeVision AVR 1.25.7, user manual.pdf

CodeVisionAVR

2.2.5 Obtaining an Executable Program

Obtaining an executable program requires the following steps:

1.Compiling the Project’s C source files, using the CodeVisionAVR C Compiler, and obtaining an assembler source file

2.Assembling the assembler source file, using the Atmel AVR assembler AVRASM32.

Compiling, executes step 1.

Making, executes step 1 and 2.

For large projects Compiling make take a considerable amount of time.

In this case it is advisable to first Check the Project for Syntax Errors, which is much faster as no files are created during this process.

2.2.5.1 Checking the Project for Syntax Errors

To check all the Project’s files for syntax errors you must use the Project|Check Syntax menu command or press the Check Syntax button of the toolbar.

The checking process can be stopped using the Project|Stop Compilation menu command or by pressing the Stop Compilation button on the toolbar.

Eventual compilation errors and/or warnings will be listed in the Message window located under the Editor window, or in the Navigator window.

By double clicking on the error or warning message, the line with the problem will be highlighted. The size of the Message window can be modified using the horizontal slider bar placed between it and the Editor window.

CodeVisionAVR

2.2.5.2 Compiling the Project

To compile the Project you must use the Project|Compile File menu command, press the F9 key or press the Compile button of the toolbar. The CodeVisionAVR C Compiler will be executed, producing an assembler source file with the .asm extension. This file can be examined and modified by opening it with the Editor.

The compilation process can be stopped using the Project|Stop Compilation menu command or by pressing the Stop Compilation button on the toolbar.

After the compilation is complete, an Information window will open showing the compilation results.

CodeVisionAVR

Eventual compilation errors and/or warnings will be listed in the Message window located under the Editor window, or in the Navigator window.

By double clicking on the error or warning message, the line with the problem will be highlighted. The size of the Message window can be modified using the horizontal slider bar placed between it and the Editor window.

CodeVisionAVR

2.2.5.3 Making the Project

To make the Project you must use the Project|Make menu command, press the Shift+F9 keys or press the Make button of the toolbar. The CodeVisionAVR C Compiler will be executed, producing an assembler source file with the .asm extension.

The compilation process can be stopped using the Project|Stop Compilation menu command or by pressing the Stop Compilation button on the toolbar.

Eventual compilation errors and/or warnings will be listed in the Message window located under the Editor window, or in the Navigator window.

By double clicking on the error or warning message, the line with the problem will be highlighted.

If no errors were encountered, then the Atmel AVR assembler AVRASM32 will be executed, obtaining the output file type specified in Project|Configure|C Compiler|Code Generation.

CodeVisionAVR

After the make process is completed, an Information window will open showing the compilation results.

Pressing the Compiler tab will display compilation results.

CodeVisionAVR

Pressing the Assembler tab will display assembly results.

CodeVisionAVR

Pressing the Programmer tab will display the Chip Programming Counter, which shows how many times was the AVR chip programmed so far.

Pressing the Set Counter button will open the Set Programming Counter window:

This dialog window allows setting the new Chip Programming Counter value.

CodeVisionAVR

Pressing the Program button allows automatic programming of the AVR chip after successful compilation. Pressing Cancel will disable automatic programming.

2.2.6 Closing a Project

You can quit working with the current Project by using the File|Close Project menu command.

If the Project files were modified, and weren’t saved yet, you will be prompted if you want to do that.

Pressing Yes will save changes and close the project.

Pressing No will close the project without saving the changes.

Pressing Cancel will disable the project closing process.

When saving, the IDE will create a backup file with a .pr~ extension.

CodeVisionAVR

2.3 Tools

Using the Tools menu you can execute other programs without exiting the CodeVisionAVR IDE.

2.3.1 The AVR Studio Debugger

The CodeVisionAVR C Compiler is designed to work in conjunction with the Atmel AVR Studio debugger version 3 and 4.06 (or later).

For the AVR Studio debugger version 4.06 (or later) the compiler will generate an extended COFF object file that allows watching structures and unions. So it is highly recommended to use AVR Studio version 4.06 (or later) instead of version 3, which doesn’t support this feature. AVR Studio 4 prior to version 4.06 does not support the extended COFF object file format, so it can’t be used with CodeVisionAVR.

Before you can invoke the debugger, you must first specify its location and file name using the

Settings|Debugger menu command.

The AVR Studio version must be specified in the Debugger list box.

Changes can be saved, respectively canceled, using the OK, respectively Cancel buttons.

The debugger is executed by selecting the Tools|Debugger menu command or by pressing the Debugger button on the toolbar.

CodeVisionAVR

2.3.2 The AVR Chip Programmer

The CodeVisionAVR IDE has a built-in In-System AVR Chip Programmer that lets you easily transfer your compiled program to the microcontroller for testing.

The Programmer is designed to work with the Atmel STK500, AVRISP, AVRISP MkII, AVR Dragon, JTAGICE MkII, AVRProg (AVR910 application note), Kanda Systems STK200+, STK300, Dontronics DT006, Vogel Elektronik VTEC-ISP, Futurlec JRAVR or the MicroTronics ATCPU, Mega2000 development boards.

The type of the used programmer and the printer port can be selected by using the

Settings|Programmer menu command.

The Programmer is executed by selecting the Tools|Chip Programmer menu command or by pressing the Chip Programmer button on the toolbar.

You can select the type of the chip you wish to program using the Chip combo box.

The SCK clock frequency used for In-System Programming with the STK500, AVRISP or AVRISP MkII can be specified using the SCK Freq. listbox. This frequency must not exceed ¼ of the chip’s clock frequency.

If the chip you have selected has Fuse Bit(s) that may be programmed, then a supplementary Program Fuse Bit(s) check box will appear.

If it is checked, than the chip’s Fuse Bit(s) will be programmed when the Program|All menu command is executed or when the Program All button is pressed.

CodeVisionAVR

The Fuse Bit(s) can set various chip options, which are described in the Atmel data sheets.

If a Fuse Bit(s) check box is checked, then the corresponding fuse bit will be set to 0, the fuse being considered as programmed (as per the convention from the Atmel data sheets).

If a Fuse Bits(s) check box is not checked, then the corresponding fuse bit will be set to 1, the fuse being considered as not programmed.

If you wish to protect your program from copying, you must select the corresponding option using the

FLASH Lock Bits radio box.

The Programmer has two memory buffers:

•The FLASH memory buffer

•The EEPROM memory buffer.

You can Load or Save the contents of these buffers using the File menu.

Supported file formats are:

•Atmel .rom and .eep

•Intel HEX

•Binary .bin

After loading a file in the corresponding buffer, the Start and End addresses are updated accordingly. You may also edit these addresses if you wish.

The contents of the FLASH, respectively EEPROM, buffers can be displayed and edited using the Edit|FLASH , respectively Edit|EEPROM menu commands.

When one of these commands is invoked, an Edit window displaying the corresponding buffer contents will open:

The buffer's contents, at the highlighted address, can be edited by pressing the F2 key and typing in the new value. The edited value is saved by pressing the Tab or arrow keys.

The highlighted address can be modified using the arrow, Tab, Shift+Tab, PageUp or PageDown keys.

CodeVisionAVR

The Fill Memory Block window can be opened by right clicking in the Edit window:

This window lets you specify the Start Address, End Address and Fill Value of the memory area to be filled.

If you wish to check the chip's signature before any operation you must use the Check Signature option.

To speed up the programming process you can uncheck the Check Erasure check box. In this case there will be no verification of the correctness of the FLASH erasure.

The Preserve EEPROM checkbox allows preserving the contents of the EEPROM during chip erasure.

To speed up the programming process you also can uncheck the Verify check box.

In this case there will be no verification of the correctness of the FLASH and EEPROM programming.

For erasing a chip's FLASH and EEPROM you must select the Program|Erase menu command. After erasure the chip's FLASH and EEPROM are automatically blank checked.

For simple blank checking you must use the Program|Blank Check menu command.

If you wish to program the FLASH with the contents of the FLASH buffer you must use the

Program|FLASH menu command.

For programming the EEPROM you must use the Program|EEPROM menu command. After programming the FLASH and EEPROM are automatically verified.

To program the Lock, respectively the Fuse Bit(s) you must use the Program|Fuse Bit(s), respectively Program|Lock Bits menu commands.

The Program|All menu command allows to automatically:

•Erase the chip

•FLASH and EEPROM blank check

•Program and verify the FLASH

•Program and verify the EEPROM

•Program the Fuse and Lock Bits.

If you wish to read the contents of the chip's FLASH, respectively EEPROM, you must use the Read|FLASH, respectively Read|EEPROM menu commands.

For reading the chip's signature you must use the Read|Chip Signature menu command. To read the Lock, respectively the Fuse Bits you must use the Read|Lock Bits, respectively Read|Fuse Bits menu commands.

For some devices there's also the Read|Calibration Byte(s) option available.

It allows reading the value of the calibration bytes of the chip's internal RC oscillator.

CodeVisionAVR

If the programmer is an Atmel STK500, AVRISP, AVRISP MkII or AVRProg (AVR910 application note), then an additional menu command is present: Read|Programmer's Firmware Version. It allows reading the major and minor versions of the above mentioned programmers’ firmware.

For comparing the contents of the chip's FLASH, respectively EEPROM, with the corresponding memory buffer, you must use the Compare|FLASH, respectively Compare|EEPROM menu commands.

For exiting the Programmer and returning to the CodeVisionAVR IDE you must use the File|Close menu command.