USB descriptors are used by a USB device to describe its properties such as id, name, manufacturer, serial number and functionality. In CircuitPython, we used to rely on a bunch of C macros from the Advanced Software Framework from MicroChip to generate a descriptor for each board at compile time. C macros, however, aren’t a great tool for generating this because some descriptors reference others. (Specifically name, manufacturer and serial number are stored as indexes with matching string descriptors.) This makes maintaining descriptors a bit of a challenge. So, instead of continuing to use these C macros, we’ve switched to a small Python library we’ve created to generate the descriptor byte array instead.
With this new USB descriptor library for Python, one can use all of Python’s goodness to set up the descriptors as desired and then convert them to bytes. Once the descriptors are converted to bytes, normal Python file writing can be used to generate a file to hold them. Currently, we have a script that generates a C file.
Lastly, since the new library is Python and only uses the struct module, we hope to run the library on CircuitPython itself! That way we can change the descriptor dynamically on boot! We’ll be able to choose between HID, MIDI and other things dynamically.
Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on code.org, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.