Once you have the Arduino IDE installed or updated, you will need to set some parameters to get the right libraries, board definition file, and the TinyUSB stack.

Install Libraries

In the Arduino IDE menus, go to Sketch -> Include Library -> Manage Libraries. You will need to ensure you have the latest versions of the following libraries:

  • Adafruit_TinyUSB
  • Adafruit_NeoPixel

Board Definition File

You will need to test this on an Adafruit SAMD board such as the Circuit Playground Express, Metro Express M0/M4, Feather Express M0/M4, and others.

In the menu go to Tools -> Board -> Boards Manager. Type in Adafruit SAMD to search. It will likely pull up both the Arduino SAMD board package and the Adafruit SAMD board package. Select the Adafruit SAMD package and ensure it is at least version 1.5.3 or higher for TinyUSB and WebUSB work.

If you do not see the Adafruit SAMD boards package, the following must be added to the Arduino IDE preferences: https://adafruit.github.io/arduino-board-index/package_adafruit_index.json

Using the TinyUSB Stack

Finally, go to Tools -> USB Stack and select TinyUSB. If this is not selectable, update your version of the Arduino IDE. Switching the USB stack puts in TinyUSB instead of the default Arduino USB stack. TinyUSB has more features including WebUSB support.

All set for the Circuit Playground Express

The screen below shows the Arduino IDE with a Circuit Playground Express board. The CPX is plugged in and in bootloader mode by tapping Reset once or twice and seeing a circle of green lights.

See the settings circled in red.

Ok, that is all the configuration needed to work with the code in the two examples next.

This guide was first published on Aug 27, 2019. It was last updated on Aug 27, 2019.

This page (Library, Board, and TinyUSB Selection) was last updated on Aug 14, 2019.

Text editor powered by tinymce.