Choose which USB and USB HID devices to include at compile-time (superseded by #2116)

[dhalbert]

Make it easy to enable and disable which USB and USB HID devices to include at build time, using two makefile variables. Defaults are:

USB_DEVICES = "CDC,MSC,AUDIO,HID"
USB_HID_DEVICES = "KEYBOARD,MOUSE,CONSUMER,GAMEPAD"

For instance, in mpconfigboard.mk, you can define those variables:

USB_DEVICES = "CDC, MSC"    # Omit MIDI and HID
USB_HID_DEVICES="KEYBOARD"    # Use only keyboard

A couple of new HID devices have been added, but are not in the default set. The entire set is KEYBOARD,MOUSE,CONSUMER,SYS_CONTROL,GAMEPAD,DIGITIZER,XAC_COMPATIBLE_GAMEPAD,RAW

If only one HID device is chosen, then it will not have a report ID in the generated HID descriptor.

XAC_COMPATIBLE_GAMEPAD is an alternate gamepad that is compatible with the Microsoft XAC controller. RAW is a 64-bit raw HID device, usage page 0xFFAF, usage 0xAF (AF is "AdaFruit"). RAW cannot be used with other HID devices, because it cannot have a report id.

The mechanism for generating the table of usb_hid.Device entries has also been simplified. More code is generated and less is done by tricky Makefile variables.

This partially addresses some needs state in #1015 but does not allow generation of USB or USB HID descriptors at run-time, in boot.py.

Tagging @ATMakersBill and @hierophect for interest.

[dhalbert]

GitHub Actions is not initiating a check run on this.