2. 开发环境搭建

嵌入式Linux开发与纯软件开发的本质区别在于：目标程序并非运行在开发主机（x86_64）上，而是运行在ARM架构的RK3568处理器上。因此，开发环境的搭建直接决定了后续uboot移植、内核编译与文件系统调试的效率与可行性。本章将系统性地完成四部分工作：交叉编译工具链的安装与验证、TFTP/NFS网络服务的配置、串口终端与网络调试环境的搭建，以及RK3568 EVB开发板的硬件连接准备。这四者构成了uboot移植工作的“基础设施”，任何一环缺失或配置不当，都会在后续的烧录、启动与调试阶段引发连锁问题。

上图展示了整个开发环境的物理与逻辑拓扑。开发主机通过三条独立通道与RK3568 EVB开发板交互：以太网通道承载TFTP与NFS流量，用于镜像传输与文件系统挂载；USB转串口通道提供控制台交互，用于uboot命令行操作与内核日志输出；电源通道为开发板提供稳定供电。理解这三条通道的分工与依赖关系，是后续所有调试工作的基础。

2.1 安装交叉编译工具链

核心原理

交叉编译工具链是一套运行在x86_64主机上、但生成ARM架构机器码的编译器集合。RK3568基于Cortex-A55核心，支持ARMv8-A 64位指令集，因此必须使用aarch64-linux-gnu-前缀的工具链。uboot编译需要完整的工具链组件，包括预处理器、编译器、汇编器、链接器以及二进制工具（objcopy、strip等）。Rockchip官方推荐使用基于GCC 10.3的预编译工具链，该版本经过充分验证，能够正确生成RK3568所需的ATF（ARM Trusted Firmware）与TEE（Trusted Execution Environment）二进制。

操作流程

1. 下载工具链：从Rockchip官方GitHub仓库或百度网盘获取gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz。
2. 解压安装：将工具链解压至/opt/目录，并配置环境变量。
3. 验证安装：编译一个简单的C程序，确认生成的是ELF 64-bit ARM aarch64格式。

# 解压工具链
sudo tar -xvf gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt/
# 添加环境变量（写入~/.bashrc）
export PATH=/opt/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin:$PATH
# 验证版本
aarch64-none-linux-gnu-gcc --version
# 编译测试程序
echo 'int main(){return 0;}' > test.c
aarch64-none-linux-gnu-gcc -o test test.c
file test
# 预期输出：ELF 64-bit LSB executable, ARM aarch64

案例拆解：工具链版本不匹配导致的编译失败

某项目组使用Ubuntu 20.04自带的gcc-9交叉编译器编译RK3568 uboot，在编译drivers/net/phy/rtl8211f.c时出现"Error: selected processor does not support requested special purpose register"错误。分析发现，该文件使用了ARMv8.2的LSE原子指令，而gcc-9默认不生成该指令集。解决方案是添加-march=armv8.2-a+lse编译选项，但更稳妥的做法是直接使用Rockchip官方工具链。该案例说明，工具链版本不仅影响编译速度，更直接影响指令集支持范围，进而导致底层驱动代码无法编译。

常见误区

• 误区一：认为64位工具链可以编译32位代码。实际上，aarch64工具链默认生成64位代码，如需编译32位需添加-march=armv7-a参数，但uboot for RK3568不需要。
• 误区二：忽略工具链的Python依赖。部分工具链的gdb需要Python 3.8+，若系统Python版本过低，gdb无法启动，但编译功能不受影响。
• 误区三：未将工具链路径加入PATH就执行make，导致系统找到x86_64的gcc，产生大量"unknown type name"错误。

2.2 配置TFTP/NFS服务

核心原理

TFTP（Trivial File Transfer Protocol）是一种轻量级文件传输协议，基于UDP 69端口，无认证机制，适合在uboot阶段加载内核镜像、设备树文件。NFS（Network File System）则允许开发板通过网络挂载主机上的目录作为根文件系统，省去每次修改后重新烧录eMMC的繁琐流程。两者的配合使用，构成了uboot开发中最常用的"网络启动"模式：uboot通过TFTP获取内核，内核通过NFS挂载根文件系统。

配置流程

# 安装TFTP服务
sudo apt-get install tftpd-hpa tftp-hpa
# 配置TFTP目录
sudo mkdir -p /tftpboot
sudo chmod 777 /tftpboot
sudo vim /etc/default/tftpd-hpa
# 内容如下：
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/tftpboot"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="--secure --create"

# 重启服务
sudo systemctl restart tftpd-hpa

