Troubleshooting Guide

Introduction

The documentation for Armv-A Base AEM FVP platform software typically suffices in most cases but there could be certain host development machine dependencies that could cause failures either during the build or execution stages. This page provides solutions for known issues that could affect the use of the platform software stack.

Error while using repo command

The repo init or repo sync command fails with the below listed error message.

File "<path-to-workspace>/.repo/repo/main.py", line 79
file=sys.stderr)
    ^
SyntaxError: invalid syntax

The typical reason for this failure could be that the default version of python on the development machine is not Python3.6. To resolve this issue, install the latest version of python, if not already installed on the development machine and invoke the repo command from /usr/bin/ with python3 as listed below.

python3 /usr/bin/repo init \
              -u https://git.gitlab.arm.com/arm-reference-solutions/arm-reference-solutions-manifest.git \
              -m pinned-aemfvp-a.xml \
              -b refs/tags/AEMFVP-A-2021.09.20

python3 /usr/bin/repo sync

Builds do not progress to completion

During the build of the platform software stack, components such as GRUB download additional code from remote repositories using the git port (or the git protocol). Development machines on which git port is blocked, the build does not progress to completion, waiting for the additional code to be downloaded. This typically is observed when setting up a new platform software workspace.

As a workaround, use https instead of git protocol for cloning required git submodules of the various components in the software stack. A patch, as an example of this change in the GRUB component, is listed below.

diff --git a/bootstrap b/bootstrap
index 5b08e7e2d..031784582 100755
--- a/bootstrap
+++ b/bootstrap
@@ -47,7 +47,7 @@ PERL="${PERL-perl}"

 me=$0

-default_gnulib_url=git://git.sv.gnu.org/gnulib
+default_gnulib_url=https://git.savannah.gnu.org/git/gnulib.git

 usage() {
   cat <<EOF

FVP closes abruptly

Tests such as distribution installation take few hours to complete on Armv-A Base AEM FVP. If the model quits abruptly during its execution without any particular error message displayed on the model launch window, the host machine’s memory requirements have to be rechecked. Refer to the model document for more information about the system requirements and follow the recommended configurations.

Repo sync fails when downloading Linux repo

If the download of the Linux repo fails during the execution of the ‘repo sync’ command, rerun the repo init command with the “–depth=1” parameter appended to the repo init command. This parameter reduces the commit history that is downloaded and can reduce the failures in downloading Linux repo.

Copyright (c) 2021, Arm Limited. All rights reserved.