phytium-linux-buildroot

Buildroot是一种简单、高效且易于使用的工具，可以通过交叉编译生成嵌入式Linux系统。Buildroot的用户手册位于docs/manual/manual.pdf。
phytium-linux-buildroot基于Buildroot，适配了飞腾e2000、d2000开发板，支持ubuntu文件系统、debian文件系统、initrd文件系统、buildroot最小文件系统的编译。

开发环境

系统要求

Buildroot被设计为在Linux系统上运行，我们只支持在ubuntu20.04、ubuntu22.04、debian11这三种主机系统上运行phytium-linux-buildroot，不支持其他系统。 首先，Buildroot需要主机系统上安装如下Linux程序，请检查是否已安装：

• Build tools:
– which
– sed
– make (version 3.81 or any later)
– binutils
– build-essential (only for Debian based systems)
– gcc (version 4.8 or any later)
– g++ (version 4.8 or any later)
– bash
– patch
– gzip
– bzip2
– perl (version 5.8.7 or any later)
– tar
– cpio
– unzip
– rsync
– file (must be in /usr/bin/file)
– device-tree-compiler
– bc
• Source fetching tools:
– wget
– git

除此之外，还需要安装如下软件包：
$ sudo apt install debootstrap qemu-user-static binfmt-support debian-archive-keyring
对于debian11系统，需要设置PATH环境变量：PATH=$PATH:/usr/sbin

下载phytium-linux-buildroot

$ git clone https://gitee.com/phytium_embedded/phytium-linux-buildroot.git

查看支持的defconfig

为飞腾CPU平台构建的文件系统的配置文件位于configs目录。
在phytium-linux-buildroot根目录下执行$ make list-defconfigs，返回configs目录中的defconfig配置文件。

$ cd xxx/phytium-linux-buildroot
$ make list-defconfigs

其中以phytium开头的为飞腾相关的defconfig配置文件，包含：

phytium_d2000_debian_defconfig      - Build for phytium_d2000_debian
phytium_d2000_debian_desktop_defconfig - Build for phytium_d2000_debian_desktop
phytium_d2000_defconfig             - Build for phytium_d2000
phytium_d2000_ubuntu_defconfig      - Build for phytium_d2000_ubuntu
phytium_d2000_ubuntu_desktop_defconfig - Build for phytium_d2000_ubuntu_desktop
phytium_d2000_ubuntu_qt5_defconfig  - Build for phytium_d2000_ubuntu_qt5
phytium_e2000_debian_defconfig      - Build for phytium_e2000_debian
phytium_e2000_debian_desktop_defconfig - Build for phytium_e2000_debian_desktop
phytium_e2000_defconfig             - Build for phytium_e2000
phytium_e2000_ubuntu_defconfig      - Build for phytium_e2000_ubuntu
phytium_e2000_ubuntu_desktop_defconfig - Build for phytium_e2000_ubuntu_desktop
phytium_initrd_defconfig            - Build for phytium_initrd
phytiumpi_defconfig                 - Build for phytiumpi
phytiumpi_ubuntu_desktop_defconfig  - Build for phytiumpi_ubuntu_desktop

编译文件系统

为e2000编译文件系统

编译默认配置的文件系统

（1）加载defconfig
$ make phytium_e2000_xxx_defconfig
其中phytium_e2000_xxx_defconfig为以下文件系统之一：

phytium_e2000_ubuntu_defconfig
phytium_e2000_ubuntu_desktop_defconfig
phytium_e2000_defconfig
phytium_e2000_debian_defconfig
phytium_e2000_debian_desktop_defconfig

（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核、e2000 img 镜像位于output/images目录。

e2000 img 镜像

目前buildroot支持编译e2000 img 镜像（disk.img），生成的e2000 img 镜像位于output/images目录。e2000 img 镜像包含了根文件系统、内核、设备树和GRUB。 使用e2000 img 镜像安装系统，不需要像之前那样将存储设备手动分区再拷贝文件，只需要将disk.img文件写入存储设备即可。

