TinyPilot项目中的USB Gadget驱动与configfs配置详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01127/article/details/148601996

TinyPilot项目中的USB Gadget驱动与configfs配置详解

tinypilot Use your Raspberry Pi as a browser-based KVM. 项目地址: https://gitcode.com/gh_mirrors/ti/tinypilot

引言：USB Gadget驱动的基本概念

在嵌入式系统和单板计算机领域，USB Gadget驱动是一个非常重要的功能模块。它允许设备作为USB从设备（如键盘、鼠标或存储设备）连接到主机。TinyPilot项目正是利用这一特性，将树莓派等设备实现为HID（人机接口设备）来实现远程控制功能。

configfs文件系统解析

configfs是Linux内核提供的一种虚拟文件系统，它为用户空间程序提供了一种直观的方式来配置内核对象。与传统的配置文件不同，configfs具有以下特点：

内存驻留：完全存在于内存中，不涉及磁盘持久化
即时生效：修改会立即作用于内核功能
结构化访问：必须遵循预定义的目录和文件结构

在TinyPilot中，configfs被挂载在/sys/kernel/config/目录下，主要用于配置USB Gadget功能。

USB Gadget配置结构详解

核心目录结构

/sys/kernel/config/usb_gadget/
└── g1/                      # 当前Gadget配置
    ├── UDC                  # USB设备控制器状态文件
    ├── functions/           # 功能接口配置
    │   ├── hid.mouse        # 鼠标功能
    │   ├── hid.keyboard     # 键盘功能
    │   └── mass_storage.0   # 存储设备功能
    └── configs/
        └── c.1/            # 主配置
            ├── strings/     # 设备描述信息
            └── [功能符号链接]  # 链接到functions/下的实际配置

关键组件说明

UDC文件：这是控制Gadget激活状态的核心文件
- 写入设备控制器名称激活Gadget
- 清空内容则停用Gadget
functions目录：包含各种USB功能的具体配置
- 创建子目录会自动生成完整的配置结构
- 支持的功能类型包括HID、Mass Storage等
configs目录：存放最终的配置组合
- 需要将functions中的配置通过符号链接关联到这里
- 可以维护多个配置方案（虽然TinyPilot目前只使用c.1）

实际操作指南与注意事项

基本操作示例

# 创建HID鼠标功能
mkdir -p /sys/kernel/config/usb_gadget/g1/functions/hid.mouse

# 配置Mass Storage为CD-ROM模式
echo 1 > /sys/kernel/config/usb_gadget/g1/functions/mass_storage.0/lun.0/cdrom

# 激活Gadget
echo "dwc2" > /sys/kernel/config/usb_gadget/g1/UDC