DRM 开发实战（二）：从零构建一个基础DRM显示应用

1. DRM显示应用开发基础在Linux图形开发领域直接渲染管理器DRM是控制现代显卡和显示硬件的核心接口。很多开发者第一次接触DRM时都会被其复杂的API吓到但实际只要理解了几个关键概念就能快速构建基础的显示应用。DRM本质上提供了对显示硬件的直接访问能力包括显示设备管理CRTC、Encoder、Connector显存管理GEM/TTM显示控制模式设置、页面翻转我刚开始接触DRM时最困惑的是如何将内存中的图像数据显示到屏幕上。后来发现整个过程可以简化为获取显示资源 → 创建缓冲区 → 绑定帧缓冲 → 设置显示模式。下面我们就用实际代码来演示这个流程。2. 环境准备与设备初始化2.1 开发环境配置首先确保系统已安装必要的开发工具和库sudo apt install build-essential libdrm-dev编译时需要链接libdrm库gcc drm_app.c -o drm_app -ldrm2.2 打开DRM设备Linux中DRM设备通常位于/dev/dri目录下。主设备节点一般是card0int fd open(/dev/dri/card0, O_RDWR | O_CLOEXEC); if (fd 0) { perror(无法打开DRM设备); return -1; }这里需要注意权限问题普通用户可能需要加入video组才能访问设备节点。2.3 获取显示资源通过drmModeGetResources获取当前系统的显示资源配置drmModeRes *res drmModeGetResources(fd); if (!res) { perror(获取DRM资源失败); close(fd); return -1; } // 通常使用第一个连接器和CRTC uint32_t crtc_id res-crtcs[0]; uint32_t connector_id res-connectors[0];实际产品中需要更健壮的资源选择逻辑比如检测实际连接的显示器。3. 缓冲区管理与帧缓冲创建3.1 创建DUMB缓冲区DUMB缓冲区是最基础的显存类型适合初学者理解struct drm_mode_create_dumb create { .width width, .height height, .bpp 32 // 32位色深 }; if (drmIoctl(fd, DRM_IOCTL_MODE_CREATE_DUMB, create)) { perror(创建DUMB缓冲区失败); return -1; }这个ioctl会返回缓冲区的句柄(handle)、大小(size)和步长(pitch)。3.2 内存映射将缓冲区映射到用户空间以便写入图像数据struct drm_mode_map_dumb map { .handle create.handle }; if (drmIoctl(fd, DRM_IOCTL_MODE_MAP_DUMB, map)) { perror(映射缓冲区失败); return -1; } uint8_t *vaddr mmap(0, create.size, PROT_READ | PROT_WRITE, MAP_SHARED, fd, map.offset);3.3 创建帧缓冲将DUMB缓冲区绑定为帧缓冲uint32_t fb_id; if (drmModeAddFB(fd, width, height, 24, 32, create.pitch, create.handle, fb_id)) { perror(添加帧缓冲失败); return -1; }这里参数解释24色深位数32每个像素的位数pitch行字节数4. 显示控制与模式设置4.1 获取显示模式从连接器获取当前支持的显示模式drmModeConnector *conn drmModeGetConnector(fd, connector_id); drmModeModeInfo mode conn-modes[0]; // 使用第一个模式4.2 设置CRTC关键的一步是将帧缓冲与CRTC关联if (drmModeSetCrtc(fd, crtc_id, fb_id, 0, 0, connector_id, 1, mode)) { perror(设置CRTC失败); return -1; }这个调用会立即将缓冲区内容显示到屏幕上。4.3 简单绘图示例填充白色背景memset(vaddr, 0xff, create.size);由于DRM是双缓冲机制这个修改会立即显示出来。5. 完整示例代码解析下面是一个完整的DRM显示应用示例#define _GNU_SOURCE #include errno.h #include fcntl.h #include stdbool.h #include stdint.h #include stdio.h #include stdlib.h #include string.h #include sys/mman.h #include unistd.h #include xf86drm.h #include xf86drmMode.h struct buffer_object { uint32_t width; uint32_t height; uint32_t pitch; uint32_t handle; uint32_t size; uint8_t *vaddr; uint32_t fb_id; }; static int create_fb(int fd, struct buffer_object *bo) { struct drm_mode_create_dumb create {}; struct drm_mode_map_dumb map {}; create.width bo-width; create.height bo-height; create.bpp 32; drmIoctl(fd, DRM_IOCTL_MODE_CREATE_DUMB, create); bo-pitch create.pitch; bo-size create.size; bo-handle create.handle; drmModeAddFB(fd, bo-width, bo-height, 24, 32, bo-pitch, bo-handle, bo-fb_id); map.handle create.handle; drmIoctl(fd, DRM_IOCTL_MODE_MAP_DUMB, map); bo-vaddr mmap(0, create.size, PROT_READ | PROT_WRITE, MAP_SHARED, fd, map.offset); memset(bo-vaddr, 0xff, bo-size); return 0; } int main() { int fd; drmModeConnector *conn; drmModeRes *res; uint32_t conn_id, crtc_id; struct buffer_object buf; fd open(/dev/dri/card0, O_RDWR | O_CLOEXEC); res drmModeGetResources(fd); crtc_id res-crtcs[0]; conn_id res-connectors[0]; conn drmModeGetConnector(fd, conn_id); buf.width conn-modes[0].hdisplay; buf.height conn-modes[0].vdisplay; create_fb(fd, buf); drmModeSetCrtc(fd, crtc_id, buf.fb_id, 0, 0, conn_id, 1, conn-modes[0]); getchar(); // 等待用户输入 drmModeFreeConnector(conn); drmModeFreeResources(res); close(fd); return 0; }6. 常见问题与调试技巧6.1 权限问题处理如果遇到权限错误sudo usermod -aG video $USER需要重新登录使更改生效。6.2 多显示器支持实际应用中需要枚举所有连接器for (int i 0; i res-count_connectors; i) { drmModeConnector *con drmModeGetConnector(fd, res-connectors[i]); if (con-connection DRM_MODE_CONNECTED) { // 找到已连接的显示器 } drmModeFreeConnector(con); }6.3 性能优化建议使用双缓冲或三缓冲减少撕裂考虑使用DMA-BUF进行零拷贝传输对于视频播放等场景使用硬件加速平面7. 进阶开发方向掌握基础显示后可以进一步探索多图层合成Overlay/Plane原子模式设置Atomic Mode Setting显存共享PRIME渲染加速OpenGL/Vulkan集成我在实际项目中遇到过的一个典型问题是多线程下的资源竞争后来通过为每个线程创建独立的DRM主设备文件描述符解决了这个问题。DRM开发需要特别注意资源管理和错误处理因为显示子系统对稳定性要求极高。