更换文件系统的linux内核版本

defconfig中的内核版本默认是linux 5.10。我们支持在编译文件系统时将内核版本更换为linux 4.19，linux 4.19 rt，linux 5.10 rt。 关于e2000 linux内核的信息请参考：https://gitee.com/phytium_embedded/phytium-linux-kernel
更换内核版本的操作步骤为：
（1）使用phytium_e2000_xxx_defconfig作为基础配置项，合并支持其他内核版本的配置：
$ ./support/kconfig/merge_config.sh configs/phytium_e2000_xxx_defconfig configs/phytium_e2000_linux_xxx.config
其中configs/phytium_e2000_linux_xxx.config为以下配置片段文件之一：

configs/phytium_e2000_linux_4.19.config
configs/phytium_e2000_linux_4.19_rt.config
configs/phytium_e2000_linux_5.10_rt.config

这三个文件分别对应于linux 4.19，linux 4.19 rt，linux 5.10 rt内核。
（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核、e2000 img 镜像位于output/images目录。

支持Phytium-optee

本项目还支持编译Phytium-optee，关于Phytium-optee的信息请参考：https://gitee.com/phytium_embedded/phytium-optee
defconfig默认不编译Phytium-optee，如果需要编译Phytium-optee请执行：
（1）使用phytium_e2000_xxx_defconfig作为基础配置项，合并支持optee的配置：
$ ./support/kconfig/merge_config.sh configs/phytium_e2000_xxx_defconfig configs/phytium_e2000_optee.config
目前Phytium-optee支持的开发板有e2000d demo、e2000q demo，默认配置为e2000d demo。如果需要更改，请将 configs/phytium_e2000_optee.config中BR2_PACKAGE_PHYTIUM_OPTEE_BOARD变量的值修改为"e2000qdemo"。
注意：phytium-linux-buildroot的最新代码已包含了Phytium-optee的依赖，如果您使用的phytium-linux-buildroot不是最新版本， 在执行编译之前需要额外安装依赖：

sudo apt install python3-pip
pip3 install pycryptodome
pip3 install pyelftools
pip3 install cryptography

（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核、TEE OS位于output/images目录。
后续部署及使用方法，请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/optee

支持xenomai

本项目还支持编译xenomai，关于xenomai的信息请参考：https://gitee.com/phytium_embedded/linux-kernel-xenomai
支持将xenomai内核及用户态的库、工具编译安装到debian系统上。如果需要编译xenomai请执行：
（1）使用phytium_e2000_debian_xxx_defconfig作为基础配置项，合并支持xenomai的配置：
$ ./support/kconfig/merge_config.sh configs/phytium_e2000_debian_xxx_defconfig configs/phytium_e2000_xenomai_xxx.config
其中，phytium_e2000_debian_xxx_defconfig为phytium_e2000_debian_defconfig或phytium_e2000_debian_desktop_defconfig；
phytium_e2000_xenomai_xxx.config为以下配置片段文件之一：

phytium_e2000_xenomai_cobalt_4.19.config  （xenomai cobalt 4.19内核+xenomai-v3.1.3.tar.gz）
phytium_e2000_xenomai_cobalt_5.10.config  （xenomai cobalt 5.10内核+xenomai-v3.2.2.tar.gz）
phytium_e2000_xenomai_mercury_4.19.config （linux 4.19 rt内核+xenomai-v3.1.3.tar.gz）
phytium_e2000_xenomai_mercury_5.10.config （linux 5.10 rt内核+xenomai-v3.2.2.tar.gz）

（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核、e2000 img 镜像位于output/images目录。
（4）文件的安装路径
xenomai用户态的库、工具被安装到根文件系统：
头文件安装到/usr/include/xenomai，配置文件安装到/etc，其它内容分别被安装到/usr目录下的bin，demo，lib，sbin，share。
关于xenomai的启动及测试工具等更多信息，请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/xenomai

