Introduction

This crate modifies an Alire program project to build a cross-compiled program for a MuntsOS Embedded Linux AArch64 / ARMv8 / arm64 target computer.

The MuntsOS Embedded Linux cross toolchain packages must be installed on your Linux development computer before you can use this crate. See Application Note #1 for Debian distributions or Application Note #2 for RPM distributions.

Each MuntsOS Embedded Linux cross toolchain contains prebuilt Ada Web Server and Linux Simple I/O Library components. Therefore, DO NOT attempt to alr with any of the aws, libsimpleio, mcp2221, remoteio, wioe5_ham1, wioe5_ham2, or wioe5_p2p crates in a project using this crate.

Environment Variables

If ALIRE_DISABLESTYLECHECKS is set to yes, the postfetch script will disable style checking in the project .gpr file.

If ALIRE_INSTALLMAKEFILE is set to yes, the postfetch script will install an optional but useful Makefile to the project directory.

You can add the following to ~/.bashrc or its equivalent to permanently define these environment variables:

export ALIRE_DISABLESTYLECHECKS=yes
export ALIRE_INSTALLMAKEFILE=yes

Example

The following commands illustrate how to create an Alire program project that will cross-compile a program to run on a MuntsOS Embedded Linux target computer. The result is a pristine (i.e. all temporary, working and deliverable files removed) project, suitable for checking into a source code control repository.

alr -n init --bin myexample
cd myexample
alr -n with muntsos_aarch64
ALIRE_DISABLESTYLECHECKS=yes ALIRE_INSTALLMAKEFILE=yes alr action -r post-fetch
make reallyclean

See also Application Note #7.