3. 开发主机环境准备：Ubuntu/Debian系统安装、虚拟机配置、网络与SSH服务设置
USB Gadget驱动开发对主机环境有明确要求：需要Linux内核头文件、交叉编译工具链、USB/IP协议栈以及稳定的网络连接。本章将指导你从零搭建一个适合USB Gadget驱动开发的主机环境，涵盖操作系统安装、虚拟机配置、网络规划与SSH服务部署。
3.1 操作系统选择与安装
推荐使用 Ubuntu 22.04 LTS 或 Debian 12 (Bookworm) 作为开发主机。两者均提供长期支持、丰富的软件包仓库以及完善的USB Gadget内核支持。
| 特性 | Ubuntu 22.04 LTS | Debian 12 (Bookworm) |
|---|---|---|
| 内核版本 | 5.15 LTS | 6.1 LTS |
| 软件包新鲜度 | 适中，稳定 | 较新，稳定 |
| Gadget配置工具 | configfs / libusbgx | configfs / libusbgx |
| 社区支持 | 非常活跃 | 活跃 |
| 适用场景 | 初学者、快速原型 | 生产环境、嵌入式系统 |
提示： 如果主机是Windows/macOS，建议使用虚拟机安装Ubuntu Server（无桌面环境），以节省资源并模拟嵌入式开发场景。
3.1.1 最小化安装步骤（以Ubuntu Server 22.04为例）
- 从官网下载ISO镜像：
ubuntu-22.04.5-live-server-amd64.iso - 使用Rufus或balenaEtcher制作启动U盘
- 安装时选择 Minimal 模式，仅安装标准系统工具
- 磁盘分区建议：
/分配30GB，/home分配20GB，剩余作为交换分区 - 设置主机名为
gadget-dev，创建用户developer - 安装完成后执行系统更新：
sudo apt update && sudo apt upgrade -y
sudo apt install build-essential linux-headers-$(uname -r) git curl wget -y3.2 虚拟机配置（可选但推荐）
使用虚拟机可以隔离开发环境、方便快照回滚，并模拟多台设备互联的USB Gadget测试场景。推荐使用 VirtualBox 7.0+ 或 VMware Workstation Pro 17+。
3.2.1 VirtualBox关键配置项
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| CPU核心数 | 2 ~ 4 | 至少2核，用于编译内核模块 |
| 内存 | 4096 MB | 低于2GB会导致编译缓慢 |
| 显存 | 16 MB | 仅控制台界面，无需图形加速 |
| 网络1 | NAT | 用于访问外网下载软件包 |
| 网络2 | Host-Only | 用于宿主机与虚拟机通信、SSH连接 |
| USB控制器 | USB 3.0 (xHCI) | 支持USB Gadget硬件透传 |
注意： 如果使用USB Gadget硬件（如BeagleBone Black、Raspberry Pi Zero），务必在虚拟机设置中启用 USB控制器 并添加对应的USB设备过滤器，否则虚拟机无法识别目标板。
3.3 网络与SSH服务设置
开发过程中需要频繁在宿主机与虚拟机之间传输文件、远程执行编译命令。稳定的网络连接和SSH服务是提高开发效率的基础。
3.3.1 网络规划
推荐使用 双网卡 方案：
- NAT网卡（eth0）： 用于访问互联网，安装软件包、更新系统。
- Host-Only网卡（eth1）： 用于宿主机与虚拟机之间的私有通信，固定IP地址，避免DHCP变化导致SSH连接中断。
在虚拟机内配置静态IP：
# 编辑 /etc/netplan/01-netcfg.yaml（Ubuntu）
network:
version: 2
ethernets:
eth0:
dhcp4: true
eth1:
dhcp4: false
addresses:
- 192.168.56.101/24
nameservers:
addresses: [8.8.8.8, 1.1.1.1]
# 应用配置
sudo netplan apply3.3.2 SSH服务安装与加固
- 安装OpenSSH Server：
sudo apt install openssh-server -y
sudo systemctl enable ssh
sudo systemctl start ssh- 验证服务状态：
sudo systemctl status ssh
# 输出应包含 "active (running)"- 配置密钥认证（推荐，避免每次输入密码）：
# 在宿主机生成密钥对（如果已有则跳过）
ssh-keygen -t ed25519 -C "gadget-dev"
# 将公钥复制到虚拟机
ssh-copy-id developer@192.168.56.101- 安全加固（生产环境建议）：
# 编辑 /etc/ssh/sshd_config
PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes
Port 2222 # 修改默认端口，减少扫描攻击
# 重启服务
sudo systemctl restart ssh
效率技巧： 在宿主机
~/.ssh/config 中添加以下配置，实现一键SSH连接：
Host gadget
HostName 192.168.56.101
User developer
Port 22
IdentityFile ~/.ssh/id_ed25519ssh gadget 即可连接。
3.4 开发工具链安装
USB Gadget驱动开发需要以下核心工具链：
| 软件包 | 用途 | 安装命令 |
|---|---|---|
| build-essential | GCC、make等基础编译工具 | sudo apt install build-essential |
| linux-headers-$(uname -r) | 当前内核头文件，用于编译内核模块 | sudo apt install linux-headers-$(uname -r) |
| libusbgx / gadget-tools | USB Gadget配置库与命令行工具 | sudo apt install libusbgx gadget-tools |
| git / curl / wget | 版本控制与源码下载 | sudo apt install git curl wget |
| vim / tmux | 编辑器与终端复用器 | sudo apt install vim tmux |
| usbutils | USB设备枚举与调试（lsusb等） | sudo apt install usbutils |
3.4.1 验证环境
安装完成后，执行以下命令验证环境是否就绪：
# 检查内核版本
uname -r
# 输出示例: 5.15.0-91-generic
# 检查GCC版本
gcc --version
# 输出示例: gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0
# 检查内核头文件是否匹配
ls /lib/modules/$(uname -r)/build
# 应存在该目录，且包含 Makefile、Kconfig 等文件
# 检查USB Gadget内核配置
zcat /proc/config.gz | grep CONFIG_USB_GADGET
# 应输出类似:
# CONFIG_USB_GADGET=y
# CONFIG_USB_GADGET_DUALSPEED=y
# CONFIG_USB_GADGETFS=m
提示： 如果
/proc/config.gz 不存在，可以安装 linux-config-5.15 包或从 /boot/config-$(uname -r) 获取内核配置。
3.5 环境验证清单
完成本章所有步骤后，请对照以下清单逐项确认：
- Ubuntu/Debian系统已安装并更新至最新
- 虚拟机已配置双网卡（NAT + Host-Only）
- Host-Only网卡已设置静态IP（如192.168.56.101）
- SSH服务已启用，且可通过密钥认证从宿主机登录
- 开发工具链（build-essential、内核头文件、libusbgx）已安装
- 内核配置中
CONFIG_USB_GADGET已启用 - 宿主机与虚拟机之间可以互相ping通
至此，开发主机环境已准备就绪。下一阶段将进入USB Gadget内核模块的编译与加载实践。