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 Pie android-9.0.0_r34 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 from http://git.ti.com/ti-linux-kernel/ti-linux-kernel,
which the version is based on version 4.19.
The kernel is built with linaro toolchain gcc7.3 32bit version, which could be gotten from here:
https://android-git.linaro.org/prebuilts/gcc/linux-x86/arm/gcc-linaro-7.3.1-2018.05-x86_64_arm-eabi.git/

The userspace components are built with AOSP prebuilt clang binary,
which the version is “Android (4691093 based on r316199) clang version 6.0.2”

The AOSP software provided in this release is functionally
tested with version 9.0 R7 based CTS package and VTS package generated based on the android-vts-9.0_r8 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 is based Pie android-9.0.0_r34
• CTS test package updated to use 9.0 R7 version
• VTS test package updated to use 9.0 R8 version
• The security patch is 2019-03-05
• Kernel is based on 4.19 version with PVR source included

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:

• P-RLCR-PATCHSET
• x15-p-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

Here are some known issues for this release build:

• Boottime test failed to run to complete because of the change on framework side, investigation in progress
• Piglit and media codec tests not enabled, work is in progress.
• Some apk benchmark tests failed to run to complete because of graphics problem.
• The CTS test pass rate is 99%, 525 of 163221 test cases were reported as failure.
  • Most of the CTS failures were repported by the modules of CtsNetTestCases and CtsNativeHardwareTestCases,which were created as Bug 4593 and Bug 4591
• The VTS test pass rate is 43%, 4075 of 7220 test cases were reported as failure.
  • Most of the vts failures were reported by the BionicUnitTests and BionicUnitTestsStatic modules, which were reported as Bug 4635 and Bug 4633

All the test failures reported by this release build had been created as bugs on Linaro bugzilla.
With fixes applied, some of them might be closed, new bugs might be created as well when new changes merged.
To see the latest status of bugs for this LCR X15 Pie build, please check please check here LCR X15 Pie open bugs

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 U-Boot ti-u-boot-2019.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-2019.01 branch from repository of git://git.ti.com/ti-u-boot/ti-u-boot.git

Getting Linaro AOSP Source Code and Compiling firmware, kernel, AOSP images

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

• Establishing a Build Environment as described here
• Download the Linaro LCR building script
• Run the linaro-build.sh script downloaded, and answer the questions when promopted

Download the Linaro LCR build script

Download the Linaro LCR building script linaro-build.sh as following for projects repo sync and patch applying;

$ mkdir workspace && cd workspace           # create new directory as workspace, using existing workspace would be OK as well
$ wget https://android-git.linaro.org/android-build-configs.git/plain/linaro-build.sh -O linaro-build.sh          # get the linaro-build.sh script
$ chmod +x linaro-build.sh                          # make it executable

Repo sync projects and build images

Run as following to start repo syncing and build firmwares, kernel, Android images for the X15 board:

$ ./linaro-build.sh -c lcr-reference-x15-p # To build from the tip of the branch

This command would help to repo sync all the AOSP and necessary projects, apply necessary patches,
and build the firmware, kernel, Android images together.

And you could specify other options to use local mirror, only repo sync projects, only build images, etc.
Most commonly used options for linaro-build.sh are like following:

$ ./linaro-build.sh -h                              # To print the script usage
$ ./linaro-build.sh -c lcr-reference-x15-p -ss      # Only build images for X15 board without repo syncing AOSP source and applying patches
$ ./linaro-build.sh -c lcr-reference-x15-p -m <url-aosp-mirror-manifest>     # Use local mirror for AOSP projects repo syncing
$ ./linaro-build.sh -c lcr-reference-x15-p -pm <pinned_manifest>             # To recreate the exact same build with the pinned manifest specified.

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

For example, to build from the tip of the source:

./linaro-build.sh -c lcr-reference-x15-p  or  ./linaro-build.sh -c lcr-reference-x15-p -m  <url-aosp-mirror-manifest>

Or to reproduce the exactly the same as this buid:

./linaro-build.sh -c lcr-reference-x15-p -pm pinned-manifest.xml or ./linaro-build.sh -c lcr-reference-x15-p -pm pinned-manifest.xml -m  <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/beagle_x15/MLO
    $ fastboot flash bootloader out/target/product/beagle_x15/u-boot.img
    $ fastboot flash boot out/target/product/beagle_x15/boot_fit.img
    $ fastboot flash system out/target/product/beagle_x15/system.img
    $ fastboot flash userdata out/target/product/beagle_x15/userdata.img
    $ fastboot flash vendor out/target/product/beagle_x15/vendor.img