RP2040+TinyUSB开发数字小键盘：CDC RX回调未触发求助

以下是针对该问题的具体排查步骤：

• 检查USB描述符配置

  • 确认CDC接口的端点配置：RX对应设备接收主机数据，需配置为OUT方向的批量/中断端点，核对bEndpointAddress的bit7为0（表示OUT）
  • 验证CDC ACM功能描述符的bNumEndpoints是否包含RX端点，同时检查配置描述符的总长度计算是否正确，避免因描述符解析错误导致主机无法识别端点
  • 确保HID与CDC的接口、端点编号不冲突，避免USB设备枚举异常

• 验证TinyUSB运行状态

  • 确认主循环中持续调用tud_task()，该函数负责处理USB事件队列，缺失会导致所有USB回调无法触发
  • 用tud_cdc_connected()检查CDC端口是否处于连接状态，主机端需正确打开对应串口设备（未打开则主机不会发送数据）
  • 主机端串口工具的参数（波特率、奇偶校验、停止位）需与设备端保持一致，部分工具会因参数不匹配抑制数据发送

• 回调函数与接收逻辑检查

  • 确认tud_cdc_rx_cb的函数签名完全正确：void tud_cdc_rx_cb(uint8_t itf)，函数名拼写、大小写无错误，参数itf为CDC接口索引（通常为0）
  • 避免在回调外部提前调用tud_cdc_read()，若主机发送的数据被提前读取，回调将不会被触发；应仅在回调触发后执行数据读取操作
  • 检查CFG_TUD_CDC_RX_BUFSIZE配置的接收缓冲区大小，若主机发送的数据超过缓冲区容量，可能导致数据丢失或回调不触发

• 硬件与底层时钟检查

  • 确认RP2040的USB引脚（GPIO24为D-，GPIO25为D+）连接无误，无虚焊、短路，使用支持数据传输的USB线缆（排除仅充电线）
  • 验证RP2040的USB外设时钟为准确的48MHz，时钟偏差过大可能导致USB通信链路不稳定，无法触发接收回调

内容的提问来源于stack exchange，提问作者jay k