arm-trusted-firmware/docs
Boyan Karatotev 8db170524d feat(smccc): implement SMCCC_ARCH_FEATURE_AVAILABILITY
SMCCC_ARCH_FEATURE_AVAILABILITY [1] is a call to query firmware about
the features it is aware of and enables. This is useful when a feature
is not enabled at EL3, eg due to an older FW image, but it is present in
hardware. In those cases, the EL1 ID registers do not reflect the usable
feature set and this call should provide the necessary information to
remedy that.

The call itself is very lightweight - effectively a sanitised read of
the relevant system register. Bits that are not relevant to feature
enablement are masked out and active low bits are converted to active
high.

The implementation is also very simple. All relevant, irrelevant, and
inverted bits combined into bitmasks at build time. Then at runtime the
masks are unconditionally applied to produce the right result. This
assumes that context managers will make sure that disabled features
do not have their bits set and the registers are context switched if
any fields in them make enablement ambiguous.

Features that are not yet supported in TF-A have not been added. On
debug builds, calling this function will fail an assert if any bits that
are not expected are set. In combination with CI this should allow for
this feature to to stay up to date as new architectural features are
added.

If a call for MPAM3_EL3 is made when MPAM is not enabled, the call
will return INVALID_PARAM, while if it is FEAT_STATE_CHECK, it will
return zero. This should be fairly consistent with feature detection.

The bitmask is meant to be interpreted as the logical AND of the
relevant ID registers. It would be permissible for this to return 1
while the ID returns 0. Despite this, this implementation takes steps
not to. In the general case, the two should match exactly.

Finally, it is not entirely clear whether this call replies to SMC32
requests. However, it will not, as the return values are all 64 bits.

[1]: https://developer.arm.com/documentation/den0028/galp1/?lang=en

Co-developed-by: Charlie Bareham <charlie.bareham@arm.com>
Signed-off-by: Boyan Karatotev <boyan.karatotev@arm.com>
Change-Id: I1a74e7d0b3459b1396961b8fa27f84e3f0ad6a6f
2025-01-07 08:00:11 +00:00
..
_static/css docs(threat model): add TF-A threat model 2021-04-30 17:59:22 +02:00
about docs(maintainers): update marvell maintainer 2024-12-23 01:48:05 -08:00
components docs(context-mgmt): add Root-Context documentation 2024-11-15 10:44:39 +00:00
design docs(arm): update docs to reflect rotpk key changes 2024-12-30 12:32:22 +01:00
design_documents feat(docs): add DPE to RSE desing doc 2024-11-04 17:28:15 +01:00
getting_started feat(smccc): implement SMCCC_ARCH_FEATURE_AVAILABILITY 2025-01-07 08:00:11 +00:00
perf docs(juno): update PSCI instrumentation data 2024-11-15 13:16:28 +00:00
plat docs(arm): update docs to reflect rotpk key changes 2024-12-30 12:32:22 +01:00
process docs: remove reference to phabricator pages 2024-05-15 14:27:45 +02:00
resources docs(context-mgmt): add Root-Context documentation 2024-11-15 10:44:39 +00:00
security_advisories chore: rename Poseidon to Neoverse V3 2024-03-26 11:27:31 -05:00
threat_model feat(docs): add RSE provided mboot backends to the threat model 2024-11-04 17:25:15 +01:00
tools fix(cot-dt2c): use processed Device Tree source file as input 2024-08-27 12:50:20 +01:00
change-log.md docs(changelog): changelog for v2.12 release 2024-11-19 18:08:58 -06:00
conf.py docs(changelog): changelog for v2.12 release 2024-11-19 18:08:58 -06:00
global_substitutions.txt feat(docs): add DPE to RSE desing doc 2024-11-04 17:28:15 +01:00
glossary.rst feat(docs): add RSE provided mboot backends to the threat model 2024-11-04 17:25:15 +01:00
index.rst feat(fwu): update the URL links for the FWU specification 2024-03-01 14:19:56 +05:30
license.rst feat(lib): introduce Hob creation library 2024-12-06 13:26:31 +00:00
Makefile build: install dependencies before doc build 2024-11-06 15:18:06 +01:00
porting-guide.rst feat(smccc): implement SMCCC_ARCH_FEATURE_AVAILABILITY 2025-01-07 08:00:11 +00:00