Running Android on the Raspberry Pi: Android Pie meets Raspberry Pi

Running Android on the Raspberry Pi
Android Pie meets Raspberry Pi
Chris Simmonds
Android Makers 2019
Running Android on the Raspberry Pi 1 Copyright © 2011-2019, 2net Ltd

License
These slides are available under a Creative Commons Attribution-ShareAlike 4.0 license. You can read the full
text of the license here
http://creativecommons.org/licenses/by-sa/4.0/legalcode
You are free to
• copy, distribute, display, and perform the work
• make derivative works
• make commercial use of the work
Under the following conditions
• Attribution: you must give the original author credit
• Share Alike: if you alter, transform, or build upon this work, you may distribute the resulting work only
under a license identical to this one (i.e. include this page exactly as it is)
• For any reuse or distribution, you must make clear to others the license terms of this work

About Chris Simmonds
• Consultant and trainer
• Author of Mastering Embedded Linux Programming
• Working with embedded Linux since 1999
• Android since 2009
• Speaker at many conferences and workshops
"Looking after the Inner Penguin" blog at http://2net.co.uk/
@2net_software
https://uk.linkedin.com/in/chrisdsimmonds/

Why?
• Porting Android to a dev board is a great way to learn about Android

Why?
• It’s a good testing ground for new ideas

Why?
• It’s a good testing ground for new ideas
• It’s fun! No, really it is!

What do you need to run Android?
• Hardware from one of the supported architectures
• ARM, x86 or MIPS, in 32 or 64 bit varieties

• Running a recent version of Linux kernel (v4.4 or later)

• With at least 512 MiB RAM

• And at least 1 GiB ﬂash storage - e.g. eMMC, SD card

• Plus a touchscreen or external display - e.g. HDMI

• Plus a touchscreen or external display - e.g. HDMI
• And a GPU with OpenGL ES 2.0 libraries (more about this later)

Android on dev boards
DragonBoard, Hikey, BeagleBone, WandBoard, Raspberry Pi, Digi ConnectCore ...

Why Raspberry Pi?
• It’s cheap ($35)

Why Raspberry Pi?
• Easy to get hold of

Why Raspberry Pi?
• Hackable

Why Raspberry Pi?
• Hackable
• Because it is there

The Raspberry Pi 3B
• BCM2837, Cortex-A53 (ARMv8) 64-bit
SoC @ 1.2GHz
• 1 GiB SDRAM
• Micro SD card slot
• 4 full size USB 2.0 A host
• 100 Mbit Ethernet
• WiFi 802.11 a/b/g/n/ac
• Bluetooth 4.2/BLE
• HDMI video output
• 40-pin header for HATs

Hasn’t it been done already?
Sure! Here are some notable projects
• Android RPi: https://github.com/android-rpi
• LineageOS: (unofﬁcial build from KonstaKang)
https://konstakang.com/devices/rpi3/LineageOS15.1
• RTAndroid: https://embedded.rwth-aachen.de/doku.php?id=en:
tools:rtandroid
• based on research by Igor Kalkov, now merged into emteria.os
• emteria.os: https://emteria.com (not open source)
• Android Things:
https://developer.android.com/things/hardware/raspberrypi
(not open source)

What do you need?
• A copy of the Android Open Source Project (AOSP)

What do you need?
• A Linux kernel with Android extensions

What do you need?
• A fair knowledge of the hardware

What do you need?
• All the help you can get from existing projects

What do you need?
• A fairly fast computer

What do you need?
• A fairly fast computer
• Time and patience

Putting Android on Raspberry Pi
• What follows is based on Konsta’s port of LineageOS

• My version of the code is at
https://github.com/csimmonds/a4rpi-local-manifest

• Challenges posed by the Raspberry Pi

• Bootloader

• Bootloader
• Graphics

• Bootloader
• Graphics
• Lack of USB OTG port

Getting AOSP
• AOSP is all of the open source components of the Android O/S

Getting AOSP
• Begin by getting the repo tool
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ∼/bin/repo
$ chmod a+x ∼/bin/repo

Getting AOSP
• Get the manifest of the version you want
$ mkdir ∼/myandroid
$ cd myandroid
$ repo init -u https://android.googlesource.com/platform/manifest -b android-9.0.0_r35

