Implement USB HID Device Support for ESP32-S2 (#5538)

* Add support and example for USB HID Devices
* Add support and example for USB Vendor

libraries/USB/src/USBHIDVendor.h

@@ -0,0 +1,67 @@
+// Copyright 2015-2020 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+#include "Stream.h"
+#include "USBHID.h"
+#if CONFIG_TINYUSB_HID_ENABLED
+
+ESP_EVENT_DECLARE_BASE(ARDUINO_USB_HID_VENDOR_EVENTS);
+
+typedef enum {
+    ARDUINO_USB_HID_VENDOR_ANY_EVENT = ESP_EVENT_ANY_ID,
+    ARDUINO_USB_HID_VENDOR_SET_FEATURE_EVENT = 0,
+    ARDUINO_USB_HID_VENDOR_GET_FEATURE_EVENT,
+    ARDUINO_USB_HID_VENDOR_OUTPUT_EVENT,
+    ARDUINO_USB_HID_VENDOR_MAX_EVENT,
+} arduino_usb_hid_vendor_event_t;
+
+typedef struct {
+    const uint8_t* buffer;
+    uint16_t len;
+} arduino_usb_hid_vendor_event_data_t;
+
+class USBHIDVendor: public USBHIDDevice, public Stream {
+private:
+    USBHID hid;
+public:
+    // Max report size is 64, but we need one byte for report ID, so in reality max is 63.
+    // Because input packets are always with length equal to the report size
+    // it will not be known how many bytes actually matter. Setting 'prepend_size' to 'true' will
+    // make the first byte of each packet to be the length of data in that packet.
+    // This comes with penalty of one byte, but is very useful when using Vendor for streaming
+    USBHIDVendor(uint8_t report_size=63, bool prepend_size=false);
+    void begin(void);
+    void end(void);
+    void prependInputPacketsWithSize(bool enable);
+    size_t setRxBufferSize(size_t);
+    size_t write(const uint8_t* buffer, size_t len);
+    size_t write(uint8_t);
+    int available(void);
+    int peek(void);
+    int read(void);
+    size_t read(uint8_t *buffer, size_t size);
+    void flush(void);
+    
+    void onEvent(esp_event_handler_t callback);
+    void onEvent(arduino_usb_hid_vendor_event_t event, esp_event_handler_t callback);
+
+    // internal use
+    uint16_t _onGetDescriptor(uint8_t* buffer);
+    uint16_t _onGetFeature(uint8_t report_id, uint8_t* buffer, uint16_t len);
+    void _onSetFeature(uint8_t report_id, const uint8_t* buffer, uint16_t len);
+    void _onOutput(uint8_t report_id, const uint8_t* buffer, uint16_t len);
+};
+
+#endif