Linaro Releases

About the Reference Linaro Confectionary Release for AM572x Evaluation Module(referred to as X15 in this document)

This Reference Linaro Confectionary Release is the release for X15 board,
it is based on the Oreo android-8.1.0_r29 branch. This build is a
userdebug variant build, which contains support for allowing full use of the
Cortex-A15 architecture, supports 32-bit applications, and run in permissive mode.

The kernel used for this build is mirror from http://git.ti.com/android/kernel,
built with linaro toolchain 32bit gcc7.2.
The version is based on version 4.14.

The userspace components are built with AOSP prebuilt clang binary,
the version is “Android clang version 5.0.300080 (based on LLVM 5.0.300080)”

The AOSP software provided in this release is functionally
tested with version 8.1 R5 based CTS package and VTS package generated from oreo-mr1-vts-release branch,
the test results of both CTS and VTS are shared with members.
We also added some benchmark tests to observe the
performance trend in various fields.

Sources are also made available so you can build your own images
(see the Building from Source tab).

What is new

• AOSP source updated to base on android-8.1.0_r29 version
• CTS test package update to use 8.1 R5 version
• The security patch is 2018-05-05
• Kernel based on 4.14 kernel
• U-boot is updated to use ti-u-boot-2018.01 branch.
• lunch command change to am57xevm_full-userdebug
• Update to use linaro gcc7.2 32bit toolchain for both kernel and u-boot compiling

ChangeLog

Please check the changelog.txt for details to see what Linaro has done on top of AOSP android-8.1.0_r29.

Support

Subscribe to the important Linaro mailing lists and join our IRC
channels to stay on top of Linaro development.

• Linaro Android Development ‘Mailing list’
• Linaro Android IRC channel on irc.freenode.net at #linaro-android
• Linaro Android ART IRC channel on irc.freenode.net at #linaro-art
• Bug reports should be filed in ‘Bugzilla’ under “Linaro Android” product and “R-LCR-X15” component.
  • You will need to login to your Linaro account. If you do not have an account or are having problems, email it-support@linaro.org for help.
• More general bug reports should be filed in Bugzilla against the individual packages that are affected.
• Questions? ‘ask linaro’
• Interested in commercial support? inquire at ‘Linaro Support’

AOSP Patch Summary

There are patches developed by TI and Linaro engineering teams were applied
to get AOSP booting to UI on the X15 development platform.
These patches can be found on Linaro Git repositories via files:

• O-RLCR-PATCHSET
• x15-o-workarounds
  Some of these patches have been submitted to AOSP and are being tracked
  for acceptance.

Any patches can be contributed through the instructions described Here

Known Issues and Limitations

Known issues

The following known issues are present in this release. Please contact support@linaro.org if you wish to know more information about these issues or have access problems when attempting to view them.

Bug ID	Bug title	Bug summary
Bug 2768	X15: Media codecs functional has failures
Bug 2970	Hikey/X15: linaro_android_kernel_test sync_basic_try_open FAILED
Bug 3367	HiKey/X15: CtsUsbTests failed on lava
Bug 3368	HiKey/X15: CtsThemeHostTestCases failed with hikey/x15 oreo reference builds
Bug 3442	X15: oreo build cts test armeabi-v7a.CtsMediaStressTestCases only has 1 pass of 120 test cases
Bug 3445	X15: vts-hal has failures with the oreo build
Bug 3446	X15: vts-library has failures with the oreo build
Bug 3447	X15: vts-performance has failures with oreo build
Bug 3448	HiKey/X15: piglit-gles3 has 0 pass with oreo build
Bug 3473	X15: armeabi-v7a.CtsCameraApi25TestCases has 0 pass with oreo build
Bug 3553	X15/HiKey: rl-sqlite failed with 8.1.0_r2 builds
Bug 3554	X15: vts-kernel-ltp has failures with oreo build
Bug 3555	X15: vts-kernel-part1 has failures with oreo build
Bug 3556	X15: some armeabi-v7a.CtsJvmtiXXX series test cases failed
Bug 3583	X15: armeabi-v7a.CtsAppTestCases has failures
Bug 3584	X15: armeabi-v7a.CtsContentTestCases has failures
Bug 3586	X15: armeabi-v7a.CtsLibcoreTestCases has failures
Bug 3587	X15: armeabi-v7a.CtsWidgetTestCases has failures
Bug 3588	X15: armeabi-v7a.CtsSecurityHostTestCases has failures
Bug 3589	X15: armeabi-v7a.CtsSecurityTestCases has failures
Bug 3590	X15: armeabi-v7a.CtsViewTestCases
Bug 3833	X15-4.14: vellamo3 test failed to run with PVR_K info printed on serial console
Bug 3840	X15-4.14: monkey test failed to run to complete
Bug 3841	X15-4.14: armeabi-v7a.CtsAtraceHostTestCases has 3 failures
Bug 3842	X15-4.14: armeabi-v7a.CtsDevicePolicyManagerTestCases has 189 failures
Bug 3844	X15: armeabi-v7a.CtsNetTestCases has failures related to connectivity and wifi
Bug 3850	X15-4.14: armeabi-v7a.CtsTelecomTestCases2 failed to run to complete
Bug 3851	X15-4.14: TOTAL_BOOT_TIME regression with about 200% slow

