平头哥 TH1520 RISC-V BeagleV-Ahead使用Thead-Yocto自定义构建系统最详细版本

使用Thead-Yocto自定义BeagleV-Ahead系统

Thead-Yocto简述

官网：https://www.yoctoproject.org/
THE YOCTO PROJECT. IT’S NOT AN EMBEDDED LINUX DISTRIBUTION,IT CREATES A CUSTOM ONE FOR YOU.
YOCTO项目：他不是一个嵌入式Linux发行版，是一个专门创建属于你的自定义系统！

Yocto 项目 (YP) 是一个开源协作项目，可帮助开发人员创建基于 Linux 的定制系统，无论硬件架构如何。该项目提供了一套灵活的工具和空间，全世界的嵌入式开发人员可以共享技术、软件堆栈、配置和最佳实践，这些技术、软件堆栈、配置和最佳实践可用于为嵌入式和物联网设备或任何需要定制 Linux 操作系统的地方创建定制的 Linux 映像。

下图介绍了 Yocto POKY参考示例的整个框架，其中 POKY 是一个 Yocto Project® 的参考发行版。它包含 OpenEmbedded 构建系统（BitBake 和 OpenEmbedded Core）以及一组meta，可帮助您开始构建自己的发行版。要使用 Yocto 项目工具，您可以下载 Poky 并使用它来引导您自己的发行版。请注意，Poky 不包含二进制文件 - 它是如何从源代码构建您自己的自定义 Linux 发行版的工作示例。

下图是Yocto-Project项目的一个完整的构建嵌入式工作流，以右上角颜色说明块来阅读此图，分别从各种 Metadata 元数据（系统源码配置软件包配置板级包支持等）以及上面黄色区域是专门的针对于各个构建工程部分所需的源码获取，包含了各种下载协议以及方式，把下载下来所需的源码保存起来，之后通过淡蓝色 Build System 来分别处理不同的源码和元层软件包进行构建，最后输出镜像以及多种格式软件包，和SDK 系统镜像等。为了方便理解，我这里专门使用红字和红色箭头做了简单的说明，因为整个yocto项目非常复杂，所以无法只通过一张图就能让大家完整理解。

如果您对yocto很感兴趣，想深入学习使用可以直接访问官方提供的使用教程 https://docs.yoctoproject.org/ ，在这个页面内，官方针对于整个yocto做了非常详细的图文教程，可以参考下图 Manuals 手册下不同章节后面红字描述来选择合适的篇幅进行阅读学习。

老版本的文档中心： https://docs.yoctoproject.org/1.8/ref-manual/ref-manual.html

配置开发环境

主机硬件配置

建议：

i7-7800K 以上架构，最少 8 核 16线程
32GB DDR4 内存，主频 3200MHz以上（必选，不然会 llvm native 错误）
存储 500G 建议固态/M2

ubuntu18 依赖安装

在使用ubuntu18安装如下依赖包之前，请确保你的Ubuntu18系统可以联网，且使用 sudo apt update 命令更新过软件源。之后在ubuntu18终端上执行如下命令即可自动安装,安装过程持续 5 -10分钟，主要根据自己的网络性能而定。

代码语言：javascript复制

sudo apt install gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev python3-subunit mesa-common-dev zstd liblz4-tool file locales sed make binutils    g   bash patch gzip bzip2 perl  tar    file  bc  python  cvs  mercurial rsync  subversion android-tools-mkbootimg vim  libssl-dev  android-tools-fastboot libncurses5-dev   u-boot-tools android-sdk-platform-tools  open-vm-tools-desktop python3-distutils  repo bison flex  -y

执行如下命令配置当前终端的编码格式为 en_US.UTF-8 。

代码语言：javascript复制

sudo locale-gen en_US.UTF-8

配置完成后上述两个步骤，就可以开始下面的编译工作了。

配置编译环境

上一节我们配置好了开发所需的ubuntu-18 主机环境，这一节我们开始获取 BealgeV-Ahead Yocto源码，并进行配置，编译输出对应的自定义系统，此章节操作起来有一定难度，建议有编译经验的同学参考。

