Customizing an Android* OS with Intel Build Tool Suite for Android* v1.1 Process Guide

Size: px

Start display at page:

Download "Customizing an Android* OS with Intel Build Tool Suite for Android* v1.1 Process Guide"

Justin Carter
5 years ago
Views:

1 Customizing an Android* OS with Intel Build Tool Suite for Android* v1.1 Process Guide May 2015, Revision 1.5

2 INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. A Mission Critical Application is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death. SHOULD YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY, PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked reserved or undefined. Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling , or go to: literature.htm Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries. *Other names and brands may be claimed as the property of others. Copyright 2015, Intel Corporation. All rights reserved. Revision: 1.5 May

3 Revision History Revision History Date Revision Description May Revised screenshots, updated Android device setup procedures, and corrected minor errors. April Revised screenshots April Corrected typographic and procedural errors, revised screenshots and process steps for updated software build, added process steps for removing apps, and clarified the process to enable OEM unlocking April Updated all screenshots and added workflow for customizing OEM partition without selecting OS module. January Added flashing information and custom OS module layout information. Reorganized content. January Administrative edit December Initial release May 2015 Revision: 1.5 3

4 Contents Contents 1 Introduction to Intel Build Tool Suite for Android* Basic Function Description General Workflow Supported Devices Installing Intel Build Tool Suite for Android* Installing Intel BTS on Windows Next Steps Customizing an OEM Partition Create a Project in Intel BTS Customize an OEM Partition Build and Flash an OEM Partition Image Customizing an OS Module using Intel Build Tool Suite for Android* Downloading the OS Module Create a Project in Intel BTS Select an OS Customizing the Operating System Build the OS Image Flash the Device Unlocking a Device Flashing a Device Export Factory Archive A Boot Animation File...34 A.1 desc.txt A.2 Additional Resources Revision: 1.5 May

5 Introduction to Intel Build Tool Suite for Android* 1 Introduction to Intel Build Tool Suite for Android* This chapter explains Intel BTS and how it can be used. 1.1 Basic Function Description Intel BTS comprises several tools and scripts into one application. The graphical user interface makes it easy to access the functions of tools without requiring the expertise needed to use many separate command-line interfaces. 1.2 General Workflow Intel BTS provides a simple means to customize the OEM partition for an Android* Lollipop OS and then flash it to a device. As an option, you can select a different build of Lollipop and flash that to the device along with your OEM partition customizations. Intel BTS can not be used to build a custom OS image. 1.3 Supported Devices Intel BTS can only flash standard Android tablets. Other devices, such as MinnowBoard MAX development boards or Android phones can not be flashed with Intel BTS. May 2015 Revision: 1.5 5

Installing Intel Build Tool Suite for Android* 2 Installing Intel Build Tool Suite for Android* This chapter explains the process to install Intel BTS. 2.1 Installing Intel BTS on Windows Intel BTS has been designed for use with Windows* 7.

6 Installing Intel Build Tool Suite for Android* 2 Installing Intel Build Tool Suite for Android* This chapter explains the process to install Intel BTS. 2.1 Installing Intel BTS on Windows Intel BTS has been designed for use with Windows* 7. If you are running Windows* 8.x, Intel BTS is intended for use in desktop mode. 1. Copy the installer (such as bts <datecode>.exe) to your hard drive. 2. Navigate to the location where you saved the installer. Double-click to start the installer. Follow the onscreen prompts. 3. When prompted to choose components to install, if you do not have Phone Flash Tool installed, select Phone Flash Tool. Note: If you are unsure whether Phone Flash Tool is installed on your computer, select the option to install it. The installer will skip previously installed components. 2.2 Next Steps To customize an OEM partition without specifying an OS image, see Chapter 3. To customize an OS image, Chapter 4. Revision: 1.5 May

