Update default config for docs so that public RTD can successfuly
render the documentation for public releases.
This update is enforced by the recent change made on public RTD
to deprecate the use of build.image config key (not used in TC docs)
and enforce the use of build.os config key instead (now mandatory for
all projects, since Oct 16, 2023).

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

tc2 doc: update method to obtain the fvp model

See merge request arm-reference-solutions/build-scripts!36

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

tc doc: fix rtd requirements paths to adopt folder structure

See merge request arm-reference-solutions/build-scripts!35

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

Include latest TC22.4 doc changes for public release

See merge request arm-reference-solutions/build-scripts!34

List of changes include:
 - add missing mention of CPU for CPU features;
 - add reverse links from each test "expected results" section to its test description;
 - other small fixes and/or improvements.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

Changes include:
 - fix the 'previous releases' links to reflect the new folder/file
   structure visible on the old TC documentation domain (enforced by
   the recent requirement to update/fix the old documentation and add
   a banner message informing user about the latest TC release and
   the new domain).
 - add .readthedocs.yaml file to comply with new RTD support changes;
 - other minor fixes/updates to keep consistency with old documentation.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

Documentation update: Use release tag for LISA checkout - export filesystem for lisa -

See merge request arm-reference-solutions/build-scripts!33

Quoc Khanh Le authored Sep 25, 2023 and Davidson Kumaresan committed Sep 26, 2023

Adding FILESYSTEM=buildroot which is needed for linux kernel
path in target_conf_buildroot.yml for EAS test.

Signed-off-by: Quoc Khanh Le <QuocKhanh.Le@arm.com>

Kshitij Sisodia authored Sep 04, 2023 and Davidson Kumaresan committed Sep 26, 2023

To ensure consistency in our tests results, the "EAS with LISA"
test documentation section has been updated to checkout "v3.1.0"
of the LISA repository rather than using the default branch tip.

Signed-off-by: Kshitij Sisodia <kshitij.sisodia@arm.com>

Davidson Kumaresan authored Sep 12, 2023 and Vishnu Banavath committed Sep 15, 2023

Currently, the ddk is patched for every build even though the required
patch is already applied.  This gives a patch fail error.  This change
will apply patch only if the gpu ddk is cloned.

Signed-off-by: Davidson K <davidson.kumaresan@arm.com>

Ahmed Genidi authored Sep 12, 2023 and Vishnu Banavath committed Sep 15, 2023

this change includes modifying the run_docker.sh file to force restart ssh agent
to unblock the setup.sh execution.

Signed-off-by: Ahmed Genidi <Ahmed.Genidi@arm.com>

This change is to delete reference to internal links
to fetch GPU kernel driver, gralloc and mali prebuilt binaries.

Signed-off-by: Vishnu Banavath <vishnu.banavath@arm.com>

Changes include:
  - remove all Debian Swr/Hwr rendering support mentions;
  - minor updates to the TC boot flow diagram;
  - add required commands for MTE sanity test;
  - add PAUTH known inconsistent failing tests known issue;
  - add new "Troubleshooting: common problems and solutions" section.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

Sergio Alves authored Aug 21, 2023 and Kshitij Sisodia committed Aug 30, 2023

These minor documentation updates include:
 - update the list of known issues/limitations:
   - add KVM kernel boot warning for Android builds;
   - add Hafnium SMC block call warning for Android builds;
 - update the list of previous releases;
 - temporarily remove SMMUv3 mentions.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

This patch changes the env variable `TC_GPU` being set to
`hwr-prebuilt` by default and removes the checks for this
variable being set for all filesystems. Instead we enforce
this variable only Android builds. This is done to be able
to boot Debian without having to build the GPU DDK.

Signed-off-by: Kshitij Sisodia <kshitij.sisodia@arm.com>

Ben Horgan authored Aug 29, 2023 and Kshitij Sisodia committed Aug 30, 2023

Without this trusty doesn't start up as the memory commands
fail with permissions errors.

Signed-off-by: Ben Horgan <ben.horgan@arm.com>

Jackson Cooper-Driver authored Aug 22, 2023 and Kshitij Sisodia committed Aug 30, 2023

Currently, the run_docker.sh always returns with RC=0 when being run
with an underlying script. This is because of the echo call at the end
of the script. Modify the script to ensure that we return with the
return code of the docker process itself.

Signed-off-by: Jackson Cooper-Driver <jackson.cooper-driver@arm.com>

Quoc Khanh Le authored May 15, 2023 and Kshitij Sisodia committed Aug 22, 2023

BTI, MTE, PAUTH tests are currently only available for building android
with HW rendering. This change make these test also available in test
folder for SW rendering

Signed-off-by: Quoc Khanh Le <QuocKhanh.Le@arm.com>

Patching for kernel driver in `patch_gpu_ddk_prebuilt`.

Signed-off-by: Kshitij Sisodia <kshitij.sisodia@arm.com>

For the configuration where the pre-built library and firmware files
are used for the DDK, the kernel driver still needs to be patched
the same way as we do when we are building from source.

Signed-off-by: Kshitij Sisodia <kshitij.sisodia@arm.com>

Rupinderjit Singh authored Aug 18, 2023 and Kshitij Sisodia committed Aug 22, 2023

If a host has two docker images of same name with different SHAs then
run_docker.sh, invoked via setup.sh, fails while verifying the pulled
docker image. This is becuase two docker images of same name but
different SHAs breaks the comparison if condition as right side
of the conditon has both the SHAs in it. This fix is now extracting
the SHA information associated with docker image name as well as
its unique TAG value.

Also, updated ubuntu version tag to fix errors while building
docker image locally.

Signed-off-by: Rupinderjit Singh <rupinderjit.singh@arm.com>

Correcting the patch number for TF-A's FPGA patch.

Signed-off-by: Kshitij Sisodia <kshitij.sisodia@arm.com>

Alex Dobrescu authored Aug 17, 2023 and Kshitij Sisodia committed Aug 22, 2023

Signed-off-by: Alex Dobrescu <alex.dobrescu@arm.com>

Vishnu Banavath authored Aug 17, 2023 and Kshitij Sisodia committed Aug 22, 2023

This change is to fetch TC2-2023.08.15 docker image, this docker image
is based on 20.04 and has wayland-scanner package installed.

Signed-off-by: Vishnu Banavath <vishnu.banavath@arm.com>

Sergio da Silva Alves authored Jul 31, 2023 and Kshitij Sisodia committed Aug 22, 2023

Signed-off-by: Sergio da Silva Alves <sergio.dasilvalves@arm.com>

* Removed the hardcoded GPU DDK export variables required to
  build GPU DDK from source for debian.
* Moved mali DDK source for debian under src/debian/mali. This
  is to differentiate debian mali source form android mali source
  when same TC build will be built both for android and debian.

Signed-off-by: Rupinderjit Singh <rupinderjit.singh@arm.com>

Signed-off-by: Sergio da Silva Alves <sergio.dasilvaalves@arm.com>

This change includes building Android with GPU prebuilt.
GPU will not be built from source, instead prebuilt bin and lib
will be used if TC_GPU is set to `hwr-prebuilt`.

Signed-off-by: Rupinderjit Singh <rupinderjit.singh@arm.com>
Signed-off-by: Ahmed Genidi <Ahmed.Genidi@arm.com>

This package will install wayland-scanner dependency inside
the docker which is required to build DDK with debian

Signed-off-by: Rupinderjit Singh <rupinderjit.singh@arm.com>

Ben Horgan authored Aug 02, 2023 and Davidson Kumaresan committed Aug 11, 2023

Using the genpd framework allows us to change the frequency and
voltage together using the scmi perf protocol. This is achieved by
patching the gpu mali kbase driver to introduce a call to
dev_pm_genpd_set_performance_state.

This patch does not include patching the driver when using the
prebuilt ddk binaries or patching the driver when using it from
debian.

Signed-off-by: Ben Horgan <ben.horgan@arm.com>

Ben Horgan authored Jul 27, 2023 and Davidson Kumaresan committed Aug 11, 2023

Configure gpu and dpu scmi power domains and gpu perf domain

Signed-off-by: Ben Horgan <ben.horgan@arm.com>

Ben Horgan authored Jul 27, 2023 and Davidson Kumaresan committed Aug 11, 2023

Configure scmi power domains for GPU and DPU to enable GPU idle
and add a GPU perf domain fro GPU dvfs.

Signed-off-by: Ben Horgan <ben.horgan@arm.com>

Ben Horgan authored Jul 24, 2023 and Davidson Kumaresan committed Aug 11, 2023

Enables turning the gpu off when idle. Also, we are currently
using this driver to change performance states, opp.

Signed-off-by: Ben Horgan <ben.horgan@arm.com>

Davidson Kumaresan authored Aug 08, 2023 and Davidson Kumaresan committed Aug 10, 2023

Signed-off-by: Davidson K <davidson.kumaresan@arm.com>

Sergio Alves authored Jul 24, 2023 and Davidson Kumaresan committed Aug 10, 2023

This patch fixes the problems associated with:
 - TC2 Android with GPU Hw rendering not booting on FPGA;
 - TC2 Android Verified Boot not loading from MMC.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>

Davidson Kumaresan authored Aug 08, 2023 and Davidson Kumaresan committed Aug 10, 2023

Info level logs helps in evaluating the SCP features

Signed-off-by: Davidson K <davidson.kumaresan@arm.com>

Sergio Alves authored Jun 02, 2023 and Davidson Kumaresan committed Aug 10, 2023

Update the version of the GCC toolchain used to compile TC to version
gcc-arm-12.2rel1.

Compiling some components may cause some warnings which with the use
of "-Werror", will be treated as fatal errors and stop the compilation.
Therefore, some temporary workaround patches were applied to overcome
this error and allow build of the TC Sw stack.

Signed-off-by: Sergio Alves <sergio.dasilvalves@arm.com>