因为构建时会从网络下载开源软件包，下载的时间依不同的网络和网速而不同切差异很大；有些开源软件位于 GitHub 仓库，受限于国内网络环境会下载失败。为了加速这一过程，可以直接获取我们这里提前准备好的所有软件包，拷贝到 ubuntu-18.04家 ~ 目录下，所有文件存放在百度网盘链接：https://pan.baidu.com/s/1GVpQoNwSpBkjaMZO2gZRrQ?pwd=rqm4 文件比较大，文件名称为 yocto-downloads_light-beagle_thead-image-linux.tar.gz 拷贝到虚拟机 ~ 家目录后，使用如下命令进行解压缩，解压缩完成是一个名为 yocto-downloads 的文件夹。

代码语言：javascript复制

cd ~
tar -xvf  yocto-downloads_light-beagle_thead-image-linux.tar.gz

下载 BeagleV-Ahead Thead-Yocto meta元层数据，在ubuntu18.04 终端下执行如下命令，在 ~家目录下指定：

代码语言：javascript复制

cd ~
git clone https://gitee.com/thead-yocto/xuantie-yocto.git -b Linux_SDK_V1.1.2

加载目标设备的配置文件，加载环境变量，如下所示进入到上述步骤已经下载好的镜像里面，执行yocto系统编译前的环境配置操作。

代码语言：javascript复制

cd xuantie-yocto
source openembedded-core/oe-init-build-env thead-build/light-fm

同时我们需要将提前解压好的软件包软链接到刚才配置完编译环境的 thead-build/light-fm/downloads目录，这样可以避免重复下载软件包的问题

代码语言：javascript复制

ln -s ~/yocto-downloads ../downloads

参考页面 https://gitee.com/thead-yocto/documents

编译系统镜像

配置镜像

开始编译

配置好前面的步骤以后，就可以选择我们需要编译的BeagleV-Ahead 开发板配置项以及选择配套的系统镜像了，我这里使用 MACHINE=light-beagle bitbake thead-image-linux 也就是表示编译后的主板是 BeagleV-Ahead编译出来的系统是 thead-image-linux 如下，在刚才配置好编译环境变量的下面执行 MACHINE=light-beagle bitbake thead-image-linux 即可开始编译。

整个编译时间大概在 5 小时以上，具体要根据性能配置而定，我这里使用i7-13700K 16核心，32GB DDR5 ，M2固态编译了大概10个小时，大家可以作为参考。编译过程中很有可能会出现各种奇怪的错误，请不要着急，一般情况下是因为配置不够，或者网络原因导致的，如果无法找到原因可以在 https://forums.100ask.net/c/elinuxdev/yocto/76 页面提交您的问题！

编译完成后系统会弹出一段类似下图蓝框所示的信息，其中最后会有一个 succeeded 表示编译成功，这就表明已经完成，之后我们就可以去 tmp-glibc/deploy/images/light-beagle 查看编译输出的镜像文件了。

编译完成后的镜像输出在 ~/xuantie-yocto/thead-build/light-fm/tmp-glibc/deploy/images/light-beagle

烧写更新镜像

编译成功后输出在 tmp-glibc/deploy/images/light-beagle的镜像可以直接通过上一篇系统评测文章介绍的，使用 fastboot来进行烧写更新，在这里，有些文件名称可能不太一样，所以我们要根据我们编译生成的镜像,来依次执行烧录命令。

如果你不想编译，只想体验一下yocto镜像的烧录过程，可以用我提前准备好的deploy压缩包链接：https://pan.baidu.com/s/1OD3ApN5JtOX8EQDz7JW1hg?pwd=2t4c 上传到 ubuntu 虚拟机，使用 tar -xvf deploy-light-beagle_thead-image-linux.tar.gz 命令就可以解压缩，里面存放了编译来的所有资源，包含镜像 SDK deb 等

烧录前准备

参考上一篇将 BeagleV-Ahead进入烧录模式，连接 MicroUSB 3.0线至ubuntu系统。

