外设兼容 - Ubuntu.Fan

USB 设备

基本排查


# 列出所有 USB 设备
lsusb
 
# 详细信息
lsusb -v -d 供应商ID:产品ID
 
# 查看 USB 设备树
lsusb -t
 
# 内核日志中的 USB 事件
sudo dmesg | grep -i usb

USB 存储设备

USB 移动硬盘和 U 盘通常即插即用。如果未自动挂载：


# 查看设备分区
sudo fdisk -l /dev/sdX
 
# 手动挂载
sudo mkdir -p /mnt/usb
sudo mount /dev/sdX1 /mnt/usb
 
# NTFS 分区挂载
sudo apt install ntfs-3g
sudo mount -t ntfs-3g /dev/sdX1 /mnt/usb

USB 串口设备


# 检查串口设备
ls /dev/ttyUSB* /dev/ttyACM*
 
# 添加用户到 dialout 组
sudo usermod -aG dialout $USER

打印机

安装 CUPS 打印服务

Ubuntu 26.04 默认安装 CUPS。确认服务运行：


systemctl status cups

添加打印机

图形界面：设置 > 打印机 > 添加打印机

命令行方式：


# 搜索网络打印机
lpinfo -v
 
# 安装打印机驱动包
sudo apt install printer-driver-all
 
# HP 打印机
sudo apt install hplip
hp-setup  # 图形化配置工具
 
# Brother 打印机
# 从 Brother 官网下载 Linux 驱动安装脚本

打印测试


# 查看已配置的打印机
lpstat -p -d
 
# 打印测试页
lp -d 打印机名称 /usr/share/cups/data/testprint

常见问题

无法检测到打印机时：


sudo systemctl restart cups
sudo lpinfo -v  # 重新扫描

扫描仪

SANE 扫描框架


sudo apt install sane-utils libsane-extra xsane
 
# 检测扫描仪
scanimage -L
 
# 命令行扫描
scanimage --format=png > scan.png
 
# 图形化扫描工具
sudo apt install simple-scan

网络扫描仪

编辑 /etc/sane.d/net.conf 添加网络扫描仪地址：


# 添加扫描仪 IP
192.168.1.100

摄像头与视频采集

摄像头检测


ls /dev/video*
v4l2-ctl --list-devices

USB 采集卡

大部分 HDMI 采集卡使用标准 UVC 驱动：


sudo apt install v4l-utils
v4l2-ctl --device=/dev/video0 --list-formats-ext

使用 OBS Studio 或 VLC 测试：


sudo apt install obs-studio
# 或
vlc v4l2:///dev/video0

绘图板

Wacom 数位板

26.04 的 Ubuntu Desktop 是 Wayland 会话，Wacom 数位板开箱即用，首选在 GNOME 设置 > 绘图板 中配置映射、按键和压感曲线，无需安装额外驱动。


# 确认设备被内核识别
sudo libinput list-devices | grep -i -A2 -i "tablet\|wacom"

Note

xsetwacom / xserver-xorg-input-wacom 仅在 X11（XWayland 不支持其调参）下有效——只有当你登录到提供 X.org 会话的其他桌面（如 KDE/Xfce）时才需要它们：


sudo apt install xserver-xorg-input-wacom
xsetwacom --list devices
xsetwacom --set "设备名称" PressureCurve 0 0 100 100

非 Wacom 绘图板

部分国产绘图板（如绘王、友基）可能需要安装额外驱动：


# 检查是否被识别为输入设备
sudo libinput list-devices | grep -i tablet

游戏手柄

Xbox（含无线适配器）、PlayStation 等主流手柄由内核内置驱动（xpad、hid-playstation 等）开箱即用，无需安装 xboxdrv（已废弃）。


# 检测手柄
ls /dev/input/js*
sudo apt install joystick
jstest /dev/input/js0

通用排查步骤

插入设备后查看内核日志：sudo dmesg -w（实时监控）
确认设备被 USB 识别：lsusb
检查是否缺少驱动或固件：sudo dmesg | grep -i firmware
安装通用固件包：sudo apt install linux-firmware
检查设备权限和用户组