Prerequisites

Get “OTG cable” and “Serial console cable” connected between the X15 board and your PC.

If this is the first time you use X15 board, please reference Booting Android-O on AM57x EVM / BeagleBoard X15 boards for the initial setup instructions.
And update the MLO and u-boot.img form this release with the instructions from Flashing_U-Boot_to_eMMC section,
since the images here need to use the u-boot files generated from the ti-u-boot-2018.01 branch from repository of git://git.ti.com/ti-u-boot/ti-u-boot.git

Get artifacts

Click on each link to download:

• MLO
• u-boot.img
• boot_fit.img
• system.img
• userdata.img
• vendor.img

Boot X15 board to fastboot mode

Press power or reset button to start the X15 board, and on the serial console,
get to U-Boot shell on device and run next command to enter fastboot mode:

    => fastboot 1

Then on the host side, run following command to make sure it’s in fastboot mode:

$ fastboot devices
0e005017394200e2    fastboot
$

Flash images

Flash the downloaded image files into the X15 board under fastboot mode with
following commands:

$ fastboot erase environment
$ fastboot oem format
$ fastboot flash xloader MLO
$ fastboot flash bootloader u-boot.img
$ fastboot flash boot boot_fit.img
$ fastboot flash system system.img
$ fastboot flash userdata userdata.img
$ fastboot flash vendor vendor.img

Boot X15 board with AOSP images

Run “fastboot reboot” or press the reset button to restart X15 board
after the fastboot flash commands, then the X15 board will boot with
the AOSP images just flashed.

You can use following command to check if the adb connection is connected:

$ adb devices
List of devices attached
0e005017394200e2  device
$

Prerequisites

Get “OTG cable” and “Serial console cable” connected between the X15 board and your PC.

If this is the first time you use X15 board, please reference Booting Android-O on AM57x EVM / BeagleBoard X15 boards for the initial setup instructions.
And update the MLO and u-boot.img form this release with the instructions from Flashing_U-Boot_to_eMMC section,
since the images here need to use the u-boot files generated from the ti-u-boot-2018.01 branch from repository of git://git.ti.com/ti-u-boot/ti-u-boot.git

Linaro AOSP Source Code

Download the AOSP building script linaro_android_build_cmds.sh for this build
from the list of artifacts listed above, and run it.
This script will help to download the entire source code of AOSP and attempt to build it.

Most commonly used options for linaro_android_build_cmds.sh:

$ ./linaro_android_build_cmds.sh -h #To print the script usage
$ ./linaro_android_build_cmds.sh -t #To build from the tip of the branch without overlay
$ ./linaro_android_build_cmds.sh -t -u <url-aosp-mirror-manifest> #As -t, but repo sync from local mirror
$ ./linaro_android_build_cmds.sh -m <pinned_manifest> #To reproduce an exact build from pinned manifest
$ ./linaro_android_build_cmds.sh -m <pinned_manifest> -u <url-aosp-mirror-manifest> #As -m, but repo sync from local mirror

The pinned manifest(pinned-manifest.xml(?) and source manifest(source-manifest.xml) can be found from the list of artifacts

Compiling Linaro AOSP RootFS

The following simple steps download, install and compile a complete Linaro AOSP distribution

• Download and install Ubuntu 14.04 64 bit or newer (download)
• Download the AOSP building script for this build from the list of artifacts
• Run the linaro_android_build_cmds.sh script downloaded, and answer the questions when promopted

Build from the tip of the source:

chmod a+x linaro_android_build_cmds.sh
export UBOOT_TOOLS_PREFIX=prebuilts/gcc/linux-x86/arm/arm-linux-androideabi-7.2-linaro/bin/arm-linux-androideabi-
export KERNEL_TOOLS_PREFIX=prebuilts/gcc/linux-x86/arm/arm-linux-androideabi-7.2-linaro/bin/arm-linux-androideabi-
./linaro_android_build_cmds.sh -t or  ./linaro_android_build_cmds.sh -t -u <url-aosp-mirror-manifest>

Or reproduce the exactly the same as this buid:

chmod a+x linaro_android_build_cmds.sh
export UBOOT_TOOLS_PREFIX=prebuilts/gcc/linux-x86/arm/arm-linux-androideabi-7.2-linaro/bin/arm-linux-androideabi-
export KERNEL_TOOLS_PREFIX=prebuilts/gcc/linux-x86/arm/arm-linux-androideabi-7.2-linaro/bin/arm-linux-androideabi-
./linaro_android_build_cmds.sh -m pinned-manifest.xml or ./linaro_android_build_cmds.sh -m pinned-manifest.xml -u <url-aosp-mirror-manifest>

Deploy AOSP Images to your x15 board

Following commands will flash the images into your x15 board via the fastboot command.

    $ fastboot erase environment
    $ fastboot oem format
    $ fastboot flash xloader out/target/product/am57xevm/MLO
    $ fastboot flash bootloader out/target/product/am57xevm/u-boot.img
    $ fastboot flash boot out/target/product/am57xevm/boot_fit.img
    $ fastboot flash system out/target/product/am57xevm/system.img
    $ fastboot flash userdata out/target/product/am57xevm/userdata.img
    $ fastboot flash vendor out/target/product/am57xevm/vendor.img