在Ubuntu下提前安装好烧录工具，如果参考上一篇安装过，可以执行fastboot --version命令来验证是否安装成功。

开始烧录

进入到编译好的镜像文件夹，在 xuantie-yocto/ 目录下的 thead-build/light-fm/tmp-glibc/deploy/images/light-beagle/ 目录，之后依次执行如下命令进行烧录操作。

代码语言：javascript复制

sudo fastboot  flash ram  u-boot-with-spl-light-beagle-2020.10-r0.bin
sudo fastboot reboot
sudo fastboot flash uboot u-boot-with-spl-light-beagle-2020.10-r0.bin 
sudo fastboot flash boot boot.ext4 
sudo fastboot flash root thead-image-linux-light-beagle-最新日期.rootfs.ext4

如下图所示，详细描述了整个编译步骤，需要留意最后烧写的 rootfs.ext4 文件，名称会随着编译的时间而变化。

烧录完成后系统会提示 finiashed 此时需要手动按下BeagleV-Ahead RESET 按钮，系统就会自动启动，使用串口登录，输入用户名 root 就可以进入系统。

启动BeagleV-Ahead

因为 thead-image-linux 没有桌面环境，所以只能通过串口方式启动进入系统，如下所示，输入用户名 root 即可进入您最新烧写好的 yocto系统。

生成SDK

编译生成

如果您只是体验一下 yocto编译系统的过程，制作出来一个自己的系统，不需要给专门搞应用开发的同事使用，或者您不需要后续开发应用，那么就不需要做这部分，相反，如果您需要后续在前面系统上开发属于自己的应用程序/产品，那么就需要构建出来一个专门且配套的 SDK（交叉工具链组件应用库和头文件），这样才可以使用配套的工具链来进行编译系统。

生成配套的SDK命令很简单，只需要在原来的编译镜像命令后加上 -c populate_sdk 参数即可。如下所示，我需要给我最新编译出来的 beagleV-Ahead 单板 thead-image-linux 系统镜像生成配套的SDK，那么只需要执行 MACHINE=light-beagle bitbake thead-image-linux -c populate_sdk 命令即可。

整个编译过程比较快，正常30分钟以内，因为只是做一些打包处理工作，但是在编译时可能会出现一些报错等问题，需要解决。

解决编译错误

初次编译生成配套的SDK会提示 packagegroup-cross-canadian-light-beagle : Depends: gdb-cross-canadian-riscv64 but it is not installable 错误，错误提示信息如下图所示，我们需要在 xuantie-yocto 目录对 openembedded-core/meta/recipes-core/packagegroups/packagegroup-cross-canadian.bb 进行修改。

修改方式如下，首先回退到上上级 xuantie-yocto 目录，之后使用 vim/nano/gedit 等文本编辑器修改 openembedded-core/meta/recipes-core/packagegroups/packagegroup-cross-canadian.bb 文件。

删除掉 ${@all_multilib_tune_values(d, 'GDB')} 这句代码，如下红框所示，删除完成后，保存退出此界面，继续返回到编译界面，执行编译 SDK命令。

如下图所示，编辑完成后，继续执行 MACHINE=light-beagle bitbake thead-image-linux -c populate_sdk 编译生成SDK，等待编译完成。

编译完成后，系统会提示如下打印信息，其中主要参考蓝色长条框内，红色框 succeeded 字符，既表示已经完成。

SDK输出

编译完成以后，生成的 sdk 在 xuantie-yocto/ 目录下的 thead-build/light-fm/tmp-glibc/deploy/sdk/ 目录，里面 oecore-x86_64-riscv64-toolchain-nodistro.0.sh是我们需要的SDK，后面只需要在 ubuntu等Linux发行版系统下执行 ./oecore-x86_64-riscv64-toolchain-nodistro.0.sh 即可安装使用，具体步骤我们会在后面介绍。

更多的参考 https://docs.yoctoproject.org/sdk-manual/working-projects.html

使用SDK开发LVGL

