Open-Q™ 820 (APQ8096) Development Kit
BSP Programmer Guide
[Document: ICS-01IMP1200-BSPPG-001 Version: 1.1 ]
Your use of this document is subject to and governed by those terms and conditions in the Intrinsyc Purchase and Software
License Agreement for the Snapdragon 820 (APQ8096) based Open-QTM 820 Development Kit, which you or the legal
entity you represent, as the case may be, accepted and agreed to when purchasing an Open-Q 820 Development Kit from
Intrinsyc Technologies Corporation (“Agreement”). You may use this document, which shall be considered part of the
defined term “Documentation” for purposes of the Agreement, solely in support of your permitted use of the Open-Q 820
Development Kit under the Agreement. Distribution of this document is strictly prohibited without the express written
permission of Intrinsyc Technologies Corporation and its respective licensors, which they can withhold, condition or delay
in its sole discretion.
Intrinsyc is a trademark of Intrinsyc Technologies Corporation, registered in Canada and other countries. Qualcomm and
Snapdragon are trademarks of Qualcomm Incorporated, registered in the United States and other countries. Other product
and brand names used herein may be trademarks or registered trademarks of their respective owners. This document
contains technical data that 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.
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
Identification
Document Title
Open-Q™ 820 (APQ8096) Development Kit BSP Programmer Guide
Document Number
ICS-01IMP1200-BSPPG-001
Version
Date
1.1
Aug 18, 2016
History
REVISION DATE
DESCRIPTION
PAGES
1.0
1.1
April 7, 2016
Initial version
Aug 18, 2016 Updated Software Use Restrictions section
All
10
1
Copyright Intrinsyc Technologies Corporation
1.
2.
3.
4.
5.
6.
7.
1.1
1.2
1.3
1.4
1.5
1.6
2.1
2.2
3.1
3.2
3.3
4.1
4.2
4.3
5.1
5.2
5.3
6.1
6.2
6.3
7.1
7.2
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
Table of Contents
INTRODUCTION ................................................................................... 4
Purpose ....................................................................................................... 4
Scope ........................................................................................................... 4
Intended Audience ...................................................................................... 4
Organization ............................................................................................... 5
Acronyms .................................................................................................... 6
Resources .................................................................................................... 7
DOCUMENTS ....................................................................................... 8
Applicable Documents ................................................................................ 8
Reference Documents ................................................................................. 8
Software Licensing ............................................................................. 9
Introduction ................................................................................................. 9
Software Licensing ..................................................................................... 9
Software Use Restrictions ......................................................................... 10
Software Version Tracking ............................................................... 11
Introduction ............................................................................................... 11
Software Version Number Convention .................................................... 11
Determining your Software’s Version Number ........................................ 11
Source Code Access ........................................................................ 12
Introduction ............................................................................................... 12
Downloading the Board Support Package ................................................ 12
Code Aurora Forum (CAF) ...................................................................... 13
Building an Android BSP ................................................................. 14
Introduction ............................................................................................... 14
Development Environment Setup ............................................................. 14
Introduction ............................................................................................................. 14
Initializing Build Environment................................................................................ 15
Repo Installation ..................................................................................................... 16
Downloading and Building Android BSP Images from Source ............... 17
Introduction ............................................................................................................. 17
Build Instructions .................................................................................................... 17
6.2.1
6.2.2
6.2.3
6.3.1
6.3.2
Installing an Android Software Image ............................................. 19
Introduction ............................................................................................... 19
Fastboot and ADB .................................................................................... 19
Introduction ............................................................................................................. 19
USB Driver Configuration for Fastboot and ADB on Linux (Ubuntu) Machine .... 19
Programming System Images using Fastboot ......................................................... 21
Fastboot and ADB use on a Windows PC ............................................................... 23
7.2.1
7.2.2
7.2.3
7.2.4
8.
Advanced Building Tips ................................................................... 26
Introduction ............................................................................................... 26
8.1
2
Copyright Intrinsyc Technologies Corporation
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
8.2
8.3
Reconfiguring / Recompiling and Updating Kernel Image on Device ..... 26
FAQS for APQ8096 BSP ......................................................................... 27
ADB Root permission ............................................................................................. 27
8.3.1
External references...................................................................................... 28
3
Copyright Intrinsyc Technologies Corporation
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
1. INTRODUCTION
1.1 Purpose
The purpose of this BSP Programmers Guide is to provide primary user information for programming of
and software intended for Android Board Support Package.
Visit the Open-Q 820 community website for more information and where you can post questions and get
information about your Open-Q 820 or visit www.intrinsyc.com
For more Android-related device information, see the Qualcomm Developer Network page at
https://developer.qualcomm.com/get-started/android-development
If you are looking for developing applications only, visit
http://developer.android.com/sdk/index.html
1.2 Scope
This document describes the following for the Open-Q 820 Development Kit:
Software Licensing and Version Information
Accessing Android software for the kit
Setting up your PC development environment used to build/install software on the kit
Building the software binaries from source code
Methods to download/install Android software binaries from your PC onto on the kit
Debug/ADB Usage
1.3 Intended Audience
This document is intended for end users who have purchased a Open-Q 820 Development Kit and interested
in Android BSP customization / Linux Device driver development / modification
4
Copyright Intrinsyc Technologies Corporation
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
1.4 Organization
This document is organized as follows:
Section 1. Introduction: This section describes the purpose, scope and structure of this document.
Section 2. Documents: This section lists other documents that are parents of or supplement this
document.
Section 3. Software Licensing: This section identifies the Android Software licensing for the
software supplied for use on your Open-Q 820 Development Kit.
Section 4. Software Version Tracking: This section identifies Android Software version
information for the software supplied for use on your Open-Q 820 Development Kit.
Section 5. Source Code Access: This section describes where and how to access the Android BSP
including the kernel source code that runs on the Open-Q 820 Development Kit.
Section 6. Building an Android Software Image: This section describes how to setup your host
PC software development environment and build software binaries from source code for use with
your Open-Q 820 Development Kit.
Section 7. Installing an Android Software Image: This section describes how to install Android
software binaries onto your Open-Q 820 Development Kit
Section 8. Advanced Development and Debugging Tips: This section describes how to configure
and control the various subsystems that are part of your Open-Q 820 Development Kit.
Section 9. Troubleshooting: This section describes some known problems and suggested solutions.
5
Copyright Intrinsyc Technologies Corporation
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
1.5 Acronyms
TERM AND ACRONYMS
DEFINITION
RF
SOM
QHD
SPMI
UIM
NFC
EMMC
USB HS
USB SS
DSI
MIPI
SATA
ANC
AMIC
JTAG
UART
USB
BLSP
SLIMBUS
MPP
CSI
DP
HDMI
GPS
EEPROM
SSBI
LNA
B2B
HSIC
Radio Frequency
System On Module
Quarter High Definition
System Power Management Interface (Qualcomm PMIC /
baseband proprietary protocol)
User Identity module
Near Field Communication
Embedded Multimedia Card
USB High Speed
USB Super Speed
MIPI Display Serial Interface
Mobile Industry processor interface
Serial ATA
Audio Noise Cancellation
Analog Microphone
Joint Test Action Group
Universal Asynchronous Receiver Transmitter
Universal Serial Bus
Bus access manager Low Speed Peripheral(Serial interfaces
like UART / SPI / I2C/ UIM)
Serial Low-power Inter-chip Media Bus
Multi-Purpose Pin
Camera Serial Interface
Display Port
High Definition Media Interface
Global Positioning system
Electrically Erasable Programmable Read only memory
Single wire serial bus interface (Qualcomm proprietary
mostly PMIC / Companion chip and baseband processor
protocol)
Low Noise Amplifier
Board to Board
High Speed Inter Connect Bus
6
Copyright Intrinsyc Technologies Corporation
Open-Q™ 820 (APQ8096) Development Kit - BSP Programmer Guide Version: 1.1
1.6 Resources
The following resources were used in the creation of this document:
http://source.android.com/source/initializing.html
http://developer.android.com/tools/publishing/versioning.html
http://developer.android.com/sdk/index.html
7
Copyright Intrinsyc Technologies Corporation