7 Customizing an OEM Partition 3 Customizing an OEM Partition This chapter explains the steps to customize an OEM partition using Intel Build Tool Suite for Android* without selecting an Android* operating system (OS) Module. 3.1 Create a Project in Intel BTS 1. Start Intel BTS. The main window, as shown in the example below, is displayed. 2. Click Start new project. May 2015 Revision: 1.5 7

Customizing an OEM Partition 3. In the New Project dialog, specify a name for your project. 4. Click Create project. The project window opens, with the Boot animation panel displayed.

8 Customizing an OEM Partition 3. In the New Project dialog, specify a name for your project. 4. Click Create project. The project window opens, with the Boot animation panel displayed. Since an OS has not yet been specified, the project window displays Android* 5.x, Lollipop as the OS. You may continue customizing the OEM partition without choosing an OS. To choose an OS, refer to Chapter 4, Customizing an OS Module using Intel Build Tool Suite for Android*. Revision: 1.5 May

9 Customizing an OEM Partition 3.2 Customize an OEM Partition 1. There are four customization panels, Boot animation, Theme, Apps, and Settings. In the Left Navigation pane, click the Panel buttons to display the Customization panels. 2. To specify a Boot animation file, on the Boot animation panel, click the +. May 2015 Revision: 1.5 9

10 Customizing an OEM Partition 3. To select a different wallpaper to be displayed on the device, click Theme. The Wallpaper panel is displayed. Note: To preview the wallpaper in landscape and portrait mode, hover your cursor over one of the wallpapers in the palette, as shown below: Revision: 1.5 May

Customizing an OEM Partition 4. Select one of the pre-loaded wallpaper images or click the + to navigate to a folder that contains a wallpaper image.

11 Customizing an OEM Partition 4. Select one of the pre-loaded wallpaper images or click the + to navigate to a folder that contains a wallpaper image. Customizing a Lollipop OS allows you to add Live wallpaper apps by clicking the lower +, as shown in the screenshot below: Note: If you add a live wallpaper app and do not intend to select an OS to customize, after flashing the OEM partition, you must do a factory reset to see the live wallpaper app on the device. 5. To deselect a wallpaper, in the palette, click the selected wallpaper, as shown below: 6. To add apps to the customization, click Apps. The Apps selection panel is displayed. May 2015 Revision:

Apps that are added to the OS image are displayed in the Apps panel, as

To remove all apps, click the circle arrow button, as shown in the example

12 Customizing an OEM Partition 7. To select apps to be added to the customization, click the + as shown below: Apps that are added to the OS image are displayed in the Apps panel, as shown below. Note: The app files should be standard Android APK files. 8. To remove all apps, click the circle arrow button, as shown in the example above. To remove individual apps, click the trash can icon. a. The app icons display a Select circle. Revision: 1.5 May

rebuild the OEM partition before you can flash the device.

13 Customizing an OEM Partition b. Select the apps to be removed. c. Click the to remove the selected apps. The selected apps are removed. Note: If you make any changes to your customizations after you have built the OEM partition, such as to remove an app from the customization, you must rebuild the OEM partition before you can flash the device. Intel BTS will remind you of this and will give you the option to rebuild the OEM partition prior to flashing. 9. Customizing a Lollipop OS also allows you to customize the default language and region on the device by selecting Settings. May 2015 Revision:

14 Customizing an OEM Partition 10. To change the settings, click the dropdown menu and select the desired language and region. 3.3 Build and Flash an OEM Partition Image After specifying the customizations for the OEM partition, you can build the partition and flash a device. To complete this process, the device must already have an OS on it and the space for the OEM partition must be sufficient to hold the new OEM partition. For example, Intel Reference Design for Android* images have a 100MB OEM partition. If you have flashed a device with an Intel RD for Android image, the device should provide sufficient room for a wallpaper and a small additional app. If a newly created OEM partition exceeds the original partition size, Intel BTS will display an error message and will not flash the device. Unfortunately, there is no way to determine the size of a newly created OEM partition file prior to flashing. 1. From the Build menu, select Build OEM partition image. Revision: 1.5 May