如果你不想编译，只想体验一下yocto镜像的烧录过程，并且使用我们预先编译好的SDK来配合开发，可以用我提前准备好的deploy压缩包链接：https://pan.baidu.com/s/1OD3ApN5JtOX8EQDz7JW1hg?pwd=2t4c 上传到 ubuntu 虚拟机，使用 tar -xvf deploy-light-beagle_thead-image-linux.tar.gz 命令就可以解压缩，里面存放了编译来的所有资源，包含镜像 SDK deb 等。

安装SDK

安装SDK这里可以理解为安装工具链，Yocto工具自动把SDK工具链整合成了一个 .sh 脚本，只需要在终端任意目录执行就可以自动安装。如下图所示。

如下所示，按照提示说明，在同一终端下执行 . /usr/local/oecore-x86_64/environment-setup-riscv64-oe-linux 命令即可使其生效，生效后可以在当前终端下输入 riscv64-unknown-linux-gnu-gcc -v 来查看当前工具链的信息如下图蓝框所示，这是一个针对于 xuantie 900系列的专用工具链。

代码语言：javascript复制

. /usr/local/oecore-x86_64/environment-setup-riscv64-oe-linux
riscv64-unknown-linux-gnu-gcc -v

获取编译LVGL

源码示例所在仓库 https://gitee.com/weidongshan/BeagleV-Ahead_Lvg8-drm_Example 使用 git 命令在 ~ 家目录 clone,获取完成后进入到 BeagleV-Ahead_Lvg8-drm_Example 目录下即可开始编译。

代码语言：javascript复制

cd ~
git clone  https://gitee.com/weidongshan/BeagleV-Ahead_Lvg8-drm_Example
cd BeagleV-Ahead_Lvg8-drm_Example
make

报错问题，提示找不到 libc.so等 C标准库

进入 /usr/local/oecore-x86_64/sysroots/riscv64-oe-linux/usr/lib 使用vim/nano/gedit等文本编辑器修改 libc.so 文件。

在 libc.so文件内修改GROUP整行为如下图所示，如果你的安装路径不是前面提示的默认 /usr/local/oecore-x86_64 ，则需要根据你的实际路径进行修改。

代码语言：javascript复制

GROUP ( /usr/local/oecore-x86_64/sysroots/riscv64-oe-linux/lib/libc.so.6 /usr/local/oecore-x86_64/sysroots/riscv64-oe-linux/lib/libc_nonshared.a  AS_NEEDED ( /usr/local/oecore-x86_64/sysroots/riscv64-oe-linux/lib/ld-linux-riscv64xthead-lp64d.so.1 ) )

修改完成后回到 LVGL 目录，继续执行 make 命令，就可以编译完成，生成一个最终的可以在 BeagleV-Ahead 运行的 demo 程序，把这个demo 应用拷贝到 BeagleV-Ahead开发板上，即可运行。

上传程序

因为BeagleV-Ahead Yocto系统网络不通，而且WIFI也无法使用，只能通过最原始的方式U盘挂载来进行数据的传输，使用U盘上传，首先把从ubuntu 编译出来的 LVGL demo程序拷贝到 U盘内，拷贝完成后通过MicroUSB OTG线连接到BeagleV-Ahead 并使用mount命令进行挂载到 /mnt目录下。推荐 U盘格式化为 FAT32 格式，方便再BeagleV-Ahead挂载。

代码语言：javascript复制

mount /dev/sda1 /mnt/
cd /mnt/
chmod  x demo

运行程序

在前面我们已经将编译好的 demo 程序存放在了U盘，并挂载在了 BeagleV-Ahead 的 /mnt 目录下，因为BeagleV-Ahead Yocto系统默认开机运行一个 weston 界面程序，所以我们要通过 kill -9 PID 命令来关闭它，才能运行我们自己的 LVGL DEMO程序，首先通过 ps -ef | grep “weston” 查找到当前进程的具体PID，得到PID号以后就可以直接使用 kill -9 PID 来杀死他，如下截图。