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 first release for X15 board,
it is based on the Nougat android-7.1.0_r7 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 the prebuilt 4.4 version kernel.

The sources are built with AOSP LLVM 3.8 clang-2690385 (based on LLVM 3.8.256229),
and gcc 4.9 for 32bit.

The Android AOSP software provided in this release is functionally
tested with CTS version 7.0 R2 and the CTS results 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

• Android source updated to base on android-7.1.0_r7 version which has following features:
• Updated to use CTS 7.0 R2 for test

ChangeLog

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

License

The use of HiKey software is subject to the terms of the HiKey:
End User License Agreement.

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 “Member Linaro Confectionery Release (M-LCR)” component.
  • You will need to login to your Linaro account. If you do not have an account or are having problems, email its@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’

Known Issues and Limitations

Known limitations

• Boot prompt on serial console some times displayed not correctly

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 2633	LCR: X15: shell prompt shows root as orot
Bug 2617	Bluetooth Share keeps stopping
Bug 2616	bootchart caused reboot on x15 builds
Bug 2614	CTS CtsDeqpTestCases module cause x15 adb connection over tcpip lost
Bug 2614	CTS test of module CtsDevicePolicyManagerTestCases causes x15 adb connection over tcpip lost

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 here for the initial setup instructions.
And following instructions assumed that your have flashed the “Pre-built Android-N images for AM57x EVM” images once metioned here.

Get artifacts

Click on each link to download:

• boot.img
• system.img
• userdata.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 flash boot boot.img
$ fastboot flash system system.img
$ fastboot flash userdata userdata.img

Boot X15 board with Android 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 android images just flashed.

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

$ adb devices
List of devices attached
0e005017394200e2  device
$

Linaro Android Source Code

Download the Android 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 for Android 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 Android RootFS

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

• Download and install Ubuntu 14.04 64 bit or newer (download)
• Download the Android 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
./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
./linaro_android_build_cmds.sh -m pinned-manifest.xml or ./linaro_android_build_cmds.sh -m pinned-manifest.xml -u <url-aosp-mirror-manifest>

Installing Android to your HiKey Board

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

    $ fastboot flash boot out/target/product/am57xevm/boot.img
    $ fastboot flash system out/target/product/am57xevm/system.img
    $ fastboot flash userdata out/target/product/am57xevm/userdata.img