5V -> SY8089降压3.3V -> ESP32
D+ -> ESP32-S2 GPIO19
D- -> ESP32-S2 GPIO20

为节省布线成本使用了ESP32-S2FN4R2，自带4MB的SPI Flash和2MB的PSRAM，不需要外挂。
天线因为没有需求所以没有拉出。
测试板使用了四种不同的触发电路用于点亮LED，用于验证不同条件下的GPIO-硬件控制电路。

#define REPORT_SIZE 64

const uint8_t hid_report_descriptor[] = {
    TUD_HID_REPORT_DESC_GENERIC_INOUT(REPORT_SIZE)
};

TUD_HID_DESCRIPTOR(0, 0, false, sizeof(hid_report_descriptor), 0x81, REPORT_SIZE, 10),

void tud_hid_set_report_cb(uint8_t instance,
	uint8_t report_id,
	hid_report_type_t report_type,
	uint8_t const *buffer,
	uint16_t bufsize) {
  	// 此处为示例代码
	}

#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "driver/gpio.h"
#include "tinyusb.h"
#include "class/hid/hid_device.h"

static const char *TAG = "Controller";
#define REPORT_SIZE 64
#define LED_GPIO_MASK ((1ULL << GPIO_NUM_1) | (1ULL << GPIO_NUM_2) | (1ULL << GPIO_NUM_3) | (1ULL << GPIO_NUM_4))



// HID 报告描述符
const uint8_t hid_report_descriptor[] = {
    TUD_HID_REPORT_DESC_GENERIC_INOUT(REPORT_SIZE)
};

// 配置描述符
#define TUSB_DESC_TOTAL_LEN (TUD_CONFIG_DESC_LEN + TUD_HID_DESC_LEN)
static const uint8_t hid_configuration_descriptor[] = {
    TUD_CONFIG_DESCRIPTOR(1, 1, 0, TUSB_DESC_TOTAL_LEN, 0x00, 100),
    TUD_HID_DESCRIPTOR(0, 0, false, sizeof(hid_report_descriptor), 0x81, REPORT_SIZE, 10),
};

// HID 描述符回调
uint8_t const *tud_hid_descriptor_report_cb(uint8_t instance) {
    return hid_report_descriptor;
}

// 主机读取 HID 报告
uint16_t tud_hid_get_report_cb(uint8_t instance,
                                uint8_t report_id,
                                hid_report_type_t report_type,
                                uint8_t *buffer,

                                uint16_t reqlen) {
    return 0;
}

void tud_hid_set_report_cb(uint8_t instance,
                           uint8_t report_id,
                           hid_report_type_t report_type,
                           uint8_t const *buffer,
                           uint16_t bufsize) {
    ESP_LOGI(TAG, "Received from host: %d bytes", bufsize);
    if (bufsize > 0) {
        switch (buffer[0])
        {
        case 0x01: // LED ON
            gpio_set_level(GPIO_NUM_1, 1);
            save_gpio_state(GPIO_NUM_1, 1);
            ESP_LOGI(TAG, "LED1 ON");
            break;
        case 0x02:
            gpio_set_level(GPIO_NUM_2, 1);
            save_gpio_state(GPIO_NUM_2, 1);
            ESP_LOGI(TAG, "LED2 ON");
            break;
        case 0x03:
            gpio_set_level(GPIO_NUM_3, 1);
            save_gpio_state(GPIO_NUM_3, 1);
            ESP_LOGI(TAG, "LED3 ON");
            break;
        case 0x04:
            gpio_set_level(GPIO_NUM_4, 1);
            save_gpio_state(GPIO_NUM_4, 1);
            ESP_LOGI(TAG, "LED4 ON");
            break;
        default:
            gpio_set_level(GPIO_NUM_1, 0);
            gpio_set_level(GPIO_NUM_2, 0);
            gpio_set_level(GPIO_NUM_3, 0);
            gpio_set_level(GPIO_NUM_4, 0);
            save_gpio_state(GPIO_NUM_1, 0);
            save_gpio_state(GPIO_NUM_2, 0);
            save_gpio_state(GPIO_NUM_3, 0);
            save_gpio_state(GPIO_NUM_4, 0);
            ESP_LOGI(TAG, "LEDs OFF");
            break;
        }
    }

    if (tud_hid_ready()) {
        tud_hid_report(0, buffer, bufsize);
    }

}

void app_main(void) {
    ESP_LOGI(TAG, "Controller Start");

    init_nvs();

    gpio_config_t io_conf = {
        .pin_bit_mask = LED_GPIO_MASK,
        .mode = GPIO_MODE_OUTPUT,
        .pull_up_en = GPIO_PULLUP_DISABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE,
    };
    gpio_config(&io_conf);
    // clear_nvs_all();

    const tinyusb_config_t tusb_cfg = {
        .device_descriptor = NULL,
        .configuration_descriptor = hid_configuration_descriptor,
        .string_descriptor = NULL,
        .external_phy = false,
    };
    ESP_ERROR_CHECK(tinyusb_driver_install(&tusb_cfg));
    ESP_LOGI(TAG, "Controller initialized");

    while (1) {
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

import hid # 此处使用的是hidapi库，使用pip install hidapi安装

VID = 0x303A
PID = 0x4002
# VID/PID可自行修改

def send_command(cmd_byte, status_byte):
    try:
        dev = hid.device()
        dev.open(VID, PID)
        dev.set_nonblocking(1)
        report = bytes([0x00, cmd_byte, status_byte] + [0x00] * 61)
        dev.write(report)

        resp = dev.read(64, timeout_ms=500)
        if resp:
            print(f"Echo: {resp}")

        dev.close()
    except Exception as e:
        print(f"Error: {e}")

if __name__ == "__main__":
    while True:
        val = input("输入1点亮LED，输入0熄灭LED，输入q退出：").strip()
        # if val == '1':
        #     send_command(0x01)
        # elif val == '0':
        #     send_command(0x00)
        # elif val.lower() == 'q':
        #     break
        # else:
        #     print("无效输入")
        match val:
            case '2':
                send_command(0x02, 0x02)
            case '3':
                send_command(0x03, 0x03)
            case '4':
                send_command(0x04, 0x04)
            case '1':
                send_command(0x01, 0x01)
            case '0':
                send_command(0x00, 0x00)
            case 'q' | 'Q':
                break
            case _:
                print("无效输入")