File	Date	Author	Commit
apps	2020-04-15	Rolf Ebert	[1732b2] added several 7-segment display examples. Moved...
avr	2020-04-15	Rolf Ebert	[1732b2] added several 7-segment display examples. Moved...
dist	2015-05-19	Rolf	[e9420b] Commit everything from private directories
doc	2015-05-19	Rolf	[e9420b] Commit everything from private directories
.gitignore	2019-10-14	Rolf Ebert	[dd875b] some more clean-up
COPYING.txt	2015-05-19	Rolf	[e9420b] Commit everything from private directories
Makefile	2019-09-03	Rolf Ebert	[810689] remove building and configuring the RTS
README	2012-08-25	Rolf Ebert	[c22b02] added README, fixed build script
configure	2019-10-05	Rolf	[76eb2e] several clean-ups
configure.orig	2015-05-19	Rolf	[e9420b] Commit everything from private directories
excldevs.mk	2011-02-04	Tero Koskinen	[326e77] Compile atmega2560 and attiny13a parts by default.
normalize_path.sh	2015-05-19	Rolf	[e9420b] Commit everything from private directories
set_devel_env_w.sh	2015-05-19	Rolf	[e9420b] Commit everything from private directories

Read Me

This is AVR-Ada V1.2.1
======================

The AVR-Ada project provides the gcc based Ada compiler GNAT for the
AVR 8-bit microcontrollers. This includes:
- the Ada compiler (GNAT) based on the existing AVR and Ada support in gcc
- a small Ada run time system and useful AVR specific support libraries
- documentation and some sample programs


Building and Installing an Ada Cross Compiler Tool Suite
========================================================

Prerequisites
-------------

Get the following source packages

    binutils (assembler, linker, etc.): 2.20.1
    gcc (compiler): 4.7.1
    avr-libc (C run time system, start-up code, linker scripts): 1.8.x
    avr-ada (Ada run time system, gcc and binutils patches): 1.2.x

You need a native GNAT compiler on your system. Nowadays almost all
Linux distributions contain the Ada enabled gcc. If your system
compiler is not yet gcc-4.7, get the latest gcc-4.7 sources and build
a new native compiler first (for at least C and Ada). On Windows use
the MinGW installer mingw-get to install gcc with Ada support. It
works well to rebuild gcc-4.7.

You need the GNU binutils and the avr-libc library. The first is
available on any GNU mirror.  Take version 2.20.1.  The latter is
available from the AVR libc home page. Any version after 1.0 will
do. I use the release 1.8.0.

The gcc sources must be from the 4.7 branch of gcc. I did all my tests
and modifications on gcc-4.7.1.

Get the latest binutils and gcc patches from the AVR-Ada project. They
are included in the full AVR-Ada source release in the directories
patches/gcc/4.7.1/ and patches/binutils/2.20.1/.


Building the compiler
---------------------

Have a look at the shell script build-avr-ada.sh in the tools/build/
directory. It automates the build process and we use it exclusively
for building our compilers and tools. For a full description of how to
use the current build script see the [BuildScript] page in the Wiki.


Install the Ada Run Time System and AVR Support Libraries
---------------------------------------------------------

After building and installing the Ada cross compiler you need a basic
run time system (RTS).

After unpacking the AVR-Ada source distribution, run configure and
make in the top level directory.  Configure determines the
installation path (PREFIX) from the installed gcc.  See the comments
in the Makefile for the different make targets.  You should first
build and install the RTS, then the AVR libraries.  The RTS will be
installed in the gcc tree, the AVR libraries will be installed in
PREFIX/avr/ada.  Make sure that you have write permissions in these
locations.


configure
make build_rts
make install_rts

make build_libs
make install_libs



Documentation and getting help
------------------------------

Please refer to the AVR-Ada wiki pages at

   http://sourceforge.net/p/avr-ada/wiki/Home/

They contain all the available documentation.  If you think that
something is missing, plase add it yourself (if happen to know).  All
SF users have write permission in the wiki.  If some questions remain
open, feel free to ask your question on the avr-ada-devel mailing
list.  We request you to subscribe to list, though, at
http://lists.sourceforge.net/lists/listinfo/avr-ada-devel


News in AVR-Ada V1.2
--------------------

Please refer to the release notes at

  http://sourceforge.net/p/avr-ada/wiki/V1.2%20Release%20Notes/