# Phytium-Android-Device

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

## Basic Information

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

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2025-10-22
- **Last Updated**: 2025-10-23

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

# Phytium D3000M Android13 Device

## <font face="Courier New">引言
<font face="Courier New">该项目主要是介绍如何在飞腾腾珑D3000M芯片开发板上移植Android13 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的目录，进到该目录，同步到android-13.0.0_r74版本

```bash
cd aosp
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-13.0.0_r74
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 android13_d3000m origin/android13_d3000m
```
<font face="Courier New">执行完成之后，飞腾部分Android源码下载ok，通过命令查看下:
```bash
$ tree -L 2 device_phytium/
device_phytium/
├── common
│   ├── audio
│   └── patch
└── pd2508
    ├── AndroidProducts.mk
    ├── BoardConfig.mk
    ├── fstab.pd2508
    ├── gpu
    ├── init.pd2508.rc
    ├── init.pd2508.usb.rc
    ├── manifest.xml
    ├── overlay
    ├── pd2508.mk
    ├── sepolicy
    ├── trusty_base.mk
    ├── uefi_loader
    └── ueventd.pd2508.rc
8 directories, 9 files
```

#### <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  ####
 #### applay patch end ####
 #### sync phytium end！ #### 
```
<font face="Courier New" color = red>执行脚本的第一个参数，为aosp源码路径，我们这里就是“/home/xxx/AN/aosp”这个目录。</font>

#### <font face="Courier New">3.3 修改fstab
<font face="Courier New">***这个步骤非常重要，未配置正确的fstab会导致启动kernel panic！！！***   
根据系统镜像存放的磁盘的实际节点，修改fstab配置。fstab文件路径：
~/AN/aosp/device/phytium/pd2508/fstab.pd2508
```bash
# Android fstab file.
#<src>                                                  <mnt_point>         <type>    <mnt_flags and options>                              <fs_mgr_flags>
# The filesystem that contains the filesystem checker binary (typically /system) cannot
# specify MF_CHECK, and must come before any filesystems that do specify MF_CHECK

#nvme
/dev/block/nvme0n1p2          /system             ext4      ro,barrier=1                                          wait,first_stage_mount
/dev/block/nvme0n1p3          /vendor             ext4      ro,barrier=1                                          wait,first_stage_mount
/dev/block/nvme0n1p4          /data               ext4      noatime,nosuid,nodev,nomblk_io_submit,errors=panic    wait
```
<font face="Courier New">其中/dev/block/nvme0n1p* 这几个是指nvme磁盘挂载在***开发板***上启动后，内核启动后该磁盘所对应的节点，fstab.pd2508默认配置是nvme。常见的集中磁盘介质及其节点如下表所示：  
|磁盘类型|节点|X/Y取值含义|举例|
|-|-|-|-|
|SATA/USB|sdX2|X:a\b\c,第X块SATA/USB硬盘|/dev/block/sda2|
|NVME|nvmeXnYp2|X：0\1\2,第X个NVMe控制器<BR>Y：1\2\3,该控制器的第Y个SSD|/dev/block/nvme0n1p2|
|MMC/SD|mmcblkXp2|X:0\1\2,第X个MMC/SD设备|/dev/block/mmcblk0p2|

-----
<BR/>

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

```bash
~/AN/aosp$ source build/envsetup.sh
~/AN/aosp$ lunch pd2508-userdebug
============================================
PLATFORM_VERSION_CODENAME=REL
PLATFORM_VERSION=13
TARGET_PRODUCT=pd2508
TARGET_BUILD_VARIANT=userdebug
TARGET_BUILD_TYPE=release
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
...
============================================
```
  ><font face="Courier New" color = red>温馨提示：<BR/>
  >1.在开发阶段我们可以选择userdebug工程，实际生产或者测试相关性能的时候建议切到user模式，
  lunch pd2508-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倍。</font>

####  <font face="Courier New">4.3 查看最终构建结果
<font face="Courier New">编译成功，我们可以到out/target/product目录下查看，会看到编译生成的相关镜像文件。  比如编译的是pd2508的工程，编译生成的文件如下：
   
```bash
~/AN/aosp$ cd out/target/product/pd2508/
~/AN/aosp/out/target/product/pd2508$ $ 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 android13_d3000m origin/android13_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-r450784d, 按下面方法配置环境并编译kernel，注意这里PATH路径以自己实际目录为准。

```bash
$ export PATH=~/AN/aosp/prebuilts/clang/host/linux-x86/clang-r450784d/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">5.1 烧录分区初始化

<font face="Courier New">首先准备一块nvme ssd硬盘，删除原有分区后，创建4个分区， 这里我们在linux下以伪代码来介绍下fdsik创建相关分区  

```bash
  p1 256MB for BOOT  
  p2 1920MB for /system : Do fdisk, new primary partition  
  p3 256MB for /vendor : Do fdisk, new primary partition  
  p4 remainings for /data, data分区依据硬盘大小，可以分的大一些，应用都会装在这个分区里。  
```

><font face="Courier New">温馨提示：<BR/>
>1.对于fdisk的使用不是很熟悉的，请开发者自行百度或者谷歌。<BR/>
>2.上述分区的大小只是建议，开发者可以根据实际情况来确定每个分区的大小。通常system分区和vendor分区和data分区分大点，预留升级空间。<BR/>
>3.且随着Android版本的sync，可能编译出来的vendor和system分区都会大于上述我们既定的大小，这个开发者可以自行修改不会影响正常的启动，并且对于data分区这个就是多多益善了。

#### <font face="Courier New">5.2 格式化boot分区和userdata分区
<font face="Courier New">将Boot分区格式化为vfat格式，userdata分区格式化成ext4，并设置分区名称，/dev/sdX中的X要依据该盘实际名字修改，伪代码如下: 
```bash
sudo mkfs.vfat -L boot   /dev/<sdX1>
sudo mkfs.ext4 -L userdata /dev/<sdX4>
```

#### <font face="Courier New">5.3 烧写system分区和vendor分区  
```bash
~/AN/aosp/out/target/product/pd2508$ sudo dd if=system.img of=/dev/<sdX2> bs=1M  
~/AN/aosp/out/target/product/pd2508$ sudo dd if=vendor.img of=/dev/<sdX3> bs=1M  
sync
```

#### <font face="Courier New">5.4 拷贝的kernel镜像、ramdisk、EFI引导文件到boot分区  
```bash
cd ~
$ mkdir tmp
$ sudo mount /dev/<sdx1> tmp
$ sudo cp ~/AN/android_common_kernel_6.6/arch/arm64/boot/Image tmp
$ sudo cp ~/AN/aosp/device/phytium/pd2508/uefi_loader/EFI/ tmp -r
$ sudo cp ~/AN/aosp/out/target/product/pd2508/ramdisk.img tmp
$ sudo umount tmp
```
---
<BR/>

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

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

UEFI的启动参数配置在boot分区/EFI/BOOT/grub.cfg文件中，源码路径：
```
~/AN/aosp/device/phytium/pd2508/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"> 6.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