Merge branch 'feature/usb_host_hid_example' into 'master'

USB Host: Add HID example

Closes IDF-2213 and IDFGH-7795

Closes #9330

See merge request espressif/esp-idf!20902

examples/peripherals/usb/host/hid/CMakeLists.txt

@@ -0,0 +1,8 @@
+# The following lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+get_filename_component(ProjectId ${CMAKE_CURRENT_LIST_DIR} NAME)
+string(REPLACE " " "_" ProjectId ${ProjectId})
+project(${ProjectId})

examples/peripherals/usb/host/hid/README.md

@@ -0,0 +1,70 @@
+| Supported Targets | ESP32-S2 | ESP32-S3 |
+| ----------------- | -------- | -------- |
+
+# USB HID Class example
+This example implements a basic USB Host HID Class Driver, and demonstrates how to use the driver to communicate with USB HID devices (such as Keyboard and Mouse or both) on the ESP32-S2/S3. Currently, the example only supports the HID boot protocol which should be present on most USB Mouse and Keyboards. The example will continuously scan for the connection of any HID Mouse or Keyboard, and attempt to fetch HID reports from those devices once connected. To quit the example (and shut down the HID driver), users can GPIO0 to low (i.e., pressing the "Boot" button on most ESP dev kits).
+
+
+### Hardware Required
+* Development board with USB capable ESP SoC (ESP32-S2/ESP32-S3)
+* A USB cable for Power supply and programming
+* USB OTG Cable
+
+### Common Pin Assignments
+
+If your board doesn't have a USB A connector connected to the dedicated GPIOs, 
+you may have to DIY a cable and connect **D+** and **D-** to the pins listed below.
+
+```
+ESP BOARD    USB CONNECTOR (type A)
+                   --
+                  | || VCC
+[GPIO19]  ------> | || D-
+[GPIO20]  ------> | || D+
+                  | || GND
+                   --
+```
+
+### Build and Flash
+
+Build the project and flash it to the board, then run monitor tool to view serial output:
+
+```
+idf.py -p PORT flash monitor
+```
+
+The example serial output will be the following:
+
+```
+I (195) example: HID HOST example
+I (35955) example: Interface number 0, protocol Mouse
+I (35955) example: Interface number 1, protocol Keyboard
+X: 000016       Y: -00083       | |o|
+|Q|T| | | | |
+X: 000016       Y: -00083       |o| |
+| |1|3|5| | |
+```
+
+Where every keyboard key printed as char symbol if it is possible and a Hex value for any other key. 
+
+#### Keyboard report description
+```
+|Q|T| | | | |
+ | | | | | |
+ | | | | | +----------------- Key 5 Char symbol
+ | | | | +------------------- Key 4 Char symbol 
+ | | | +--------------------- Key 3 Char symbol
+ | | +----------------------- Key 2 Char symbol
+ | +------------------------- Key 1 Char symbol
+ +--------------------------- Key 0 Char symbol
+```
+
+#### Mouse report description
+```
+X: -00343   Y: 000183   | |o|
+     |            |      | |
+     |            |      | +- Right mouse button pressed status ("o" - pressed, " " - not pressed)
+     |            |      +--- Left mouse button pressed status ("o" - pressed, " " - not pressed)
+     |            +---------- Y relative coordinate of the cursor 
+     +----------------------- X relative coordinate of the cursor 
+```

examples/peripherals/usb/host/hid/components/hid/CMakeLists.txt

@@ -0,0 +1,3 @@
+idf_component_register(SRCS "hid_host.c"
+                       PRIV_REQUIRES usb
+                       INCLUDE_DIRS "include")