ESP32-S3 原生 USB HID 按钮：实体使能、单键按下与释放

idf.py --version
python --version
idf.py -B build -D SDKCONFIG=sdkconfig.local build
# 核实际 sdkconfig.local 中两个 CALLBACK=y，再从桥口上传
idf.py -B build -D SDKCONFIG=sdkconfig.local -p /dev/cu.YOUR_BRIDGE_PORT flash monitor

/* SPDX-License-Identifier: MIT */
#include <string.h>
#include "esp_log.h"
#include "esp_timer.h"
#include "driver/gpio.h"
#include "tinyusb.h"
#include "tinyusb_default_config.h"
#include "class/hid/hid_device.h"
#include "hid_model.h"
static const char *TAG="W07";
/* After initialization, this state is owned only by the TinyUSB task. */
static w07_state_t state;static bool current_report_pressed;static uint64_t last_poll_ms;static bool polled;
_Static_assert(HID_KEY_F13==0x68,"Locked HID F13 usage must match production model");
const uint8_t w07_report_descriptor[]={TUD_HID_REPORT_DESC_KEYBOARD()};
#define CONFIG_DESC_LEN (TUD_CONFIG_DESC_LEN+TUD_HID_DESC_LEN)
const uint8_t w07_configuration_descriptor[]={
 TUD_CONFIG_DESCRIPTOR(1,1,0,CONFIG_DESC_LEN,0,100),
 TUD_HID_DESCRIPTOR(0,4,HID_ITF_PROTOCOL_KEYBOARD,sizeof(w07_report_descriptor),0x81,8,10)
};
static const char *strings[]={(const char[]){0x09,0x04},"Hixinwu Lab","W07 F13 Button (ARM required)","W07-LAB-PROTOTYPE","Single keyboard interface"};
uint8_t const *tud_hid_descriptor_report_cb(uint8_t instance){(void)instance;return w07_report_descriptor;}
uint16_t tud_hid_get_report_cb(uint8_t instance,uint8_t report_id,hid_report_type_t type,uint8_t *buffer,uint16_t requested){
 (void)instance;if(report_id!=0||type!=HID_REPORT_TYPE_INPUT)return 0;
 uint8_t bytes[8];w07_report_bytes(current_report_pressed,bytes);uint16_t n=requested<sizeof(bytes)?requested:sizeof(bytes);memcpy(buffer,bytes,n);return n;
}
void tud_hid_set_report_cb(uint8_t instance,uint8_t report_id,hid_report_type_t type,uint8_t const *buffer,uint16_t size){(void)instance;(void)report_id;(void)type;(void)buffer;(void)size; /* Host keyboard LED output does not arm this device. */}
static void device_event(tinyusb_event_t *event,void *arg){
 (void)arg;w07_reset_link(&state);current_report_pressed=false;gpio_set_level(GPIO_NUM_4,0);
 /* bus_reset clears TinyUSB's sof_consumer; enable only after configuration. */
 if(event->id==TINYUSB_EVENT_ATTACHED)tud_sof_cb_enable(true);
 ESP_LOGI(TAG,"USB event=%d; require zero report and fresh physical ARM cycle; submitted transfers cannot be recalled",event->id);
}
/* TinyUSB dispatches SOF and device_event in the same task, not in the ISR.
 * No task can process a device_event between model decision and report enqueue.
 * Physical/queued events not yet dispatched, and already queued USB transfers,
 * are outside that guarantee; a disconnected host cannot be sent a release.
 */
void tud_sof_cb(uint32_t frame_count){
 (void)frame_count;const uint64_t now=(uint64_t)esp_timer_get_time()/1000ULL;
 if(polled&&now>=last_poll_ms&&now-last_poll_ms<10)return;
 polled=true;last_poll_ms=now;
 const bool usb=tud_mounted()&&!tud_suspended();const bool ready=tud_hid_ready();
 w07_command_t command=w07_tick(&state,now,usb,ready,gpio_get_level(GPIO_NUM_5)==0,gpio_get_level(GPIO_NUM_6)==0);
 if(command!=W07_NONE){uint8_t report[8];const bool press=command==W07_PRESS;w07_report_bytes(press,report);bool accepted=tud_hid_report(0,report,sizeof(report));
  if(accepted){w07_queued(&state,command,now);current_report_pressed=press;}else{w07_failed(&state);current_report_pressed=false;}
  ESP_LOGI(TAG,"REPORT %s queued=%u; USB queue acceptance is not application effect",press?"F13_PRESS":"ALL_RELEASED",accepted);
 }
 gpio_set_level(GPIO_NUM_4,state.armed);
}
void app_main(void){
 gpio_config_t inputs={.pin_bit_mask=(1ULL<<5)|(1ULL<<6),.mode=GPIO_MODE_INPUT};ESP_ERROR_CHECK(gpio_config(&inputs));
 gpio_config_t led={.pin_bit_mask=1ULL<<4,.mode=GPIO_MODE_OUTPUT};ESP_ERROR_CHECK(gpio_config(&led));gpio_set_level(GPIO_NUM_4,0);
 w07_reset_link(&state); /* Complete before driver creates the USB task. */
 tinyusb_config_t cfg=TINYUSB_DEFAULT_CONFIG(device_event);cfg.descriptor.string=strings;cfg.descriptor.string_count=sizeof(strings)/sizeof(strings[0]);cfg.descriptor.full_speed_config=w07_configuration_descriptor;
 esp_err_t e=tinyusb_driver_install(&cfg);if(e!=ESP_OK){ESP_LOGE(TAG,"TinyUSB install=%s; no key reports",esp_err_to_name(e));return;}
 ESP_LOGI(TAG,"ARM GPIO5 and BUTTON GPIO6 activeLOW external10k; nativeUSB19/20, UART0 bridge; USB task owns polling/reports; no automatic key at boot");
}