支持ethercat

本项目还支持编译ethercat，关于ethercat的信息请参考：https://gitee.com/phytium_embedded/ether-cat
支持将ethercat驱动及用户态的库、工具编译安装到debian系统上，ethercat只支持linux 4.19 rt，linux 5.10 rt内核。如果需要编译ethercat请执行：
（1）使用phytium_e2000_debian_xxx_defconfig作为基础配置项，合并支持rt内核，及ethercat的配置：
./support/kconfig/merge_config.sh configs/phytium_e2000_debian_xxx_defconfig configs/phytium_e2000_linux_xxx_rt.config configs/phytium_e2000_ethercat.config
其中，phytium_e2000_debian_xxx_defconfig为phytium_e2000_debian_defconfig或phytium_e2000_debian_desktop_defconfig；
phytium_e2000_linux_xxx_rt.config为phytium_e2000_linux_4.19_rt.config或phytium_e2000_linux_5.10_rt.config。
（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核、e2000 img 镜像位于output/images目录。
（4）文件的安装路径
将ethercat的驱动模块安装到根文件系统的/lib/modules/version/ethercat/目录，并且通过将ec_macb加入/etc/modprobe.d/blacklist.conf 黑名单的方式，使得开机时不自动加载ec_macb模块，而是让用户手动加载。
ethercat用户态的库、工具被安装到根文件系统：
配置文件安装到/etc，其它内容分别被安装到/usr目录下的bin，include，lib，sbin，share。
关于ethercat的使用方法等更多信息，请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/ethercat

支持jailhouse（e2000）

本项目还支持为e2000编译jailhouse，关于jailhouse的信息请参考：https://gitee.com/phytium_embedded/phytium-jailhouse
支持将jailhouse编译安装到ubuntu系统，如果需要编译jailhouse请执行：
（1）使用phytium_e2000_ubuntu_xxx_defconfig作为基础配置项，合并支持jailhouse的配置：
./support/kconfig/merge_config.sh configs/phytium_e2000_ubuntu_xxx_defconfig configs/phytium_e2000_jailhouse_xxx.config
其中，phytium_e2000_ubuntu_xxx_defconfig为phytium_e2000_ubuntu_defconfig或phytium_e2000_ubuntu_desktop_defconfig；
phytium_e2000_jailhouse_xxx.config为phytium_e2000_jailhouse_4.19.config或phytium_e2000_jailhouse_5.10.config。
（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核、e2000 img 镜像位于output/images目录。
（4）文件的安装路径
jailhouse相关的文件被安装到根文件系统：

按照Makefile中的规则，将jailhouse的驱动jailhouse.ko安装到/lib/modules/version/jailhouse/driver；jailhouse.bin安装到/lib/firmware；
linux-loader.bin安装到/usr/local/libexec/jailhouse；jailhouse和ivshmem-demo安装到/usr/local/sbin；
python helper脚本安装到/usr/local/libexec/jailhouse；jailhouse-config-collect.tmpl和root-cell-config.c.tmpl
安装到/usr/local/share/jailhouse；jailhouse-completion.bash安装到/usr/share/bash-completion/completions/并改名为jailhouse；
另外，还将configs/*/*.cell安装到/etc/jailhouse；inmates/demos/*/*.bin安装到/usr/local/libexec/jailhouse/demos；
pyjailhouse安装到/usr/local/lib/python3.8/dist-packages。

关于jailhouse的使用方法等更多信息，请参考https://gitee.com/phytium_embedded/phytium-jailhouse/blob/master/Readme.md

为d2000编译文件系统

与“为e2000编译文件系统”相比，“为d2000编译文件系统”还需要“准备内核源码”和“编译initrd”。

准备内核源码

（1）在phytium-linux-buildroot的根目录下创建files目录，将内核源码拷贝到files目录并重命名为linux-4.19.tar.gz
$ mkdir files
$ cp xxx/linux-4.19-master.tar.gz files/linux-4.19.tar.gz
（2）计算内核源码的哈希值

