inforce 6501 User manual

Confidential and Proprietary –Inforce Computing Inc.
NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public
servers or web sites to: t[email protected].
Restricted Distribution: Not to be distributed to anyone who is not an employee of either
Inforce Computing or its subsidiaries without the express approval of Inforce Computing.
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 Inforce Computing, Inc.
Inforce Computing is a trademark of Inforce Computing Incorporated, registered in the
United States and other countries. All Inforce Computing 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.
Inforce Computing Inc.
48820 Kato Road, # 600B
Fremont, CA 94538
U.S.A.
© 2015 Inforce Computing Inc.
Inforce 6501™Development Kit
Ubuntu Linux Software Release Note V1.0
002602 Rev B
September 22, 2015
Submit technical questions at:
http://www.inforcecomputing.com/techweb/

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Revision History
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION i
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
Revision History
Revision
Date
Description
Author
A
18/August/2015
Initial Release
VS
B
22/September/2015
Changed SYS6501 to Inforce 6501 development kit
Updated Section 1
MSS
Approval Record
Function
Name
Date
Checked By
VS
22/September/2015
Reviewed By
MV
22/September/2015
Approved By
RVD
22/September/2015

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 License Agreement
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION ii
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
License Agreement
Your use of this document is subject to and governed by those terms and conditions in the Inforce
Computing Purchase and Software License Agreement for the APQ8084 based Inforce 6501
development kit, which you or the legal entity you represent, as the case may be, accepted and
agreed to when purchasing a Inforce 6501 development kit from Inforce Computing Inc.
(“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
Inforce 6501 development kit under the Agreement. Distribution of this document is strictly
prohibited without the express written permission of Inforce Computing Inc. and its respective
licensors, which they can withhold, condition or delay in its sole discretion.
Inforce Computing is a trademark of Inforce Computing Inc., registered in USA and other countries.
Qualcomm is a trademark of Qualcomm Inc, 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.

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Preface
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION iii
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
Preface
This document provides instructions to build and boot an Ubuntu-based Linaro Member Build that
provides a terminal-like environment using Ubuntu Linux and the Gnome terminal on the Inforce
6501 development kit.
Intended Audience
This document is intended for Linux developers and practitioners who intend to try out Ubuntu
Linux on the Inforce 6501 development kit.
Intended Use
All Inforce boards are evaluated as Information Technology Equipment (I.T.E.) for use in personal
computers (PC) for installation in homes, offices, schools, computer rooms, and similar locations.
The suitability of this product for other PC or embedded non-PC applications or other environments,
such as medical, industrial, alarm systems, test equipment, etc. may not be supported without
further evaluation by Inforce Computing.
Conventions
The following conventions are used in this document:
CAUTION
Cautions warn the user about how to prevent damage to hardware or loss of data.
NOTE
Notes call attention to important information.
Note
This document is subject to change without notice.
Support Information
Every effort has been made to ensure the accuracy of Release Note. If you have any comments,
questions, or ideas regarding this document, contact Inforce’s technical support at:
[e-mail]

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Table of Contents
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION iv
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
Table of Contents
INTRODUCTION ............................................................................................................................1
UBUNTU LINUX ON INFORCE 6501 DEVELOPMENT KIT ............................................................2
BUILD AND RUN IMAGES........................................................................................................................2
PROGRAMMING THE ETHERNET MAC ADDRESS.................................................................................6
FEATURES OF THE RELEASE..........................................................................................................7
FEATURES SUPPORTED IN THIS RELEASE .............................................................................................7
NEW FEATURES OF THIS RELEASE .........................................................................................................7
BUGS..............................................................................................................................................8
KNOWN ISSUES........................................................................................................................................8
FIXED .........................................................................................................................................................8
WITHDRAWN ............................................................................................................................................8
LIMITATIONS.................................................................................................................................9
CONTACT INFORMATION .......................................................................................................... 10

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Introduction
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 1
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
INTRODUCTION
The Inforce 6501 development kit is comprised of the Inforce 6501 Micro SoM and a Mini-ITX carrier
board. It is powered by Qualcomm® Snapdragon™ 805 APQ8084 SoC. This software release is
applicable only for 16GB eMMC storage of the Inforce 6501 boards.
The Inforce 6501 development kit comes bundled with the proper power supply (12V) and it is
recommended to use it.
The boot process is complex, but from a high-level perspective, it can be described as follows: The
krait core jumps to the main bootloader after the booting process. SBL1 and the APPSBL are binary
files which are loaded from eMMC partitions. Loading these files from SD card is not supported.
There are dedicated partitions in the on-board eMMC for each of these files:
Partition
Size (kb)
Label
mmcblk0p2
512
sbl1
mmcblk0p7
1024
aboot
It is not recommended to erase or modify any of these partitions. Modifying may cause the
board to no longer boot. If the eMMC partitions have been erased or partition table has been
corrupted, the board would have to be sent back through RMA.
The board comes with fastboot support, which means that the APPSBL implements the fastboot
protocol. Fastboot is a special bootloader protocol that allows eMMC partition to be flashed with
new images. By default, the APPSBL will load and execute the boot image from the ‘boot’ partition.
To go to fastboot mode, press the power and Vol–buttons simultaneously on the carrier board
before powering on the Inforce 6501 board.
This release supports the following versions:
Linux Kernel: 3.10.40
Ubuntu Linux: 14.10 aka Utopic

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Ubuntu Linux on Inforce 6501 Development Kit
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 2
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
UBUNTU LINUX ON INFORCE 6501
DEVELOPMENT KIT
The following instructions assume that you are working from an Ubuntu 12.04 (or later) host system
for development. The steps for other systems will be similar, and should be easily discerned from
what follows.
BUILD AND RUN IMAGES
A. Package Description
The binaries and build-related files are packaged into the tarball, which can be extracted to the
release folder “SYS6501_Ubuntu_Linux_BSP_880399_V1.0”. This package contains binaries and
source folders.
The binaries folder contains:
Boot image that includes prebuilt kernel with Inforce patches applied (zImage+dts+initrd)
Root FS image that includes a minimal Gnome Shell environment
Firmware image that includes proprietary firmwares from Qualcomm
The binaries provided can be flashed directly onto your Inforce 6501 development kit using the
commands in the next section.
The source folder contains:
GCC compiler tarball
Boot image configuration file
Initrd image
Kernel source bundle in repo-ifc6501-v1.0.bundle
Base kernel patches (without MIPI-DSI feature)
MIPI-DSI patches
These files are useful to build kernel image.
B. Flashing the Images
Change the directory to binaries folder within the release folder. From fastboot mode, enter the
following commands:
#fastboot flash boot boot-ifc6501-v1.0.img
#fastboot flash cache firmware-ifc6501-v1.0.img
#fastboot flash userdata rootfs-ubuntu-utopic-gnome-ifc6501-v1.0.img
#fastboot reboot

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Ubuntu Linux on Inforce 6501 Development Kit
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 3
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
The platform shall boot into Ubuntu utopic. Once the board boots, enter the login password
“linaro”. The Gnome-based image is expected to provide a terminal-like experience and it is thus
recommended to use an USB Keyboard.
NOTE
Flashing userdata takes around 22 minutes.
MIPI-DSI feature is not supported in the default release binaries.
C. Resizing Root FS Partition
Open a terminal and enter the command below:
$ df -ah
The above command will list the available partitions and sizes. To increase the partition size, issue
the following commands:
$ sudo resize2fs /dev/mmcblk0p25
$ df -ah
Note that the partition size is increased to 10GB.
Now if you want to build the kernel images and create a boot image, follow the steps in the
subsequent sections.
D. Fetch Kernel Sources
To build the kernel image, follow the steps listed below from your Ubuntu host machine. To get
kernel sources, the user can follow any of the following methods:
Getting kernel source from the release package
The kernel sources are available within the source folder of the
SYS6501_Ubuntu_Linux_BSP_880399_V1.0 package as repo-ifc6501-v1.0.bundle.
$mkdir Ubuntu_Linux
$cd Ubuntu_Linux
Copy the repo-ifc6501-v1.0.bundle file to the current folder from the source package
SYS6501_Ubuntu_Linux_BSP_880399_V1.0 using the commands below:
$cp <path to release folder>/source/repo-ifc6501-v1.0.bundle .
$git clone repo-ifc6501-v1.0.bundle ifc6501-v1.0 -b ifc6501-
v1.0
$cd ifc6501-v1.0

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Ubuntu Linux on Inforce 6501 Development Kit
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 4
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
Getting kernel source through GIT repository
The current Ubuntu-Linux release is based on Android 4.4.4 MSM kernel with the release
tag LNX.LA.3.6_rb1.27. The kernel sources are available on codeaurora.org.
$mkdir Ubuntu_Linux
$cd Ubuntu_Linux
$git clone git://codeaurora.org/kernel/msm-3.10.git ifc6501-
v1.0 -b LNX.LA.3.6_rb1.27
$cd ifc6501-v1.0
Extract the patches from 3.10.40-ifc6501-v1.0-patches.tar.gz file in the source folder.
$tar xvf ../../source/3.10.40-ifc6501-v1.0-patches.tar.gz
Apply the patches to the kernel.
$ git checkout -b ifc6501-v1.0
$ git am 3.10.40-ifc6501-v1.0-patches/*.patch
NOTE
The kernel built using the above method will only support HDMI display, not Truly MIPI-DSI display. In
order to make the Truly MIPI-DSI display to work, extra patches are needed which are available in the
ZIP file 3.10.40-ifc6501-v1.0-mipi-dsi-patches.tar.gz.
Extract the MPI-DSI patches from 3.10.40-ifc6501-v1.0-mipi-dsi-patches.tar.gz file in the source
folder.
$tar xvf ../../source/3.10.40-ifc6501-v1.0-mipi-dsi-patches.tar.gz
Apply the MIPI-DSI patches to the kernel.
$ git checkout -b ifc6501-v1.0-mipi-dsi
$ git am 3.10.40-ifc6501-v1.0-mipi-dsi-patches/*.patch
E. Build Kernel Sources
Use the toolchain available in Inforce package SYS6501_Ubuntu_Linux_BSP_880399_V1.0 (the
toolchain can also be downloaded from
https://releases.linaro.org/14.09/components/toolchain/binaries/gcc-linaro-arm-linux-
gnueabihf-4.9-2014.09_linux.tar.bz2.
Change the directory to SYS6501_Ubuntu_Linux_BSP_880399_V1.0/source.
$tar xvf gcc-linaro-arm-linux-gnueabihf-4.9-2014.09_linux.tar.bz
Change the directory to SYS6501_Ubuntu_Linux_BSP_880399_V1.0/Ubuntu_Linux/ifc6501-
v1.0.
$TC={path to release folder}/source/gcc-linaro-arm-linux-gnueabihf-
4.9-2014.09_linux/bin/arm-linux-gnueabihf-
$alias kmake='make CROSS_COMPILE=$TC ARCH=arm -j16'
$kmake ifc6501_defconfig
$kmake qcom/apq8084-v1.1-sbc.dtb
$kmake zImage
$cat arch/arm/boot/zImage arch/arm/boot/dts/qcom/apq8084-v1.1-
sbc.dtb > zImage-dtb

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Ubuntu Linux on Inforce 6501 Development Kit
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 5
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
abootimg is a tool to read/write/update Android boot partition, and is available in most standard
Linux distributions. From your Ubuntu host machine, run the following commands:
$sudo apt-get install abootimg -y
$abootimg --create boot-ifc6501-v1.0.img -k zImage-dtb -f
../../source/bootimg_6501.cfg -r ../../source/initrd.img
#fastboot flash boot boot-ifc6501-v1.0.img
Assuming that firmware and user data are flashed earlier as in Section B,
#fastboot reboot
Once the board boots, enter the login password “linaro”.
F. Wi-Fi Module Build
Wi-Fi feature is supported in the default release binaries. Follow the steps below to build wlan kernel
module if the user wants to build it from the sources.
Change the directory to SYS6501_Ubuntu_Linux_BSP_880399_V1.0/Ubuntu_Linux folder, and
follow the steps below:
$git clone git://codeaurora.org/platform/vendor/qcom-
opensource/wlan/qcacld-2.0.git -b LNX.LA.3.6_rb1.27
$cd qcacld-2.0
$TC={path to release folder}/source/gcc-linaro-arm-linux-gnueabihf-
4.9-2014.09_linux/bin/arm-linux-gnueabihf-
$alias kmake='make CROSS_COMPILE=$TC ARCH=arm -j16'
Make the following changes to Makefile:
KERNEL_SRC ?= <kernel source path>
$kmake
Copy the wlan.ko to /lib/modules/3.10.40-ifc6501-v1.0+/extra/ directory on target.
Run “sudo depmod -a” command on target.
Reboot the target.
G. Customizing the rootfs
The user can add/delete/modify contents in rootfs provided by Inforce, if required. The tools
(android-tools-fsutils in Debian/Ubuntu) are typically packaged in desktop distributions of Ubuntu
Utopic.
Use the following commands to customize the rootfs:
$simg2img rootfs-ubuntu-utopic-gnome-ifc6501-v1.0.img rootfs.img.raw
$mkdir mnt-point
$sudo mount -t ext4 -o loop rootfs.img.raw mnt-point/

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Ubuntu Linux on Inforce 6501 Development Kit
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 6
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
Make the required changes to rootfs:
$img2simg rootfs.img.raw rootfs-ubuntu-utopic-gnome-ifc6501-v1.0-
modified.img
$sudo umount mnt-point/
The generated rootfs file can be directly flashed with fastboot.
PROGRAMMING THE ETHERNET MAC ADDRESS
Update the file using the command $sudo vi /etc/network/interfaces in Inforce 6501 by the
MAC address available as a sticker on the board.
auto eth0
iface eth0 inet dhcp
hwaddress ether xx:xx:xx:xx:xx:xx

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Features of the Release
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 7
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
FEATURES OF THE RELEASE
FEATURES SUPPORTED IN THIS RELEASE
The following features are supported in this release:
1. HDMI Display and Audio: 1080p video playback with audio has been validated in this
release.
2. Gigabit Ethernet: This release supports Gigabit Ethernet.
3. USB 2.0 and USB 3.0: USB-based input devices (Keyboard, Mouse, Mass Storage) have been
validated in this release.
4. Micro SD Card Interface: Access to micro SD card interface has been validated.
NOTE
Connect the micro SD card to the board. Execute the following commands:
#fdisk -l
#mkdir /temp2
#mount /dev/mmcblk1p1 /temp2 (p1 partition is assumed to be
present in the SD card)
5. Serial UART: This release supports serial UART.
6. CPU Frequency: This release supports up to 2.7GHz.
7. USB Camera (Microsoft LifeCam HD 5000 is validated
http://www.microsoft.com/hardware/ en-in/d/lifecam-hd-5000)
Use the following commands to test the USB camera:
#sudo apt-get update
#sudo apt-get install cheese -y
#sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-bad -y
Connect the Microsoft HD camera to the USB port of the Inforce 6501 development kit.
Launch the camera using cheese application by issuing the following command and you shall
see the camera-captured frames on the HDMI display:
# cheese &
8. Analog Audio: This release has support for analog audio (Tx/Rx) through external codec
WCD9320.
9. Wi-Fi: This release was validated for Wi-Fi client functionality.
10. MIPI-DSI: Support for Truly 480×864 (ACC-1B30) display (only for kernel built after applying
the MIPI-DSI patches).
NEW FEATURES OF THIS RELEASE
This section is not applicable for this release.

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Bugs
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 8
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
BUGS
KNOWN ISSUES
The following table describes the known bugs in this release. Future releases will be deployed, as
these issues are resolved.
#
Description
1
While using only DSI, there is a slight delay when the truly 480×864 panel is used and the display
backlight flashes five times.
2
Audio is simultaneously heard on both the analog jack and the HDMI.
3
Slight green flicker is observed on the DSI-MIPI display.
4
Audio is not working on the DSI-MIPI display.
FIXED
This section is not applicable for this release.
WITHDRAWN
This section is not applicable for this release.

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Limitations
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 9
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
LIMITATIONS
The following features are not supported in this release:
1. MIPI-CSI Camera
2. GPS
3. Bluetooth
4. On-board Accelerometer and Gyroscope sensors
5. Multimedia support without video hardware acceleration.
6. Hexagon DSP Support
7. Analog MIC
8. HDMI only mode is not working when MIPI-DSI patches are applied.
Display working modes are:
DSI only
DSI + HDMI

Inforce 6501™ Development Kit Ubuntu Linux Software Release Note V1.0 Contact Information
002602 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 10
Confidential and Proprietary –Inforce Computing, Inc.
Provided under NDA
CONTACT INFORMATION
USA (Corporate Headquarters)
Inforce Computing, Inc.
48820 Kato Road, # 600B
Fremont, California 94538 USA.
Phone: [phone]
Fax: [phone]
For technical assistance refer:
http://www.inforcecomputing.com/techweb
For technical support contact:
[e-mail]
For sales contact:
[e-mail]
© 2015 Inforce Computing, Inc. All rights reserved. All data provided is for informational purposes only and does not represent any expressed or implied
guarantees. At the time of publishing, the information is believed to have been accurate; nevertheless, Inforce Computing doesn’t assume responsibility for any
errors, omissions, and inaccuracies whatsoever. Product specifications are subject to change without notice. Inforce Computing and the Inforce logo are registered
trademarks of Inforce Computing, Inc. in the USA and other countries. Qualcomm and Snapdragon are trademarks of Qualcomm Incorporated, registered in the
United States and other countries; used with permission. Qualcomm Snapdragon is a product of Qualcomm Technologies, Inc. Qualcomm Snapdragon, Qualcomm
Adreno, Qualcomm Hexagon, Krait™ and HQV™ are products of Qualcomm Technologies Inc. All other trademarks and product information are the property of
their respective owners.