15 Customizing an OEM Partition The image is saved in the project directory in the build folder and is ready to be flashed to the device. When the build process completes, the following dialog is displayed: To save the image to a different location (if you plan to use a different method than Intel BTS to flash the device), click Save image and specify a location. To dismiss the dialog, click Ok. 2. To flash the device with the newly created OEM partition, from the Build menu, select Flash OEM partition to device. Note: If you make any change to the customizations after you build an OEM partition, when you attempt to flash the OEM partition, the tool asks you if you want to re-build the partition: 3. Follow the on-screen directions to prepare the device for flashing. May 2015 Revision:

16 Customizing an OEM Partition The progress window displays the processes being executed on the device. When the flash process is complete, the progress window displays Device flashed successfully! 4. Click OK to dismiss the progress window. Revision: 1.5 May

Customizing an OS Module using Intel Build Tool Suite for Android* 4 Customizing an OS Module using Intel Build Tool Suite for Android* This chapter explains the steps to customize an Android*

17 Customizing an OS Module using Intel Build Tool Suite for Android* 4 Customizing an OS Module using Intel Build Tool Suite for Android* This chapter explains the steps to customize an Android* operating system (OS) Module. 4.1 Downloading the OS Module This section explains steps to obtain an Android OS module and put it in a location on your Windows 7 or Windows 8 computer. 1. Locate the OS module that you wish to customize with Intel BTS by doing one of the following actions: If you created a custom OS module, locate that file and skip to Section 4.2. If you are customizing an Intel Reference Design for Android* OS Module, you ll need to obtain it first. To obtain an OS module, talk to your Intel representative or log into your VIP account. A typical OS module file will be named similarly to cohol-flashfiles-device- COHOL01000-signed.zip. 2. Download that module to a location on your computer. For the examples that follow, we used the file cohol-flashfiles-device- COHOL01000-signed.zip. Your filename may differ. Note: Do not extract any files from the zip archive. The Intel BTS application will extract the files in a subsequent step. May 2015 Revision:

18 Customizing an OS Module using Intel Build Tool Suite for Android* 4.2 Create a Project in Intel BTS 1. Start Intel BTS. The main window, as shown in the example below, is displayed. 2. Click Start new project. 3. In the New Project dialog, specify a name for your project. Revision: 1.5 May

19 Customizing an OS Module using Intel Build Tool Suite for Android* 4. Click Create project. The project window opens, with the Boot animation panel displayed. 4.3 Select an OS Unless a specific OS is chosen from the installed OS modules, Intel BTS creates customizations for a generic build of Android Lollipop. Choosing another installed OS module may expose or hide different customizations. Choosing an installed OS module allows you to use Intel BTS to flash the full OS (along with your customizations) to a device. 1. To select an OS, click Select OS. May 2015 Revision:

20 Customizing an OS Module using Intel Build Tool Suite for Android* Intel BTS displays the Operating System panel. 2. Click Import OS. 3. Navigate to the zip file you downloaded or located in Section 4.1. Select the file and click Open. 4 Revision: 1.5 May

Customizing an OS Module using Intel Build Tool Suite for Android* After Intel BTS finishes importing the OS module, the main window is displayed with

21 Customizing an OS Module using Intel Build Tool Suite for Android* After Intel BTS finishes importing the OS module, the main window is displayed with an operating system tile to be customized. If available, the OS tile displays all the different versions of the operating system. May 2015 Revision:

Customizing an OS Module using Intel Build Tool Suite for Android* 4.4 Customizing the Operating System 1. If different builds are available, choose the version of the operating system. 2.

22 Customizing an OS Module using Intel Build Tool Suite for Android* 4.4 Customizing the Operating System 1. If different builds are available, choose the version of the operating system. 2. Click Select to choose an operating system to be customized. There are four customization panels, Boot animation, Theme, Apps, and Settings. To display a Customization panel, in the Left Navigation pane, click a Panel button. Revision: 1.5 May

