DisplayLink RPM内核模块深入分析：evdi库与DKMS集成原理

DisplayLink RPM内核模块深入分析：evdi库与DKMS集成原理

【免费下载链接】displaylink-rpmRPM sources for the DisplayLink USB display adapters项目地址: https://gitcode.com/gh_mirrors/di/displaylink-rpm

DisplayLink RPM项目是为Fedora、CentOS Stream、Rocky Linux和AlmaLinux OS构建DisplayLink驱动的RPM包，支持DL-7xxx、DL-6xxx、DL-5xxx、DL-41xx和DL-3xxx系列设备，包含开源的evdi库，通过DKMS实现内核模块的动态管理。

evdi库：DisplayLink驱动的核心组件

evdi（Extensible Virtual Display Interface）库是DisplayLink驱动的核心，作为用户空间与内核模块间的桥梁，负责处理显示数据的传输与渲染。在项目中，evdi库的源代码位于/data/web/disk1/git_repo/gh_mirrors/di/displaylink-rpm/evdi-%{version}/module/目录，包含多个关键文件：

• evdi_drm_drv.c：实现DRM（Direct Rendering Manager）驱动核心功能，负责初始化设备、管理显示模式和处理用户空间请求。
• evdi_gem.c：处理图形执行管理器（GEM）对象，管理显示缓冲区的分配与释放。
• evdi_fb.c：实现帧缓冲设备接口，提供屏幕显示数据的存储区域。

evdi库的版本与项目版本同步，当前版本为1.15.0，定义在displaylink.spec文件中：%{!?_version:%global _version 1.15.0}。

DKMS集成：动态内核模块管理的实现

DKMS（Dynamic Kernel Module Support）是项目中实现内核模块自动编译和安装的关键技术。通过DKMS，evdi模块能够在系统内核更新后自动重新编译，确保驱动的持续可用性。

DKMS配置文件

evdi模块的DKMS配置文件为/data/web/disk1/git_repo/gh_mirrors/di/displaylink-rpm/%{_prefix}/src/evdi-%{version}-%{release}/dkms.conf，其中包含模块名称、版本、构建命令等信息。在RPM构建过程中，通过以下步骤配置DKMS：

1. 禁用弱模块链接：echo "NO_WEAK_MODULES=yes" >> dkms.conf，避免DKMS为弱模块创建符号链接。
2. 设置版本信息：sed -i "s/PACKAGE_VERSION=.*/PACKAGE_VERSION=\"%{version}-%{release}\"/" dkms.conf，确保DKMS使用正确的版本号。

RPM安装与DKMS操作

在RPM包的安装过程中，displaylink.spec的%post脚本段执行DKMS命令：

%{_sbindir}/dkms add evdi/%{version}-%{release} --rpm_safe_upgrade >> %{logfile} 2>&1 || \ { echo "WARNING: DKMS add failed for evdi/%{version}-%{release}. Check %{logfile} for details." >&2; } %{_sbindir}/dkms build evdi/%{version}-%{release} >> %{logfile} 2>&1 || \ { echo "WARNING: DKMS build failed for evdi/%{version}-%{release}. Check %{logfile} for details." >&2; } %{_sbindir}/dkms install evdi/%{version}-%{release} >> %{logfile} 2>&1 || \ { echo "WARNING: DKMS install failed for evdi/%{version}-%{release}. Check %{logfile} for details." >&2; }

这些命令将evdi模块添加到DKMS管理、编译并安装到当前内核中。

构建流程：从源码到RPM包

项目的构建过程通过Makefile和displaylink.spec文件定义，主要步骤包括：

1. 准备源码

• 下载DisplayLink驱动包：Source4: DisplayLink_USB_Graphics_Software_for_Ubuntu_%{_daemon_version}.zip。
• 提取evdi源码：mv displaylink-driver-%{_daemon_version}/evdi.tar.gz evdi-%{version}，并应用补丁update-bundled-evdi-to-latest-release.patch。

2. 编译evdi库

进入evdi-%{version}/library/目录，执行%make_build编译libevdi.so库，并安装到%{_libexecdir}/%{name}/目录。

3. 安装内核模块源码

将evdi模块源码复制到%{_prefix}/src/evdi-%{version}-%{release}/目录，供DKMS使用。

4. 打包与安装

RPM包包含evdi库、内核模块源码、系统服务配置（如displaylink-driver.service）、udev规则（99-displaylink.rules）等文件，确保驱动在系统中正确部署和运行。

高级配置与故障排除

模块参数配置

evdi模块的参数通过evdi.conf文件（/etc/modprobe.d/evdi.conf）配置，例如设置依赖模块加载顺序：

softdep evdi pre: drm_kms_helper drm

安全启动支持

在启用Secure Boot的系统上，需使用MOK（Machine Owner Key）签名evdi模块。DKMS从3.0.4版本开始自动生成密钥，用户需执行以下步骤：

1. 安装mokutil和dkms：sudo dnf install mokutil dkms。
2. 导入密钥：mokutil --import /var/lib/dkms/mok.pub，并重启系统完成 enrollment。
3. 重新构建模块：sudo dkms autoinstall。

常见问题解决

• DKMS构建失败：检查日志文件%{_localstatedir}/log/displaylink/displaylink.log，确认内核开发包已安装（kernel-devel或kernel-16k-devel）。
• 显示器连接问题：验证udev规则是否正确应用，执行udevadm trigger触发设备检测。

总结

DisplayLink RPM项目通过evdi库和DKMS的紧密集成，为Linux系统提供了稳定、灵活的DisplayLink设备驱动解决方案。evdi库作为核心组件，实现了显示数据的高效处理；DKMS则确保了内核模块在系统更新时的自动适配。通过本文的深入分析，用户可以更好地理解驱动的工作原理，进行配置优化和故障排除。

项目的持续维护和更新确保了对新内核版本和硬件设备的支持，用户可通过make github-release命令获取最新版本的evdi库，或参与项目贡献，推动驱动的不断完善。

【免费下载链接】displaylink-rpmRPM sources for the DisplayLink USB display adapters项目地址: https://gitcode.com/gh_mirrors/di/displaylink-rpm