Getting AOSP
• Get the manifest of the version you want
$ mkdir ∼/myandroid
$ cd myandroid
$ repo init -u https://android.googlesource.com/platform/manifest -b android-9.0.0_r35
• Copy all the code (*)
$ repo sync
(*) 70 GiB worth

Customizing AOSP
• Porting Android to new hardware means creating a new Board
Support Package

Customizing AOSP
Support Package
• Consisting of device conﬁguration (next slide), Hardware
Abstraction Layer and other low level packages

Customizing AOSP
Support Package
• Put these into a local manifest, .repo/local_manifests/default.xml

Customizing AOSP
Support Package
• Put these into a local manifest, .repo/local_manifests/default.xml
$ git clone https://github.com/csimmonds/a4rpi-local-manifest .repo/local_manifests -b pie
<?xml version="1.0" encoding="UTF-8"?>
<manifest>
<remote name="a4rpi" fetch="https://github.com/csimmonds" />
<remote name="lineage" fetch="https://github.com/lineage-rpi"/>
<project path="device/rpiorg/rpi3" name="a4rpi-device" revision="pie" remote="a4rpi"/>
[...]

Device configuration
• Device specific configuration is in device/[organisation]/[product]
• Example: device/rpiorg/rpi3

Device configuration
• Device specific configuration is in device/[organisation]/[product]
• Example: device/rpiorg/rpi3
• Select the one you want with command lunch
$ source build/envsetup.sh
$ lunch rpi3-eng

Selecting the base product
• Base product is selected in device conﬁguration by device.mk
$(call inherit-product, $(SRC_TARGET_DIR)/product/aosp_base.mk)
• Products in AOSP
aosp_base.mk Android tablet
aosp_base_telephony.mk Android phone
atv_base.mk Android TV
car.mk Android Automotive

Building AOSP
m

Building AOSP
m
Then go and make a cup of tea: it’s going to take a couple of hours

When the build is over
• You will ﬁnd images in out/target/product/[product name]
out/target/product/rpi3/cache.img
out/target/product/rpi3/ramdisk.img
out/target/product/rpi3/system.img
out/target/product/rpi3/userdata.img
out/target/product/rpi3/vendor.img
• Just write these to a micro SD card (Raspberry Pi)
• ... or use fastboot to ﬂash them (everything except Raspberry Pi)

But wait, what about Linux?
• Android runs on top of Linux

• So, you need a Linux kernel with the Android kernel patches

• Usually provided by the silicon vendor (Qualcomm, NXP, Rockchip, ...)

• Usually provided by the silicon vendor (Qualcomm, NXP, Rockchip, ...)
• For Raspberry Pi, use Konsta’s kernel:
$ git clone https://github.com/lineage-rpi/android_kernel_brcm_rpi3 -b lineage-15.1 rpi3
$ cd rpi3
$ make lineageos_rpi3_defconfig
$ make -j $(nproc) zImage
$ make dtbs

Challenge 1: Booting the Raspberry Pi
• Most Android devices have a bootloader that supports the fastboot
protocol for ﬂashing and booting images

• Raspberry Pi does not have such a bootloader

• So, we have to package the kernel and initial ramdisk and use
Broadcom loader to start Linux

• So, we have to package the kernel and initial ramdisk and use
Broadcom loader to start Linux
• ... To update Android, you need to take out the SD card and reﬂash ...

Boot ﬁles
• The RPi boots from the ﬁrst partition of the SD card
Bootloader:
bootcode.bin
fixup.dat
fixup_x.dat
start.elf
start_x.elf
config.txt
Linux:
cmdline.txt
bcm2710-rpi-3-b.dtb
overlays/
zImage
Android:
ramdisk.img

Challenge 2: Graphics
• We need OpenGL ES 2.0 libraries with Android extensions

• Three options

• Three options
• Get binary OpenGLES libraries from the vendor, if they exist (they don’t
for Broadcom BCM2708/2835)

• Three options
• Use open source drivers, Mesa and DRM, if they exist (they do for
BCM2708/2835)

• Three options
• Use open source drivers, Mesa and DRM, if they exist (they do for
BCM2708/2835)
• Use Soft GPU, Swiftshader