# 安装NFS服务
sudo apt-get install nfs-kernel-server
sudo mkdir -p /nfsroot
sudo chmod 777 /nfsroot
sudo vim /etc/exports
# 添加以下行（192.168.1.0/24为开发板所在网段）
/nfsroot 192.168.1.0/24(rw,sync,no_root_squash,no_subtree_check)

# 重启NFS服务
sudo systemctl restart nfs-kernel-server

案例拆解：TFTP传输超时问题排查

在uboot中执行tftp 0x1000000 uImage时，传输在约10%处停止并报"TFTP error: Timeout"。排查步骤：首先在主机上执行tftp localhost测试本机服务正常；其次检查开发板与主机的网络连通性，发现开发板能ping通主机IP，但无法ping通主机名；进一步检查发现开发板未配置DNS，而TFTP服务器地址使用了主机名。解决方案：在uboot环境变量中设置serverip为主机IP地址，而非主机名。该案例说明，网络调试中IP地址配置必须显式、明确，避免依赖名称解析。

常见误区

• 误区一：TFTP目录权限不足。tftpd-hpa默认以tftp用户运行，若目录权限为755且属主为root，则无法写入文件。
• 误区二：NFS导出路径与挂载点混淆。开发板挂载的是主机上的导出路径，而非主机的根目录。
• 误区三：忽略网络MTU设置。若主机网卡MTU为1500，而开发板PHY支持巨型帧，可能导致大文件传输失败。

2.3 搭建串口终端与网络调试环境

核心原理

串口是嵌入式开发中最可靠的调试通道。RK3568 EVB板载USB转串口芯片（通常为CH340或CP2102），通过USB线连接主机后，在主机上呈现为/dev/ttyUSB0设备节点。uboot的早期启动日志（包括ATF、DDR初始化、uboot版本信息）仅通过串口输出，因此串口终端是观察启动流程的唯一窗口。网络调试环境则包括静态IP配置、ping测试、以及telnet/ssh（在uboot阶段通常不支持，但可在Linux内核启动后使用）。

操作流程

1. 安装串口工具：推荐使用minicom或picocom，两者均为轻量级终端模拟器。
2. 配置串口参数：RK3568 EVB的调试串口默认波特率为1500000（1.5Mbps），数据位8，无校验，停止位1。
3. 验证串口通信：连接开发板并上电，观察终端是否输出启动日志。
4. 配置网络环境：在uboot命令行中设置IP地址、服务器IP、网关等环境变量。

# 安装picocom
sudo apt-get install picocom
# 连接串口（-b 波特率，-d 数据位，-p 无校验，-s 停止位）
sudo picocom -b 1500000 -d 8 -p n -s 1 /dev/ttyUSB0

# 若使用minicom
sudo minicom -s  # 进入配置界面，选择Serial port setup
# 按A修改串口设备为/dev/ttyUSB0
# 按E修改波特率为1500000
# 保存为默认配置

# 在uboot命令行中配置网络
setenv ipaddr 192.168.1.100
setenv serverip 192.168.1.10
setenv gatewayip 192.168.1.1
setenv netmask 255.255.255.0
saveenv
# 测试网络连通性
ping 192.168.1.10

案例拆解：串口无输出的完整排查

新收到的EVB开发板上电后，串口终端无任何输出。按以下顺序排查：①检查电源指示灯是否点亮，确认12V电源适配器正常；②用万用表测量开发板核心电压（1.8V、3.3V、5V）是否正常；③检查串口线是否连接至正确的UART2排针（丝印标注TX/RX/GND），注意不要连接至UART1或UART3；④确认USB转串口芯片驱动已安装（lsmod | grep ch340或lsmod | grep cp210x）；⑤尝试短接TX与RX引脚，在终端输入字符应回显，以验证串口链路本身正常；⑥若以上均正常，则可能是bootrom未检测到启动介质，需检查eMMC/SD卡是否已烧录uboot。该案例表明，串口调试需要系统性的硬件排查思路，不能仅依赖软件配置。

常见误区

• 误区一：使用USB转串口线但未安装驱动。CH340在Ubuntu 20.04下通常自动识别，但CP2102可能需要手动安装驱动。
• 误区二：串口工具未关闭硬件流控。RK3568 EVB的调试串口仅引出TX/RX/GND三根线，必须关闭RTS/CTS流控。
• 误区三：网络IP地址与主机不在同一网段。uboot的ping命令不支持跨网段，必须确保开发板与主机在同一子网。

2.4 准备RK3568 EVB开发板及必要硬件连接

核心原理

