📚 课程目录第4章开发环境搭建

4. 开发环境搭建

嵌入式 OpenGL ES 开发与桌面环境最大的区别在于：GPU 驱动、窗口系统、EGL 实现和交叉编译工具链往往由 SoC 厂商深度定制。若环境搭建不正确，即使代码逻辑完全正确，也会在 eglGetDisplay、eglInitialize 或 eglCreateWindowSurface 阶段失败。本章围绕工具链、EGL 初始化、窗口系统集成和典型平台配置四条主线展开。

一、交叉编译工具链：从宿主机到目标板

交叉编译工具链负责在 x86 宿主机上生成 ARM/AArch64 可执行文件。选择工具链时，必须与目标板的 libc、内核版本和 GPU 用户态驱动 ABI 匹配。常见组合如下：

树莓派：官方推荐 arm-linux-gnueabihf（32 位）或 aarch64-linux-gnu（64 位），也可直接使用 Raspberry Pi OS 自带的 gcc 进行本机编译。
i.MX 系列：NXP 提供 Yocto SDK，工具链前缀通常为 arm-poky-linux-gnueabi- 或 aarch64-poky-linux-。
瑞芯微 RK 系列：Buildroot 或 Debian SDK 中常见 arm-linux-gnueabihf- 与 aarch64-linux-gnu-。

工具链验证是第一步，必须确认目标架构、浮点 ABI 和动态链接器路径：

# 查看工具链目标架构
arm-linux-gnueabihf-gcc -v

# 编译一个最小测试程序
arm-linux-gnueabihf-gcc hello.c -o hello

# 查看 ELF 头与解释器
arm-linux-gnueabihf-readelf -h hello
arm-linux-gnueabihf-readelf -l hello | grep interpreter

若解释器显示 /lib/ld-linux-armhf.so.3，而目标板实际为 /lib/ld-linux.so.3，运行时会报 “No such file or directory”。此时应更换工具链或创建软链接，而不是盲目复制库文件。

二、EGL 初始化：OpenGL ES 与窗口系统的桥梁

EGL 负责管理显示连接、渲染表面和图形上下文。嵌入式平台通常提供厂商专用 EGL 库，例如树莓派的 libEGL.so（Broadcom）、i.MX 的 libEGL.so（Vivante）和瑞芯微的 libEGL.so（Mali）。初始化流程如下：

调用 eglGetDisplay(EGL_DEFAULT_DISPLAY) 获取显示连接。
调用 eglInitialize 初始化 EGL，并获取版本号。
通过 eglChooseConfig 选择匹配的帧缓冲配置，重点关注 EGL_RED_SIZE、EGL_GREEN_SIZE、EGL_BLUE_SIZE、EGL_ALPHA_SIZE、EGL_DEPTH_SIZE 和 EGL_RENDERABLE_TYPE。
调用 eglCreateWindowSurface 或 eglCreatePbufferSurface 创建渲染表面。
调用 eglCreateContext 创建 OpenGL ES 上下文，并通过 eglMakeCurrent 绑定。

EGLDisplay display = eglGetDisplay(EGL_DEFAULT_DISPLAY);
if (display == EGL_NO_DISPLAY) { /* 检查 /dev/dri/card0 权限 */ }

EGLint major, minor;
if (!eglInitialize(display, &major, &minor)) {
    // 常见原因：未设置 DISPLAY、缺少 GPU 驱动、权限不足
}

const EGLint configAttribs[] = {
    EGL_SURFACE_TYPE, EGL_WINDOW_BIT,
    EGL_RENDERABLE_TYPE, EGL_OPENGL_ES2_BIT,
    EGL_RED_SIZE, 8, EGL_GREEN_SIZE, 8, EGL_BLUE_SIZE, 8,
    EGL_DEPTH_SIZE, 24, EGL_NONE
};
EGLConfig config;
EGLint numConfigs;
eglChooseConfig(display, configAttribs, &config, 1, &numConfigs);

调试 EGL 时，优先检查 eglGetError() 返回值。若返回 EGL_NOT_INITIALIZED，通常是显示连接未建立；若返回 EGL_BAD_CONFIG，则说明属性列表与驱动能力不匹配。

三、窗口系统集成：X11、Wayland 与直接渲染

嵌入式窗口系统主要有三种形态：X11、Wayland 和直接渲染（DRM/KMS 或 Framebuffer）。不同形态下，EGL 的本地窗口类型不同：

窗口系统	本地窗口类型	典型平台	注意事项
X11	Window（XID）	桌面 Linux、部分 i.MX	需设置 DISPLAY，依赖 X Server
Wayland	wl_egl_window	树莓派、瑞芯微 Debian	需链接 libwayland-egl
DRM/KMS	gbm_surface	i.MX、RK 无桌面环境	需打开 /dev/dri/card0，使用 GBM
Framebuffer	fbdev_window	旧版嵌入式	性能较低，逐渐被 DRM 取代

以 Wayland 为例，创建 EGL 窗口表面需要先获取 wl_surface，再通过 wl_egl_window_create 转换为 EGL 可用的本地窗口：

struct wl_egl_window *eglWindow =
    wl_egl_window_create(wlSurface, width, height);

EGLSurface eglSurface =
    eglCreateWindowSurface(display, config,
                           (EGLNativeWindowType)eglWindow, NULL);

若使用 DRM/KMS 直接渲染，则需通过 GBM 创建 gbm_surface，并将其作为 EGLNativeWindowType 传入。此时不再依赖 X11 或 Wayland，适合资源受限的嵌入式设备。

四、常见嵌入式平台环境配置

树莓派：Raspberry Pi OS 已集成 Broadcom EGL 与 OpenGL ES 驱动。若使用 Lite 版本，需安装 libegl1-mesa-dev、libgles2-mesa-dev 和 libdrm-dev。在 /boot/config.txt 中确认 dtoverlay=vc4-kms-v3d 已启用，否则 EGL 可能回退到软件渲染。

i.MX 系列：NXP 官方 BSP 提供 Vivante GPU 驱动。需将 libEGL.so、libGLESv2.so、libGAL.so 和 libVSC.so 部署到目标板 /usr/lib，并确保 /dev/galcore 设备节点存在。若使用 Yocto，可直接在镜像中启用 imx-gpu-viv 配方。

瑞芯微 RK 系列：Buildroot SDK 中需启用 BR2_PACKAGE_ROCKCHIP_MALI 或 libmali。Debian 系统下通常已预装 Mali 驱动，可通过 glmark2-es2 验证。若出现 eglInitialize 失败，检查 /dev/mali0 权限和 libmali.so 的符号链接是否正确。

常见误区：直接将桌面版 libEGL.so 复制到目标板。嵌入式 GPU 驱动与内核 DRM 版本强绑定，混用会导致 eglInitialize 返回 EGL_NOT_INITIALIZED，甚至内核崩溃。务必使用厂商 SDK 中的驱动。

五、验证与排障清单

工具链：readelf -h 确认架构与 ABI 一致。
EGL：eglQueryString(display, EGL_VENDOR) 确认驱动厂商。
窗口系统：echo $DISPLAY 或 echo $WAYLAND_DISPLAY 确认环境变量。
权限：ls -l /dev/dri/card0 与 /dev/mali0 确认当前用户可访问。
运行：使用 glmark2-es2 或 es2_info 快速验证 OpenGL ES 是否可用。

环境搭建完成后，建议先运行一个最小 EGL 初始化程序，确认 eglQueryString 返回的厂商与版本符合预期，再逐步加入着色器、纹理和帧缓冲对象。这样可以把问题定位在环境层，而不是渲染逻辑层。