1. 课程导学与环境准备
各位同学，欢迎来到《Yocto项目U-Boot引导与启动流程调试实战》的第一章。我是你们这门课的老朋友，一个在嵌入式底层摸爬滚打了十几年的工程师。今天咱们不急着敲代码，先把地基打牢。
你想想看，做嵌入式开发，最头疼的是什么？不是功能实现不了，而是系统起不来。U-Boot就是那个让系统“活过来”的第一口仙气。而Yocto，则是帮你把整个软件栈——从U-Boot、内核到根文件系统——打包成一套可靠产物的工业级工具链。这两样东西，是嵌入式Linux工程师的看家本领。
1.1 Yocto项目概述
Yocto项目，说白了，是一个开源协作项目。它提供了一套模板、工具和方法论，让你能定制出属于自己的Linux发行版。它不是Linux发行版本身，而是制作发行版的工具。
我在2012年刚接触Yocto时，觉得这东西太重了。不就是交叉编译吗？Makefile一把梭不就行了？后来项目规模大了，要维护十几个BSP，要同时支持不同架构的芯片，要管理几百个软件包的版本和补丁……嗯，我承认我当初太年轻了。Yocto的可复现性和层（Layer）机制，在复杂项目中简直是救命稻草。
核心概念速览：
- Poky：Yocto项目的参考发行版，也是我们课程的起点。
- BitBake：Yocto的心脏，一个任务调度引擎，负责解析配方（Recipe）并执行构建任务。
- Layer（层）：用于隔离不同功能的代码集合。比如BSP层、应用层、元数据层。
- Recipe（配方）：描述如何下载、配置、编译和安装一个软件包的脚本文件（.bb）。
Yocto的典型工作流是这样的：你定义好机器（MACHINE）和镜像（IMAGE），BitBake根据配方，自动下载源码、打补丁、交叉编译、打包，最终生成一个完整的系统镜像。整个过程高度自动化，但也意味着学习曲线比较陡。
1.2 U-Boot在嵌入式系统中的作用
U-Boot，全称Universal Boot Loader。它是嵌入式系统的固件，负责初始化硬件、加载内核并启动系统。你可以把它想象成PC上的BIOS+GRUB的合体，但功能更强大，也更贴近硬件。
为什么我们需要U-Boot？因为CPU上电后，内存还没初始化，文件系统更是没影的事。U-Boot是第一个在裸机上跑起来的程序，它得自己搞定时钟、DDR、串口、网卡等外设，然后才能从Flash、SD卡或网络加载内核。
| 阶段 | U-Boot职责 | 我踩过的坑 |
|---|---|---|
| 上电启动 | 从ROM执行SPL（Secondary Program Loader） | SPL代码大小受限，我曾在64KB内塞了太多初始化代码，导致链接失败 |
| 硬件初始化 | 配置时钟、DDR控制器、串口 | DDR时序参数配错，板子死活跑不起来，最后用示波器一根根线测才发现 |
| 加载内核 | 从存储介质读取内核镜像到内存 | 分区表搞错了，U-Boot读到的内核是坏的，系统反复重启 |
| 传递参数 | 设置bootargs，告诉内核根文件系统在哪 | bootargs里写错了root=参数，内核panic，查了一整天 |
| 启动内核 | 跳转到内核入口点，交出控制权 | 设备树地址没对齐，内核直接挂死 |
U-Boot还有一个强大的功能：交互式命令行。你可以通过串口中断启动流程，手动执行命令来调试。比如用md查看内存，用tftp通过网络下载文件，用bootm手动启动内核。这门课后面会大量用到这些命令。
1.3 搭建Yocto开发环境（Ubuntu 22.04）
环境搭建是新手最容易卡住的地方。我建议你准备一台干净的Ubuntu 22.04虚拟机或物理机。别用WSL1，WSL2勉强可以，但文件系统性能有点问题。我个人习惯用Ubuntu Server版，然后自己装桌面，这样系统比较轻量。
第一步，安装必要的依赖包。Yocto对主机环境要求很严格，缺了某个包，编译到一半就会报错。我曾经因为没装chrpath，折腾了俩小时才找到原因。
sudo apt-get update
sudo apt-get install -y 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 \
xterm python3-subunit mesa-common-dev zstd liblz4-tool file locales libacl1
小提示： 执行完上面的命令后，记得运行 sudo locale-gen en_US.UTF-8 来生成UTF-8 locale。Yocto的构建系统对locale很敏感，缺了这个会报奇怪的错误。
第二步，配置Git。Yocto的源码管理重度依赖Git，你需要设置好用户名和邮箱：
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
第三步，选择一个工作目录。我习惯在/home/<用户名>/yocto下工作。注意，不要放在共享目录或NTFS分区，Yocto构建时会创建大量符号链接，跨文件系统会导致失败。
1.4 下载U-Boot源码与Yocto Poky层
好，环境准备好了，我们来拉代码。Yocto项目本身通过repo工具管理多个Git仓库，但我们课程先从最核心的Poky开始。
Poky是Yocto的参考发行版，包含了BitBake、OpenEmbedded Core以及一系列基础配方。我们用它来构建一个最小的系统镜像。
cd ~/yocto
git clone git://git.yoctoproject.org/poky -b kirkstone
cd poky
这里我选择了kirkstone分支，它是Yocto 4.0的长期支持版本（LTS），稳定且文档齐全。你可能会问，为什么不选最新的？我在项目中吃过亏，追新分支往往意味着不兼容的API变更和未修复的bug。对于生产环境，LTS是更稳妥的选择。
接下来，下载U-Boot源码。Yocto的层机制允许我们通过配方自动下载U-Boot，但为了调试方便，我建议你单独拉一份U-Boot源码，方便我们后续手动修改和实验。
cd ~/yocto
git clone git://git.denx.de/u-boot.git -b v2023.04
注意，这里我指定了v2023.04标签。U-Boot的版本和内核版本一样，需要和你的硬件平台匹配。我们课程会基于QEMU模拟的vexpress-a9平台进行实验，这个版本完全够用。
重要提醒： 下载U-Boot源码时，确保网络畅通。如果遇到连接超时，可以尝试使用镜像源：git clone https://source.denx.de/u-boot/u-boot.git。另外，Poky的Git仓库也提供了国内镜像，比如清华大学的Tuna源，速度会快很多。
现在，你的~/yocto目录下应该有两个文件夹：poky和u-boot。这就是我们整个课程的实验基础。
为了验证环境是否正常，我们来初始化Yocto的构建环境：
cd ~/yocto/poky
source oe-init-build-env build-qemuarm
这个脚本会设置一系列环境变量，并创建一个build-qemuarm目录。执行成功后，你会看到命令行提示符变成了类似bitbake的环境。这说明你的环境已经准备好了。
最后，我用一张图来总结本章的知识结构，帮你理清思路：
嗯，到这里，第一章的内容就差不多了。你有了Yocto的Poky层，有了U-Boot源码，环境也验证通过了。别小看这些准备工作，我见过太多同学因为环境没配好，后面调试时各种报错，最后发现是主机缺了个包。磨刀不误砍柴工，把这一步走扎实了，后面咱们才能专心研究U-Boot的启动流程和调试技巧。