RK3568 EVB（Evaluation Board）是Rockchip官方评估板，板载资源丰富，包括：RK3568 SoC、2GB DDR4、8GB eMMC、千兆以太网（RTL8211F PHY）、USB 3.0/2.0接口、HDMI输出、MIPI-DSI/CSI接口、PCIe插槽、以及40pin GPIO扩展头。在uboot移植阶段，需要关注的硬件模块包括：调试串口（UART2）、以太网PHY、eMMC/SD卡启动接口、以及电源指示灯。正确的硬件连接是后续所有软件调试的前提。

硬件连接清单

操作流程

1. 检查板卡完整性：确认SoC、DDR、eMMC、PHY芯片无物理损伤，排针无弯曲。
2. 连接调试串口：使用杜邦线将UART2排针与USB转串口模块相连，注意交叉连接。
3. 连接网络：将网线插入RJ45座，另一端连接至主机所在交换机或直连主机网口。
4. 连接电源：最后连接12V电源，避免热插拔损坏电路。
5. 检查启动模式：确认boot mode拨码开关处于eMMC启动位置（通常为ON-OFF-OFF-OFF）。

案例拆解：网口无法link-up的硬件排查

开发板启动后，uboot中执行ping命令报"link down"。首先检查网线连接，确认RJ45指示灯亮起；若不亮，用网线测试仪检测网线通断；若网线正常，则检查PHY芯片供电，用万用表测量RTL8211F的AVDD_2V5引脚电压是否为2.5V；若电压正常，则可能是PHY的复位引脚被拉低，检查复位电路RC延时是否足够；最后，若以上均正常，可能是PHY芯片虚焊，需用热风枪补焊。该案例展示了硬件排障的层级化思路：从外部连接→供电→复位→焊接质量，逐步深入。

常见误区

• 误区一：使用劣质USB转串口模块。部分模块使用FT232RL芯片，但山寨版本可能存在供电不足或信号质量差的问题，导致乱码或丢字符。
• 误区二：忽略静电防护。在干燥环境下，人体静电可能击穿SoC的GPIO引脚，建议佩戴防静电手环。
• 误区三：误将5V电源接入3.3V排针。RK3568 EVB的GPIO排针部分引脚为3.3V电平，接入5V会损坏SoC。

2.5 环境验证与综合测试

核心原理

环境搭建完成后，必须进行端到端的验证，确保所有组件协同工作。验证分为三个层次：工具链验证（编译通过）、网络服务验证（TFTP/NFS可访问）、硬件链路验证（串口输出正常、网络link-up）。只有三层全部通过，才能开始uboot移植工作。

验证流程

# 1. 工具链验证：编译uboot（以rockchip官方defconfig为例）
cd u-boot
make rk3568_defconfig
make -j$(nproc)
# 预期生成u-boot.bin，大小约1MB

# 2. TFTP验证：将u-boot.bin复制到/tftpboot
cp u-boot.bin /tftpboot/
# 在开发板uboot命令行执行
tftp 0x1000000 u-boot.bin
# 预期输出：Bytes transferred = xxx

# 3. NFS验证：在/nfsroot中创建测试文件
echo "NFS test" > /nfsroot/test.txt
# 在开发板Linux中挂载
mount -t nfs 192.168.1.10:/nfsroot /mnt
cat /mnt/test.txt
# 预期输出：NFS test

# 4. 串口验证：观察uboot启动日志
# 预期看到：
# U-Boot 2017.09-rc2-00001-g1a3b2c4 (Jan 01 2024 - 00:00:00)
# SoC: RK3568
# DRAM: 2 GiB
# Net: eth0: ethernet@fe2a0000

案例拆解：一次完整的环境验证过程

某学员在搭建环境时，工具链编译通过，但TFTP传输总是失败。通过tcpdump抓包发现，开发板发送的TFTP请求源端口为随机端口，但主机的tftpd-hpa仅监听69端口，且响应包的目标端口错误。进一步检查发现，主机存在多个网卡，tftpd-hpa绑定到了错误的IP地址。解决方案：在/etc/default/tftpd-hpa中显式指定TFTP_ADDRESS="192.168.1.10:69"，重启服务后正常。该案例说明，多网卡主机上服务绑定地址是常见问题，必须显式配置。

常见误区

• 误区一：验证不全面。只验证了工具链编译，未验证TFTP/NFS，导致后续uboot烧录时才发现网络问题。
• 误区二：忽略日志分析。串口输出乱码时，首先怀疑波特率，但有时是USB转串口模块供电不足导致信号畸变。
• 误区三：未保存uboot环境变量。网络配置后未执行saveenv，重启后配置丢失。