# Phytium-Android-Device

**Repository Path**: phytium_embedded/phytium-android-device

## Basic Information

- **Project Name**: Phytium-Android-Device
- **Description**: 该项目是介绍如何在飞腾平台上，移植启动Android操作系统。当前支持Android 16/13，支持芯片D3000M。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: android16_d3000m
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 2
- **Created**: 2025-10-22
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

# Phytium D3000M Android16 Device

## <font face="Courier New">引言
<font face="Courier New">该项目主要是介绍如何在飞腾腾珑D3000M芯片开发板上移植Android16 aosp。  
Phytium Android内核仓库地址：https://gitee.com/phytium_embedded/phytium-android-common-kernel  

---
<BR/>

## <font face="Courier New">一.搭建开发环境
<font face="Courier New">万事开头难，不过木有关系，千里之行始于足下！让我们先从最最简单的搭建Android aosp编译开发环境为起点，来开始我们的Android系统启动之旅！
#### <font face="Courier New">1.1 准备一台装有ubuntu20.04及以上系统X86主机，内存最低配置要求16G，建议32G。
><font face="Courier New" color = red>当然这个只是最低配置的要求，机器性能肯定是多多益善。配置越高，编译速度越快！而且强烈建议不要使用虚拟机安装ubuntu，而是直接安装ubuntu系统。不要问为什么，因为虚拟机跑ubuntu的效率太低，编译起来那酸爽，你懂的！</font>
#### <font face="Courier New">1.2 新建一个存放下载脚本文件的目录：  

```bash
$ mkdir ~/bin
$ PATH=~/bin:$PATH
```
#### <font face="Courier New">1.3 下载repo脚本文件  

```bash
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo  
$ chmod a+x ~/bin/repo  
$ vi ~/bin/repo  
$ REPO_URL = 'https://gerrit.googlesource.com/git-repo'  
$ 改为  
$ REPO_URL = 'https://gerrit-google.tuna.tsinghua.edu.cn/git-repo'  
```

#### <font face="Courier New">1.4.安装JDK 8  

```bash
$ sudo apt-get install openjdk-8-jdk  
```
#### <font face="Courier New">1.5.安装编译依赖库  
<font face="Courier New">构建Android编译需要依赖的库非常多，如下都是我们需要安装下载的库：

```bash
$ sudo apt-get install libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-dev g++-multilib
$ sudo apt-get install -y git flex bison gperf build-essential libncurses5-dev:i386
$ sudo apt-get install tofrodos python-markdown libxml2-utils xsltproc zlib1g-dev:i386
$ sudo apt-get install dpkg-dev libsdl1.2-dev libesd0-dev  
$ sudo apt-get install git-core gnupg flex bison gperf build-essential
$ sudo apt-get install zip curl zlib1g-dev gcc-multilib g++-multilib
$ sudo apt-get install libc6-dev-i386
$ sudo apt-get install lib32ncurses5-dev x11proto-core-dev libx11-dev
$ sudo apt-get install libgl1-mesa-dev libxml2-utils xsltproc unzip m4
$ sudo apt-get install lib32z-dev ccache
$ sudo apt-get install libncurses5
```
>  <font face="Courier New" color = red>如果在安装依赖库时遇到libesd0-dev 安装不成功，出现如下的错误信息  
  E: 无法定位软件包 libesd0-dev  
  sudo vim /etc/apt/sources.list  //在行尾添加如下两行的内容    
  deb http://us.archive.ubuntu.com/ubuntu/ xenial main universe  
  deb-src http://us.archive.ubuntu.com/ubuntu/ xenial main universe  
  sudo apt-get update && sudo apt-get install libesd0-dev</font>  

#### <font face="Courier New">1.6.修改编译服务器默认python版本
  <font face="Courier New">将默认python版本指定位python2 ，执行如下命令

```bash
$ ln -s /usr/bin/python2 /usr/bin/python  
```
---
<BR/>

## <font face="Courier New">二.Android aosp源代码下载
<font face="Courier New">经过前面的一顿操作，我们Android的开发环境已经构建OK了(Android源码下载环境和编译环境)，此时我们可以进行下载Android aosp源码的步骤了。

#### <font face="Courier New">2.1 创建存放android aosp源码的目录，进到该目录：

```bash
$ mkdir AN
$ cd AN
```
#### <font face="Courier New">2.2.下载初始化包
<font face="Courier New">执行如下命令:

