Rusted Firmware-A

This project provides an experimental Rust port of Trusted Firmware-A’s (TF-A) EL3 runtime firmware (BL31) for Armv9-A.

TF-A's boot images (BL1 and BL2) are out of scope of this project.

Responsibilities

The EL3 runtime firmware is responsible for:

Boot process coordination - Initiating the boot process of the components in the secure and normal worlds
Security state coordination - Managing transitions between normal and secure worlds
Secure Monitor Call (SMC) handling - Processing SMCs invoked by other software components

Supported SMC Interfaces

The current implementation supports:

Arm Architecture Calls.
A Secure Partition Manager Dispatcher (SPMD) that complies with Arm Firmware Framework for Arm A-profile (FF-A).
Arm Power State Coordination Interface (PSCI).
Errata Management.
Arm True Random Number Generator Firmware Interface.
An optional platform-specific service.

For more details on each of these services, please refer to the SMC services overview document.

Supported Platforms

The following platforms are supported currently:

Arm Fixed Virtual Platform (FVP)
QEMU

Hardware and Software Requirements

RF-A is targeted at recent Arm devices and as such it makes some assumptions about the hardware it runs on and the software interfaces it implements or relies on. These assumptions are outlined here.

Getting started

See our Getting Started Guide.

See the RF-A architecture overview for an overview of the code structure.

License

The project is provided under the BSD-3-Clause license, see LICENSE. Contributions to this project are accepted under the same license and must also be made under the terms of the Developer Certificate of Origin, confirming that the code submitted can (legally) become part of the project.

Contributing

See the contribution guidelines and style guide.

Providing feedback

We welcome your feedback on this project! You can contact us through:

the RF-A mailing list;
the trustedfirmware Discord server, on the #rusted-firmware-a channel.

If you want to report an issue, request a feature or simply take a look at the on-going and future work items, please head to our Github issues.

Arm trademark notice

Arm is a registered trademark of Arm Limited (or its subsidiaries or affiliates).

This project uses some of the Arm product, service or technology trademarks, as listed in the Trademark List, in accordance with the Arm Trademark Use Guidelines.

Subsequent uses of these trademarks throughout this repository do not need to be prefixed with the Arm word trademark.

Staging counterpart to the `RF-A/rusted-firmware-a` project.

Branches

Tags