$ sha256sum files/linux-4.19.tar.gz
22a2345f656b0624790dcbb4b5884827c915aef00986052fd8d9677b9ee6b50e  files/linux-4.19.tar.gz

编辑linux/linux.hash文件，将linux-4.19.tar.gz对应行的哈希值修改为刚刚计算的哈希值，如下所示：
sha256 22a2345f656b0624790dcbb4b5884827c915aef00986052fd8d9677b9ee6b50e linux-4.19.tar.gz
注意：每次更新files目录里面的内核源码，都需要同时修改linux/linux.hash里面内核源码对应的哈希值，这是为了验证files目录中的文件与dl目录中的文件一致。

编译initrd

（1）配置及编译initrd

$ make phytium_initrd_defconfig 
$ make 

（2）将编译好的initrd备份保存
$ cp xxx/phytium-linux-buildroot/output/images/rootfs.cpio.gz ~/initrd
（3）清理编译结果
$ make clean

编译默认配置的文件系统

（1）加载defconfig
$ make phytium_d2000_xxx_defconfig
其中phytium_d2000_xxx_defconfig为以下文件系统之一：

phytium_d2000_ubuntu_defconfig
phytium_d2000_ubuntu_desktop_defconfig
phytium_d2000_defconfig
phytium_d2000_debian_defconfig
phytium_d2000_debian_desktop_defconfig

（2）编译文件系统
$ make
（3）镜像的输出位置
生成的根文件系统、内核位于output/images目录。

支持无桌面qt5 eglfs

本项目还支持将qt5 eglfs编译安装到无桌面的ubuntu系统，对应的配置文件为phytium_d2000_ubuntu_qt5_defconfig，用来运行在d2000+x100上。
如果需要编译qt5 eglfs请执行：
（1）加载defconfig
$ make phytium_d2000_ubuntu_qt5_defconfig
（2）编译文件系统
$ make
（3）镜像的输出位置
生成的根文件系统、内核位于output/images目录。
（4）文件的安装路径
qt5相关的文件被安装到根文件系统的/usr目录：
头文件安装到/usr/include/qt5，库安装到/usr/lib，plugins安装到/usr/lib/qt/plugins，examples安装到/usr/lib/qt/examples。

支持jailhouse（d2000/ft2004）

本项目还支持为d2000/ft2004编译jailhouse，编译步骤与为e2000编译jailhouse的步骤类似，请参考“为e2000编译文件系统>支持jailhouse（e2000）”。
除了将第（1）步，修改为：
（1）使用phytium_d2000_ubuntu_defconfig作为基础配置项，合并支持jailhouse的配置：
./support/kconfig/merge_config.sh configs/phytium_d2000_ubuntu_defconfig configs/phytium_d2000_jailhouse.config
其余步骤与为e2000编译jailhouse的步骤相同。

为phytiumpi编译SD卡镜像

（1）加载defconfig
$ make phytiumpi_xxx_defconfig
其中phytiumpi_xxx_defconfig为以下文件系统之一：

phytiumpi_defconfig
phytiumpi_ubuntu_desktop_defconfig

（2）编译
$ make
（3）镜像的输出位置
生成的根文件系统、内核位于 output/images 目录。 sdcard.img 就是 SD 的镜像文件。
后续部署及使用方法，请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/phytiumpi/linux

清理编译结果

（1）$ make clean
删除所有编译结果，包括output目录下的所有内容。当编译完一个文件系统后，编译另一个文件系统前，需要执行此命令。
（2）$ make distclean
重置buildroot，删除所有编译结果、下载目录以及配置。

树外构建

