README.md

# MCU-Driver-HAL for Arm platforms

This repository contains the driver implementation for Arm hardware platforms.

## Building

```sh
# Configure
cmake -S . -B build --toolchain=mcu-driver-hal/tools/cmake/toolchain-{armclang|arm-none-eabi-gcc}.cmake -DCMAKE_SYSTEM_PROCESSOR=cortex-m55
# Build
cmake --build build -j
```

You may want to add optional arguments to those lines to customize your build.
For example, the configure stage accepts:

- `-DCMAKE_BUILD_TYPE=Release` will build your applications optimised for size. See
  [here](./mcu-driver-hal/tools/cmake/profiles) for more details.
- `-DCMAKE_VERBOSE_MAKEFILE=ON` will make your build tool more verbose, typically printing the
  command lines invoking the compiler.
- `-DCMAKE_EXPORT_COMPILE_COMMANDS=1` generates a build database that can be used by IDEs to provide
  better completion.
- `-DVARIANT=FVP` will choose an FVP build variant instead the default MPS3 FPGA.
- `-DHTRUN_ARGUMENTS="--micro=FVP_CS300_U55;--fm=MPS3"` configures `ctest` and `htrun` to work with the FVP via the `mbed-fastmodel-agent` (if installed).

The build stage can be passed a specific target name after a `--` to build only that target or `clean` to remove the build products (objects and executables). E.g.

```sh
cmake --build build -j -- clean
cmake --build build -j -- mdh-arm-hal-example-serial
```