沁恒CH58x自定义USB HID项目使用手册

1. 目录结构及介绍

该项目位于GitHub上，仓库地址为：https://github.com/iot-lorawan/ch58x_usbhid_custom。其目录结构和关键文件大致如下：

ch58x_usbhid_custom/
├── CH58x_common.h           # 核心通用头文件，包含了必要的宏定义和函数声明。
├── LICENSE                  # MIT许可证文件，说明了项目使用的开源许可条款。
├── README.md                # 项目简介文档，快速了解项目目的和如何开始。
├── main.c                   # 主程序文件，实现了USB HID的主要逻辑。
├── MyDevDescr[]              # 设备描述符数组，定义了USB设备的基本属性。
└── ...                      # 可能包含其他源代码文件、配置文件和辅助工具等。

项目的核心在于main.c，它通常包含了初始化USB设备、处理USB事件和用户数据传输的逻辑。CH58x_common.h提供了对CH58x系列芯片操作的基础支持。

2. 项目启动文件介绍

main.c

启动文件主要指main.c，它是项目的入口点。在main.c中，开发者初始化芯片的USB功能，设置USB HID的相关参数，包括但不限于报告描述符、端点大小等，并且实现USB通信的接收与发送逻辑。此外，通常还会包含设备进入正常工作模式后的循环处理，以应对USB请求和事件处理。

#include "CH58x_common.h"
// 初始化函数，设备枚举等
void USB_Init(void);
int main(void) {
    USB_Init();
    while(1) {
        // 循环处理USB事件和数据传输
        // ...
    }
}

3. 项目的配置文件介绍

在本项目中，虽然没有明确标记为“配置文件”的单独文件，但配置信息主要分布在几个关键部分：

• 设备描述符 (MyDevDescr[])：这部分代码定义在C文件中，实际上是作为一个配置块存在的。它告诉操作系统这是一个何种类型的USB设备，如设备类、子类、版本号以及端点大小等。

• 宏定义 （例如 #define RepDataLoadLen 64 和 #define DevEP0SIZE 0x40）：这些在CH58x_common.h或其他源文件中的宏定义控制着USB通信的关键参数，如报告数据长度和默认端点大小，是重要的配置要素。

• 特定配置代码片段：项目可能含有条件编译或函数调用来适应不同的配置需求。例如，通过修改事件处理函数(DevEP1_IN_Deal())的行为，可以调整USB HID的具体行为。

总之，尽管这个项目可能不像一些框架那样有明显的配置文件，但其核心配置通过代码中的常量定义和初始化过程实现。开发人员需要仔细阅读并理解这些部分，以按需定制USB HID行为。