There does not appear to be any specific size requirement for the micro
SD card used with the Arm Corstone-1000 for MPS3. Relax the wording to
allow any card which is `at least 4 GB` as cards which are exactly 4 GB
may now be difficult to source.

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

For both Corstone-1000 and N1SDP, show examples for picocom but make it
clear any terminal client should work fine (giving picocom, minicom, and
screen as examples).

Remove the statement about port names being different on Windows as the
rest of the documentation just assumes a Linux host is being used.

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

For both Corstone-1000 and N1SDP, specify a minimum 16GB for USB
storage. This should be sufficient for the rootfs.

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

For clarity, the YML files for the three cassini base configs should
all have the same structure.

Align cassini-dev.yml/dev.yml and cassini-sdk.yml/sdk.yml with
cassini.yml such that:
- cassini-<foo>.yml includes cassini-base.yml and sets the target
- cassini-<foo>.yml includes <foo>.yml
- <foo>.yml adds the distro feature cassini-<foo>

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

In the User Manual, add a brief description of `cassini-dev.yml` as one
of the three supported Base Configs.

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

Build, deployment and reset instructions vary between N1SDP,
Corstone-1000 for MPS3, and Corstone-1000 FVP so they should be in one
of the platform specific documents (`Getting Started with...`).

Conversely, login instructions are platform independent and should be
moved from the platform specific documents to the generic user guide.

A `Getting Started with...` document is created for the N1SDP and all
platform specific instructions in the generic user guide are moved to
the relevant platform guide (N1SDP, Corstone-1000 MPS3, or
Corstone-1000 FVP).

Each `Getting Started with...` document starts with a section which:
- names the platform kas config file
- shows the command used to build a base image for that platform
- shows the image files created (firmware and distro)
The structure of this section is aligned across all supported platforms

The generic build instructions in the user guide now contains links to
each of the platform specific `Getting Started` guides.

Changelog: other
Signed-off-by: Adam Johnston <adam.johnston@arm.com>

Adds:
- 2gb
- 8n1
- baud
- corstone1000-image-corstone1000-fvp.wic.nopt
- dialout
- distro
- unmount

Removes:
- diego.sueiro

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

`validate` -> `Validate` for consistency with other docs

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

The Corstone-1000 guides use a different header/outline markup to the
rest of the documentation (although they are rendered in the same way).

Re-align the Corstone-1000 header/outline markup style with the rest of
the documentation

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

`cassini-sdk.yml` is one of two base configs for cassini (the other
being `cassini.yml`). As `cassini-sdk.yml` includes `cassini.yml` the
intended use is

`kas build \
meta-cassini-config/kas/cassini-sdk.yml:\
meta-cassini-config/kas/n1sdp.yml`

... rather than...

`kas build \
meta-cassini-config/kas/cassini.yml:\
meta-cassini-config/kas/cassini-sdk.yml:\
meta-cassini-config/kas/n1sdp.yml`

Update `Build, Deploy and Validate Cassini Image` to make this clearer

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

Inclusion of `EXTRA_IMAGE_FEATURES` complicates the build flow if
`IMAGE_FEATURES` is already present, instead we should append to it.

Therefore, refactor `cassini-sdk.inc` and `cassini-test.inc` to include
required `debug-tweaks` feature for distro.

This patch also fixes the typo.

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

When building with `cassini-dev` as DISTRO_FEATURE, the appropriate
image features are not turned on due to typo named as `cassini-devel`

This patch fixes the following:
* Remove `cassini-devel.inc`
* Add `cassini-dev.inc` to include `debug-tweaks` as IMAGE_FEATURE
* Update `cassini-distro-feature.bbclass` to reflect the above change

Changelog: bug
Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

The parsec cli tests include RSA key generation which is very slow.
The test action and job timeouts are increased to accommodate this.

Signed-off-by: Gowtham Suresh Kumar <gowtham.sureshkumar@arm.com>

The RSA key generation operation is very slow and this causes the
parsec-tool to timeout when the cli tests are executed. The parsec cli
test script can use a preset PARSEC_TOOL variable so this patch sets
this variable with sufficient timeout to complete the tests.

Signed-off-by: Gowtham Suresh Kumar <gowtham.sureshkumar@arm.com>

The Corstone-1000 FVP config refers to the uncompressed rootfs image
(.rootfs.wic.pad) however the build only deploys a compressed image
(.rootfs.wic.pad.gz). When following the instructions in the user guide
the Corstone-1000 FVP therefore fails to find the Cassini rootfs image
and falls back to the Corstone-1000 flash image.

Explicitly add wic.pad to IMAGE_FSTYPES for the FVP so that the
instructions in the user guide behave as expected.

This is not a problem for CI as the compressed image is extracted
automatically by LAVA.

Changelog: bug
Signed-off-by: Adam Johnston <adam.johnston@arm.com>

To allow us to pick up the fetch file fix in the templates we need to
move to a newer version.

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored May 12, 2023 and Drew Reed committed May 30, 2023

Enable the location of the sstate-cache common volume to be set based on
the host infrastructure the build is running on.

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored May 03, 2023 and Drew Reed committed May 30, 2023

To ensure the builds work on both kubernetes and docker+machine based
infrastructure we need to adopt the new template version the sets the
entry points to run or not in a deterministic manner.

Changelog: bug
Signed-off-by: Drew Reed <Drew.Reed@arm.com>

The correct syntax for `kas shell` is
    `kas shell [-c COMMAND]`
