三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

飞腾FT-2000/4平台Ubuntu系统SM750显卡驱动编译安装全攻略

发布时间：2026/8/7 3:38:33 三亩地 编程学习日记
飞腾FT-2000/4平台Ubuntu系统SM750显卡驱动编译安装全攻略

1. 项目背景与核心挑战

最近在折腾一台基于飞腾FT-2000/4处理器的国产化主机，系统装的是Ubuntu 22.04 LTS。机器本身运行流畅，但一接上显示器，问题就来了：桌面分辨率被锁死在1024x768，刷新率也只有60Hz，外接的2K显示器直接不识别。这体验，瞬间回到了二十年前。一查显卡信息，用的是SM750/768这块芯片。问题很明确，系统自带的fbdev或vesa通用驱动，根本没法发挥这块显卡的真实性能，更别提多屏、高分辨率这些现代需求了。

SM750/768这块显卡，在国产化设备和一些嵌入式、工控领域其实挺常见的，它功耗低、集成度高。但在主流的Linux发行版，特别是较新的Ubuntu版本里，官方仓库往往不包含其专有驱动。这就导致了一个尴尬的局面：硬件是国产的“芯”，系统是开源的“魂”，但中间的“桥梁”——显卡驱动，却断了。对于开发者、运维或者任何需要在飞腾平台上进行图形界面操作的用户来说，没有合适的驱动，就意味着无法进行代码开发、图形设计甚至流畅的日常办公。

这个问题的核心，不在于飞腾处理器本身，而在于其配套的芯片组和外围设备驱动生态。FT-2000/4或D2000处理器通常搭配的是国产的套片（Chipset），其中集成的显示核心可能就是SM750/768。Ubuntu系统默认只为x86_64架构的常见硬件（如Intel/AMD集显、NVIDIA独显）提供完善的驱动支持。对于ARM架构的飞腾平台，特别是这些相对小众的显示芯片，驱动需要手动编译和安装。这不仅仅是点一下鼠标就能完成的任务，它涉及到内核头文件、编译环境、源码适配和模块签名等一系列底层操作。

2. 驱动方案选型与原理剖析

面对SM750/768在Ubuntu下的驱动问题，通常有几种路径，但并非都行得通。

2.1 方案对比与可行性分析

第一种是寄希望于Ubuntu自动更新或通过apt安装。很遗憾，在Ubuntu 22.04或24.04的官方源和restricted源中，基本找不到名为sm750或siliconmotion的驱动包。执行ubuntu-drivers devices命令，列表里也通常是空的。这是因为SM750/768的驱动并未被收录进标准的内核树（Mainline Kernel）或Ubuntu的硬件启用（Hardware Enablement）堆栈中。

第二种是寻找预编译的.deb包。一些设备制造商（OEM）可能会为其特定型号的整机提供驱动包。但飞腾平台多为开发板或通用主板，OEM支持薄弱，且不同厂商的固件和硬件设计可能有细微差异，通用预编译包风险很高，极易导致系统无法启动。

因此，最可靠、也是最通用的方案是第三种：手动编译开源驱动源码。SM750/768的驱动源码通常由芯片厂商（Silicon Motion）提供或由社区维护，并托管在如GitHub等开源平台上。编译驱动意味着我们需要在目标系统（你的飞腾Ubuntu）上，用当前运行的内核版本对应的工具链，将C语言源代码构建成内核可加载的模块（.ko文件）。这个过程能确保驱动与你的内核版本、系统架构（aarch64）完全匹配。

2.2 编译驱动的核心原理

为什么一定要编译？Linux内核是一个宏内核（Monolithic Kernel），设备驱动以内核模块的形式存在，与内核核心紧密耦合。每个内核版本都有其特定的应用程序二进制接口（ABI）和数据结构。预编译的驱动模块只对特定的内核版本有效。Ubuntu自动升级内核后，原有的驱动模块就会因为符号（Symbol）不匹配而无法加载，这就是常见的“驱动掉了”的情况。

手动编译的过程，实质上是调用系统上的GCC编译器，根据当前内核的/usr/src/linux-headers-$(uname -r)目录下的头文件，将驱动源码编译成与当前内核ABI兼容的模块。这样生成的.ko文件，才能被modprobe正确识别并插入内核，驱动硬件工作。

对于飞腾ARM平台，编译时使用的编译器虽然是gcc，但其背后默认使用的是系统的交叉编译工具链，能够生成aarch64架构的代码。我们不需要像在x86主机上为ARM交叉编译那样额外配置，这是在同一架构下本地编译的优势。

3. 实战：在飞腾Ubuntu上编译安装SM750驱动

下面，我将以Ubuntu 22.04 LTS (Jammy Jellyfish) on FT-2000/4平台为例，展示完整的操作流程。请确保你已通过SSH或直接接入了显示器和键盘（如果驱动失效，SSH是救命稻草）。

3.1 前期准备与环境搭建

首先，更新系统并安装编译驱动所必需的软件包。这些工具是构建任何内核模块的基础。

