飞腾派OS(Phytium Pi OS)是运行在飞腾派开发板上的深度定制的Linux系统(基于Debian11)。它针对飞腾派开发板的硬件定制了内核配置,不同的软件包,可以更好的适应不同的场景。
它可以烧录在SD卡中,作为飞腾派开发板的启动系统。
飞腾派OS由Buildroot生成,获取更多Buildroot的信息,可参考用户手册docs/manual/manual.pdf。
Buildroot被设计为在x86 Linux系统上运行,结合其他因素,本仓库只支持在ubuntu20.04、ubuntu22.04、debian11这三种x86系统上进行开发,不支持其他系统。
首先,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)
– bc
• Source fetching tools:
– wget
– git
除此之外,还需要安装如下软件包:
$ sudo apt install debootstrap qemu-user-static binfmt-support debian-archive-keyring
对于debian11系统,需要设置PATH环境变量:PATH=$PATH:/usr/sbin
$ git clone https://gitee.com/phytium_embedded/phytium-pi-os
克隆后,将会生成phytium-pi-os目录,我们称之为源码根目录,若无另外说明,下面的操作命令都是基于该源码根目录进行描述的
为飞腾派构建的文件系统的配置文件位于configs目录。
执行$ make list-defconfigs
,返回configs目录中的defconfig配置文件。
$ cd xxx/phytium-pi-os
$ make list-defconfigs
其中以phytiumpi开头的为飞腾相关的defconfig配置文件,包含:
phytiumpi_defconfig - Build for phytiumpi
phytiumpi_desktop_defconfig - Build for phytiumpi with desktop
(1)加载defconfig
$ make phytiumpi_xxx_defconfig
其中phytiumpi_xxx_defconfig
为以下文件系统之一:
phytiumpi_defconfig
phytiumpi_desktop_defconfig
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、sdcard.img 镜像位于output/images目录。
支持编译phytiumpi img 镜像(sdcard.img),生成的phytiumpi img 镜像位于output/images目录。sdcard.img 镜像包含了根文件系统、内核、设备树。
使用sdcard.img 镜像安装系统,不需要将存储设备手动分区再拷贝文件,只需要将sdcard.img文件写入存储设备即可。
defconfig中的内核版本默认是linux 5.10。我们支持在编译文件系统时将内核版本更换为linux 4.19,linux 4.19 rt,linux 5.10 rt。
关于phytiumpi linux内核的信息请参考:https://gitee.com/phytium_embedded/phytium-linux-kernel
更换内核版本的操作步骤为:
(1)使用phytiumpi_xxx_defconfig作为基础配置项,合并支持其他内核版本的配置:
$ ./support/kconfig/merge_config.sh configs/phytiumpi_xxx_defconfig configs/phytiumpi_linux_xxx.config
其中configs/phytiumpi_linux_xxx.config
为以下配置片段文件之一:
configs/phytiumpi_linux_4.19.config
configs/phytiumpi_linux_4.19_rt.config
configs/phytiumpi_linux_5.10_rt.config
这三个文件分别对应于linux 4.19,linux 4.19 rt,linux 5.10 rt内核。
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、sdcard.img 镜像位于output/images目录。
本项目还支持编译Phytium-optee,关于Phytium-optee的信息请参考:https://gitee.com/phytium_embedded/phytium-optee
defconfig默认不编译Phytium-optee,如果需要编译Phytium-optee请执行:
(1)使用phytiumpi_xxx_defconfig作为基础配置项,合并支持optee的配置:
$ ./support/kconfig/merge_config.sh configs/phytiumpi_xxx_defconfig configs/phytiumpi_optee.config
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、TEE OS位于output/images目录。
后续部署及使用方法,请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/optee
本项目还支持编译xenomai,关于xenomai的信息请参考:https://gitee.com/phytium_embedded/linux-kernel-xenomai
支持将xenomai内核及用户态的库、工具编译安装到debian系统上。如果需要编译xenomai请执行:
(1)使用phytiumpi_xxx_defconfig作为基础配置项,合并支持xenomai的配置:
$ ./support/kconfig/merge_config.sh configs/phytiumpi_xxx_defconfig configs/phytiumpi_xenomai_xxx.config
其中,phytiumpi_xxx_defconfig
为phytiumpi_defconfig
或phytiumpi_desktop_defconfig
;
phytiumpi_xenomai_xxx.config
为以下配置片段文件之一:
phytiumpi_xenomai_cobalt_4.19.config (xenomai cobalt 4.19内核+xenomai-v3.1.3.tar.gz)
phytiumpi_xenomai_cobalt_5.10.config (xenomai cobalt 5.10内核+xenomai-v3.2.2.tar.gz)
phytiumpi_xenomai_mercury_4.19.config (linux 4.19 rt内核+xenomai-v3.1.3.tar.gz)
phytiumpi_xenomai_mercury_5.10.config (linux 5.10 rt内核+xenomai-v3.2.2.tar.gz)
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、sdcard.img 镜像位于output/images目录。
(4)文件的安装路径
xenomai用户态的库、工具被安装到根文件系统的/usr/xenomai目录。
关于xenomai的启动及测试工具等更多信息,请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/xenomai
本项目还支持编译ethercat,关于ethercat的信息请参考:https://gitee.com/phytium_embedded/ether-cat
支持将ethercat驱动及用户态的库、工具编译安装到debian系统上,ethercat只支持linux 4.19 rt,linux 5.10 rt内核。如果需要编译ethercat请执行:
(1)使用phytiumpi_xxx_defconfig作为基础配置项,合并支持rt内核,及ethercat的配置:
./support/kconfig/merge_config.sh configs/phytiumpi_xxx_defconfig configs/phytiumpi_linux_xxx_rt.config configs/phytiumpi_ethercat.config
其中,phytiumpi_xxx_defconfig
为phytiumpi_defconfig
或phytiumpi_desktop_defconfig
;
phytiumpi_linux_xxx_rt.config
为phytiumpi_linux_4.19_rt.config
或phytiumpi_linux_5.10_rt.config
。
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、sdcard.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
本项目还支持编译openamp,编译OpenAMP裸跑二进制镜像请参考:https://gitee.com/phytium_embedded/phytium-standalone-sdk
,编译OpenAMP FreeRTOS二进制镜像请参考:https://gitee.com/phytium_embedded/phytium-free-rtos-sdk
支持将openamp二进制镜像、用户空间测试程序安装到debian系统上,openamp只支持linux 4.19,linux 5.10内核。如果需要编译openamp请执行:
(1)使用phytiumpi_xxx_defconfig作为基础配置项,合并支持openamp的配置:
./support/kconfig/merge_config.sh configs/phytiumpi_xxx_defconfig configs/openamp_xxx.config
其中,phytiumpi_xxx_defconfig
为phytiumpi_defconfig
或phytiumpi_desktop_defconfig
;
openamp_xxx.config
为openamp_standalone.config
或openamp_free_rtos.config
。
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、sdcard.img 镜像位于output/images目录。
(4)文件的安装路径
将openamp二进制镜像、用户空间测试程序安装到根文件系统:
openamp_core0.elf安装到/lib/firmware,用户空间测试程序安装到/usr/bin。
关于openamp的使用方法等更多信息,请参考https://gitee.com/phytium_embedded/phytium-embedded-docs/tree/master/open-amp
使用默认配置phytiumpi_xxx_defconfig编译出的SD卡镜像,默认支持移远通信EC20CEHDLG-128-SNNS无线通信4G模块。如何实现4G模块上网,参考飞腾派支持4G模块上网
使用默认配置phytiumpi_xxx_defconfig编译出的SD卡镜像不支持5G上网功能。如果需要支持移远通信RG200U-CN MINIPCIE 5G模块上网,需要重新编译生成SD卡镜像。
(1)使用phytiumpi_xxx_defconfig作为基础配置项,合并支持5G模块的配置:
./support/kconfig/merge_config.sh configs/phytiumpi_desktop_defconfig configs/phytiumpi_5g.config
(2)编译
$ make
(3)镜像的输出位置
生成的根文件系统、内核、sdcard.img 镜像位于output/images目录。
关于使用5G模块上网的详细步骤,请参考本仓库的wiki飞腾派支持5G模块上网。
(1)$ make clean
删除所有编译结果,包括output目录下的所有内容。当编译完一个文件系统后,编译另一个文件系统前,需要执行此命令。
(2)$ make distclean
重置源码根目录,删除所有编译结果、下载目录以及配置。
注:make distclean命令会删除下载目录(dl目录)下的所有源码压缩包。将下载目录提前备份,二次编译时,可以大大减少编译所需时间。
默认情况下,编译生成的所有内容都存储在output目录,然而,树外构建允许使用除output以外的其他输出目录。使用树外构建时,全局配置文件.config和临时文件也存储在输出目录中。这意味着使用相同的源码树,只要使用不同的输出目录,就可以并行运行多个构建。
使用树外构建进行配置的方式有以下三种可供选择:
(1)在源码根目录下,使用O变量指定输出目录:
$ make O=xxx/foo-output phytiumpi_xxx_defconfig
(2)在一个空的输出目录运行,指定O变量和源码根目录的路径:
$ mkdir xxx/foo-output
$ cd xxx/foo-output
$ make -C xxx/phytium-pi-os/ O=$(pwd) phytiumpi_xxx_defconfig
(3)对于使用merge_config.sh合并配置文件的情况,在源码根目录运行:
$ mkdir xxx/foo-output
$ ./support/kconfig/merge_config.sh -O xxx/foo-output configs/phytiumpi_xxx_defconfig configs/phytiumpi_xxx.config
运行上述命令之一,会在输出目录中创建一个Makefile,所以在输出目录中再次运行make时,不再需要指定O变量和源码根目录的路径。
因此配置完成后,编译的命令为:
$ cd xxx/foo-output
$ make
默认的内核源码目录是output/build/linux-<version>
,如果在该目录对内核进行了修改(例如修改内核配置或源码),
当运行make clean
后该目录会被删除,修改也随之被删除,所以在该目录中直接修改内核是不合适的。
因此,对于这种情况提供了一种机制:<PKG>_OVERRIDE_SRCDIR
机制。
操作方法是,创建一个叫做local.mk的文件,local.mk的内容可以是:
LINUX_OVERRIDE_SRCDIR = /home/xxx/linux-kernel/linux-xxx
将local.mk文件和.config文件放在同一目录下。这个目录对于树内构建是源码根目录,对于树外构建是树外构建的输出目录。
LINUX_OVERRIDE_SRCDIR指定了一个本地的内核源码目录,这样就不会去下载、解压、打补丁内核源码了,而是使用LINUX_OVERRIDE_SRCDIR
指定的内核源码目录。需要注意内核源码实际存放的目录要与LINUX_OVERRIDE_SRCDIR的值相对应。
这样开发人员首先在LINUX_OVERRIDE_SRCDIR指定的目录对内核进行修改,然后运行make linux-rebuild
或者 make linux-reconfigure
即可。
该命令首先将LINUX_OVERRIDE_SRCDIR中的内核源码同步到output/build/linux-custom
目录,然后进行配置、编译、安装。
如果想要编译、安装内核,并重新生成系统镜像,请运行make linux-rebuild phyuboot-rebuild all
。
(1)将phytiumpi img 镜像(sdcard.img)写入sd卡:
$ sudo dd if=xxx/phytium-pi-os/output/images/sdcard.img of=/dev/sdb bs=1M status=progress
本项目还提供了将img镜像烧录进sd卡并进行md5值校验的脚本,确保烧录正确。该脚本需在顶层目录下执行,用法为以下其中之一:
$ sudo ./board/phytium/dd_and_checkMD5.sh /dev/sdx desktop
$ sudo ./board/phytium/dd_and_checkMD5.sh /dev/sdx no_desktop
其中,/dev/sdx表示sd卡对应的设备节点名称;
如果编译的是phytiumpi_desktop_defconfig,使用第一条命令;如果编译的是phytiumpi_defconfig,使用第二条命令。
(2)SD卡接到开发板,启动开发板电源,启动文件系统
(3)开发板第一次启动时,系统首先运行phytium-firstlogin程序。该程序的主要功能包括设置root用户密码、创建普通用户、连接网络、设置区域和设置语言环境、配置固件等。详细见phytium-firstlogin介绍与使用
(4)开发板运行时,如果需要更换uboot、Image和dtb,可以在飞腾派上执行对应脚本,用法如下:
$ sudo runtime_replace_bootloader.sh all
$ sudo runtime_replace_bootloader.sh uboot
$ sudo runtime_replace_bootloader.sh fitImage
以上三条命令分别实现了更换uboot+Image+dtb、更换uboot和更换Image+dtb的功能,要求当前目录下有fip-all.bin和fitImage文件。
(5)开发板运行时,如果需要远程升级uboot、Image和dtb、rootfs,可以在飞腾派上执行对应脚本,用法如下:
$ sudo get_phytium_ota all
$ sudo get_phytium_ota uboot
$ sudo get_phytium_ota fitImage
$ sudo get_phytium_ota rootfs
以上四条命令通过远程分别将整个系统、uboot、Image+dtb和根文件系统升级到最新版本。关于phytium_ota更多信息,可以参考phytium_ota介绍与使用
(6)由于不同的开发板的硬件配置有所不同,对应的固件也有变化。开发板运行时,如果需要更新固件uboot的配置,可以在飞腾派上执行ft-config脚本,用法和示例如下:
$ sudo ft-config {hw|mem|pcie} {type}
$ sudo ft-config hw v3
$ sudo ft-config mem 8g
$ sudo ft-config pcie usb3
上面三个例子,分别是配置固件支持硬件v3版本、设置内存为8g和设置pcie为usb3。关于ft-config更多信息,可以参考飞腾派固件配置工具ft-config的介绍与使用
关于如何编译内核外部模块,可参考https://www.kernel.org/doc/html/latest/kbuild/modules.html
使用工具链来交叉编译内核模块,工具链位于output/host/bin
,工具链的sysroot为
output/host/aarch64-buildroot-linux-gnu/sysroot
。
交叉编译内核外部模块的命令为:
$ make ARCH=arm64 \
CROSS_COMPILE=/home/xxx/phytium-pi-os/output/host/bin/aarch64-none-linux-gnu- \
-C /home/xxx/phytium-pi-os/output/build/linux-xxx/ \
M=$PWD \
modules
利用linux-headers可以在开发板上进行内核模块编译,软链接/lib/modules/version/build
指向linux-headers。
在开发板上编译内核外部模块的命令为:
make -C /lib/modules/xxx/build M=$PWD modules
本节简单介绍如何交叉编译出能够运行在飞腾派开发板上的应用软件,完整的教程请参考用户手册docs/manual/manual.pdf。
所有用户态的软件包都在package目录,每个软件包有自己的目录package/<pkg>
,其中<pkg>
是小写的软件包名。这个目录包含:
(1)Config.in
文件,用Kconfig语言编写,描述了包的配置选项。
(2)<pkg>.mk
文件,用make编写,描述了包如何构建,即从哪里获取源码,如何编译和安装等。
(3)<pkg>.hash
文件,提供hash值,检查下载文件的完整性,如检查下载的软件包源码是否完整,这个文件是可选的。
(4)*.patch
文件,在编译之前应用于源码的补丁文件,这个文件是可选的。
(5)可能对包有用的其他文件。
首先创建软件包的目录package/<pkg>
,然后编写该目录下的文件。
一般情况下,package/<pkg>
下有Config.in
和<pkg>.mk
两个文件。关于如何编写这两个文件,大家可以参考package/<vpu-lib>
和
用户手册docs/manual/manual.pdf,这里简单概括一下。
(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
文件中可以设置的变量及其含义,请参考用户手册docs/manual/manual.pdf。
(1)单独编译软件包
$ cd xxx/phytium-pi-os
$ make <pkg>
编译结果在output/build/<pkg>-<version>
(2)将软件包编译进根文件系统
在phytiumpi_xxx_defconfig中添加一行BR2_PACKAGE_<PKG>=y
$ make phytiumpi_xxx_defconfig
$ make
1、关于phytium pi vpu的包请咨询飞腾技术支持或FAE。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型