Testing ART on a model (QEMU or Arm FVP)

This document describes how to test ART on a model - QEMU or the ARM Fixed Virtual Platform.

It covers steps on how to build and run an Android system image targeting a model and to use it as a target platform for running ART tests via ADB in chroot mode. The guide covers both QEMU and the ARM Fixed Virtual Platform; the setup is very similar.

More information on QEMU and Arm FVP could be found in {AOSP}/device/generic/goldfish/fvpbase/README.md.

One would need two AOSP trees for this setup:

  • a full stable (tagged) tree - to be used to build AOSP image for the model.
    • android-13.0.0_r12 was tested successfully to run QEMU: repo init -u https://android.googlesource.com/platform/manifest -b android-13.0.0_r12
  • a full or minimal tree - the one to be tested as part of ART test run.

Setting up the QEMU/Arm FVP

Once a full AOSP tree is downloaded, please follow the instructions in ${AOSP}/device/generic/goldfish/fvpbase/README.md; they should cover:

  • fetching, configuring and building the model.
  • building AOSP image for it.
  • launching the model.

Once the model is started and reachable via adb, ART tests could be run.

Notes:

  • fvp_mini lunch target should be used as we don't need graphics to run ART tests.
  • 'Running the image in QEMU' mentions that a special commit should be checked out for QEMU for GUI runs. Actually it is recommended to use it even for non-GUI runs (fvp_mini).

Running the Arm FVP with SVE enabled

To test SVE on Arm FVP, one extra step is needed when following the instructions above; for QEMU run this is not needed. When launching the model some extra cmdline options should be provided for 'run_model':

export SVE_PLUGIN=${MODEL_PATH}/plugins/<os_and_toolchain>/ScalableVectorExtension.so
$ ./device/generic/goldfish/fvpbase/run_model --plugin ${SVE_PLUGIN} -C SVE.ScalableVectorExtension.veclen=2

Note: SVE vector length is passed in units of 64-bit blocks. So "2" would stand for 128-bit vector length.

Running ART test

QEMU/FVP behaves as a regular adb device so running ART tests is possible using the standard chroot method described in test/README.chroot.md with an additional step, described below. A separate AOSP tree (not the one used for the model itself), should be used - full or minimal.

Then the regular ART testing routine should be performed; the regular "lunch" target ("armv8" and other targets, not "fvp-eng").

# Config the test run for QEMU/FVP.
export ART_TEST_RUN_ON_ARM_FVP=true

# Build, sync ART tests to the model and run, see test/README.chroot.md.

Note: ART scripts only support one adb device at a time. If you have other adb devices connected, use export ANDROID_SERIAL=localhost:5555 to run scripts on QEMU/FVP."