首页/资讯中心/详情

C#上位机与STM32F103 USB HID通信实战：从设备枚举到双向数据传输

C#上位机与STM32F103 USB HID通信实战：从设备枚举到双向数据传输
📅 发布时间：2026/7/16 8:05:41

1. 环境准备与设备枚举

在开始C#上位机与STM32F103的USB HID通信前，我们需要准备好开发环境。对于STM32F103端，建议使用Keil MDK或IAR EWARM作为开发工具，并安装STM32CubeMX来生成USB HID的初始化代码。上位机端则需要安装Visual Studio（推荐2017或更高版本）和.NET Framework。

设备枚举的关键步骤：

  1. VID/PID设置：在STM32端，通过修改usbd_desc.c中的设备描述符，确保为设备分配了唯一的VID（供应商ID）和PID（产品ID）。例如：

    #define USB_VID 0x0483 //ST官方测试VID #define USB_PID 0x5750 //自定义PID

  2. 报告描述符配置：在usbd_custom_hid_if.c中定义报告描述符，指定数据传输格式。一个典型的64字节双向传输描述符如下：

    __ALIGN_BEGIN static uint8_t CUSTOM_HID_ReportDesc_FS[30] __ALIGN_END = { 0x06, 0xFF, 0x00, // USAGE_PAGE (Vendor Defined) 0x09, 0x01, // USAGE_ID (Vendor Usage 1) 0xA1, 0x01, // COLLECTION (Application) 0x15, 0x00, // LOGICAL_MINIMUM (0) 0x26, 0xFF, 0x00, // LOGICAL_MAXIMUM (255) 0x75, 0x08, // REPORT_SIZE (8bit) 0x95, 0x40, // REPORT_COUNT (64字节) 0x09, 0x02, // USAGE_ID (Input Report) 0x81, 0x02, // INPUT (Data,Var,Abs) 0x09, 0x03, // USAGE_ID (Output Report) 0x91, 0x02, // OUTPUT (Data,Var,Abs) 0xC0 // END_COLLECTION };

  3. 端点配置：在usbd_conf.h中调整端点缓冲区大小，确保与报告描述符匹配：

    #define CUSTOM_HID_EPIN_SIZE 0x40 //IN端点64字节 #define CUSTOM_HID_EPOUT_SIZE 0x40 //OUT端点64字节

C#端枚举设备：
通过调用Windows API（SetupAPI和hid.dll）遍历已连接的HID设备，筛选目标VID/PID的设备路径。核心代码如下：

[DllImport("hid.dll")] static extern bool HidD_GetHidGuid(ref Guid hidGuid); public static List<string> FindHidDevices(ushort vid, ushort pid) { Guid hidGuid = Guid.Empty; HidD_GetHidGuid(ref hidGuid); IntPtr hDevInfo = SetupDiGetClassDevs(ref hidGuid, null, IntPtr.Zero, DIGCF_PRESENT | DIGCF_DEVICEINTERFACE); List<string> devicePaths = new List<string>(); SP_DEVICE_INTERFACE_DATA interfaceData = new SP_DEVICE_INTERFACE_DATA(); interfaceData.cbSize = Marshal.SizeOf(interfaceData); for (int i = 0; SetupDiEnumDeviceInterfaces(hDevInfo, IntPtr.Zero, ref hidGuid, (uint)i, ref interfaceData); i++) { uint requiredSize = 0; SetupDiGetDeviceInterfaceDetail(hDevInfo, ref interfaceData, IntPtr.Zero, 0, ref requiredSize, IntPtr.Zero); IntPtr detailPtr = Marshal.AllocHGlobal((int)requiredSize); Marshal.WriteInt32(detailPtr, Marshal.SizeOf(typeof(SP_DEVICE_INTERFACE_DETAIL_DATA))); SetupDiGetDeviceInterfaceDetail(hDevInfo, ref interfaceData, detailPtr, requiredSize, ref requiredSize, IntPtr.Zero); string devicePath = Marshal.PtrToStringAuto(new IntPtr(detailPtr.ToInt32() + 4)); if (devicePath.Contains($"vid_{vid:X4}&pid_{pid:X4}")) { devicePaths.Add(devicePath); } Marshal.FreeHGlobal(detailPtr); } return devicePaths; }

2. 建立稳定连接

成功枚举设备后，下一步是通过设备路径打开连接。这里需要注意异步操作和错误处理，避免因设备突然断开导致程序崩溃。

C#打开设备的完整流程：

  1. 创建文件句柄：使用CreateFileAPI以读写模式打开设备：

    IntPtr deviceHandle = CreateFile( devicePath, GENERIC_READ | GENERIC_WRITE, FILE_SHARE_READ | FILE_SHARE_WRITE, IntPtr.Zero, OPEN_EXISTING, FILE_FLAG_OVERLAPPED, IntPtr.Zero); if (deviceHandle == INVALID_HANDLE_VALUE) { throw new Exception("设备打开失败，错误码：" + Marshal.GetLastWin32Error()); }

  2. 获取设备能力信息：通过HidP_GetCaps读取输入/输出报告长度：

    HIDP_CAPS caps; IntPtr preparsedData; HidD_GetPreparsedData(deviceHandle, out preparsedData); HidP_GetCaps(preparsedData, out caps); int inputReportLength = caps.InputReportByteLength; //包含ReportID的完整长度 int outputReportLength = caps.OutputReportByteLength;

  3. 初始化异步通信：使用FileStream包装句柄，并启动异步读取：

    FileStream hidStream = new FileStream( new SafeFileHandle(deviceHandle, false), FileAccess.ReadWrite, inputReportLength, true); //启用异步IO byte[] inputBuffer = new byte[inputReportLength]; hidStream.BeginRead(inputBuffer, 0, inputBuffer.Length, ReadCompleted, inputBuffer);

常见问题排查：

  • 权限不足：以管理员身份运行程序，或为设备设置宽松的ACL规则。
  • 报告长度不匹配：检查STM32端的USBD_CUSTOMHID_OUTREPORT_BUF_SIZE是否与上位机读取的长度一致。
  • 端点未正确配置：使用Bus Hound工具验证设备是否正常响应主机请求。

3. 实现双向数据传输

3.1 数据发送机制

HID设备的输出报告需要严格遵循协议格式。首字节必须是ReportID，后续为实际数据。以下是发送64字节数据的示例：

public void SendData(byte[] data) { if (data.Length > outputReportLength - 1) { throw new ArgumentException($"数据过长，最大支持{outputReportLength - 1}字节"); } byte[] report = new byte[outputReportLength]; report[0] = 0; //ReportID，单报告设备通常为0 Array.Copy(data, 0, report, 1, data.Length); hidStream.Write(report, 0, report.Length); hidStream.Flush(); //立即发送缓冲区数据 }

关键细节：

  • Flush的必要性：如果不调用Flush()，数据可能滞留在缓冲区，导致下位机接收延迟。
  • 阻塞处理：同步写入可能阻塞UI线程，实际项目中建议使用BeginWrite异步方法。

3.2 异步接收处理

通过回调函数实现非阻塞数据接收，注意处理设备热插拔情况：

private void ReadCompleted(IAsyncResult result) { byte[] buffer = (byte[])result.AsyncState; try { int bytesRead = hidStream.EndRead(result); if (bytesRead > 0) { byte[] actualData = new byte[bytesRead - 1]; Array.Copy(buffer, 1, actualData, 0, bytesRead - 1); OnDataReceived?.Invoke(this, actualData); //触发事件通知UI } //重启异步读取 hidStream.BeginRead(buffer, 0, buffer.Length, ReadCompleted, buffer); } catch (IOException ex) { OnDeviceDisconnected?.Invoke(this, EventArgs.Empty); } }

优化传输性能：

  • 调整bInterval：在STM32的端点描述符中，bInterval字段决定主机轮询间隔（单位ms）。减小该值可提高实时性，但会增加总线负载：
    /* 在usbd_conf.h修改端点描述符 */ #define CUSTOM_HID_FS_BINTERVAL 0x05 //5ms间隔
  • 双缓冲机制：在下位机实现双缓冲，避免数据覆盖。

4. 调试与性能优化

4.1 使用Bus Hound分析数据

Bus Hound是USB协议分析的利器，可以捕获原始数据包。典型的使用场景包括：

  1. 验证枚举过程：检查设备描述符、配置描述符是否正确返回。
  2. 调试数据传输：对比上位机发送数据和实际总线数据，排查ReportID或长度错误。
  3. 测量时间间隔：监控连续数据包的间隔时间，确认bInterval是否生效。

4.2 常见问题解决方案

  • 设备无法识别：

    • 检查STM32的USB DP（PA12）引脚是否上拉1.5kΩ电阻。
    • 确认USBD_Init函数被正确调用，且中断优先级配置合理。

  • 数据包截断：

    • 确保报告描述符中的REPORT_SIZE和REPORT_COUNT与实际传输长度匹配。
    • 在上位机端验证HIDP_CAPS返回的InputReportByteLength。

  • 异步接收丢数据：

    • 增加接收缓冲区，或在STM32端实现流量控制机制。
    • 使用Thread.Sleep(1)短暂释放CPU，避免回调函数处理过载。

实战技巧：
在STM32端添加调试输出，通过串口打印USB事件状态（如HAL_PCD_ConnectCallback），可快速定位硬件连接问题。