sudo apt update sudo apt upgrade -y sudo apt install -y build-essential git libelf-dev linux-headers-$(uname -r)
  • build-essential: 包含GCC、make等核心编译工具。
  • linux-headers-$(uname -r): 安装与你当前运行内核版本一致的头文件，这是编译模块的“蓝图”。$(uname -r)会自动获取你的内核版本，例如5.15.0-91-generic。
  • libelf-dev: 处理ELF（可执行与可链接格式）文件所需的库，内核模块编译会用到。

接下来，寻找驱动源码。经过搜索，一个较为活跃且支持较新内核的SM750驱动仓库是https://github.com/loongson-community/linux.git中的一个分支或特定目录，但更直接的是社区维护的独立仓库。例如，我们可以尝试使用一个经过验证的源码：

git clone https://github.com/freddix/legacy_sm750fb.git cd legacy_sm750fb

注意：驱动源码仓库可能随时间变化。如果上述仓库失效，请尝试以“sm750fb linux driver”为关键词在GitHub或GitLab上搜索。选择最近有更新的仓库，这通常意味着对更新内核的兼容性更好。

3.2 驱动源码的配置与编译

进入源码目录后，我们首先查看Makefile。一个标准的驱动Makefile会通过obj-m来定义要构建的模块对象。在这个例子中，模块名很可能是sm750fb.o，最终生成sm750fb.ko。

编译命令非常简单：

make

make命令会读取当前目录的Makefile，并调用内核构建系统（Kbuild）。Kbuild系统会去/lib/modules/$(uname -r)/build（这是一个指向头文件目录的符号链接）寻找当前内核的配置和头文件，然后进行编译。

如果编译成功，你会在当前目录下看到生成的sm750fb.ko文件。如果遇到编译错误，通常有以下几种可能及解决思路：

  1. 内核版本太新，源码不兼容：错误信息常涉及某个函数签名改变或数据结构成员缺失。这时需要根据错误提示，去源码中做简单修改。例如，老版本dma_alloc_coherent函数参数顺序可能和新内核不同。你需要搜索错误中的函数名，对比内核头文件中的新定义，并相应修改驱动源码中的调用方式。这是手动编译驱动最常见的“坑”。
  2. 缺少依赖：确保所有开发包已安装。有时需要libdrm-dev等。
  3. 架构问题：确认源码支持ARM64（aarch64）。绝大多数开源驱动都支持多架构。

3.3 安装与加载内核模块

编译成功后，需要将模块安装到系统的标准模块目录，并更新模块依赖关系。

sudo make install

这条命令通常会执行以下操作：将sm750fb.ko复制到/lib/modules/$(uname -r)/kernel/drivers/video/fbdev/目录下，然后运行depmod -a来更新模块的依赖信息。

接下来，手动加载驱动模块：

sudo modprobe sm750fb

如果一切顺利，你不会看到任何错误输出。此时，可以通过以下命令验证模块是否加载成功：

lsmod | grep sm750fb

以及查看内核日志，确认驱动初始化信息：

dmesg | tail -20

你期望看到的日志可能包含“SM750 frame buffer device initialized”或类似信息。

3.4 配置系统以持久化加载驱动

modprobe加载的驱动在下次重启后会失效。为了让系统每次启动都自动加载它，我们需要将模块名添加到指定的配置文件中。

echo "sm750fb" | sudo tee /etc/modules-load.d/sm750fb.conf

这个操作创建了一个配置文件，告诉systemd-modules-load服务在启动早期加载sm750fb模块。

4. 安装后的配置、验证与故障排查

驱动加载成功，只是第一步。要让图形界面（通常是X11下的LightDM/GDM登录管理器）正确使用新驱动，还需要进行配置。

4.1 配置X11使用fbdev驱动

SM750驱动通常提供的是fbdev（帧缓冲设备）接口。我们需要告诉X11服务器使用这个帧缓冲设备。首先，备份并编辑X11的配置文件：

sudo cp /etc/X11/xorg.conf /etc/X11/xorg.conf.backup sudo nano /etc/X11/xorg.conf

如果这个文件不存在，可以创建一个。在其中添加以下基本配置：

Section "Device" Identifier "SM750" Driver "fbdev" Option "fbdev" "/dev/fb0" # 通常SM750驱动会占用fb0 EndSection Section "Screen" Identifier "Default Screen" Device "SM750" Monitor "Configured Monitor" DefaultDepth 24 SubSection "Display" Depth 24 Modes "1920x1080" "1280x1024" "1024x768" # 添加你期望的分辨率，第一个为默认 EndSubSection EndSection

保存退出后，重启图形界面服务或直接重启系统：

sudo systemctl restart lightdm # 或 gdm3, sddm，取决于你的桌面环境

4.2 验证驱动生效

重启进入图形界面后，通过多种方式验证：

  1. 命令行检查：

    lspci -k | grep -A 2 -i vga

    输出应显示Kernel driver in use: sm750fb。

    xrandr

    这个命令会列出当前显示接口（如Virtual1）和支持的分辨率。你应该能看到比之前更多的、更高的分辨率选项。

  2. 图形界面检查：进入系统设置->显示，查看分辨率选项是否已解锁至显示器的原生分辨率。