Customizing an OS Module using Intel Build Tool Suite for Android* 3. Start by clicking the Boot animation. The Boot animation selection panel is displayed. 4.

23 Customizing an OS Module using Intel Build Tool Suite for Android* 3. Start by clicking the Boot animation. The Boot animation selection panel is displayed. 4. Click the + to select an animation file. Note: The boot animation should be a zip file corresponding to the standard Android boot animation format. For more information, see "Boot Animation File" on page 34. May 2015 Revision:

24 Customizing an OS Module using Intel Build Tool Suite for Android* 5. To select a different wallpaper to be displayed on the device, click Theme. The Wallpaper image selection panel is displayed. Note: To preview the wallpaper in landscape and portrait mode, hover your cursor over one of the wallpapers, as shown below: Revision: 1.5 May

Customizing an OS Module using Intel Build Tool Suite for Android* 6. Select one of the pre-loaded wallpaper images or click the + to navigate to a folder that contains a wallpaper image.

25 Customizing an OS Module using Intel Build Tool Suite for Android* 6. Select one of the pre-loaded wallpaper images or click the + to navigate to a folder that contains a wallpaper image. If you are customizing an Lollipop OS module, you may also add Live Wallpaper by clicking the lower +, as shown in the screenshot below: 7. To deselect a wallpaper, in the palette, click the selected wallpaper, as shown below: 8. To add apps to the customization, click Apps. The Apps selection panel is displayed. May 2015 Revision:

26 Customizing an OS Module using Intel Build Tool Suite for Android* 9. To select apps to be added to the customization, click the + as shown below: Apps that are added to the OS image are displayed in the Apps panel, as shown below. Note: The app files should be standard Android APK files. 10. To remove all apps, click the circle arrow button, as shown in the example above. To remove individual apps, click the trash can icon. a. The app icons display a Select circle. Revision: 1.5 May

Note: If you make any changes to your customizations after you have built the OEM partition, such as to remove an app from the customization, you must rebuild the

27 Customizing an OS Module using Intel Build Tool Suite for Android* b. Select the apps to be removed. c. Click the to remove the selected apps. The selected apps are removed. Note: If you make any changes to your customizations after you have built the OEM partition, such as to remove an app from the customization, you must rebuild the OEM partition before you can flash the device. Intel BTS will remind you of this and will give you the option to rebuild the OEM partition prior to flashing. 11. If you are customizing a Lollipop OS module, you may also customize the default language and region on the device by selecting Settings. May 2015 Revision:

From the Build menu, select Build OEM Partition Image. The image is saved in the project directory in the build folder and is ready to be flashed to the device.

28 Customizing an OS Module using Intel Build Tool Suite for Android* 12. To change the settings, click the dropdown menu and select the desired language and region. 4.5 Build the OS Image 1. From the Build menu, select Build OEM Partition Image. The image is saved in the project directory in the build folder and is ready to be flashed to the device. When the build process completes, the following dialog is displayed: S To save the image to a different location (if you plan to use a different method than Intel BTS to flash the device), click Save image and specify a location. To dismiss the dialog, click Ok. Revision: 1.5 May

29 Customizing an OS Module using Intel Build Tool Suite for Android* 4.6 Flash the Device Use the steps in this section to flash the OS along with your customized OEM partition to the device Unlocking a Device Prior to flashing a device, you must enable it to be unlocked by fastboot commands that will be sent to it from Intel BTS. To enable unlocking, do the following: 1. On the device, open Settings. 2. Tap About Tablet. 3. Tap Build Number seven times. If a note appears: No need, you are already a developer Developer Options is already available on the Settings pane under System. May 2015 Revision:

Customizing an OS Module using Intel Build Tool Suite for Android* 4. In Settings, in the System group, tap Developer Options. The Developer Options pane is displayed.

