ZHCACO6A january   2011  – may 2023

 

  1.   1
  2. 1MSP430™ USB HID Windows API 编程人员指南
  3. 2引言
  4. 3实现
    1. 3.1 概述
    2. 3.2 文件组织
    3. 3.3 系统要求
    4. 3.4 MSP430 USB API 堆栈
    5. 3.5 Windows 如何将物理 USB HID 器件映射到主机应用程序
    6. 3.6 在系统上查找特定 HID 器件/接口并将其打开
    7. 3.7 发送/接收数据
    8. 3.8 检测 HID 器件的动态连接/断开
  5. 4函数调用参考
    1. 4.1 器件连接管理和初始化调用
      1. 4.1.1 VOID HID_Init(struct strHidDevice* pstrHidDevice)
      2. 4.1.2 DWORD HID_GetSerNums(WORD vid, WORD pid, struct strTrackSerialNumbers *serialNumList)
      3. 4.1.3 DWORD HID_GetNumOfInterfaces(WORD vid, WORD pid, DWORD numSerNums)
      4. 4.1.4 BYTE HID_Open(struct strHidDevice* pstrHidDevice, WORD vid, WORD pid, DWORD deviceIndex, char serialNumber[SERNUM_LEN], DWORD totalDevNum, DWORD totalSerNum)
      5. 4.1.5 BYTE HID_Close(struct strHidDevice* pstrHidDevice)
      6. 4.1.6 BYTE HID_GetVersionNumber(struct strHidDevice* pstrHidDevice, USHORT * VersionNumber)
    2. 4.2 发送/接收数据
      1. 4.2.1 BYTE HID_WriteFile(struct strHidDevice* pstrHidDevice, BYTE* buffer, DWORD bufferSize, DWORD* bytesSent)
      2. 4.2.2 BYTE HID_ReadFile(struct strHidDevice* pStrHidDevice, BYTE* buffer, DWORD bufferSize, DWORD* bytesReturned)
    3. 4.3 即插即用管理
      1. 4.3.1 BYTE HID_RegisterForDeviceNotification(HWND hWnd, HDEVNOTIFY* diNotifyHandle)
      2. 4.3.2 BYTE HID_UnregisterForDeviceNotification(HDEVNOTIFY* diNotifyHandle)
      3. 4.3.3 BOOL IsDeviceAffected(struct strHidDevice* pstrHidDevice)
  6. 5演示应用程序
  7. 6MSP430 USB 工具套件
  8.   HID 接口数据结构：strHidDevice
  9.   HID 数据管道器件上的报告格式
  10.   C 参考文献
  11.   C 修订历史记录

3.4 MSP430 USB API 堆栈

MSP430 USB API 旨在让开发者无需详细了解 USB，即可轻松创建 USB 器件。它随附了 MSP430 USB 描述符工具，后者能够自动完成以下操作：

  • 针对 USB 接口的任意组合（单个或复合）配置 API 堆栈
  • 创建首次就奏效的 USB 描述符

适用于 HID 的 API 支持两种 HID 实现。一种是针对传统 HID 器件，这需要详细了解 HID 报告。另一种是针对数据管道 HID 器件，这是 TI 的一种将 HID 用作简单数据载体的方法。这就让设计人员无需创建 HID 报告。

对于 MSP430 应用程序，HID 数据管道接口看起来和感觉都非常像 COM 端口：

  • 它相对未格式化，允许设计人员应用所选的格式。
  • 它可以处理任何大小的数据块（不受 USB 数据包大小的限制）。

实际上，适用于 HID 数据管道器件的 API 与适用于 CDC（用于在主机上生成虚拟 COM 端口）的 API 几乎完全相同。

有关 MSP430 USB API 堆栈的更多信息，请参阅 MSPUSBDEVPACK 文档，网址为 https://www.ti.com.cn/tool/cn/MSP430USBDEVPACK。