Generate USB descriptors with Python!

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.

To find out more about the Python USB Descriptor library check it out on GitHub and visit our Discord channel.

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, or even use Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for MakeCode, CircuitPython, 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.

Join 10,000+ makers on Adafruit’s Discord channels and be part of the community! http://adafru.it/discord

What do you want from CircuitPython in 2019?

Have an amazing project to share? Join the SHOW-AND-TELL every Wednesday night at 7:30pm ET on Google+ Hangouts.

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Follow Adafruit on Instagram for top secret new products, behinds the scenes and more https://www.instagram.com/adafruit/

Maker Business — Designing hardware is hard. Designing a test jig can be harder.

Wearables — 5 meter fun

Electronics — Solder isn’t everything.

Biohacking — Beyond CBD and THC

Python for Microcontrollers — Python snakes its way to Makerdiary nRF52840, it’s full of stars, LumiDrive, and more…! #Python #Adafruit #CircuitPython @circuitpython @micropython @ThePSF @Adafruit

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at AdafruitDaily.com !

No Comments

No comments yet.

Sorry, the comment form is closed at this time.