Skip to content
Assember for the Atmel AVR microcontroller family
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Another CR+LF fix Sep 25, 2010
includes Add support for ATtiny48/88 Apr 24, 2019
src Add support for ATtiny48/88 Apr 24, 2019
tests Add regression tests Feb 25, 2019
.gitignore
.travis.yml Add Travis config Feb 26, 2019
AUTHORS
CHANGELOG.md
COPYING Reorganisation of files and removed compiler warnings of unused varia… May 7, 2010
Makefile v1.4.1 Apr 24, 2019
README.md Add top-level Makefile that replaces the Build script Feb 25, 2019
TODO
USAGE.md

README.md

AVRA

Assember for the Atmel AVR microcontroller family

AVRA is an assembler for Atmel AVR microcontrollers, and it is almost compatible with Atmel's own assembler AVRASM32. The programming principles and conceptions are based on the ANSI programming language "C".

Differences between AVRA and AVRASM32

There are some differences between the original Atmel assembler AVRASM32 and AVRA. Basically AVRA is designed to replace AVRASM32 without special changes in your current Atmel AVR Studio enviroment. Command line options have been adapted as far as it was possible until now. Jumping to fault containing line directly by double-clicking on the error message in the output window does work as with AVRASM32.

The differences in detail

Support for some extra preprocessor directives.

.define, .undef, .ifdef, .ifndef, .if, .else, .endif, .elif, .elseif, .warning

Not all command line options are supported.

Specifying an eeprom file (-e) is not supported. All eeprom data is put out into a file called program.eep.hex and always Intel hex format. Other hex file formats than Intel are currently not supported.

Forward references not supported for .ifdef and .ifndef directives.

This makes sure, that directives like .ifdef and .undef are working properly. If you are familiar with the C programming language, you should get easily into AVRA. See chapter "Programming techniques" for more information about how to write proper code.

Enhanced macro support

AVRA has some new features for writing flexible macros. This should increase the ability to reuse code e.g. build your own library.

Debugging support

AVRA creates a coff file everytime the assembly was sucessful. This file allows AVR Studio or any coff compatible debugger to simulate or emulate the program.

Meta tags for assembly time

This helps you tracking versions of your software and can also be used to generate customer specific serial numbers.

Compatibility

Since AVRA is written in ANSI C, it should be possible to compile it on most system platforms. If you have problems compiling AVRA, please open an issue in the tracker.

History

The initial version of AVRA was written by John Anders Haugum. He released all versions until v0.7. Tobias Weber later took over, followed by Burkhard Arenfeld (v1.2) then Jerry Jacobs (v1.3).

After a long 8 years of inactivity, I (Virgil Dupras), took over, preparing a v1.4 release and onwards.

See AUTHORS for a complete list of contributors.

Build

To build the avra executable, cd into the project's root directory and run make. A src/avra binary will be produced. You can install it with make install.

By default, make runs under the linux OS, which assumes a typical GNU toolchain. If that doesn't work for you, look at the available platforms available in src/makefiles and override OS when you call make. Note that those platforms aren't all well tested. Please open an issue in the tracker if you notice a platform not working.

Usage

See USAGE.md.

Change log

See CHANGELOG.md.

You can’t perform that action at this time.