History

Maxim Reznik 22ae2aea53 Add more readme files.		2023-12-06 16:38:32 +02:00
..
HiFive1	Switch to GNAT FSF 12 support (#418 )	2023-01-02 11:34:55 +01:00
HiFive1_rev_B	Switch to GNAT FSF 12 support (#418 )	2023-01-02 11:34:55 +01:00
MicroBit	Switch to GNAT FSF 12 support (#418 )	2023-01-02 11:34:55 +01:00
NRF52_DK	Switch to GNAT FSF 12 support (#418 )	2023-01-02 11:34:55 +01:00
OpenMV2	Update example projects for new board support projects	2018-04-27 21:16:40 +02:00
STM32F4_DISCO	Refine and strengthen package Audio (#410 )	2022-05-31 16:08:33 +02:00
STM32F429_Discovery	STM32F429: Fix example project files	2018-06-27 15:57:37 +02:00
STM32F469_Discovery	Update example projects for new board support projects	2018-04-27 21:16:40 +02:00
STM32F746_Discovery	Update example projects for new board support projects	2018-04-27 21:16:40 +02:00
STM32F769_Discovery	Update example projects for new board support projects	2018-04-27 21:16:40 +02:00
Unleashed/blinky	SiFive Unleashed: Add an example project	2019-09-06 12:35:02 +02:00
feather_stm32f405	Add support for IS31fl3731 LED matrix driver	2020-01-03 10:02:15 +01:00
nucleo_f446ze	Add NUCLEO-F446ZE board definition	2019-02-04 16:53:05 +01:00
shared	corrections to serial_io facilities (#409 )	2022-05-30 15:40:25 +02:00
stm32_f4ve	Add more readme files.	2023-12-06 16:38:32 +02:00
stm32_h405	PCD8544 LCD driver (#364 )	2020-09-17 14:49:10 +02:00
stm32f4xx_m	Add SD card examples for `stm32f4xx_m`.	2023-12-06 16:38:32 +02:00
.gitignore	Improve the organisation of the examples.	2016-04-26 09:34:37 +02:00
README.md	Add more READMEs	2023-12-06 16:38:32 +02:00

README.md

Ada_Drivers_Library examples

In this directory you will find instructions and examples to start your first Ada_Drivers_Library project.

The goals of the examples are:

Offer a simple way to start a project
Demonstrate the supported features of the boards
Demonstrate the supported drivers of a micro-controller family

The examples are sorted by boards but some of them are working on multiple boards, in that case the code is stored in the shared directory.

Getting started

Download and install the tools

Compiler and IDE

Most of the boards/micro-controller supported are based on the ARM Cortex-M architecture. If you have a GNAT Pro subscription, you can download the compiler (GNAT) and IDE (GNAT Programming Studio) from your account. Otherwise, there are GNAT FSF and GPRbuild releases from the Alire project that you can download here.

A public release of GNAT Studio is also available here.

stlink

For the STM32 board we recommend to use the open-source probe interface stlink.

On Windows, you can get it from the Msys2 package manager.

On Linux, you have to download the source and compile the tool:

$ git clone https://github.com/texane/stlink.git
$ cd stlink
$ make release

Miscellaneous

Some boards require a specific tool or configuration, in that case you will find the additional instructions in the example directory dedicated to this board (for instance Micro:bit).

Clone the repository

If you are on Windows, we recommend to use the GitHub Desktop application.

Otherwise, from the command line:

git clone --recursive https://github.com/AdaCore/Ada_Drivers_Library.git

Open an example project

Start GNAT Programming Studio and open one of the project supported by the board you have:

Compile the project

Use the "Build all" button in GNAT Programming Studio tool bar.

Run the project

For the STM32 board, use the "Flash to board" button in the tool bar.

We need your help

If you notice an error in these instructions, or if you want to improve them, please go to Ada_Drivers_Library GitHub repository. Thank you in advance.