4.3 常见故障与深度排查

如果驱动加载后黑屏、分辨率不对或无法进入桌面，请按以下步骤排查：

  1. 检查内核日志：这是最重要的信息来源。重启系统，在GRUB菜单选择“高级选项”，进入“恢复模式”或一个低分辨率终端。然后查看完整的驱动加载日志：

    journalctl -b -k | grep -i sm750 dmesg | grep -i sm750

    关注是否有“probe failed”、“error -xx”、“invalid parameter”等关键词。

  2. 确认帧缓冲设备：驱动可能没有使用/dev/fb0。检查所有帧缓冲设备：

    ls -l /dev/fb*

    尝试在xorg.conf中更换fbdev路径，如/dev/fb1。

  3. 驱动参数：有些驱动支持模块参数。你可以尝试在加载时传递参数，或者在/etc/modprobe.d/目录下创建配置文件（如sm750fb.conf）：

    options sm750fb mode_option=1920x1080-24@60

    参数名需要查阅驱动源码或modinfo sm750fb的输出。

  4. X11日志：X服务器的日志位于/var/log/Xorg.0.log。检查其中关于fbdev和SM750的条目，特别是以(EE)开头的错误行和以(II)开头的信息行。

    grep -E "(EE|WW|II).*(fbdev|SM750|screen)" /var/log/Xorg.0.log

  5. 回滚与安全模式：如果修改xorg.conf导致无法启动，可以在恢复模式下删除或重命名该文件，系统会使用自动检测的配置。始终记得备份原始配置。

5. 进阶话题：Wayland、DKMS与性能调优

5.1 关于Wayland

现代Ubuntu桌面版（如22.04 GNOME）默认可能使用Wayland显示服务器协议。Wayland的架构与X11不同，它不直接使用fbdev驱动。对于SM750这类驱动，在纯Wayland会话下可能无法工作或功能受限。如果你的系统默认进入了Wayland，遇到问题，可以在登录界面选择“Ubuntu on Xorg”会话。这是一个临时的、更兼容的解决方案。长期来看，驱动需要提供DRM/KMS（Direct Rendering Manager / Kernel Mode Setting）支持才能完美适配Wayland。这通常需要更深入的驱动开发工作。

5.2 使用DKMS管理内核升级

手动编译的驱动有一个致命缺点：系统每次升级内核后，驱动就会失效，需要重新编译安装。DKMS（Dynamic Kernel Module Support）可以自动化这个过程。

要为SM750驱动创建DKMS支持，你需要一个符合DKMS标准的源码目录结构（通常包含dkms.conf文件）。如果下载的源码包没有，可以手动创建。

假设你的驱动源码在/usr/src/sm750fb-1.0：

  1. 创建dkms.conf文件：

    PACKAGE_NAME="sm750fb" PACKAGE_VERSION="1.0" MAKE[0]="make all" CLEAN="make clean" BUILT_MODULE_NAME[0]="sm750fb" DEST_MODULE_LOCATION[0]="/kernel/drivers/video/fbdev" AUTOINSTALL="yes"

  2. 将源码目录和dkms.conf复制到/usr/src下。

  3. 注册并安装到DKMS：

    sudo dkms add -m sm750fb -v 1.0 sudo dkms build -m sm750fb -v 1.0 sudo dkms install -m sm750fb -v 1.0

完成后，每次内核更新，DKMS都会在安装新内核后自动为你重新编译这个驱动模块。

5.3 性能调优与多屏支持

SM750/768性能有限，不适合大型3D应用。但我们可以优化2D和显示体验：

  • 显存调整：检查驱动是否支持通过模块参数调整显存大小。查看modinfo sm750fb，寻找类似vidmem或mem的参数。增加显存可能对高分辨率有帮助。
  • 刷新率：在xorg.conf的Display子项中，可以指定Modeline来精确控制分辨率和刷新率。使用cvt命令生成Modeline：
    cvt 1920 1080 60
    将输出的一行复制到xorg.conf的Display子项中，并添加Modeline和Option "PreferredMode"。
  • 多屏：SM750可能支持多路输出。这需要在xorg.conf中配置多个Device和Screen节，并使用ServerLayout节将它们组合。这非常复杂，且高度依赖硬件具体设计（如板载的VGA、DVI、LVDS接口定义）。通常需要参考主板手册和驱动源码中的文档或注释。

整个流程走下来，从驱动缺失的“睁眼瞎”，到手动编译后的“高清世界”，虽然步骤繁琐，但每一步都有其明确的逻辑。在国产化平台和开源系统的结合部，这种“自力更生”的调试能力，正在变得越来越重要。最深的体会是，遇到编译错误不要慌，内核日志（dmesg）和X11日志（/var/log/Xorg.0.log）是你最好的朋友，90%的问题都能从中找到线索。另外，在修改任何关键配置文件（如xorg.conf）前，务必备份，并确保有另一种访问系统的方式（如SSH），这能让你在配置错误导致黑屏时，依然有挽回的余地。

编程学习 学习日记 实战经验
← 返回列表