在 FPGA 实现的机械键盘设计中，动态 USB 端点重配置是一种关键技术，它允许设备在运行时切换 USB 接口角色，从而支持多种协议如 HID（人机交互设备）和 CDC（通信设备类），这对于集成实时通信功能尤为重要。与静态配置不同，这种动态机制能根据需求调整端点分配，避免资源浪费并提升设备兼容性。
Clavier 项目作为一个开源 FPGA 键盘示例，展示了这种技术的实际应用。该项目使用 VHDL 语言纯硬件实现 USB 设备栈，包括一个集成 2 端口 USB 2.0 hub，支持全尺寸 105 键 ISO 布局和 N 键无冲 1000Hz 轮询率。“Clavier 是一个 FPGA-based 机械键盘，集成了 USB hub 和多种通信接口。” 通过 FPGA 的灵活性，它实现了端点重配置的核心逻辑：在枚举过程中或运行时，根据主机请求动态加载不同的 USB 描述符，实现从纯 HID 键盘到 HID+CDC 复合设备的切换。这不仅支持键盘输入，还允许通过 UART 等接口进行实时数据传输，如调试或自定义协议通信。
实现动态 USB 端点重配置的核心在于 USB 设备控制器的 FPGA 模块设计。首先，需要一个可重配置的 USB PHY 接口，通常基于开源的 USB 2.0 全速设备核心，仅需少量 IO 引脚连接。端点管理器模块负责端点 0（控制端点）的标准请求处理，如 SET_CONFIGURATION 和 SET_INTERFACE。当主机发送配置请求时，FPGA 逻辑解析描述符，动态分配端点地址：例如，端点 1 用于 HID 中断输入（键盘报告），端点 2 用于 CDC 批量传输（串口数据）。重配置过程涉及暂停当前传输、更新端点状态机，并重新协商链路，通常在 50-100ms 内完成，以最小化用户感知中断。
证据显示，这种方法在 Clavier 中有效避免了静态设计的局限性。传统键盘 FPGA 项目往往固定为 HID 模式，导致无法扩展通信功能，而动态重配置允许端点从 HID 切换到 CDC，支持实时 comms 集成。例如，在开发环境中，键盘可作为调试工具，通过 CDC 端点传输 FPGA 内部状态，而不中断键盘功能。这依赖于 USB 规范的复合设备支持，FPGA 需维护多个配置描述符集，并在运行时选择激活。
为落地实施，提供以下可操作参数和清单：
-
端点配置参数：
- HID 端点：地址 0x81（输入），最大包大小 64 字节，轮询间隔 1ms（1000Hz）。
- CDC 端点：地址 0x02（输出）和 0x82（输入），批量传输，最大包大小 64 字节。
- 重配置超时阈值：200ms，若超过则回滚到默认 HID 配置，避免挂起。
-
描述符管理：
- 准备两个配置描述符：Config1（仅 HID，长度约 34 字节），Config2（HID+CDC，长度约 55 字节）。
- 使用 FPGA 状态寄存器存储当前模式，主机 GET_DESCRIPTOR 请求时返回相应描述符。
- 缓冲区大小：端点缓冲至少 128 字节，支持双缓冲以防数据丢失。
-
实时通信集成：
- UART 桥接：FPGA 内部将 USB CDC 数据映射到 UART TX/RX，波特率 115200bps。
- 同步机制：使用 USB 帧号与 FPGA 时钟同步，确保实时性，延迟 < 5ms。
- 多接口支持：端点切换时，通知上层应用（如键盘扫描模块）暂停 / 恢复输入报告。
监控要点包括：
- 链路状态监控：FPGA 逻辑持续检查 USB 重置和挂起事件，若检测到异常，重置端点状态机。
- 错误处理：实现 NAK/stall 响应，日志记录重配置失败率，若 > 5% 则触发固件回滚。
- 性能指标：测量端点切换延迟，使用 ILA（集成逻辑分析仪）捕获时序波形，确保 < 100ms。
- 资源利用：在 Lattice ECP5 等 FPGA 上，USB 核心占用约 2000 LUT，动态逻辑额外 500 LUT。
潜在风险包括重配置期间的短暂断连，可能导致主机重新枚举，影响用户体验。为缓解，使用平滑过渡：预加载新描述符，并在 SET_CONFIGURATION 前缓冲未发数据。限制造成：FPGA 时钟需稳定在 48MHz，避免抖动影响 USB 时序；电源噪声可能干扰 BGA 封装 FPGA 的 USB PHY，建议添加滤波电容。
回滚策略：默认 fallback 到 HID-only 模式，确保键盘基本功能可用。测试清单：
- 枚举测试：验证主机识别复合设备。
- 切换测试：模拟主机请求，检查端点激活。
- 压力测试：连续重配置 100 次，监控稳定性。
- 兼容性：测试 Windows/Linux 主机驱动。
通过这些参数和策略，开发者可在 Clavier 基础上扩展，实现高效的 FPGA USB 键盘，支持动态多接口应用。这种方法不仅提升了设备的多功能性，还为嵌入式系统提供了可重用模块，推动开源硬件创新。
（字数约 1050）