默认情况下，buildroot生成的所有内容都存储在buildroot源码目录的output目录。然而，buildroot也支持树外构建。树外构建允许使用除output以外的其他输出目录。 使用树外构建时，buildroot的.config和临时文件也存储在输出目录中。这意味着使用相同的buildroot源码树，只要使用不同的输出目录，可以并行运行多个构建。
使用树外构建进行配置的方式有以下三种：
（1）在buildroot源码目录运行，使用O变量指定输出目录：
$ make O=xxx/foo-output phytium_xxx_defconfig
（2）在一个空的输出目录运行，需要指定O变量和buildroot源码树的路径：
$ mkdir xxx/foo-output
$ cd xxx/foo-output
$ make -C xxx/phytium-linux-buildroot/ O=$(pwd) phytium_xxx_defconfig
（3）对于使用merge_config.sh合并配置文件的情况，在buildroot源码目录运行：
$ mkdir xxx/foo-output
$ ./support/kconfig/merge_config.sh -O xxx/foo-output configs/phytium_xxx_defconfig configs/phytium_xxx.config

运行上述命令之一，buildroot会在输出目录中创建一个Makefile，所以在输出目录中再次运行make时，不再需要指定O变量和buildroot源码树的路径。
因此配置完成后，编译的命令为：
$ cd xxx/foo-output
$ make

在开发板上启动系统

在e2000开发板上启动系统

安装系统

可以通过手动分区的方式安装系统，将存储设备分区、格式化后，再将buildroot生成的文件拷贝到对应的分区； 也可以使用e2000 img 镜像安装系统，这种方式不需要手动将存储设备分区再拷贝文件，只需要将disk.img文件写入存储设备即可。

手动分区安装系统

（1）主机端将存储设备分成两个分区（以主机识别设备名为/dev/sdb 为例，请按实际识别设备名更改）
$ sudo fdisk /dev/sdb
这将启动fdisk程序，在其中输入命令：

输入g创建GPT分区表；
输入n创建分区，需要创建两个分区；
输入t将第一个分区的分区类型修改为'EFI System'；
输入p打印分区表，确保输出中包含'Disklabel type: gpt'及第一个分区的类型为'EFI System'；
输入w将分区表写入磁盘并退出。

（2）格式化分区

$ sudo mkfs.vfat /dev/sdb1
$ sudo mkfs.ext4 /dev/sdb2

（3）将内核、设备树和GRUB拷贝到第一个分区（EFI分区），将根文件系统拷贝到第二个分区（根分区）

$ sudo mount /dev/sdb1 /mnt
$ sudo cp xxx/phytium-linux-buildroot/output/images/Image /mnt
$ sudo cp xxx/phytium-linux-buildroot/output/images/e2000q-demo-board.dtb /mnt（用于U-Boot启动）
$ sudo cp -r xxx/phytium-linux-buildroot/output/images/efi-part/EFI/ /mnt（用于UEFI启动）
$ sync
$ sudo umount /dev/sdb1
$ sudo mount /dev/sdb2 /mnt
$ sudo cp xxx/phytium-linux-buildroot/output/images/rootfs.tar /mnt
$ cd /mnt
$ sudo tar xvf rootfs.tar
$ sync
$ cd ~
$ sudo umount /dev/sdb2

使用e2000 img 镜像安装系统

将e2000 img 镜像（disk.img）写入存储设备：
$ sudo dd if=xxx/phytium-linux-buildroot/output/images/disk.img of=/dev/sdb bs=1M
$ sync

U-Boot启动系统

安装系统后，将存储设备接到开发板，启动开发板电源，串口输出U-Boot命令行，设置U-Boot环境变量来启动系统。
SATA盘：

=>setenv bootargs console=ttyAMA1,115200  audit=0 earlycon=pl011,0x2800d000 root=/dev/sda2 rw;
=>fatload scsi 0:1 0x90100000 Image;
=>fatload scsi 0:1 0x90000000 e2000q-demo-board.dtb;
=>booti 0x90100000 - 0x90000000

U盘：

=>setenv bootargs console=ttyAMA1,115200  audit=0 earlycon=pl011,0x2800d000 root=/dev/sda2 rootdelay=5 rw;
=>usb start
=>fatload usb 0:1 0x90100000 Image;
=>fatload usb 0:1 0x90000000 e2000q-demo-board.dtb;
=>booti 0x90100000 - 0x90000000

