The WipperSnapper user experience is optimized for microcontrollers such as the ESP32-S2, ESP32, and SAMD51 (with QSPI flash and AirLift). These hardware configurations allow for easy firmware installation and configuration through either the web (using Adafruit's Web ESPTool for ESP32-S2, ESP32) or your operating system (using TinyUSB). 

Some IoT hardware, such as the Arduino Nano 33 IoT, Arduino MKR WiFi 1010 will not work with the existing provisioning methods because they lack external flash storage and/or native USB which allows them to be used as a USB volume.

HOWEVER, you can use a board that lacks these properties, it'll just be a bit trickier to get set up and will require the usage of Arduino IDE.

The following boards are supported by following the instructions on this page:

• Arduino Nano 33 IoT
• Arduino MKR WiFi 1010

Sign up for Adafruit IO

Adafruit IO is a platform designed by Adafruit to display, respond, and interact with your project's data. You will need an Adafruit IO account to use the Adafruit.io Wippersnapper platform. 

If you do not already have an Adafruit IO account set up, head over to io.adafruit.com to create one for free.

Arduino Setup

First - you should go through the setup guides associated with your selected set of hardware, and make sure you have established internet connectivity using the hardware before continuing. 

Next, install the Adafruit WipperSnapper library for Arduino using the Library Manager in the Arduino IDE.

Click the Manage Libraries ... menu item, search for WipperSnapper, and select the Adafruit WipperSnapper Beta library, and install the latest version:

When asked to install the dependencies, click Install all.

Load Example

Open up File -> Examples -> Adafruit WipperSnapper Beta -> Wippersnapper_NoFS

Configure Example

In the code, replace YOUR_AIO_USERNAME and YOUR_AIO_KEY with your Adafruit IO Username and Adafruit IO Key

• If you need to find these credentials, visit io.adafruit.com and click "My Key" on the top right.

Then, replace YOUR_WIFI_SSID with your wireless network's name and YOUR_WIFI_PASSWORD with your wireless network's password.

Save the sketch.

Register your Hardware with WipperSnapper

On a web browser, navigate to the Adafruit IO WipperSnapper page. Keep this page open during this step.

In the Arduino IDE, verify and upload the sketch to your hardware.

• Having trouble compiling or uploading? File a bug report here >>>

On your browser, you should see a new modal pop-up with a picture of your board! Give your board a name and click Continue to Device Page.

Congrats, your board is registered with WipperSnapper! The LED(s) or NeoPixel(s) will periodically flash to alert you that the board is still connected to Adafruit.io WipperSnapper.

Next, let's add some components to your board and start playing around!