使用 STM32CubeMX 配置 USB HID 键盘的步骤如下：

1. 硬件准备

• 选择支持 USB 的 STM32 型号（如 STM32F103C8T6、STM32F407VG 等）。
• 确保硬件 USB 接口（如 USB DM/DP）正确连接。

2. STM32CubeMX 配置

1. 创建工程

   • 打开 STM32CubeMX，选择对应型号的芯片。

2. 配置时钟

   • 在 Clock Configuration 中启用外部晶振（HSE），并确保 USB 时钟为 48MHz（USB 必须精确的时钟）。

3. 启用 USB

   • 在 Connectivity 选项卡中启用 USB，选择 Device (FS) 模式。
   • 在 Middleware 中选择 USB_DEVICE，类为 Human Interface Device (HID)。

4. 配置 HID 描述符

   • 在 Project Manager > Code Generator 中勾选生成 .c/.h 文件。
   • 在 USB_DEVICE > Class For IP > HID 中，确保报告描述符正确（参考默认键盘描述符）。

3. 生成代码

点击 Generate Code，生成 Keil/IAR/STM32IDE 工程。

4. 添加键盘逻辑

在生成的代码中修改以下部分：

(1) 定义 HID 报告结构体

在 usbd_hid.h 中添加键盘报告描述符：

typedef struct {
  uint8_t modifiers;  // 例如 Ctrl/Shift
  uint8_t reserved;
  uint8_t keycode[6]; // 最多支持6个按键
} HID_KeyboardReport_TypeDef;

(2) 发送按键事件

在 main.c 中添加发送按键的函数：

void Send_Key(uint8_t key) {
  HID_KeyboardReport_TypeDef report;
  report.modifiers = 0;      // 无修饰键
  report.reserved = 0;
  report.keycode[0] = key;  // 按下指定键
  for (int i=1; i<6; i++) report.keycode[i] = 0; // 其他键置零

  USBD_HID_SendReport(&hUsbDeviceFS, (uint8_t*)&report, sizeof(report));
  HAL_Delay(20);  // 短暂延时确保发送完成
  report.keycode[0] = 0;  // 松开按键
  USBD_HID_SendReport(&hUsbDeviceFS, (uint8_t*)&report, sizeof(report));
}

(3) 触发按键事件

在 main 函数的主循环中调用：

while (1) {
  if (按键触发条件) {  // 例如 GPIO 输入检测
    Send_Key(HID_KEY_A);  // 发送字母 'A' 的键码
    HAL_Delay(100);
  }
}

5. HID 键码参考

常用键码定义（参考 usbd_hid.h）：

#define HID_KEY_A        0x04
#define HID_KEY_B        0x05
#define HID_KEY_ENTER    0x28
#define HID_KEY_SPACE    0x2C
#define HID_KEY_CTRL_LEFT 0xE0

6. 注意事项

• USB 枚举：首次连接可能需要几秒枚举设备，电脑会识别为 HID 键盘。
• 按键释放：必须发送全零报告，否则按键会持续按下。
• 报告描述符：确保描述符与键盘标准匹配（可参考 USB HID 官方文档）。

示例工程

可在 GitHub 搜索 STM32 USB HID Keyboard 参考开源项目，或参考 STM32CubeMX 自带的 HID_Standalone 示例。