30 Customizing an OS Module using Intel Build Tool Suite for Android* 4. In Settings, in the System group, tap Developer Options. The Developer Options pane is displayed. Note: If there is a green box with a white check to the right of the Enable OEM unlock option, unlocking is already enabled and you may skip to Flashing a Device on page Tap OEM unlocking. A query appears on the device. Revision: 1.5 May

31 Customizing an OS Module using Intel Build Tool Suite for Android* 6. Tap Enable. A green toggle indicates OEM unlocking is enabled. Note: The default fastboot scripts do not lock the device after the fastboot scripts are finished. While you are developing your custom OS or customizing an OS, you may choose to unlock your Android* device and leave it unlocked. In this way, you can avoid repeatedly locking and unlocking the device to test each change Flashing a Device 1. In the Intel BTS main window, from the Build menu, select one of the options to flash the device. The differences are explained in the table below: Table 1. Flash to Device Options Select this Option To Flash Flash OEM Partition The OEM partition onto the device (see Section 3.3) Flash Release OS to device Flash Debug OS to device A final version of the OS onto the device An OS that is enabled for debug May 2015 Revision:

Customizing an OS Module using Intel Build Tool Suite for Android* The Flash Release OS or

flashing. 2. Follow the on-screen directions to prepare the device for flashing.

Flash Tool itself. The progress window displays the processes being executed on the device.

32 Customizing an OS Module using Intel Build Tool Suite for Android* The Flash Release OS or Flash Debug OS progress window is displayed with instructions for preparing the device for flashing. 2. Follow the on-screen directions to prepare the device for flashing. Note: For more information about flashing the device, consult the help from within the Phone Flash Tool itself. The progress window displays the processes being executed on the device. When the flash process is complete, the progress window displays Device flashed successfully!. Revision: 1.5 May

Customizing an OS Module using Intel Build Tool Suite for Android* If the flash process fails, the progress window displays an error, similar to

7 Export Factory Archive After you have completed your OS module customizations, flashing, and testing, you can export the OS module to a factory

In the Save As window, specify a location and name for the Factory archive. In the example below, we used the filename L-factory-archive.zip.

33 Customizing an OS Module using Intel Build Tool Suite for Android* If the flash process fails, the progress window displays an error, similar to the example shown below: Note: After flashing, you may need to reboot the device two times for it to properly recognize the new OS. 4.7 Export Factory Archive After you have completed your OS module customizations, flashing, and testing, you can export the OS module to a factory archive. 1. With the completed project open in Intel BTS, from the Build menu, select Export factory archive. 2. In the Save As window, specify a location and name for the Factory archive. In the example below, we used the filename L-factory-archive.zip. You may use any filename. 3. Click Save. While the archive is being saved, the alert shown below is displayed. When the save is complete, the project window is displayed. May 2015 Revision:

34 Boot Animation File A Boot Animation File A.1 desc.txt An Android* boot animation is a zip file containing a file desc.txt and folders with the animation frames as JPEG or PNG images. The desc.txt file is the animation control file, which describes the animation and how to play the frames. The schema is: [width] [height] [frames per second] p [number of loops] [delay] [folder] This first line specifies the dimensions of the animation and its speed. Revision: 1.5 May

35 Boot Animation File The second line describes part of the animation. It can be duplicated as many times as required. The images in the folder are played, in order, for the duration indicated by the number of loops before going on to the next part. Zero, as the number of loops, means display forever. An example is shown below: -+- desc.txt +- middle +- image01.jpg +- image02.jpg +- image03.jpg +- image04.jpg +- image05.jpg +- image06.jpg +- start +- image01.jpg +- image02.jpg +- image03.jpg +- static +- image01.jpg Here s an example of a desc.txt file: p 1 0 start p 20 0 middle p 0 0 static A.2 Additional Resources May 2015 Revision:

Intel Cache Acceleration Software for Windows* Workstation

Intel Cache Acceleration Software for Windows* Workstation Release 3.1 Release Notes July 8, 2016 Revision 1.3 INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS