Qualcomm Technologies, Inc. MSM8909.LA.1.1 Linux Android Release 1.1.23 for MSM8909 Devices Release Notes for MSM8909_LA_1_1-01123 80-NT958-9 A February 26, 2015 Confidential and Proprietary – Qualcomm Technologies, Inc. © 2015 Qualcomm Technologies, Inc. and/or its affiliated companies. All rights reserved. NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to: [email protected]. Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the express written permission of Qualcomm Technologies, Inc. Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm Technologies, Inc. or its affiliated companies without the express approval of Qualcomm Configuration Management. Qualcomm is a trademark of Qualcomm Incorporated, registered in the United States and other countries. All Qualcomm Incorporated trademarks are used with permission. Other product and brand names may be trademarks or registered trademarks of their respective owners. This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and international law is strictly prohibited. Qualcomm Technologies, Inc. 5775 Morehouse Drive San Diego, CA 92121 U.S.A. Revision history Revision Date Description A Feb 2015 Initial release of documentation for MSM8909.LA.1.1 Linux Android Release 1.1.23 for MSM8909 Devices (MSM8909_LA_1_1-01123) 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 3 Confidential and Proprietary – Qualcomm Technologies, Inc. Contents 1 Getting Started ................................................................................................. 6 1.1 Downloading QTI proprietary software from ChipCode .............................................. 6 1.2 Downloading open source HLOS software .................................................................. 7 1.3 Build components and commands ................................................................................ 7 1.3.1 Modify MPSS map .......................................................................................... 11 1.4 Supporting documentation .......................................................................................... 12 2 Supported ASICs and Memory Configuration ............................................. 14 3 New Features ................................................................................................. 19 4 Bugs and Limitations .................................................................................... 20 4.1 New ............................................................................................................................. 20 4.1.1 Ongoing ........................................................................................................... 20 4.2 Resolved ...................................................................................................................... 20 5 Test Reports ................................................................................................... 21 5.1 CTS test report ............................................................................................................ 21 5.2 MSM8909 + PM8916 modem power dashboard ........................................................ 22 5.3 MSM8909 + PM8916 multimedia power dashboard .................................................. 23 5.4 MSM8909 + PM8909 modem power dashboard ........................................................ 24 5.5 MSM8909 + PM8909 multimedia power dashboard .................................................. 25 A Cumulative Features ..................................................................................... 26 B Apache License ............................................................................................. 34 C OZPLA License ............................................................................................. 35 D OKL4 Software .............................................................................................. 37 E References ..................................................................................................... 38 E.1 Related documents ..................................................................................................... 38 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 4 Confidential and Proprietary – Qualcomm Technologies, Inc. Release Notes for MSM8909_LA_1_1-01123 Contents Figures Figure 2-1 MSM8909 memory map diagram ............................................................................................ 16 Figure 2-2 Relocatables partition of MSM8909 memory map .................................................................. 17 Figure 2-3 MPSS_EFS/SBL (BOOT) partition of MSM8909 memory map ............................................. 17 Figure 2-4 MSM8909 1GB illustrative memory map diagram .................................................................. 17 Tables Table 1-1 Android build information ......................................................................................................... 10 Table 1-2 Meta flavor description .............................................................................................................. 11 Table 2-1 Performance-optimized DDR frequency plan ........................................................................... 18 Table 2-2 GPU frequency performance ..................................................................................................... 18 Table 5-1 MSM8909 + PM8916 modem power dashboard....................................................................... 22 Table 5-2 MSM8909 + PM8916 multimedia power dashboard ................................................................ 23 Table 5-3 MSM8909 + PM8909 modem power dashboard....................................................................... 24 Table 5-4 MSM8909 + PM8909 multimedia power dashboard ................................................................ 25 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 5 Confidential and Proprietary – Qualcomm Technologies, Inc. 1 Getting Started This is a pre-CS release. NOTE: 1.1 Downloading QTI proprietary software from ChipCode QTI software can be downloaded from the ChipCode™ website. Designated points of contact in your organization can download the licensed software. The software is organized into distribution packages (distros) composed of subsystem image files. Each distro has a corresponding Git project. The Git tree includes revisions for previous builds that allow you to diff the changes between releases. 1. If you are new to ChipCode, review the following link for up-to-date documentation and a set of tutorial videos: https://chipcode.qti.qualcomm.com/projects/help/wiki 2. Create a top-level directory on the build PC and unzip each of the subsystem images to generate the following directory structure. In this example, <target_root> is the top-level directory. <target_root> /common/ /boot_images/ /common/ /modem_proc/ /rpm_proc/ /trustzone_images/ /cnss_proc/ /LINUX/ contents.xml 3. Ensure that the contents.xml file is located in the root folder as shown above. 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 6 Confidential and Proprietary – Qualcomm Technologies, Inc. Release Notes for MSM8909_LA_1_1-01123 Getting Started 1.2 Downloading open source HLOS software The Linux Board Support Package (BSP) release is obtained in two parts, a proprietary release from ChipCode and an open source release from the Code Aurora Forum (CAF) site. 1. Open the contents.xml file that was downloaded from ChipCode (see Section 1.1) and search for the <name>apps</name> tag. 2. Below this tag, locate the <build_id> tag. This identifies the corresponding open source HLOS software build. For example: <build_id> LA.BR.1.2.3-02510-8x09.0</build_id> 3. Follow the instructions listed at https://www.codeaurora.org/xwiki/bin/QAEP/release (look under the Branch releases section) to find the APSS build ID in the released software. 4. In an empty directory, use the repo init command with the correct branch and manifest as indicated in the branch releases table. $ repo init -u git://codeaurora.org/platform/manifest.git -b release -m [manifest] –repo-url=git://codeaurora.org/tools/repo.git 5. Type the repo sync command. $ repo sync 6. After the repo sync finishes, copy the vendor/qcom/proprietary directory tree from the proprietary HLOS release into the open source HLOS source tree contained in your workspace. $cp -r <LYA_build_location>/HY11-<build_id>/LINUX/android/*. 1.3 Build components and commands Build commands, required tools, and supported build environments for each component are listed in the following table. Supported Build Required tool build Build commands component version environments MPSS Linux Hexagon Build images – ./build.sh 8909.gen.prod -k Windows tool set Clean the build –./build.sh 8909.gen.prod -c 6.4.02 Python Ver For Windows, use build.cmd. 2.7.6 Perl Ver 5.14.2 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 7 Confidential and Proprietary – Qualcomm Technologies, Inc. Release Notes for MSM8909_LA_1_1-01123 Getting Started Supported Build Required tool build Build commands component version environments BOOT Linux ARM Compiler Windows Windows tools Build images 5.01 update 3 boot_images/build/ms/build.cmd (build 94) TARGET_FAMILY=8909 --prod Clean the build boot_images/build/ms/build.cmd -c TARGET_FAMILY=8909 –prod Linux Build images boot_images/build/ms/build.sh TARGET_FAMILY=8909 --prod Clean the build boot_images/build/ms/build.sh -c TARGET_FAMILY=8909 --prod Depending on the configuration, edit the script boot_images/build/ms/build_8909.sh to change if [ -e “setenv.sh” ]; then - source setenv.sh + source ./setenv.sh fi RPM Linux ARM Compiler Windows Windows tools Build images 5.01 update 3 rpm_proc/build/build_8909.bat (build 94) Clean the build rpm_proc/build/build_8909.bat -c Linux build Build images rpm_proc/build/build_8909.sh Clean the build rpm_proc/build/build_8909.sh -c CNSS Binary only – – 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 8 Confidential and Proprietary – Qualcomm Technologies, Inc. Release Notes for MSM8909_LA_1_1-01123 Getting Started Supported Build Required tool build Build commands component version environments TZ Linux ARM Compiler Linux Windows Tools 5.01 Build images – ./build.sh CHIPSET=msm8909 tz update 3 (build sampleapp tzbsp_no_xpu playready widevine 94) isdbtmm aostlm securitytest keymaster commonlib Clean the build – ./build.sh CHIPSET=msm8909 tz sampleapp tzbsp_no_xpu playready widevine isdbtmm aostlm securitytest keymaster commonlib –c Windows Build images – build.cmd CHIPSET=msm8909 tz sampleapp tzbsp_no_xpu playready widevine isdbtmm aostlm securitytest keymaster commonlib Clean the build – build.cmd CHIPSET=msm8909 tz sampleapp tzbsp_no_xpu playready widevine isdbtmm aostlm securitytest keymaster commonlib –c APSS Linux only Ubuntu Linux 12.04 Build images arm-linux- 1. In a BASH shell, navigate to the Android source androideabi- tree base directory. gcc (GCC) 4.7 cd <build id>/LINUX/android 2. Enter the following command to configure the build environment shell settings. source build/envsetup.sh You must use the source command so that the environment settings are defined in the current shell. 3. Enter the lunch command to select the build configuration, or enter with no parameters to see an interactive menu for making selections. lunch msm8909-userdebug 4. Run make to start the build (shown with –j 16 option to run parallel builds for faster build times on a multicore build machine). make –j4 For complete build instructions, see MSM8909 Linux Android Software User Manual Software Product Document [SP80-NR964-4]. For the build components and IDs, refer to the about.html file in the root of the repository on Qualcomm ChipCode. 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 9 Confidential and Proprietary – Qualcomm Technologies, Inc. Release Notes for MSM8909_LA_1_1-01123 Getting Started Table 1-1 shows the Android build information for this release. Also, the CAF website is provided. Table 1-1 Android build information Android Date Tag/Build ID Chipset Manifest version Lollipop 02/26/2015 LA.BR.1.2.3-03110-8x09.0 MSM8909 LA.BR.1.2.3-03110-8x09.0.xml 05.00.02 CAF website information for this release: https://www.codeaurora.org/cgit/quic/la/platform/manifest/tag/?id=LA.BR.1.2.3-03110-8x09.0 Look for the project name platform/vendor/qcom/ferrum.git for MSM8909. NOTE: QMSS software strip procedure To strip-off QMSS software, AMSS customers must run the following commands before starting the compilation: rm -rf vendor/qcom/proprietary/qrdplus rm -rf packages/apps/FastPowerOn Segment loading is enabled for TD-SCDMA; refer to MSM8x09 Chipset Software Overview NOTE: [80-NR964-2] for NV settings. For TD-SMCDA camping – NV 72542 must (Bitmap to enable specific segment) be set to 1 (segment) For WCDMA camping – NV 72542 must (Bitmap to enable specific segment) be set to 2 (segment) The size of MPSS + ADSP (VUnicore) image in Figure 2-1 (memory map) is 85 MB. Since there are different modem builds depending on the radio technologies and/or optimizations supported, refer to Table 1-2 to identify the actual size of the MPSS image as well as the start address of the relocatables section for the build variant that is being used. 80-NT958-9 A MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 10 Confidential and Proprietary – Qualcomm Technologies, Inc.