Introduction to Android Installation on Intel Pentium /Celeron N3000 ("Braswell"/"Bear Ridge") 64-bit CRB for Digital Signage Revision 0.5 May 24, 2016 Copyright 2016 American Megatrends, Inc. All Rights Reserved. American Megatrends, Inc. 5555 Oakbrook Parkway Suite 200 Norcross, GA 30093 (USA) This publication contains proprietary information which is protected by copyright. No part of this publication may be reproduced, transcribed, stored in a retrieval system, translated into any language or computer language, or transmitted in any form whatsoever without the prior written consent of the publisher, American Megatrends, Inc. American Megatrends, Inc. retains the right to update, change, and modify this publication at any time, without notice. For Additional Information Call American Megatrends BIOS Sales Department at 1-800-828-9264 for additional information. Limitations of Liability In no event shall American Megatrends be held liable for any loss, expenses, or damages of any kind whatsoever, whether direct, indirect, incidental, or consequential, arising from the design or use of this product or the support materials provided with the product. Limited Warranty
No warranties are made, either expressed or implied, with regard to the contents of this work, its merchantability, or fitness for a particular use. American Megatrends assumes no responsibility for errors and omissions or for the uses made of the material contained herein or reader decisions based on such use. Trademark and Copyright Acknowledgments All product names used in this publication are for identification purposes only and are trademarks of their respective Companies. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Intel is a trademark of Intel Corporation in the U.S. and other countries. Revision Information Date Rev Description of Changes Owner 2016-05-24 0.5 Updated to reflect ww20 release Tiffany Hsu 2016-05-11 0.4 Modified instructions in Section 3.2 to C. Follett clarify steps on GIT server download, build and flash procedure 2016-04-19 0.3 3nd release for adding instruction on Tiffany Hsu ADB over Ethernet function (P.25) 2016-04-06 0.2 2nd release for internal review (BSP Tiffany Hsu WW13) 2016-01-28 0.1 First release for internal review Tiffany Hsu Copyright 2016 Public Document (PUB) Page 2 of 25
Table of Contents 1 INTRODUCTION... 4 1.1 Purpose of this document... 4 2 SUMMARY OF THIS DOCUMENT... 5 2.1 Support Scope... 5 2.2 Items Delivered... 5 2.3 Known Issues... 5 2.4 Intel Native Features on Bear Ridge... 7 2.5 Android Customization Services from American Megatrends, Inc. (AMI)... 17 3 INSTALLING THE ANDROID IMAGE ON THE INTEL PENTIUM /CELERON N3000 ("BRASWELL"/"BEAR RIDGE")... 22 3.1 UEFI BIOS Configuration... 22 3.2 Standard Build Procedure... 22 3.3 Build output... 23 3.4 Android Image Flashing and Booting... 23 3.5 Instructions for Enabling Internet... 24 3.6 Connecting to the UART... 24 3.7 ADB over Ethernet... 24 Copyright 2016 Public Document (PUB) Page 3 of 25
1 Introduction 1.1 Purpose of this document AMI provides the Intel Board Support Package (BSP) 2016 WW13 release and related instructions for customer evaluation on Intel Pentium /Celeron N3000 ("Braswell"/"Bear Ridge") 64-bit CRB for Digital Signage. Customers who intend to investigate the Intel N3000 CRB for Digital Signage solution (hereafter referred to as Bear Ridge ) may follow the guidelines in this document for environment configuration, build image, flashing the device as well as reviewing any known issues. Copyright 2016 Public Document (PUB) Page 4 of 25
2 Summary of This Document 2.1 Support Scope Google GMS is excluded from the release information Hardware support targets on Intel Pentium/Celeron N3000 CRB ( Bear Ridge ) 2.2 Items Delivered This Release Document (file name: AMI_ReleaseNote_IntelN3000CRB-BSP_PUB_Q2-2016) Android Image (Intel 2016WW20, Android V5.1.1) Android BSP Source Code 2.3 Known Issues There are some known issues, which may not always happen, or only are duplicated on certain platforms: 1) [App] Some ARM native apps crash on execution 2) [Audio] HDMI2 has no audio output 3) [Audio] System cannot launch Speech Recorder App 4) [BT] A2DP may not be fully functional 5) [Contact] Cannot set photo for a contact, no Save or Cancel button is visible 6) [CTS] There are some failed test cases in CTS test 7) [Display] Some brands and models of DP monitors have been known not to work / incompatible 8) [Display] Cannot enable "wireless display" to search nearby devices 9) [Display] Intermittent screen flashing when playing video with 1080i resolution 10) [Display] edp is not supported on Bear Ridge CRB 11) [Display] Maximum of 30fps frame rate videos are supported for dual simultaneous 4K video playback 12) [Display] Booting Android while using the DP occasionally results in erratic colors on screen, which can be worked around by re-plugging the display port without resetting the board 13) [Ethernet] Ethernet GUI Control Panel is not available in the Settings panel in Android 14) [Ethernet] Ethernet icon not visible on status bar when battery is not connected 15) [Ethernet] On Bear Ridge CRB, Ethernet LAN 1 is active after LAN2 port is disabled in BIOS 16) [Ethernet] Ethernet has been known to fail occasionally while WiFi card is plugged in during loading of fastboot-usb Copyright 2016 Public Document (PUB) Page 5 of 25
17) [Ethernet] To successfully enable Ethernet functionality, the LAN cable must be inserted before system boot-up 18) [Gallery] The Gallery app may crash when the EDIT button in the menu is clicked 19) [Gallery] Cannot crop photos, no Save and Cancel button is visible 20) [Gallery] Gallery does not work for video playback 21) [HDMI] For HDMI display, only the DDI2 HDMI port is working and can automatically detect displays only up to 1080p. However, the user can configure display resolution from terminal with the following instructions: # su # stop # setprop intel.hwc.proxydisplayw <resolution width> # setprop intel.hwc.proxydisplayh <resolution height> # start" 22) [Music] The Music app cannot play media files 23) [OTG] OTG does not work (USB OTG function is now only available on BSW RVP) 24) [Power] Battery icon is displayed on status bar when there is no battery connected 25) [Power] Long boot time on initial boot (approx. 5-10 minutes), with subsequent boots lasting around 1.5 minutes 26) [Power] Power ON scheduling in Settings -> Date and Time is not functional 27) [Power] Reboot and shutdown options by pressing the power button are not functional 28) [Power] While the display card is connected, the system cannot boot into fastboot and BIOS using the volume buttons 29) [USB] ADB over USB is not functional, but ADB over Ethernet is functional 30) [USB] USB2 port on Bear Ridge BSP only supports USB Host Mode 31) [Video] When playing MPEG4 video, some lagging may occur 32) [Wallpaper] The default wallpaper icon is not synchronized with the actual display 33) [WiFi Direct] Error message appears when device is renamed 34) [WiFi Direct] No response when "Searching for Devices" is clicked 35) [YouTube] Cannot play video unless using Desktop version of YouTube Copyright 2016 Public Document (PUB) Page 6 of 25
2.4 Intel Native Features on Bear Ridge The additional features are specific to Bear Ridge: Enabling Dual Displays This new feature on this Android release provides for dual display support. Setup the target system with the following configuration: 1) Configure the connected system with two displays; Display 1 (Primary) connected to the VGA port and Display 2 (Secondary) connected to the HDMI Port. Display 1 (Primary) Display 2 (Secondary) 2) Once the system is booted up, both displays will enter Clone screen mode, where by default the VGA is the primary and HDMI is the secondary display. Rotation Mode on Dual Displays Note: By default, both connected displays are in landscape mode. Primary Display Secondary Display Copyright 2016 Public Document (PUB) Page 7 of 25
To rotate both screens 90 independently, follow these instructions: 1) Go to Settings -> Display Orientation 2) Select one of the four options available. For example, if portrait on external is selected, the secondary display will rotate to the portrait format and the primary display remains in landscape format. Primary Display Secondary Display Copyright 2016 Public Document (PUB) Page 8 of 25
Setting Default Application(s) to Display on the Secondary Display In the extended display mode, the default application presentation can be configured in Android* settings to enable specific applications to run on secondary displays. The following procedures describe how to enable two displays to run two independent applications: 1) Go to Settings->Dual Display 2) On the Dual Display option, all applications installed in Android* are listed with a small checkbox on the right. Application(s) which are checked ( ) in this setting is automatically displayed on the secondary display. Copyright 2016 Public Document (PUB) Page 9 of 25
For example, if the Gallery is selected in the Dual Display setting, you will see the Gallery on the secondary display when it is enabled. Primary Display Secondary Display Note: No modification of the application is required to get the application to run on the secondary display. The application will also scale to full screen on the secondary display. Audio Routing Support This feature enables audio routing capabilities through the onboard speaker (for CHT-CR only), headphone from audio jack and HDMI audio Follow the instructions below as an example of how this may be applied: 1) Make sure that the monitor connected to the HDMI port has audio capabilities 2) Go to Settings -> Sounds and Notifications -> Dynamic Audio Output Settings Copyright 2016 Public Document (PUB) Page 10 of 25
The options available are shown below: The three audio routing features available in the Dynamic Audio Output Settings are: 1) Primary Audio Output a. Speaker as primary audio output: Select Speaker radio button and uncheck the Dual Output checkbox. b. HDMI Audio as primary audio: Select the HDMI Audio radio button and uncheck the Dual Output checkbox. c. System Default: The primary audio output function defaults according to an audio output priority order of HDMI Audio or speaker, depending on which audio output is connected. 2) Dual Audio Output a. To enable Dual Audio Output, select the System Default radio button and leave the check the Dual output checkbox selected. 3) Secondary Audio Output The following settings are required for Secondary Audio Output: a. Ensure the Dual Output checkbox is unchecked. b. Note: The Secondary Output App textbox refers to the application to which the STREAM MUSIC audio would be rerouted. The name would derive from the package name defined in AndroidManifest.xml. For example: AOSP Music app is com.android.music. c. Secondary System Default/Speaker/HDMI Audio radio button group refers to one of the available outputs for secondary applications: Speaker as secondary audio output: Select Secondary Speaker radio button HDMI Audio as secondary audio output: Select Secondary HDMI audio radio button and uncheck the Dual Output checkbox Secondary system default: Secondary audio output function is disabled. Copyright 2016 Public Document (PUB) Page 11 of 25
USB Support for Four Cameras This feature enables user to connect all four USB cameras simultaneously and stream with the MultiCamera application. USB bandwidth and various camera firmware implementations from the camera vendor can affect four concurrent cameras streaming; therefore, selection of the right camera is crucial. It is advisable to use cameras that are less than 720p. For examples, refer to the validated camera module. MultiCamera sample application source code is available in: packages/app/camera/multicamera Steps to configure the system: 1) Four USB cameras are connected to a USB hub and attached to an available on board USB port. 2) Once the system boots, open the MultiCamera app, which is present in the Apps menu. Observe that the connected camera stream is displayed on screen. A sample of the expected output from the MultiCamera app is shown below: Copyright 2016 Public Document (PUB) Page 12 of 25
Ethernet GUI This feature enables the user to view and configure Ethernet settings. To configure the Ethernet settings, follow these instructions: 1) Ensure that a LAN cable is connected to the LAN port. 2) Go to Settings -> Ethernet 3) The following information will be shown: 4) Click on Change Ethernet Settings and then click the Show Advanced Options checkbox to configure Ethernet settings as desired. Copyright 2016 Public Document (PUB) Page 13 of 25
Display Setting This feature enables the user to adjust the display resolution. Follow the instructions below as an example: 1) Go to Settings -> Display Setting Copyright 2016 Public Document (PUB) Page 14 of 25
2) The available options are shown below. The Status indicates whether the display is connected or not: 3) In either Primary Modes or Secondary Modes, click the desired resolution and the display will be adjusted to the selected resolution. Copyright 2016 Public Document (PUB) Page 15 of 25
Intel Smart Video The feature is for enhanced video quality for interlaced content. It can be enabled /disabled as needed in the following way: 1) Go to Settings -> Intel Smart Video 2) Here, Intel Smart Video can be toggled On or Off. The default setting is Off. Copyright 2016 Public Document (PUB) Page 16 of 25
Slide the toggle button to turn it On. Power Off Scheduling This feature can schedule a daily Power Off of the system. Configuration is as follows: 1) Go to Settings -> Date and Time 2) Select Automatic Power Off 3) Choose hour of day and minute of hour to Power Off the system daily Shutdown Option in Settings This feature enables graceful shutdown of the system. This can be initiated as follows: 1) Go to Settings 2) Click on Shutdown 3) A pop-up dialog box with Shutting Down appears, and the system will shut down gracefully in 5 seconds 2.5 Android Customization Services from American Megatrends, Inc. (AMI) AMI has deep experience in Android feature development and offers customization services drawn from that expertise, including: System Integration and Professional Services 1) Driver Porting 2) Driver Development 3) Quality Validation 4) Qualification for Google Certifications Security Features 1) Widevine Level One (Widevine is the Google Digital Rights Management [DRM] service for protection of digital content) 2) Enabling Secure Boot and signing key process Copyright 2016 Public Document (PUB) Page 17 of 25
General Customization 1) Custom boot process, including display of boot animation, audio and log 2) Preloading of media, including video files, audio files, notification sounds and image files 3) Pre-defined bookmark URL and website name, including target homepage 4) Pre-loaded wallpapers, including selected default wallpaper 5) Modification of Home Screen layout to a) locate application and Widgets List, b) define Hot Seat 6) Preloading of specific apps or services per customer requirements Application Development 1) Smart Battery Model Tool To maintain the battery charge level in the production stage and control appropriate battery levels, AMI has defined three battery modes and generated a tool for use during the manufacturing process. The three modes are: Stop Charging Once the battery reaches the desired charge level, the system battery will no longer charge. After reaching the target level, the AC adapter will only supply power to the mainboard. Ship Mode Once the battery is placed in this mode, the battery is effectively disconnected from software applications and not consumed. This ensures that battery charge remains consistent until the next Power On. Force Discharge When connected to AC power, the desired threshold of battery power level (e.g. 50%) can be selected, and the battery will not be charged until the power level is reduced below the threshold. 2) Diagnostic Tools To diagnose system health at the component level in a consolidated and efficient manner, AMI offers a number of tools, including: System Information Display Camera Health Power Health Storage Health Network Health Audio Health Sensor Health System Input Health 3) Validation Tools To qualify system stability, the system can be tested automatically for multiple cycles with the following: Warm Reboot Copyright 2016 Public Document (PUB) Page 18 of 25
Cold Reboot Suspend / Resume OpenGL File Copy / Verification Media Playback Wi-Fi Connectivity 4) Customization Tools AMI also provides Customization Tools that enables customers to quickly adopt common customizations in the Android system without re-creating the Android system image. This approach minimizes collision on system design and also reduces potential impacts on system quality. In addition to implementation benefits, verifying a customized image prevents added effort in taking full scope quality tests. Some of the detailed customization items that are supported are as follows: System Properties Display appropriate model number, build number, Bluetooth device name, default language, time zone, default screen timeout, default volume, Wi-Fi status, default brightness level, boot animation, boot audio, and boot logo Media Preload desired video and audio files Apps Pre-install Apps Wallpaper Add wallpaper options and set desired wallpaper as default Browser Add bookmarks lists and set one as default homepage Home Screen Place specific app shortcuts or widgets on the home screen and/or hot seat area Notification Add notification files and setting default notifications 5) Remote Control Service and APK AMI has created a Remote Control Service and APK as a solution for remote control of the host device via mobile phone. In detail, the user can employ an Android mobile phone as a remote control client to control another host device running the host application via a network connection. Additionally, the host device can be one of a variety of devices, such as a set-top box installed with a customized BSP from AMI. The AMI Remote Control Service operates as a one-on-one service and includes many features like mouse, touch support, software keyboard, sensor, and mirror capabilities. With these capabilities, the user s mobile phone can control the host device for scrolling pages, clicking objects, typing words, and playing motion games. Because this service also features mirror capability, all interactions are displayed on both the client and host devices simultaneously. Copyright 2016 Public Document (PUB) Page 19 of 25
Server Wi-Fi Client 6) OTA Service The AMI OTA Service utilizes OTA server and management software taken from our popular MegaRAC XMS (Extendible Management Server) platform. It provides great flexibility so customers can use their individual accounts to manage their own OTA ROM files, to not only maintain old OTA ROM files but also upload new ones. End users can also receive system updates for their Android devices with no limitations on location or time by downloading OTA ROM files via MegaRAC XMS whenever the system detects a new version of a ROM file. With respect to system updates, these can be either full or incremental updates. In a full update, the data saved within the System and Recovery partitions will be replaced by the new ROM file downloaded from the OTA server for system upgrade, while still preserving user data within the Data partition of the system. In an incremental update, some of the ROM files within the System and Recovery partitions will be updated for correcting issues or adding features. Copyright 2016 Public Document (PUB) Page 20 of 25
7) Additional Features, including: LAN access via USB Ethernet dongle Support for both locked and unlocked Fastboot boot loader Additional File Systems - NTFS Read Only - NTFS Read & Write (Upon license condition) Multiple NVRAM defaults to support different global markets Copyright 2016 Public Document (PUB) Page 21 of 25
3 Installing the Android Image on the Intel Pentium /Celeron N3000 ("Braswell"/"Bear Ridge") This section explains configuration information, the process of building an image as well as flashing the Bear Ridge CRB. 3.1 UEFI BIOS Configuration Please follow the steps below to properly configure UEFI BIOS: 1) Power cycle the board. Press the DEL key to enter the BIOS menu. 2) Use the following setting to disable secure boot: Security -> Secure Boot Menu -> Secure Boot -> Disabled 3) Disable onboard LAN2 port with the following setting: Chipset -> Onboard LAN 2 -> Disabled 3.2 Standard Build Procedure Please follow these steps for the standard build procedure: 1) Issue the command below in a newly created folder: # git clone https://amigit.gitsrc.com/git/bsw_rvp 2) Issue the following commands to get the latest branch/version of the BSP. Note there are two options available to the user: to download with or without kernel source. For users who want the BSP without kernel source, see step 2.1 below. For users who want the BSP with kernel source, see step 2.2. below. 2.1) To download BSP without kernel source: # cd bsw_rvp # git checkout ww20 and skip step 4 and 5 below. 2.2) To download BSP with kernel source: # cd bsw_rvp # git checkout ww20_include_kernel 3) Enter your username and password (provided by AMI via email upon registration) when prompted. Copyright 2016 Public Document (PUB) Page 22 of 25
4) If you are building the kernel for the first time, you need to perform the following: $ cd kernel/cht/ $ http://downloads.yoctoproject.org/releases/yocto/yocto-1.8/toolchain/x86_64/pokyglibc-x86_64-core-image-sato-core2-64-toolchain-1.8.sh $ chmod +x poky-glibc-x86_64-core-image-sato-core2-64-toolchain-1.8.sh $ sudo./poky-glibc-x86_64-core-image-sato-core2-64-toolchain-1.8.sh 5) Build the kernel for Bear Ridge $./bsw-git-build.sh 6) The Android build system can only build an image for booting through either emmc or SATA HDD/SSD, though not both. The default image supports emmc boot. To switch to SATA boot, execute the following commands: a. cd device/intel/braswell/ b. patch p0 < patches/sata_configs.patch 7) Compile the Intel build tree, using the eng variant. $ source./build/envsetup.sh $ lunch bsw_rvp-eng 8) To install using the userfastboot method run: $ make factoryscripts userfastboot-usb j8 To install using the installer method run: $ make flashfiles j8 Note: The -j flag can be used to specify how many parallel processes you want to run for the repo sync and can greatly speed up the builds. You may choose a higher number depending on your build machine cores. 3.3 Build output The image files for flashing will be created under: <repo_base_dir>/out/target/product/bsw_rvp/ 3.4 Android Image Flashing and Booting 1) Connect a USB Drive to the host machine 2) Extract the contents of bsw_rvp-flashfiles-<build type>.<username>.zip to the USB Drive 3) Connect the USB Drive to one of the USB ports of the RVP 4) Power ON the board and enter the BIOS menu by pressing the DEL key. Make sure that the top left DP is connected to a display port or a monitor with HDMI support. Refer to the instructions for Internet Enabling (Section 3.5) for setting up a proxy on the target device. Copyright 2016 Public Document (PUB) Page 23 of 25
5) In the BIOS menu select Boot Manager, which will open the Boot Option menu. From the Boot Option menu select USB Device and select Internet EFI Shell a. If installing a SATA image press the ESC key and run the following command: installer --batch install-sata.cmd b. If installing an emmc image press enter and startup.nsh will automatically run the commands to install the emmc image Note: There is a known issue that the Android flashing process takes over 13 minutes for SATA builds when using the installer. When installing on SATA it is better to use the Userfastboot method at this time. 3.5 Instructions for Enabling Internet Once Android has booted on the target device, proxy host and proxy port have to be set in the order below to enable internet browsing through a proxy. Go to the terminal and run the following commands: su setprop persist.ethernet.proxyhost <Proxy Host> setprop persist.ethernet.proxyport <Proxy Port> reboot After the system reboots, Internet connectivity should work properly. 3.6 Connecting to the UART Download and install the latest FTDI VCP (Virtual Com Port) drivers. They are available online at http://www.ftdichip.com/drivers/vcp.htm. Connect a USB cable from the Flash Host to the Intel device connector at J9C3: Next, open a console program on your Flash Host (for example, use PuTTY and choose connection type Serial ). Two COM ports should be displayed; use the Device Manager to see them, listed as USB Serial Port under Ports (COM & LPT) ). The lowest value is the one to monitor. The baud rate should be set to 115200 in order to correctly see the output (find this option in PuTTY under Connection Serial ). 3.7 ADB over Ethernet To using ADB Shell via Ethernet: 1) BIOS Settings: a. Ensure the onboard LAN1 is enabled and the onboard LAN2 is disabled under BIOS settings -> Chipset. Copyright 2016 Public Document (PUB) Page 24 of 25
b. Ensure the LAN cable is connected to the LAN1 port. Note: Make sure that Ethernet has a MAC address included. 2) Android Settings: a. On the Android system, go to Settings -> Ethernet, and confirm that Internet is active. b. Confirm the target device's IP address. c. Execute the following command: $ adb connect <the target device's IP address> $ adb shell Copyright 2016 Public Document (PUB) Page 25 of 25