UEFI启动系统

如果是使用e2000 img 镜像安装系统，将存储设备接到开发板，启动开发板电源，即可自动启动系统。
如果是通过手动分区的方式安装系统，安装系统后，还需要在主机端配置存储设备的EFI分区中的/EFI/BOOT/grub.cfg文件，确保菜单条目中内核命令行参数root的值为根分区（这里是第二个分区）。
（1）通过分区UUID
获取第二个分区的UUID：
$ sudo blkid -s PARTUUID -o value /dev/sdb2
将grub.cfg中root的值设置为"root=PARTUUID=xxx"，xxx为分区UUID的值。
（2）通过设备名
将grub.cfg中root的值设置为"root=/dev/sda2"。
然后将存储设备接到开发板，启动开发板电源，自动启动系统。

在d2000开发板上启动系统

安装系统

（1）主机端将存储设备分成两个分区（以主机识别设备名为/dev/sdb 为例，请按实际识别设备名更改）
$ sudo fdisk /dev/sdb
这将启动fdisk程序，在其中输入命令：

输入g创建GPT分区表；
输入n创建分区，需要创建两个分区；
输入t将第一个分区的分区类型修改为'EFI System'；
输入p打印分区表，确保输出中包含'Disklabel type: gpt'及第一个分区的类型为'EFI System'；
输入w将分区表写入磁盘并退出。

（2）格式化分区

$ sudo mkfs.vfat /dev/sdb1
$ sudo mkfs.ext4 /dev/sdb2

（3）主机端将内核、设备树、GRUB和initrd拷贝到第一个分区（EFI分区），将根文件系统拷贝到第二个分区（根分区）

$ sudo mount /dev/sdb1 /mnt
$ sudo cp xxx/phytium-linux-buildroot/output/images/Image /mnt
$ sudo cp xxx/phytium-linux-buildroot/output/images/d2000-devboard-dsk.dtb /mnt（用于U-Boot启动）
$ sudo cp -r xxx/phytium-linux-buildroot/output/images/efi-part/EFI/ /mnt（用于UEFI启动）
$ sudo cp ~/initrd /mnt
$ sync
$ sudo umount /dev/sdb1
$ sudo mount /dev/sdb2 /mnt
$ sudo cp xxx/phytium-linux-buildroot/output/images/rootfs.tar /mnt
$ cd /mnt
$ sudo tar xvf rootfs.tar
$ sync
$ cd ~
$ sudo umount /dev/sdb2

U-Boot启动系统

安装系统后，将存储设备接到开发板，启动开发板电源，串口输出U-Boot命令行，设置U-Boot环境变量来启动系统。
SATA盘：

=>setenv bootargs console=ttyAMA1,115200 earlycon=pl011,0x28001000 root=/dev/sda2 rootdelay=5 rw initrd=0x93000000,85M
=>fatload scsi 0:1 0x90100000 d2000-devboard-dsk.dtb
=>fatload scsi 0:1 0x90200000 Image
=>fatload scsi 0:1 0x93000000 initrd
=>booti 0x90200000 - 0x90100000

U盘：

=>setenv bootargs console=ttyAMA1,115200 earlycon=pl011,0x28001000 root=/dev/sda2 rootdelay=5 rw initrd=0x93000000,85M
=>usb start
=>fatload usb 0:1 0x90100000 d2000-devboard-dsk.dtb
=>fatload usb 0:1 0x90200000 Image
=>fatload usb 0:1 0x93000000 initrd
=>booti 0x90200000 - 0x90100000

UEFI启动系统

