The new Code Climate header check expects the following header format:

   SPDX-FileCopyrightText: <text>Copyright YYYY(-YYYY)
   [Copyright holder] <[Email address]></text>
   SPDX-License-Identifier: <LicenseID>

Convert all files to the new format.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

The headercheck Code Climate plugin now supports a new license header
format, "format-1". Use this instead of the default "legacy" format.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

To improve readability and make the source code of each individual
test easier to access, add a link in each mention of a test and leave
the link to the test cases folder in meta-arm untouched.

Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>

Add the extlinks sphinx extension to be able to link to source code
located in external repositories.

Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>

Create variables for the version of each component as well as
definitions for the versions and corresponding repository URLs. Add a
table to the top of the components page with the component name, version
used and a repository link.

Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>

Add borrow information for the stack integration.
Provides an overview of the key components and the applied changes for this
project so that the user can determine how to isolate and build them
independently and import them into their existing project.

Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>

Add reproduction information for the stack integration.
Describes how to reproduce a Reference Stack image and how to configure,
build, run and validate the supported set of architecture features.

Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Peter Hoyes authored Mar 01, 2023 and Diego Sueiro committed Mar 02, 2023

The BSP SMP test case uses the device tree to determine the number of
CPUs to validate. However, baremetal-image is overriding this by
specifiying maxcpus on the Linux command line. Override the number of
CPUs validated by the test case by specifiying TEST_SMP_NUM_CPUS in the
image recipe.

Additionally factor out the number of CPUs to the variable
BAREMETAL_IMAGE_NUM_CPUS so that it can be changed in one place.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Improve CI rules for the following jobs:
* Docs-Build
* Image-Build
* check-layers

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Major changes:
* Store the build configs to artifacts
* Change the name to the format of BUILD_REF-JOB_NAME-JOB_ID

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Tomás Agustín González Orlando authored Feb 27, 2023 and Tomás Agustín González Orlando committed Mar 01, 2023

Add validation information for the stack integration.

Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>

Major changes:
* Store the log artifacts after the build
* Parse the test log to generate a junit file of the results
* Install the module required by yoctoqa-to-junit.py

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Jingzhao Ni <Jingzhao.Ni@arm.com>

Remove dummy-job as it is not needed now.

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Major changes:

* Update utility-image for supporting image build
* Introduce kronos-build.yml which extends kas_build, to complete
  image build and other kas build related jobs
* Introduce kronos-image-builds.yml to include fvp-rd-kronos baremetal
  in the list of images to be built
* Introduce image_build.yml.j2 template for generating the image build
  child jobs
* Introduce yocto-qa.yml for Yocto layer check
* Introduce trigger-image-builds.yml to merge jobs and trigger them
* Add and update rules for new jobs
* Add auxiliary scripts, including:

  * jobs-to-kas
  * update-repos.py
  * converting yoctoqa result to junit format
  * generating child job test report

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Jingzhao Ni <Jingzhao.Ni@arm.com>

Peter Hoyes authored Jan 20, 2023 and Robbie Cao committed Feb 10, 2023

For the baremetal use case, introduce a dedicated image recipe.

This image recipe sets maxcpus to 4 in GRUB_LINUX_APPEND.

Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>

Peter Hoyes authored Jan 15, 2023 and Robbie Cao committed Feb 10, 2023

Major changes:

* Bootstrap meta-kronos layer using bitbake-layer create-layer.
* Intial Kas configurations in base.yml to extend the Kronos Kas file
  in the meta-arm layer using meta-kronos.
* Introduce baremetal.yml for image build (target is unset yet).
* Introduce ci.yml for image build in CI.

Changelog: other
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Major changes:

* Update spellcheck exclude patterns.
* Rearrange the other lists in alphabetical order.

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Tomás Agustín González Orlando authored Jan 17, 2023 and Filipe Rinaldi committed Jan 27, 2023

To promote cross-links between the documentation and the code, create a
small Sphinx extension which transforms links relative to the repository
root into a reference to the repository URL. It attempts to read the
version from the Read the Docs configuration and falls back to `git
rev-parse HEAD`.

The links can be written as follows:

  :repo:`path/to/file.bb`

The environment variable REPO_URL_PATTERN can be used to modify the repo
URL for development purposes.

The Read the Docs version_name is not useful for determining the Git ref
for the purposes of linking to the source code because of the special
value "latest", which refers to the default branch. Use the
gitlab_version variable instead, which despite the name is simply the
"commit_name" of the version according to:
https://github.com/readthedocs/readthedocs.org/blob/6.3.0/readthedocs/doc_builder/backends/sphinx.py#L95
and
https://github.com/readthedocs/readthedocs.org/blob/6.3.0/readthedocs/builds/models.py#L254



Changelog: other
Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Robbie Cao authored Jan 14, 2023 and Filipe Rinaldi committed Jan 27, 2023

Add initial documentation with:
* conf.py for the Sphinx Documentation Builder
* index.rst for the index
* license file documentation
* requirements.txt with dependencies for building the docs

Changelog: other
Signed-off-by: Tomás González <tomasagustin.gonzalezorlando@arm.com>
Signed-off-by: Peter Hoyes <Peter.Hoyes@arm.com>
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Filipe Rinaldi <filipe.rinaldi@arm.com>

Jingzhao Ni authored Jan 14, 2023 and Filipe Rinaldi committed Jan 27, 2023

This patch introduces a Docker image (utility-image) built in the .pre
stage to be used for CI jobs.

Changelog: other
Signed-off-by: Jingzhao Ni <Jingzhao.Ni@arm.com>
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Filipe Rinaldi <filipe.rinaldi@arm.com>

Robbie Cao authored Jan 14, 2023 and Filipe Rinaldi committed Jan 27, 2023

Enable GitLab's Code Quality which uses Codeclimate with a number of
code checkers.

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>
Signed-off-by: Jingzhao Ni <Jingzhao.Ni@arm.com>
Signed-off-by: Filipe Rinaldi <filipe.rinaldi@arm.com>

Robbie Cao authored Jan 14, 2023 and Filipe Rinaldi committed Jan 27, 2023

Initial CI pipeline with Dangerbot enabled.

The danger-review job is the only job running in the .pre stage at the
moment.
Using a dummy job to run in the Setup stage to make the pipeline
visible.

Changelog: other
Signed-off-by: Jingzhao Ni <Jingzhao.Ni@arm.com>
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Robbie Cao authored Jan 14, 2023 and Filipe Rinaldi committed Jan 18, 2023

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Robbie Cao authored Jan 14, 2023 and Filipe Rinaldi committed Jan 18, 2023

Changelog: other
Signed-off-by: Robbie Cao <robbie.cao@arm.com>

Signed-off-by: Robbie Cao <robbie.cao@arm.com>