4. Ryzen Embedded开发环境搭建

Ryzen Embedded 平台通常运行 Linux 或 Yocto 定制系统，而开发主机多为 x86_64 的 Ubuntu。开发主机与目标板的 CPU 架构虽然同为 x86_64，但目标系统往往使用精简的 glibc、特定内核头文件和定制 rootfs，因此不能直接把主机上的 gcc 产物拷过去运行。搭建开发环境的核心，是让“编译侧”与“运行侧”在 ABI、库版本和内核接口上保持一致。本节围绕交叉编译工具链、SDK、BSP 与远程调试四件事展开，并给出可复现的配置路径。

一、工具链：先确定 sysroot，再谈编译器

交叉编译工具链由编译器、链接器、binutils、C 库和 sysroot 组成。对 Ryzen Embedded 而言，常见选择是 Yocto 生成的 SDK 工具链，或厂商提供的 gcc-arm 类工具链（若目标为 ARM 核的嵌入式控制器）。判断工具链是否匹配，关键看三点：目标三元组（如 x86_64-poky-linux）、sysroot 中的 libc 版本、以及内核头文件版本。可以用以下命令快速核对：

$ $CC -dumpmachine
x86_64-poky-linux
$ $CC -print-sysroot
/opt/poky/4.0/sysroots/x86_64-pokysdk-linux
$ ls $SDKTARGETSYSROOT/usr/lib/libc.so.6

如果目标板使用 glibc 2.35，而工具链 sysroot 是 2.31，链接阶段可能通过，运行阶段却报 GLIBC_2.34 not found。因此工具链版本必须与 BSP 镜像同源。实操中建议把工具链环境变量写入独立脚本，避免污染主机环境：

$ source /opt/poky/4.0/environment-setup-x86_64-poky-linux
$ echo $CC
x86_64-poky-linux-gcc -m64 -march=core2 ...

二、SDK 与 BSP：镜像、内核、设备树的对应关系

BSP 是板级支持包，包含 U-Boot、Linux 内核、设备树和驱动补丁；SDK 则是在 BSP 基础上导出的开发套件，提供工具链、sysroot、库和头文件。二者必须来自同一次构建，否则会出现内核模块 vermagic 不匹配、设备树节点缺失等问题。典型目录结构如下：

• bsp/：U-Boot、kernel、device-tree、recipes
• sdk/：environment-setup-*、sysroots、host tools
• images/：core-image-minimal、模块 .ko、dtb

构建 SDK 的常用命令是 bitbake core-image-minimal -c populate_sdk，产物为 .sh 自解压安装包。安装后，用 devtool 或 bitbake -c devshell 进入配方级开发环境，可以保证编译参数与镜像一致。若只做应用层开发，直接使用 SDK 的 environment-setup 即可；若涉及内核模块，则必须使用 BSP 中同一内核源码树，并在 Makefile 中指定 KERNELDIR 与 ARCH。

三、远程调试：从串口到 GDBserver 的链路

远程调试分三层：串口控制台用于早期启动和内核日志；SSH 用于文件传输与进程管理；GDBserver 用于源码级断点调试。目标板启动后，先确认网络与 SSH：

$ ssh root@192.168.1.50
# uname -a
Linux ryzen-board 6.1.0 #1 SMP ...

应用调试时，在目标板运行 gdbserver :1234 ./app，主机端用交叉 gdb 连接：

$ $GDB ./app
(gdb) target remote 192.168.1.50:1234
(gdb) set sysroot $SDKTARGETSYSROOT
(gdb) break main
(gdb) continue

内核调试则通过 kgdb 或 kdb，需要内核开启 CONFIG_KGDB 并在启动参数中加入 kgdboc=ttyS0,115200。若使用 JTAG，还需连接 OpenOCD 并加载对应的 SoC 配置文件。无论哪种方式，符号文件必须与目标上运行的内核或应用完全一致，否则断点地址会偏移。

四、配置检查与常见问题

环境搭好后，建议按以下顺序验证：第一步，用 $CC 编译一个打印 uname 的小程序，确认能生成目标格式可执行文件；第二步，scp 到目标板运行，确认动态库可加载；第三步，启动 gdbserver 并在主机端命中 main 断点；第四步，若涉及内核模块，用 modinfo 核对 vermagic 与目标内核一致。常见故障包括：GLIBC_2.34 not found（sysroot 版本偏低）、invalid module format（内核源码树不一致）、Remote connection closed（gdbserver 未启动或端口被占用）。