安装系统后，需要在主机端配置存储设备的EFI分区中的/EFI/BOOT/grub.cfg文件，确保菜单条目中内核命令行参数root的值为根分区（这里是第二个分区）。
（1）通过分区UUID
获取第二个分区的UUID：
$ sudo blkid -s PARTUUID -o value /dev/sdb2
将grub.cfg中root的值设置为"root=PARTUUID=xxx"，xxx为分区UUID的值。
（2）通过设备名
将grub.cfg中root的值设置为"root=/dev/sda2"。
然后将存储设备接到开发板，启动开发板电源，自动启动系统。

ubuntu系统安装桌面

phytium_e2000_ubuntu_desktop_defconfig和phytium_d2000_ubuntu_desktop_defconfig默认安装了xfce桌面，配置并编译它就可以获得带 xfce桌面的ubuntu系统。如果需要在开发板上安装其他桌面，重新配置并编译phytium_e2000_ubuntu_defconfig或phytium_d2000_ubuntu_defconfig， 然后在开发板启动这个不带桌面的ubuntu系统。

登录

ubuntu系统包含了超级用户root，和一个普通用户user，密码和用户名相同。

动态获取 IP 地址

$ sudo dhclient
$ ping www.baidu.com

安装桌面

安装GNOME桌面

$ sudo apt update
$ sudo apt -y install ubuntu-gnome-desktop

安装KDE桌面

$ sudo apt update
$ sudo apt -y install kubuntu-desktop

安装XFCE桌面

$ sudo apt update
$ sudo apt -y install xfce4 xfce4-terminal
在安装过程中，它会要求你选择显示管理器是gdm3还是lightdm，这里选择的是lightdm。  
安装完成后重启系统，在图形登录界面点击用户名右边的ubuntu logo按钮，选择桌面环境为“Xfce Session”，输入密码登录。

ubuntu及debian系统支持linux-headers

linux-headers包含构建内核外部模块所需的头文件，编译ubuntu和debian的defconfig会生成linux-headers。
关于如何编译内核外部模块，可参考https://www.kernel.org/doc/html/latest/kbuild/modules.html

交叉编译内核模块

编译ubuntu和debian的defconfig，会在output/target/usr/src目录中安装linux-headers-version。
使用buildroot的工具链来交叉编译内核模块，buildroot工具链位于output/host/bin，工具链的sysroot为 output/host/aarch64-buildroot-linux-gnu/sysroot。

交叉编译内核外部模块的命令为：

$ make ARCH=arm64 \
CROSS_COMPILE=/home/xxx/phytium-linux-buildroot/output/host/bin/aarch64-none-linux-gnu- \
-C /home/xxx/phytium-linux-buildroot/output/target/usr/src/linux-headers-5.10.153-phytium-embeded \
M=$PWD \
modules

开发板上编译内核模块

buildroot将linux-headers-version安装在根文件系统的/usr/src目录下， 并为它创建了一个软链接/lib/modules/version/build。
注意，由于linux-headers是在x86-64主机交叉编译生成的，在开发板上直接使用它编译内核模块会报错：
/bin/sh: 1: scripts/basic/fixdep: Exec format error。
因此，需要将x86-64格式的fixdep等文件替换为ARM aarch64格式的（以linux 5.10内核为例）：
（1）scp -r username@host:/home/xxx/phytium-linux-buildroot/board/phytium/common/linux-5.10/scripts /usr/src/linux-headers-5.10.153-phytium-embeded
（2）或者在编译ubuntu和debian的defconfig之前，将board/phytium/common/post-custom-skeleton-ubuntu-base-20.04.sh和 board/phytium/common/post-custom-skeleton-debian-base-11.sh中的如下两行取消注释，再执行编译。
# cp -r board/phytium/common/linux-5.10/scripts $destdir
# cp -r board/phytium/common/linux-4.19/scripts $destdir

在开发板上编译内核外部模块的命令为：
make -C /lib/modules/5.10.153-phytium-embeded/build M=$PWD modules

buildroot编译新的应用软件

本节简单介绍如何通过buildroot交叉编译能运行在开发板上的应用软件，完整的教程请参考buildroot用户手册manual.pdf。

buildroot软件包介绍