```bash
wget -c -t 0 https://mirrors.tuna.tsinghua.edu.cn/aosp-monthly/aosp-latest.tar
tar xvf aosp-latest.tar
```
####  <font face="Courier New">2.3.解压后看到一个aosp的目录，进到该目录，同步到android16-qpr2-release版本

```bash
cd aosp
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android16-qpr2-release
repo sync
```
><font face="Courier New">温馨提示：<BR/>
>1.此处我们通过wget下载的是清华打包好的源，由于地域或者网络因素可能下载会很慢而且可能wget会异常退出，这个建议开发者最好是最清晨或者网络比较空闲的时候下载<BR/>
>2.如果使用清华的源下载的速度非常慢的话，建议开发者可以切换到中科大的源进行先关的操作，具体可以详见博客[使用清华或中科大AOSP源镜像下载Android源码](https://www.kaelli.com/19.html)和[中科大AOSP 镜像使用帮助](https://mirrors.ustc.edu.cn/help/aosp.html)。
----
<BR/>

## <font face="Courier New">三. 代码整合
<font face="Courier New">不容易啊到这里，我们Android的编译环境和aosp源码也都已经下载OK了。是时候合入飞腾适配相关的源码了！

####  <font face="Courier New">3.1 下载飞腾相关Android源码部分
<font face="Courier New" color = red>这里强烈建议朋友们，不要将飞腾对Android源码修改部分下载到前面Android aosp仓库的根目录下面，最好是和Android根目录平级的一个目录。</font>

<font face="Courier New">开始下载，执行clone命令：
```bash
cd ~/AN
~/AN$ git clone git@gitee.com:phytium_embedded/phytium-android-device.git
~/AN$ cd phytium-android-device
~/AN/phytium-android-device$ git checkout -b android16_d3000m origin/android16_d3000m
```

#### <font face="Courier New">3.2 合入飞腾android相关源码
<font face="Courier New">飞腾android相关源码下载完毕之后，要将工程 project代码合入到aosp代码中,执行project中的phytium_env.sh脚本，可以方便快捷的完成，具体如下：

```bash
~/AN/phytium-android-device$ chmod 777 phytium_env.sh 
~/AN/phytium-android-device$ ./phytium_env.sh  /home/xxx/AN/aosp
THE ANDROID_PATH_ROOT /home/xxx/AN/aosp 
 #### sync phytium env start！ #### 
 #### sync device_phytium  #### 
 #### apply patch  ####
 #### apply patch end ####
 #### sync phytium end！ #### 
```
<font face="Courier New" color = red>执行脚本的第一个参数，为aosp源码路径，我们这里就是“/home/xxx/AN/aosp”这个目录。</font>

##  <font face="Courier New">四.编译Android代码
<font face="Courier New">执行到这里，万事俱备只欠东风了。我们可以开始最终的Android源码编译和构建了。这里我们分为如下两部分进行:
####  <font face="Courier New">4.1 lunch编译项目
进入前面aosp的根目录执行，可以根据需要选择product，目前pd2508有两种可选择的product，如下命令:

| 选项 | 适用场景 | 主要特性 | 差别说明 |
|------|----------|----------|----------|
| `pd2508_pad-bp4a-userdebug` | 平板设备 | 支持传感器、NFC、触摸屏、蓝牙、WLAN、摄像头 | 包含完整的传感器支持（加速度计、陀螺仪等）和NFC功能，适合需要移动感知和近场通信的平板应用场景 |
| `pd2508_laptop-bp4a-userdebug` | 笔记本设备 | 支持触摸屏、蓝牙、WLAN、摄像头 | 不包含传感器和NFC支持，适合传统笔记本形态的设备，更注重桌面办公体验 |

```bash
~/AN/aosp$ source build/envsetup.sh
~/AN/aosp$ lunch pd2508_pad-bp4a-userdebug
============================================
PLATFORM_VERSION_CODENAME=REL
PLATFORM_VERSION=16
TARGET_PRODUCT=pd2508_pad
TARGET_BUILD_VARIANT=userdebug
TARGET_ARCH=arm64
TARGET_ARCH_VARIANT=armv8-a
TARGET_CPU_VARIANT=generic
TARGET_2ND_ARCH=arm
TARGET_2ND_ARCH_VARIANT=armv8-a
TARGET_2ND_CPU_VARIANT=generic
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.8.0-111-generic-x86_64-Ubuntu-22.04.5-LTS
HOST_CROSS_OS=windows
BUILD_ID=BP4A.251205.006
OUT_DIR=out
SOONG_ONLY=false
============================================
```
```bash
~/AN/aosp$ source build/envsetup.sh
~/AN/aosp$ lunch pd2508_laptop-bp4a-userdebug
============================================
PLATFORM_VERSION_CODENAME=REL
PLATFORM_VERSION=16
TARGET_PRODUCT=pd2508_laptop
TARGET_BUILD_VARIANT=userdebug
TARGET_ARCH=arm64
TARGET_ARCH_VARIANT=armv8-a
TARGET_CPU_VARIANT=generic
TARGET_2ND_ARCH=arm
TARGET_2ND_ARCH_VARIANT=armv8-a
TARGET_2ND_CPU_VARIANT=generic
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.8.0-111-generic-x86_64-Ubuntu-22.04.5-LTS
HOST_CROSS_OS=windows
BUILD_ID=BP4A.251205.006
OUT_DIR=out
SOONG_ONLY=false
============================================
```
  ><font face="Courier New" color = red>温馨提示：<BR/>
  >1.在开发阶段我们可以选择userdebug工程，实际生产或者测试相关性能的时候建议切到user模式，
  lunch pd2508_pad-bp4a-user or lunch pd2508_laptop-bp4a-user<BR/>
  >2.当我们从userdebug切到user模式进行相关烧录的时候，注意一定要对userdata分区进行相关清除工作(格式化或者直接删除掉该分区相关的内容),否则Android系统会启动异常</font>

####  <font face="Courier New">4.2 开始构建lunch项目

```bash
~/AN/aosp$ make -j32
```
<font face="Courier New" color="red">执行make开始编译，这里j后面的数字依据cpu的核数调整。第一次编译很耗时，例如Intel I5-9500 cpu，为6核6线程CPU，编译时间为5小时左右。j后面数字参考make命令关于-j参数的说明，建议定义为cpu核数，最大不要超过核数的2倍。另外，不同的product会生成在不同的out/target/product目录下互不影响，并且共同的代码如framework不需要重新编译；所以，在保证代码一致性并第一次编译成功的情况下可以不需要删除out编译，切换这两种product编译耗时很短。</font>

####  <font face="Courier New">4.3 查看最终构建结果
<font face="Courier New">编译成功，我们可以到out/target/product目录下查看，会看到编译生成的相关镜像文件。  
lunch时如果选择pd2508_pad-bp4a-userdebug，对应的目录为pd2508_pad；如果选择的是pd2508_labtop-bp4a-userdebug，对应的目录则为pd2508_labtop。为了描述方便，统一用<pd2508_xxx>指代，该路径统一称为out目录。以pad为例：
   
```bash
~/AN/aosp$ cd out/target/product/pd2508_pad/
~/AN/aosp/out/target/product/pd2508_pad$ ls *img
ramdisk.img  system.img  userdata.img  vendor.img
```
-----

<BR/>

##  <font face="Courier New">五.编译pd2508内核
<font face="Courier New">通过前面一顿猛如虎的操作，我们完成了Android镜像的编译了，是时候来编译飞腾相关的内核镜像了。大致流程无外乎，下载，配置编译环境，编译！

### <font face="Courier New">5.1 下载pd2508内核

```bash
cd ~/AN/
~/AN$ git clone git@gitee.com:phytium_embedded/phytium-android-common-kernel.git
git checkout -b android16_d3000m origin/android16_d3000m
```

### <font face="Courier New">5.2 构建编译环境开始编译

- <font face="Courier New"> 系统中安装arm64 gcc交叉编译器
```bash
$ sudo apt install gcc-aarch64-linux-gnu
```
- <font face="Courier New">配置clang交叉编译环境，google要求用clang编译kernel，aosp工程代码中提供了clang的交叉编译工具链。
路径在 aosp/prebuilts/clang/host/linux-x86/clang-r547379, 按下面方法配置环境并编译kernel，注意这里PATH路径以自己实际目录为准。

```bash
$ export PATH=~/AN/aosp/prebuilts/clang/host/linux-x86/clang-r547379/bin:$PATH
$ export MAKE_OPTIONS="ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- CC=clang HOSTCC=clang"
$ make ${MAKE_OPTIONS} phytium_gki_defconfig
$ make ${MAKE_OPTIONS} -j6
```
- <font face="Courier New">如果编译没有报错，将会在kernel目录arch/arm64/boot下，生成kernel的镜像文件Image。

-----
<br/>

##  <font face="Courier New">六. 镜像烧写
<font face="Courier New">通过前面艰苦卓绝的战斗，我们终于构建出来我们想要的各种Android镜像文件了，是时候见证奇迹的时刻了，让我们通过上述镜像来开启我们的Android启动之旅！

#### <font face="Courier New">6.1 打包boot.img

<font face="Courier New">boot.img 是一个 FAT32 格式的 EFI 启动分区。将内核Image和ramdisk.img拷贝到out目录boot目录下，运行脚本make_boot.sh即可生成boot.img
```bash
$ cd ~/AN/aosp/out/target/product/<pd2508_xxx>
$ cp <phytium-android-common-kernel>/arch/arm64/boot/Image ./boot/
$ cp ~/AN/aosp/out/target/product/<pd2508_xxx>/ramdisk.img ./boot/

$ tree boot
boot/
├── Image
├── ramdisk.img
└── EFI/
    └── BOOT/
        ├── bootaa64.efi
        └── grub.cfg

$ cp ~/AN/aosp/device/phytium/pd2508/pd2508_common/tools/mking/make_boot.sh ./
$ bash make_boot.sh
```

#### <font face="Courier New">6.2 打包aosp整体镜像
<font face="Courier New">现在out目录下已经有了boot.img system.img vendor.img这三个核心分区镜像文件，通过运行脚本mking.sh生成整体镜像文件aosp16-xxxx-pd2508.img。
```bash
$ cd ~/AN/aosp/out/target/product/<pd2508_xxx>
$ ls *.img
boot.img  system.img  vendor.img
$ cp ~/AN/aosp/device/phytium/pd2508/pd2508_common/tools/mking/mking.sh ./
$ bash mking.sh
```

#### <font face="Courier New">6.3 烧录整体镜像
<font face="Courier New">准备一个最小8G的NVME磁盘，接入一台X86电脑。将生成的整体镜像烧入该磁盘。Linux环境下，使用dd命令烧录即可
```bash
$ sudo dd if=aosp16-xxxx-pd2508.img of=/dev/sdb bs=1M
```
<font face="Courier New">也可以在windows环境下，使用win32Diskimager、rufus、balenaEtcher等烧录工具进行烧录。

#### <font face="Courier New">6.4 Userdata resize说明

<font face="Courier New">为了调试使用方便，我们新增了一个userdata resize的功能：在烧录后第一次启动init阶段，会自动将userdata分区自动reize到磁盘剩余的所有空间。所以userdata分区默认配置的size只有128M。  
如果不想使用该功能，需要做如下操作。
- 1.生成boot.img时，修改EFI/BOOT/grub.cfg文件，去掉其中的参数phytium.expand_data=1。
- 2.用mk_img.sh脚本生成镜像时，带入参数--size参数，指定userdata分区大小，单位是MB。具体分多大以你需要的大小为准，最小1024MB，如果想体验王者荣耀，需要几十G的空间。
```bash
$ bash mking.sh --size 1024
```
---
<BR/>

## <font face="Courier New">七. 启动设备
<font face="Courier New">见证奇迹的时刻就要到了，成功还是失败就在这把操作了。将烧写好的硬盘和调试串口线，连接到开发板上。上位机的串口调试工具波特率设置为115200，上电开机。  
飞腾提供了两种引导启动，UEFI和Uboot启动。D3000M平台默认是UEFI启动。

###  <font face="Courier New"> 7.1 UEFI启动

UEFI的启动参数配置在boot分区/EFI/BOOT/grub.cfg文件中，源码路径：
```
~/AN/aosp/device/phytium/<pd2508_xxx>/uefi_loader/EFI/BOOT/grub.cfg
```
<font face="Courier New">默认配置的参数能支持大部分场景启动，上电后，会直接进入系统。  
如果不出意外的话，静等片刻就可以看到我们的Android开机动画了,最终进入Android的启动界面。

![Android开机动画](res/bootanimation.png)
![Android Launcher](res/launcher.png)

###  <font face="Courier New"> 7.2 设置DPI
DPI会影响Android界面图标的大小。如果图想要调整DPI，可以在grub.cfg中添加一项 DPI=xxx.  

-------
<BR/>

## <font face="Courier New">八.  开源许可协议  
<font face="Courier New">这个项目我们采用的协议是:
Apache 2.0
----
<BR/>

## <font face="Courier New">九.项目维护者联系方式
<font face="Courier New">各位朋友，如果在使用过程中有遇到相关疑问，可以联系如下的相关维护者，我们将在第一时间为您提供答疑解惑，助您及时解决相关问题。<BR>
<font face="Courier New">zhangjianwei@phytium.com.cn  
<font face="Courier New">tangkaiwen@phytium.com.cn  
<font face="Courier New">xiayan1086@phytium.com.cn  
<font face="Courier New">chenda2442@phytium.com.cn