Graphics: Mesa
mesa
OpenGLES
OpenGLES
3-D Apps
android.opengl.*
HWUI
2-D graphics
libEGL.so
libGLESv1_cm.so
libGLESv2.so
libEGL_mesa.so
libGLESv1_CM_mesa.so
libGLESv2_mesa.so
DRM VC4 kernel driver
Framework
HAL
Kernel
libdrm
Surface Flinger
drm_
hwcomposer
drm_
gralloc
V3D GPU Video controller
Surface
buﬀers

Mesa
• Mesa 3D library: https://www.mesa3d.org/

Mesa
• Supports OpenGL ES 1/2/3 and EGL

Mesa
• Supports OpenGL ES 1/2/3 and EGL
• Drivers for mobile GPUs include:
Driver SoC
freedreno Qualcomm MSM
nouveau NVidea Tegra
VC4 Broadcom BCM2708 (Raspberry Pi)
etnaviv NXP i.MX6
lima/panfrost ARM Mali 4xx, Txxx and Gxx
softpipe soft GPU

DRI/DRM
• DRI (Direct Rendering Infrastructure): user-space wrappers for DRM,
including libdrm

DRI/DRM
including libdrm
• DRM (Direct Rendering Manager): kernel device driver to access GPU
and video controller hardware blocks

DRI/DRM
including libdrm
• DRM (Direct Rendering Manager): kernel device driver to access GPU
and video controller hardware blocks
# ls -l /dev/dri/*
crw-rw-rw- 1 root graphics 226, 0 1970-01-01 00:00 /dev/dri/card0
crw-rw-rw- 1 root graphics 226, 128 1970-01-01 00:00 /dev/dri/renderD128

Open source graphics go mainstream
• Google is encouraging vendors to move to mesa/DRM

Open source graphics go mainstream
• Google is encouraging vendors to move to mesa/DRM
• For example
• Pixel 3 has a Qualcomm 845 SoC with Adreno 630 GPU
• Uses Mesa/DRM with freedreno driver
See Alistair Strachan’s presentation at Linux Plumber’s conference, November 2018,
DRM/KMS for Android
https://linuxplumbersconf.org/event/2/contributions/229/attachments/53/60/
10._DRM_KMS_for_Android_v1.pdf

Graphics: Swiftshader
SwiftShader
OpenGLES
OpenGLES
App 3-D graphics
android.opengl.*
HWUI
2-D graphics
libEGL.so
libGLESv1_cm.so
libGLESv2.so
libEGL_swiftshader.so
libGLESv1_CM_swiftshader.so
libGLESv2_swiftshader.so
Surface Flinger
FBDEV
Framework
HAL
Kernel

Challenge 3: ADB
• Raspberry Pi only has USB host ports, but ADB needs a USB
peripheral port

Challenge 3: ADB
peripheral port
• Usually provided by a dual mode USB "On The Go" (OTG) port

Challenge 3: ADB
peripheral port
• (Actually, the BCM283x has OTG hardware but it is used internally to
bridge the USB host controller, Ethernet, and so on)

Challenge 3: ADB
peripheral port
• But, we can use ADB over Ethernet instead
$ adb connect Android.local
connected to Android.local:5555

Challenge 3: ADB
peripheral port
• But, we can use ADB over Ethernet instead
$ adb connect Android.local
connected to Android.local:5555
$ adb shell
rpi3:/ #

Current status
• Code is on github (URL at the
end)
• Based on Android Pie 9.0 r 30
• Using SwiftShader
• Works:
• HDMI touch screen
• Ethernet
• WiFi (probably)
• Bluetooth (possibly)
• Not working:
• Audio
• Streaming video
• Lots of other things...
• Early stages: still many things to
do

Apps
• Has standard AOSP apps
• Install Gapps if you want
PlayStore, etc
https://opengapps.org
• Note: this does not come with
a license from Google

Delving deeper
• If you would like to discover more about building Android platforms,
visit http://www.2net.co.uk/training.html and enquire about
training classes for your company
• 2net training is available world-wide

Relevant links:
Android 4 RPi
@2net_software http://www.2net.co.uk
Any questions?

Running Android on the Raspberry Pi: Android Pie meets Raspberry Pi

More Related Content

What's hot (20)

Similar to Running Android on the Raspberry Pi: Android Pie meets Raspberry Pi (20)

More from Chris Simmonds (18)

Recently uploaded (20)

Running Android on the Raspberry Pi: Android Pie meets Raspberry Pi