buildroot中所有用户态的软件包都在package目录，每个软件包有自己的目录package/<pkg>，其中<pkg>是小写的软件包名。这个目录包含：
（1）Config.in文件，用Kconfig语言编写，描述了包的配置选项。
（2）<pkg>.mk文件，用make编写，描述了包如何构建，即从哪里获取源码，如何编译和安装等。
（3）<pkg>.hash文件，提供hash值，检查下载文件的完整性，如检查下载的软件包源码是否完整，这个文件是可选的。
（4）*.patch文件，在编译之前应用于源码的补丁文件，这个文件是可选的。
（5）可能对包有用的其他文件。

编写buildroot软件包

首先创建软件包的目录package/<pkg>，然后编写该软件包中的文件。
buildroot中的软件包基本上由Config.in和<pkg>.mk两个文件组成。关于如何编写这两个文件，大家可以参考package/<vpu-lib>和 buildroot用户手册，这里简单概括一下。
（1）Config.in文件中必须包含启用或禁用该包的选项，而且必须命名为BR2_PACKAGE_<PKG>，其中<PKG>是大写的软件包名，这个选项的值是布尔类型。 也可以定义其他功能选项来进一步配置该软件包。然后还必须在package/Config.in文件中包含该文件：
source "package/<pkg>/Config.in"
（2）<pkg>.mk文件看起来不像普通的Makefile文件，而是一连串的变量定义，而且必须以大写的包名作为变量的前缀。最后以调用软件包的基础结构（package infrastructure）结束。变量告诉软件包的基础结构要做什么。
对于使用手写Makefile来编译的软件源码，在<pkg>.mk中调用generic-package基础结构。generic-package基础结构实现了包的下载、提取、打补丁。 而配置、编译和安装由<pkg>.mk文件描述。<pkg>.mk文件中可以设置的变量及其含义，请参考buildroot用户手册。

编译软件包

（1）单独编译软件包

$ cd xxx/phytium-linux-buildroot
$ make <pkg>

编译结果在output/build/<pkg>-<version>

（2）将软件包编译进根文件系统

在phytium_xxx_defconfig中添加一行BR2_PACKAGE_<PKG>=y
$ make phytium_xxx_defconfig
$ make

FAQ

1. Ubuntu文件系统桌面无法登陆问题?

文件系统启动后控制台下apt install kubuntu-desktop    
检查/home/user权限是否为user  
chown -R user:user /home/user
重新启动开发板子

2. 播放音频没有声音？

将user用户加入audio组，可解决user用户下没声音的问题
gpasswd -a user audio

3. 下载ubuntu及debian太慢或报错？
   目前下载ubuntu及debian的源为清华大学镜像，如果遇到下载很慢，或者下载报错： E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing? 从而导致编译的phytium_e2000_debian_desktop_defconfig或phytium_e2000_ubuntu_desktop_defconfig没有桌面问题， 请将清华源更换为中科大源，即将以下文件

board/phytium/common/post-custom-skeleton-ubuntu-base-20.04.sh
board/phytium/common/ubuntu-package-installer
board/phytium/common/post-custom-skeleton-debian-base-11.sh
board/phytium/common/debian-package-installer

中的mirrors.tuna.tsinghua.edu.cn改为mirrors.ustc.edu.cn

4. 编译内核时报错Can't find default configuration "arch/arm64/configs/phytium_defconfig"!
   需要删除dl目录中的内核源码，再重新编译：

rm -rf dl/linux/
make linux-dirclean
make

5. 关于e2000 vpu的包请咨询飞腾技术支持或FAE。

6. 在ubuntu或debian上安装完cpufreq-utils，CPU调频模式不再是performance。
   安装了cpufreq-utils以后，会同时安装一个/etc/init.d/cpufrequtils脚本，这个脚本在启动后会将cpufreq的模式设置为ondemand动态调频。 可以把这个脚本改一下：将ENABLE改为false，便不会修改cpufreq策略，或者将GOVERNOR=“performance”。