Skip to content

[Backport to release/v1.0] Document how to target older ARM CPUs #411

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vt-tv merged 2 commits into from
Feb 16, 2026
Merged

[Backport to release/v1.0] Document how to target older ARM CPUs #411

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ef981be
Document how to target older ARM CPUs
vt-tv Feb 16, 2026
9176198
Update docs/Building.md
vt-tv Feb 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions docs/Building.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,19 @@ PIC is enabled by default and can be disabled with
2. Install doxygen and ccache through brew: `brew install doxygen ccache`
3. Install the GStreamer runtime and developement packages according to [these instructions](https://gstreamer.freedesktop.org/documentation/installing/on-mac-osx.html?gi-language=c#download-and-install-the-sdk)


## ARM notes

The MXL project is configured to require the `armv8.5-a` architecture on ARM CPUs. Most modern ARM CPUs meet this requirement. Notable exceptions are the Raspberry Pis. For example, the Pi 5 CPU has an architecture level `armv8.2-a` whereas the Pi 4 Model B is at level `armv8.0-a`. To properly target these CPUs, pass the architecture type as an additional argument to cmake : `-DMXL_TARGET_ARCH=<archname>`.

For example, for the Raspberry Pi 5:
```
mkdir build
cd build
cmake .. --preset Linux-GCC-Debug -DMXL_TARGET_ARCH=armv8.2a
cmake --build build/Linux-GCC-Debug --target all
```

# Using with CMake

The MXL provides a CMake package configuration file that allows for easy integration into your project. If it is installed in a non-default location, you may need to specify its root path using `CMAKE_PREFIX_PATH`:
Expand Down