Alire Crate - STM32L0xx HAL

Table of Contents

• Repository structure
• License
• Development

This repository provides the HAL library for the STMicroelectronics STM32L0 MCU series and is intended to be distributed via the Alire package manager. This library, ported from C to Ada, is based on the following projects:

Table 1. Credits

Project	Version
STMicroelectronics’s STM32CubeL0 HAL Driver MCU Component	v1.10.6

Repository structure

Table 2. Content

Path	Description
src/	Library source files
tests/	Library test subproject

License

Licensed under the Apache License, Version 2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Development

Requests and reporting

Please report bugs or feature requests to the project maintainers, preferably using the issues tracker.

Workflow

The project development workflow is inspired by the GitFlow branching model. Although strict naming conventions are not enforced, feature branches should branch from develop and fix branches from main or latest release.

Alire aliases

Alire aliases can be configured to simplify frequent toolchain operations, especially if involving the .gpr project file or environment variables provided by Alire. Script file make-aliases.sh is provided to configure the following aliases:

• alr emu: (tests subproject) Execute tests in emulated environment;

• alr emugdb: (tests subproject) Execute tests in emulated environment with GDB server enabled;

• alr gdbemu: (tests subproject) Launch GDB and connect to emulated tests instance.

  These aliases use GNATemu and GDB, hence they require arm-eabi-gnatemu and arm-eabi-gdb to be available in $PATH. At the time of writing, the former is not available through Alire. However non-GNATPro users may still find available ARM ELF GNAT Community Edition, which ships also the arm-eabi-gnatemu binary, at AdaCore’s Download page.

Tests and debug on emulated target

The target platform can be emulated using GNATemu. Sub-crate project tests/tests.gpr supplies the Emulator package with minimal working configuration. To run tests in the emulated environment, execute from within the sub-project folder the following command.

Start tests in emulation environment

$ alr emu

To debug tests, within its folder run the following commands, in two separated terminals, to start GNATemu followed by GDB.

Start GNATemu

$ alr emugdb

Start GDB

$ alr gdbemu