or
    `kas shell [--command COMMAND]`
rather than
    `kas shell [-c=COMMAND]`

Anything else may work with a given kas version (by design or by
accident) but is not documented behavior

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

As there is a difference in usage between `kas` and `kas-container` when
building images for the Corstone-1000 FVP, add `kas-container` command
lines to the FVP user guide

This is a minor change to align langdale-dev with main

Signed-off-by: Adam Johnston <adam.johnston@arm.com>

Lava uses pexpect to search for prompts, which includes all the output
on the connection. Having a prompt with a wildcard like (*.) in
beginning of the search string, the pexpect is asked to match against
an extremely large and growing input string, which causes significant
delays in processing job output.

This fixes the sanity and ptest job which takes more than time on
lava farm to reach the boot stage. Also update the timeouts of tasks
in the job.

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

Split the ptest for nightly/weekly and Merge request runs:
The intention is to only run short-duration tests for each
merge request raised and longer tests for nightly/weekly
* `Merge request` run includes:
  user-accounts-integration-tests, container-engine-integration-tests
  and k3s-integration-tests
* nightly/weekly run include parsec-simple-e2e-tests and all tests
  from `Merge request` run

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

Run the ptest-runner as a `test` user rather than root, this fixes the
issue with the user access where `bats` is being invoked as a `test`
user by ptest framework running as `root`

All ptest-runner suites should be invoked as `test` user

The `test` user should be able to access necessary drivers and not
require `root` access

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

Remove the old v1.6.1 compatibility and use v1.9.0 recipe from meta-oe

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

The original use of CI_REGISTRY/CI_PROJECT_PATH results in invalid
registry access paths as the CI_PROJECT_PATH could contain uppercase
letters that are not allowed in registry paths.  The change switches to
the correctly formatted CI_REGISTRY_IMAGE variable in image references.
Switch to new template version with the change to using
CI_REGISTRY_IMAGE included.

Changelog: bug
Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Lava uses pexpect to search for prompts, which includes all the output
on the connection. Having a prompt with a wildcard like (*.) in
beginning of the search string, the pexpect is asked to match against
an extremely large and growing input string, which causes significant
delays in processing job output.

This fixes the sanity and ptest job which takes more than 6 hours on
lava farm to reach the boot stage. Also update the timeouts of tasks
in the job.

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

Drew Reed authored Apr 12, 2023 and Drew Reed committed Apr 13, 2023

The Corstone-1000 MPS3 sanity test should ensure the board can boot to a
state where it is able to run tests.As the tests should be run as root
we need to ensure the default cassini user is able to switch to the root
user automatically when required.
The prompt string has also been updated to be consistent with the FVP
sanity script so that it no longer matches an earlier string in the boot
log.

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Apr 12, 2023 and Drew Reed committed Apr 13, 2023

Add the running of a sanity boot test for the corstone1000-fvp images

Changelog: other
Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Jan 31, 2023 and Drew Reed committed Apr 13, 2023

Build the Corstone-1000 FVP into a docker container for use in lava.
Use the same version of the FVP that the yocto build fetches.

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Apr 06, 2023 and Drew Reed committed Apr 13, 2023

Update the ci pipeline to build images for the corstone1000-fvp machine.

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Jan 30, 2023 and Drew Reed committed Apr 13, 2023

Modify the documentation to include corstone1000-fvp details

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Jan 30, 2023 and Drew Reed committed Apr 13, 2023

Modify the kas configurations to add corstone1000-fvp as a new target
and setup other files to allow the FVP build to complete.

Changelog: feature
Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Apr 06, 2023 and Drew Reed committed Apr 13, 2023

Moved the Corstone-1000 specific items out of the generic distro layer
and into the bsp layer where machine specific settings should live.

Changelog: other
Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Apr 06, 2023 and Drew Reed committed Apr 13, 2023

Includes the build directory in the spellcheck exclude list so the
checker can be run locally after a build has been done.
Fixes the include pattern for the meta-cassini-* directories so it
matches correctly.
Remove non-existent /gitlab directory from the exclude list.
Add used words to the dictionary to clear remaining existing issues.

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Apr 03, 2023 and Drew Reed committed Apr 13, 2023

Split the definition of `.if-new-merge-request` over 2 lines to meet the
yamllint 80 character line length rule

Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Drew Reed authored Mar 17, 2023 and Drew Reed committed Apr 13, 2023

As recommended by the yocto project we should explicitly set the
DISTRO_FEATURES variable to ensure we only build packages/features we
need. The results in a significant reduction in the number of
packages being built.

Changelog: other
Signed-off-by: Drew Reed <Drew.Reed@arm.com>

Align ACS, ptest and Sanity jobs with similar flashing firmware
timeout minutes and retry option.

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

Key guidance on commit structure and message content is buried in the
linked documents (some of which contain broken links). Provide a working
link to the Linux kernel patch guidance and summarise key points here.

Changelog: other
Signed-off-by: Adam Johnston <adam.johnston@arm.com>

Set the required timeout for the image pushed to SD card to 120
seconds. This fixes the issue with ACS job for N1SDP, where
deployer was timing out at 30 seconds.

Signed-off-by: Vikas Katariya <vikas.katariya@arm.com>

Job execution is taking longer than 3 hours. The fix uses
the 'retry' keyword to run the job again when that
specific error occurs.

Signed-off-by: Deborah Awoyemi <Deborah.Awoyemi@arm.com>